LIQUID INSTRUMENTS MATLAB API -integraatiosulakkeet

MATLAB API Migration Guide

Moku: Labin päivittäminen ohjelmistoversioon 3.0 avaa joukon uusia ominaisuuksia. Päivittäessään API-käyttäjien on suoritettava lisätoimia siirtääkseen komentosarjansa uuteen Moku API -pakettiin. Tässä siirtooppaassa esitellään API-muutokset, versiossa 3.0 saatavilla olevat uudet ominaisuudet ja mahdolliset taaksepäin yhteensopivuuden rajoitukset.

Yliview

Moku:Lab-ohjelmistoversio 3.0 on merkittävä päivitys, joka tuo uuden laiteohjelmiston, käyttöliittymän ja APl:t Moku:Lab-laitteistoon. Päivitys tuo Moku:Labin yhteen Moku:Pron ja Moku:Gon kanssa, mikä tekee skriptien jakamisesta helppoa kaikilla Moku-alustoilla. Päivitys avaa joukon uusia ominaisuuksia monille olemassa oleville instrumenteille. Se lisää myös kaksi uutta ominaisuutta: Multi-instrument Mode ja Moku Cloud Compile. On myös joitain hienovaraisia ​​käyttäytymiseroja, jotka on kuvattu Taaksepäin yhteensopivuus -osiossa.

Tämä on merkittävä päivitys, joka vaikuttaa API-arkkitehtuuriin, ja siksi uusi MATLAB API v3.0 -paketti ei ole taaksepäin yhteensopiva olemassa olevien MATLAB-komentosarjojen kanssa. API-käyttäjien on siirrettävä komentosarjansa uuteen Moku API -pakettiin, jos he päivittävät Moku:Labinsa versioon 3.0. Sovellusliittymän käyttäjien, joilla on merkittävää räätälöityjen ohjelmistojen kehitystä, tulee harkita huolellisesti nykyisen koodinsa siirtämiseen vaadittavaa vaivaa. Moku:Lab 1.9:ää ei suositella uusiin käyttöönotuksiin, ja kaikkia asiakkaita kehotetaan päivittämään. Jos ongelmia ilmenee päivityksen jälkeen, käyttäjät voivat päivittää ohjelmistoversioon 1.9.

Tässä siirtooppaassa kerrotaan advantagMoku:Lab-version 3.0 päivityksistä ja mahdollisista komplikaatioista. Siinä kuvataan myös MATLAB-sovellusliittymän päivitysprosessi ja Moku:Lab-version päivittäminen tarvittaessa.

Version 3.0 uusia ominaisuuksia

Uusia ominaisuuksia

Ohjelmistoversio 3.0 tuo Multi-Instrument Moden ja Moku Cloud Compile -sovelluksen Moku:Labiin ensimmäistä kertaa sekä monia suorituskyky- ja käytettävyyspäivityksiä instrumenttisarjaan.

Moniinstrumenttitila

Moku:Labin usean instrumentin tilassa käyttäjät voivat käyttää kahta laitetta samanaikaisesti luodakseen mukautetun testiaseman. Jokaisella instrumentilla on täysi pääsy analogisiin tuloihin ja ulostuloihin sekä instrumenttipaikkojen välisiin liitäntöihin. Välineiden väliset liitännät tukevat nopeaa, alhaisen latenssin, reaaliaikaista digitaalista tiedonsiirtoa jopa 2 Gb/s, joten instrumentit voivat toimia itsenäisesti tai ne voidaan liittää kehittyneiden signaalinkäsittelyputkien rakentamiseen. Instrumentteja voidaan vaihtaa dynaamisesti sisään ja ulos keskeyttämättä toista instrumenttia. Edistyneet käyttäjät voivat myös ottaa käyttöön omia mukautettuja algoritmejaan moniinstrumenttitilassa Moku Cloud Compile -palvelun avulla.

Moku Cloud Compile

Moku Cloud Compile -sovelluksen avulla voit ottaa mukautetun DSP:n käyttöön suoraan Moku:Lab FPGA:lle monilaitetilassa. Kirjoita koodi käyttämällä a web selain ja käännä se pilveen; Moku Cloud Compile ottaa bittivirran käyttöön yhteen tai useampaan Moku-kohdelaitteeseen.

Oskilloskooppi

• Syvä muistitila: säästä jopa 4M sampvähemmän per kanava täydellä sampling-nopeus (500 MSa/s)

Spectrum Analyzer

• Parannettu melulattia
• Logaritminen Vrms ja Vpp asteikko
• Viisi uutta ikkunatoimintoa (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Vaihemittari

• Taajuussiirtymä, vaihe ja amplitude voidaan nyt lähettää analogisena voltage -signaaleja
• Käyttäjät voivat nyt lisätä DC-offsetin lähtösignaaleihin
• Vaihelukittu siniaaltolähtö voidaan nyt kertoa taajuus jopa 2 50x tai jakaa alas 125x
• Parannettu kaistanleveysalue (1 Hz - 100 kHz)
• Edistyneet vaiheen käärintä- ja automaattiset palautustoiminnot

Aaltomuodon generaattori

• Melulähtö
• Pulssileveysmodulaatio (PWM)

Lukita Ampelävämpi

• Paranneltu matalia taajuuksia PLL lukitus
• PLL:n minimitaajuus on laskettu 10 Hz:iin
• Sisäinen PLL-signaali voidaan nyt kertoa taajuudella 250x tai jakaa alas 125x käytettäväksi demoduloinnissa
• 6-numeroinen vaihearvojen tarkkuus

Frequency Response Analyzer

• Maksimitaajuus nostettu 120 MHz:stä 200 MHz:iin
• Kasvata pyyhkäisypisteiden enimmäismäärää 512:sta 8192:een
• Uusi dynamiikka AmpLiitude-ominaisuus optimoi lähtösignaalin automaattisesti parhaan mittausdynamiikan saavuttamiseksi
• Uusi ln/ln1 mittaustila
• Syötteen kylläisyysvaroitukset
• Matemaattinen kanava tukee nyt mielivaltaisia ​​kompleksiarvoisia yhtälöitä, jotka sisältävät kanavasignaaleja, mikä mahdollistaa uudentyyppiset monimutkaiset siirtofunktiomittaukset
• Tulosignaalit voidaan nyt mitata dBVpp- ja dBVrms-yksiköissä dBm:n lisäksi
• Pyyhkäisyn edistyminen näkyy nyt kaaviossa
• Taajuusakseli voidaan nyt lukita tahattomien muutosten estämiseksi pitkän pyyhkäisyn aikana

Laser Lock Box

• Parannettu lohkokaavio näyttää pyyhkäisy- ja modulaatiosignaalipolut
• Uusi lukko stages-ominaisuuden avulla voit mukauttaa lukitusmenettelyä
• Paranneltu matalia taajuuksia PLL lukitus
• 6-numeroinen vaihearvojen tarkkuus
• Paranneltu matalia taajuuksia PLL lukitus
• PLL:n minimitaajuus on laskettu 10 Hz:iin
• The PLL signaali voidaan nyt kertoa taajuus jopa 250x tai jakaa alas 0.125x käytettäväksi demodulaatiossa

muu

Lisätty tuki sinifunktiolle kaavaeditoriin, jota voidaan käyttää mukautettujen aaltomuotojen luomiseen mielivaltaisessa aaltomuotogeneraattorissa

Muunna binääri LI files CSV-, MATLAB- tai NumPy-muotoon ladattaessa laitteesta

Päivitetty API-tuki

Uusi Moku MATLAB API v3.0 -paketti tarjoaa parannettua toimivuutta ja vakautta. Se saa säännöllisesti päivityksiä suorituskyvyn parantamiseksi ja uusien ominaisuuksien lisäämiseksi.

Taaksepäin yhteensopivuuden rajoitukset

API

Uusi Moku MATLAB API v3.0 -paketti ei ole taaksepäin yhteensopiva edellisen Moku:Lab MATLAB v1.9 -paketin kanssa. MATLAB-komentosarjaargumentit ja palautusarvot ovat täysin erilaisia. Jos sinulla on laaja räätälöity ohjelmistokehitys Moku:Lab MATLABia hyödyntäen, harkitse kaikkien ohjelmistojen siirtämisen vaikutusta uuden API:n kanssa yhteensopiviksi.

Vaikka Moku:Lab MATLAB-paketti ei enää saa päivityksiä, Liquid Instruments jatkaa edelleen tuen tarjoamista käyttäjille, jotka eivät voi siirtyä uuteen API-pakettiin.

Etsi yksityiskohtaiset examples jokaiselle instrumentille uudessa Moku MATLAB API v3.0 -paketissa, jotta se toimii perustana aiemman MATLAB-kehityksen muuntamiseksi uudeksi API-paketiksi.

Regressiot

RAM-levy tietojen kirjaamiseen

Versiossa 1.9 oli 512 megatavua filejärjestelmä laitteen RAM-muistissa, jota voitaisiin käyttää tietojen kirjaamiseen korkeilla sampling hinnat. Versiossa 3.0 kirjautuminen RAM-muistiin ei ole enää käytettävissä. Tietojen kirjaamisen mahdollistamiseksi tarvitaan SD-kortti. Vastaavasti myös maksimiottonopeus muuttuu. Versio 1.9 tukee jopa 1 MSa/s, kun taas versio 3.0 tukee jopa 250 kSa/s yhdellä kanavalla ja 1 kSa/s 125 kanavalla. Jopa pienemmillä nopeuksilla ja SD-kortilla työnkulkuja, joihin sisältyi useiden nopeiden lokien tallentaminen RAM-muistiin ja niiden kopioiminen myöhemmin SD-kortille tai asiakkaalle, ei enää tueta.

Tiedon kirjaus CSV-muotoon

Versio 1.9 pystyi tallentamaan tiedot suoraan CSV-tiedostoon file kirjaamisen aikana. Tämä ominaisuus ei ole suoraan saatavilla versiossa 3.0. Käyttäjät, joiden työnkulkuun sisältyi CSV:n tallentaminenfiles suoraan SD-kortille tai asiakkaan on nyt ensin muutettava binaari file CSV-tiedostoon joko asiakassovelluksella tai asentamalla erilliset Liquid Instruments -instrumentit File Muunna tietokoneeksi, jota he käyttävät tietojenkäsittelyyn.

Muutokset, jotka eivät ole yhteensopivia

Tietojen skaalaus LIA:ssa

Versiossa 1.9 toteutimme tiedon skaalauksen siten, että kertomalla kaksi 0.1 V DC signaalia saatiin 0.02 V DC ulostulo. Versiossa 3.0 muutimme tämän siten, että tulokseksi tuli 0.01 V DC, mikä vastaa paremmin asiakkaiden intuitiivisia odotuksia.

Waveform Generator -lähtö on otettava käyttöön, jotta sitä voidaan käyttää modulaatiolähteenä/laukaisimena

Versiossa 1.9 eri kanavan aaltomuotoa voitiin käyttää modulaatio- tai liipaisulähteenä Waveform Generatorissa, vaikka kyseisen kanavan lähtö olisi poistettu käytöstä. Tämä poistettiin versiosta

• Käyttäjien, jotka haluavat tehdä ristimodulaation ilman, että heidän tarvitsee irrottaa laitteensa lähtöjä, on säädettävä

Moku MATLAB API

Moku MATLAB API v3.0 -paketti on tarkoitettu tarjoamaan MATLAB-kehittäjille minkä tahansa Moku-laitteen ohjaamiseen tarvittavat resurssit ja viime kädessä mahdollisuus sisällyttää nämä ohjaimet suurempiin loppukäyttäjien sovelluksiin. Uusi Moku MATLAB API v3.0 -paketti tarjoaa seuraavat:

• Täysin toimiva example MATLAB-skriptit kullekin
• Kaikki MATLAB-skriptit on varustettu kommenteilla, jotka ovat helposti ymmärrettäviä ja voivat toimia loppukäyttäjän lähtökohtana mukauttamiseen ja
• Joukko toimintoja, jotka tarjoavat täyden hallinnan Mokulle

Tällä hetkellä tuetut instrumentit

1. Mielivaltainen aaltomuotogeneraattori
2. Data Loggeri
3. Digitaalinen suodatinlaatikko
4. FIR-suodattimen rakentaja
5. Frequency Response Analyzer
6. Laser Lock Box
7. Lukitus Ampelävämpi
8. Oskilloskooppi
9. Vaihemittari
10. PID-säädin
11. Spectrum Analyzer
12. Aaltomuodon generaattori
13. Moniinstrumenttitila
14. Moku Cloud Compile

Asennus

Vaatimukset

• MATLAB-versio 2015 tai uudempi

Jos sinulla on jo aiempi versio Moku MATLAB API:sta asennettuna, poista se ennen kuin jatkat. Voit poistaa paketin asennuksen Add-on Managerista.

1. Avaa Lisäosien hallinta Koti > Ympäristö -välilehden kautta.
2. Etsi Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Vaihtoehtoisesti voit ladata työkalupakin suoraan Liquid Instrumentsista websivusto osoitteessa https://www.liquidinstruments.com/products/apis/matlab-api/. Sinun on asetettava hakupolku manuaalisesti, jos teet tämän.
4. Tarkista, että työkalulaatikkoon on lisätty oikea polku valitsemalla Koti > Ympäristö -välilehdestä Aseta polku.
5. Varmista, että työkalulaatikon asennuspaikkaan osoittaa sisääntulo. Tyypillinen polku voi olla CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku- MATLAB.
6. Lataa laitteen tiedot files kirjoittamalla 'moku_download####) MATLAB-komentoikkunaan. ### tulee korvata nykyisellä laiteohjelmistoversiollasi. Yol löytää nykyisen laiteohjelmistoversiosi Moku: -työpöytäsovelluksen kautta napsauttamalla Mokua hiiren kakkospainikkeella ja viemällä osoittimen "Laitetiedot" tai iPad-sovelluksesta painamalla pitkään Mokua.
7. Varmista, että työkalupakki on määritetty oikein kirjoittamalla "help Moku" MATLAB-komentoikkunaan. Jos tämä komento onnistuu. sitten työkalupakki on asennettu onnistuneesti

Moku API -muutokset

Uusi Moku MATLAB API -arkkitehtuuri eroaa riittävästi edeltäjästään eikä siksi ole taaksepäin yhteensopiva olemassa olevien API-skriptien kanssa. Seuraava yksinkertaistettu oskilloskooppi example näyttää erot vanhojen ja uusien API-pakettien välillä ja toimii tiekartana olemassa olevan koodin siirtämiseen.

Oskilloskooppi example

Jakson vaiheet

1. Tuo Moku MATLAB API 3.0
2. Lunasta Mokun omistusoikeus ja lataa Oscilloscope-bittivirta kohteeseen
3. Aseta aikapohja ja aseta aika-akselin vasemman ja oikean jänneväli.
4. Hanki tietoja, hanki yksi kehys tiedoista oskilloskoopista
5. Lopeta asiakasistunto luopumalla Mokun omistajuudesta

Yllä kuvattu sekvenssi on yksinkertaistettu esimample kuvaamaan eroja vanhojen ja uusien API-pakettien välillä. Asiakasistunnon aloittamisen, instrumentin bittivirran lataamisen Mokuun ja asiakasistunnon lopettamisen lisäksi loppukäyttäjä voi käyttää mitä tahansa toimintoja eri tavalla vastatakseen sovelluksensa tarpeisiin.

Erot

Tässä tarkastellaan eroja kahden APl:n välillä sekvenssin jokaisessa vaiheessa.

Lunasta Mokun omistajuus ja lataa Oskilloskoopin bittivirta laitteeseen. Verrattuna Moku MATLAB 1.9:ään uudella API:lla on täysin erilaiset toiminnot:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Toiminto	get_by_name()	käyttöönotto_tai_yhteys ect()	Oskilloskooppi ()
Sallitut kentät ja arvot	nimi: merkkijonon aikakatkaisu: float	instrumentti: käytettävän laitteen luokka	ip: merkkijono sarja: merkkijono
	voima: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: float
			read_timeout: float

 

1. Aseta aikapohja. Funktio on sama, mutta sallitut argumentit ovat hieman erilaisia:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Toiminto	set_timebase()	set_timebase()
   Sallitut kentät ja arvot	t1: float t2: float	t1: float t2: float range: bool

2. Hanki dataa. Funktiot ja sallitut argumentit ovat samat, mutta palautettu tietotyyppi ja pituus ovat erilaisia:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Toiminto	get_data ()	get_data ()
   Sallitut kentät ja arvot	aikakatkaisu: kelluva odotus: bool	aikakatkaisu: float wait_reacquire: bool
   Palautuspituus	16383 pistettä kehystä kohden	1024 pistettä kehystä kohden

3. Vapauta Mokun omistusoikeus:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Toiminto	lähellä()	relinquish_ownership()

Oskilloskoopin toimintoluettelo

Moku MATLAB 1.9	Moku MATLAB 3.0
set_sourceO	set_sourcesO
set_triggerO	set_triggerO
get_dataQ	get_dataQ
set_frontendQ	set_frontendQ
set_defau!tsQ set_timebaseO set_xmodeQ	set_defau!tsQ set_timebaseQ disable_inputO enable_rollmodeQ
set_precision_modeQ	set_acquisition_modeQ
sync_phaseQ	sync_output_phaseQ
get_frontendQ	get_frontendQ
get_samp!erateO get_rea!time_dataQ	get_samp!erateO save_high_res_bufferO
gen_rampwaveO gen_sinewaveO	gener_waveformO get_acquisition_modeQ
gen_squarewaveQ	get_sourcesQ
gen_offQ	get_timebaseQ get_output_!oadQ
set_samplerateQ set_framerateQ	get_interpo!ationO set_output_!oadQ
	set_hysteresisQ set_interpo!ationO
	set_input_attenuationO
	set_sourceO osc_measurementQ
	yhteenvetoQ

Moku MATLAB API perustuu Moku API:hen. Katso täydelliset Moku API -dokumentaatiot Moku API Reference -oppaasta, joka löytyy täältä https://apis.liq uidinstrume nts.com/re fe rence/.

Lisätietoja Moku MATLAB API:n käytön aloittamisesta on osoitteessa https://a pis.liquid instruments.com/sta luokitus-Matlab.kotiin

Päivitysprosessi

Jos päivitys versioon 3.0 on osoittautunut rajoittavan tai muutoin haittaavan jotakin sovelluksesi kannalta kriittistä, voit päivittää aiempaan versioon 1.9. Tämä voidaan tehdä a web selain.

Vaiheet

1. Ota yhteyttä Liquid Instrumentsiin ja hanki file laiteohjelmiston versiolle 9.
2. Kirjoita Moku:Lab IP-osoitteesi kohtaan a web selain (katso kuvakaappaus).
3. Selaa Päivitä laiteohjelmisto -kohdassa ja valitse laiteohjelmisto file tarjoaa Liquid Instruments.
4. Valitse Lataa ja päivitä. Päivitysprosessi voi kestää yli 10 minuuttia

© 2023 Liquid Instruments. varattu.

laudinstruments.com

Asiakirjat / Resurssit

LIQUID INSTRUMENTS MATLAB API -integraatiosulakkeet [pdfKäyttöopas MATLAB API, MATLAB API integrointisulakkeet, integrointisulakkeet, sulakkeet

Viitteet

• Käyttöopas