LIQUID INSTRUMENTS MATLAB API integrációs biztosítékok

MATLAB API migrációs útmutató

A Moku: Lab szoftver 3.0-s verziójára való frissítése számos új funkciót nyit meg. Frissítéskor az API-felhasználóknak további lépéseket kell tenniük, hogy áttelepítsék szkripteiket az új Moku API-csomagba. Ez az átállási útmutató ismerteti az API-módosításokat, a 3.0-s verzió frissítésében elérhető új funkciókat, valamint a visszamenőleges kompatibilitási korlátozásokat.

Felettview

A Moku:Lab szoftver 3.0-s verziója egy jelentős frissítés, amely új firmware-t, felhasználói felületet és hozzáférési pontokat hoz a Moku:Lab hardverbe. A frissítés a Moku:Lab-t összhangba hozza a Moku:Pro-val és a Moku:Go-val, megkönnyítve a szkriptek megosztását az összes Moku platformon. A frissítés számos új funkciót nyit meg számos meglévő eszközhöz. Két új funkciót is hozzáad: Multi-instrument Mode és Moku Cloud Compile. Vannak apró viselkedésbeli különbségek is, amelyeket a Visszafelé kompatibilitás részben ismertetünk.

Ez egy jelentős frissítés, amely az API architektúrát érinti, ezért az új MATLAB API v3.0 csomag nem lesz visszafelé kompatibilis a meglévő MATLAB szkriptekkel. Az API-felhasználóknak portolniuk kell szkripteiket az új Moku API-csomagba, ha frissítik Moku:Lab-jukat a 3.0-s verzióra. A jelentős egyéni szoftverfejlesztéssel rendelkező API-felhasználóknak gondosan mérlegelniük kell a meglévő kódjuk portolásához szükséges erőfeszítés mértékét. A Moku:Lab 1.9 nem ajánlott új telepítésekhez, és minden ügyfelet javasolunk a frissítésre. Ha a frissítés után problémák merülnek fel, a felhasználóknak lehetőségük lesz az 1.9-es szoftververzióra való visszalépésre.

Ez az átállási útmutató felvázolja advantaga Moku:Lab 3.0-s verziójának frissítéséről és lehetséges komplikációiról. Felvázolja a MATLAB API frissítésének folyamatát és a Moku:Lab visszaminősítését is, ha szükséges.

A 3.0-s verzió újdonságai

Új funkciók

A szoftver 3.0-s verziója először hozza a Multi-Instrument Mode és a Moku Cloud Compile szolgáltatást a Moku:Lab-ba, valamint számos teljesítmény- és használhatósági frissítést a műszercsomagban.

Több eszköz üzemmód

A Moku:Lab többműszeres üzemmódja lehetővé teszi a felhasználók számára, hogy egyidejűleg két műszert telepítsenek egyéni tesztállomás létrehozásához. Mindegyik hangszer teljes hozzáféréssel rendelkezik az analóg bemenetekhez és kimenetekhez, valamint a hangszernyílások közötti összeköttetésekhez. A műszerek közötti összeköttetések nagy sebességű, alacsony késleltetésű, valós idejű digitális kommunikációt támogatnak akár 2 Gb/s-ig, így a műszerek önállóan is futhatnak, vagy csatlakoztathatók fejlett jelfeldolgozó csővezetékek kiépítéséhez. A hangszerek dinamikusan cserélhetők ki és be a másik hangszer megszakítása nélkül. A haladó felhasználók a Moku Cloud Compile segítségével többeszközös módban is telepíthetik saját egyéni algoritmusaikat.

Moku Cloud Compile

A Moku Cloud Compile lehetővé teszi, hogy az egyéni DSP-t közvetlenül a Moku:Lab FPGA-ra telepítse Multi Instrument módban. Írjon kódot a segítségével web böngészőben, és fordítsa le a felhőben; A Moku Cloud Compile a bitfolyamot egy vagy több Moku céleszközre telepíti.

Oszcilloszkóp

• Mély memória mód: takarítson meg akár 4 millió másodpercetampkevesebb csatornánként teljes sampling sebesség (500 MSa/s)

Spectrum Analyzer

• Javított zajszint
• Logaritmikus Vrms és Vpp skála
• Öt új ablak funkció (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Fázismérő

• Frekvencia eltolás, fázis és ampA litude mostantól analóg voltage jelek
• A felhasználók mostantól DC eltolást adhatnak a kimeneti jelekhez
• A fáziszárolt szinuszos kimenet immár 2-szeresre szorozható vagy 50-szeresre osztható.
• Továbbfejlesztett sávszélesség-tartomány (1 Hz-től 100 kHz-ig)
• Fejlett fázisburkolási és automatikus visszaállítási funkciók

Hullámforma generátor

• Zajkimenet
• Impulzusszélesség -moduláció (PWM)

Bezárni Ampélethűbb

• Jobb teljesítmény az alacsony frekvencián PLL záró
• A minimális PLL frekvencia 10 Hz-re csökkent
• A belső PLL jel immár frekvencia szorozható 250x-re vagy osztható 125x-re a demodulációhoz
• 6 számjegyű pontosság a fázisértékekhez

Frekvenciaválasz-elemző

• A maximális frekvencia 120 MHz-ről 200 MHz-re nőtt
• Növelje a maximális sweep pontokat 512-ről 8192-re
• Az új dinamika AmpA litude funkció automatikusan optimalizálja a kimeneti jelet a legjobb mérési dinamikatartomány érdekében
• Új ln/ln1 mérési mód
• Bemeneti telítettségi figyelmeztetések
• A matematikai csatorna mostantól tetszőleges komplex értékű egyenleteket támogat a csatornajelek bevonásával, lehetővé téve új típusú komplex átviteli függvény méréseket.
• A bemeneti jelek a dBm-en kívül dBVpp-ben és dBVrms-ben is mérhetők
• A sweep folyamata most megjelenik a grafikonon
• A frekvencia tengelye most zárolható, hogy elkerülje a véletlen változást egy hosszú söprés során

Lézeres Lock Box

• A továbbfejlesztett blokkdiagram a letapogatási és modulációs jelutakat mutatja
• Az új zár stages funkció lehetővé teszi a zárolási eljárás testreszabását
• Jobb teljesítmény az alacsony frekvencián PLL záró
• 6 számjegyű pontosság a fázisértékekhez
• Jobb teljesítmény az alacsony frekvencián PLL záró
• A minimális PLL frekvencia 10 Hz-re csökkent
• A PLL a jel immár frekvencia szorozható 250x-re vagy osztható 0.125x-re a demodulációhoz

Más

A szinuszfüggvény támogatása az egyenletszerkesztőben, amely egyéni hullámformák generálására használható az Önkényes hullámforma generátorban

Bináris konvertálás LI files CSV, MATLAB vagy NumPy formátumba az eszközről való letöltéskor

Frissített API-támogatás

Az új Moku MATLAB API v3.0 csomag továbbfejlesztett funkcionalitást és stabilitást biztosít. Rendszeres frissítéseket fog kapni a teljesítmény javítása és új funkciók bevezetése érdekében.

Visszafelé kompatibilitási korlátozások

API

Az új Moku MATLAB API v3.0 csomag visszafelé nem kompatibilis a korábbi Moku:Lab MATLAB v1.9 csomaggal. A MATLAB parancsfájl-argumentumok és a visszatérési értékek teljesen eltérőek. Ha kiterjedt egyéni szoftverfejlesztéssel rendelkezik a Moku:Lab MATLAB használatával, fontolja meg az összes szoftver áttelepítésének hatását, hogy kompatibilis legyen az új API-val.

Bár a Moku:Lab MATLAB csomag már nem kap frissítéseket, a Liquid Instruments továbbra is támogatja azokat a felhasználókat, akik nem tudnak áttérni az új API-csomagra.

Keresse meg a részletes plampAz új Moku MATLAB API v3.0 csomagban található minden egyes eszközhöz, amely alapként szolgál a korábbi MATLAB fejlesztések új API-csomaggá konvertálásához.

Regressziók

RAM lemez adatnaplózáshoz

Az 1.9-es verzióban 512 MB volt filerendszer az eszköz RAM-jában, amely magas s-értéken használható adatok naplózásáraampling árak. A 3.0-s verzióban a RAM-ba való naplózás már nem érhető el. Az adatnaplózás engedélyezéséhez SD-kártya szükséges. Ennek megfelelően változik a maximális felvételi sebesség is. Az 1.9-es verzió 1 MSa/s-ig, míg a 3.0-s verzió akár 250 kSa/s-ig támogat 1 csatornán és 125 kSa/s-ig 2 csatornán. Még kisebb sebességeknél és SD-kártyával sem támogatottak azok a munkafolyamatok, amelyek magukban foglalták a több nagy sebességű napló RAM-ba való mentését, majd későbbi átmásolását az SD-kártyára vagy a kliensre.

Adatnaplózás CSV-be

Az 1.9-es verzió képes volt az adatokat közvetlenül CSV-fájlba menteni file naplózás közben. Ez a funkció közvetlenül nem érhető el a 3.0-s verzióban. Azok a felhasználók, akiknek munkafolyamata a CSV mentését is magában foglaltafiles közvetlenül SD-kártyára, különben a kliensnek most először konvertálnia kell a bináris fájlt file CSV-fájlba, akár az ügyfélalkalmazás használatával, akár az önálló Liquid Instruments telepítésével File Átalakítás arra a számítógépre, amelyet adatfeldolgozásra használnak.

Nem visszafelé kompatibilis változtatások

Adatskálázás LIA-ban

Az 1.9-es verzióban az adatskálázást úgy valósítottuk meg, hogy két 0.1 V-os DC jel szorzata 0.02 V DC kimenetet eredményezett. A 3.0-s verzióban ezt úgy módosítottuk, hogy az eredmény 0.01 V DC lett, ami jobban megfelel az ügyfelek intuitív elvárásainak.

A Waveform Generator kimenetét engedélyezni kell a modulációs forrás/triggerként való használathoz

Az 1.9-es verzióban egy másik csatorna hullámformája használható modulációs vagy triggerforrásként a Waveform Generatorban, még akkor is, ha az adott csatorna kimenete le van tiltva. Ezt a verzióban eltávolították

• Azoknak a felhasználóknak, akik anélkül szeretnének keresztmodulációt végezni, hogy ki kellene húzniuk eszközük kimeneteit, módosítaniuk kell

Moku MATLAB API

A Moku MATLAB API v3.0 csomag célja, hogy a MATLAB fejlesztők számára biztosítsa a Moku eszközök vezérléséhez szükséges erőforrásokat, és végső soron azt a képességet, hogy ezeket a vezérlőket nagyobb végfelhasználói alkalmazásokba is beépítsék. Az új Moku MATLAB API v3.0 csomag a következőket tartalmazza:

• Teljesen működőképes plample MATLAB szkripteket mindegyikhez
• Minden MATLAB szkripthez megjegyzések tartoznak, amelyek könnyen érthetőek, és kiindulási pontként szolgálhatnak a végfelhasználó számára a testreszabáshoz és
• Funkciókészlet, amely teljes irányítást biztosít a Moku felett

Jelenleg támogatott hangszerek

1. Önkényes hullámforma generátor
2. Adatnaplózó
3. Digitális szűrődoboz
4. FIR szűrőépítő
5. Frekvenciaválasz-elemző
6. Lézeres Lock Box
7. Bezárás Ampélethűbb
8. Oszcilloszkóp
9. Fázismérő
10. PID vezérlő
11. Spectrum Analyzer
12. Hullámforma generátor
13. Több eszköz üzemmód
14. Moku Cloud Compile

Telepítés

Követelmények

• MATLAB 2015-ös vagy újabb verzió

Ha már telepítve van a Moku MATLAB API korábbi verziója, kérjük, távolítsa el azt a folytatás előtt. A csomagot eltávolíthatja a Kiegészítéskezelőből.

1. Nyissa meg a Bővítménykezelőt a Kezdőlap > Környezet lapon.
2. Keressen rá A Bővítménykezelőben válaszd a Moku eszközt, majd kattints a „Hozzáadás” gombra. Az eszköztár Moku-MATLAB néven fog megjelenni.
3. Alternatív megoldásként letöltheti az eszköztárat közvetlenül a Liquid Instruments-ből webwebhely a címen https://www.liquidinstruments.com/products/apis/matlab-api/. Ha ezt teszi, manuálisan kell beállítania a keresési útvonalat.
4. Ellenőrizze, hogy a megfelelő útvonalat adta-e hozzá az eszköztárhoz. Ehhez válassza a Kezdőlap > Környezet lapon az „Útvonal beállítása” lehetőséget.
5. Győződjön meg arról, hogy van egy bemenet, amely az eszköztár telepítési helyére mutat. Egy tipikus elérési út a következő lehet: CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Töltse le a műszer adatait files a 'moku_download####) beírásával a MATLAB parancsablakba. A ###-ot le kell cserélni az aktuális firmware-verzióra. A Yol megtalálhatja az aktuális firmware-verziót a Moku: asztali alkalmazáson keresztül, ha jobb egérgombbal kattint Moku-ra, és rámutat az „Eszközadatok” elemre, vagy az iPad alkalmazásban, ha hosszan lenyomja a Moku-t.
7. Győződjön meg arról, hogy az eszköztár megfelelően van beállítva, és írja be a „help Moku” szót a MATLAB parancsablakba. Ha ez a parancs sikeres. akkor az eszköztár sikeresen telepítve lett

Moku API változások

Az új Moku MATLAB API architektúra kellően különbözik elődjétől, ezért nem kompatibilis visszafelé a meglévő API-szkriptekkel. A következő egyszerűsített oszcilloszkóp exampA le mutatja a különbségeket a régi és az új API-csomagok között, és útitervként szolgál a meglévő kód portolásához.

Oszcilloszkóp plample

Sorozat lépései

1. Importálja a Moku MATLAB API 3.0-t
2. Igényelje a Moku tulajdonjogát, és töltse fel az Oscilloscope bitfolyamot ide
3. Állítsa be az időalapot, és állítsa be az időtengely bal és jobb oldali tartását.
4. Szerezzen adatokat, szerezzen be egyetlen képkockát az oszcilloszkópból
5. Az ügyfélmunka befejezése a Moku tulajdonjogának lemondásával

A fent leírt sorrend egy egyszerűsített példaample, hogy szemléltesse a régi és az új API-csomagok közötti különbségeket. A kliens munkamenet megkezdésén, az eszköz bitfolyamának Moku-ba való feltöltésén és a kliens munkamenet befejezésén kívül a végfelhasználó tetszőleges számú funkciót gyakorolhat különféle módon, hogy megfeleljen az alkalmazás igényeinek.

Különbségek

Itt megnézzük a két APl közötti különbségeket a szekvencia egyes lépéseinél.

Igényelje a Moku tulajdonjogát, és töltse fel az Oscilloscope bitfolyamot az eszközre. A Moku MATLAB 1.9-hez képest az új API teljesen más funkciókkal rendelkezik:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Funkció	get_by_name()	deploy_or_conn ect()	Oszcilloszkóp()
Engedélyezett mezők és értékek	név: string timeout: float	eszköz: a bevetni kívánt eszköz osztálya	ip: string serial: string
	erő: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: float
			read_timeout: float

 

1. Állítsa be az időalapot. A függvény ugyanaz, de a megengedett argumentumok kissé eltérnek:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funkció	set_timebase()	set_timebase()
   Engedélyezett mezők és értékek	t1: float t2: float	t1: float t2:float strict: bool

2. Adatok beszerzése. A függvények és a megengedett argumentumok megegyeznek, de a visszaadott adattípus és -hossz eltérő:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funkció	get_data()	get_data()
   Engedélyezett mezők és értékek	timeout: float wait: bool	timeout: float wait_reacquire: bool
   Visszatérés hossza	16383 pont képkockánként	1024 pont képkockánként

3. A Moku tulajdonjogának felszabadítása:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Funkció	közeli()	relinquish_ownership()

Oszcilloszkóp függvények listája

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
	összefoglalóQ

A Moku MATLAB API a Moku API-n alapul. A Moku API teljes dokumentációját az itt található Moku API referenciában találja https://apis.liq uidinstrume nts.com/re fe rence/.

További részletek a Moku MATLAB API használatának megkezdéséhez a következő címen találhatók: https://a pis.liquid instruments.com/sta értékelés-Matlab.otthon

Visszalépési folyamat

Ha bebizonyosodott, hogy a 3.0-s verzióra való frissítés korlátozza vagy más módon hátrányosan befolyásolja az alkalmazás szempontjából kritikus fontosságú dolgokat, akkor visszaválthat az előző 1.9-es verzióra. Ez megtehető a web böngésző.

Lépések

1. Vegye fel a kapcsolatot a Liquid Instruments-szel, és szerezze be file a firmware 9-es verziójához.
2. Írja be Moku:Lab IP-címét a web böngésző (lásd a képernyőképet).
3. A Firmware frissítése alatt tallózzon, és válassza ki a firmware-t file a Liquid Instruments biztosítja.
4. Válassza a Feltöltés és frissítés lehetőséget. A frissítési folyamat több mint 10 percet is igénybe vehet

© 2023 Liquid Instruments. fenntartott.

laudinstruments.com

Dokumentumok / Források

LIQUID INSTRUMENTS MATLAB API integrációs biztosítékok [pdf] Felhasználói útmutató MATLAB API, MATLAB API integrációs biztosítékok, integrációs biztosítékok, biztosítékok

Hivatkozások

• Felhasználói kézikönyv