KVAPALNÉ NÁSTROJE Integračné poistky MATLAB API

Sprievodca migráciou rozhrania MATLAB API

Aktualizácia Moku: Lab na verziu softvéru 3.0 odomkne množstvo nových funkcií. Pri aktualizácii musia používatelia API vykonať ďalšie kroky na migráciu svojich skriptov do nového balíka Moku API. Tento sprievodca migráciou popisuje zmeny API, nové funkcie dostupné v aktualizácii verzie 3.0 a všetky obmedzenia spätnej kompatibility.

Koniecview

Softvér Moku:Lab verzie 3.0 je hlavná aktualizácia, ktorá prináša nový firmvér, používateľské rozhranie a APl hardvéru Moku:Lab. Aktualizácia prináša Moku:Lab do súladu s Moku:Pro a Moku:Go, čo uľahčuje zdieľanie skriptov na všetkých platformách Moku. Aktualizácia odomyká množstvo nových funkcií pre mnohé z existujúcich nástrojov. Pridáva tiež dve nové funkcie: Multi-instrument Mode a Moku Cloud Compile. Existuje aj niekoľko jemných rozdielov v správaní, ktoré sú uvedené v časti Spätná kompatibilita.

Toto je hlavná aktualizácia, ktorá ovplyvňuje architektúru API, a preto nový balík MATLAB API v3.0 nebude spätne kompatibilný s existujúcimi skriptami MATLABu. Používatelia API budú musieť svoje skripty preniesť do nového balíka Moku API, ak upgradujú svoje Moku:Lab na verziu 3.0. Používatelia API s významným vývojom vlastného softvéru by mali starostlivo zvážiť úroveň úsilia potrebného na portovanie ich existujúceho kódu. Moku:Lab 1.9 sa neodporúča pre nové nasadenia a všetkým zákazníkom odporúčame inovovať. Ak sa po inovácii vyskytnú problémy, používatelia budú mať možnosť prejsť na verziu softvéru 1.9.

Tento sprievodca migráciou popisuje advantagaktualizácie a potenciálne komplikácie Moku:Lab verzie 3.0. Načrtáva tiež proces aktualizácie rozhrania MATLAB API a ako v prípade potreby prejsť na nižšiu verziu vášho Moku:Lab.

Nové funkcie verzie 3.0

Nové funkcie

Softvérová verzia 3.0 po prvýkrát prináša režim viacerých nástrojov a kompiláciu Moku Cloud Compile do Moku:Lab, ako aj mnoho vylepšení výkonu a použiteľnosti v rámci sady nástrojov.

Viacnástrojový režim

Režim viacerých nástrojov na Moku:Lab umožňuje používateľom nasadiť dva nástroje súčasne a vytvoriť tak vlastnú testovaciu stanicu. Každý nástroj má plný prístup k analógovým vstupom a výstupom spolu s prepojením medzi slotmi pre nástroje. Vzájomné prepojenia medzi prístrojmi podporujú vysokorýchlostnú digitálnu komunikáciu s nízkou latenciou v reálnom čase až do rýchlosti 2 Gb/s, takže prístroje môžu bežať nezávisle alebo ich možno pripojiť k vybudovaniu pokročilých potrubí na spracovanie signálu. Nástroje je možné dynamicky zamieňať a vymieňať bez prerušenia druhého nástroja. Pokročilí používatelia môžu tiež nasadiť svoje vlastné algoritmy v režime viacerých nástrojov pomocou Moku Cloud Compile.

Kompilácia Moku Cloud

Moku Cloud Compile vám umožňuje nasadiť vlastné DSP priamo na Moku:Lab FPGA v režime viacerých nástrojov. Napíšte kód pomocou a web prehliadač a skompilovať ho v cloude; Moku Cloud Compile nasadí bitový tok do jedného alebo viacerých cieľových zariadení Moku.

Osciloskop

• Režim hlbokej pamäte: ušetrite až 4 mil. sampmenej na kanál pri plnej samprýchlosť plavenia (500 MSa/s)

Spektrum Analyzer

• Vylepšená hladina hluku
• Logaritmická stupnica Vrms a Vpp
• Päť funkcií nového okna (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Phasemeter

• Frekvenčný posun, fáza a amplitude môže byť teraz výstup ako analógový objtage signály
• Používatelia môžu teraz pridať jednosmerný posun k výstupným signálom
• Fázovo uzamknutý sínusový výstup môže byť teraz frekvenčne vynásobený až 2 50x alebo rozdelený na 125x
• Vylepšený rozsah šírky pásma (1 Hz až 100 kHz)
• Pokročilé funkcie fázového balenia a automatického resetovania

Generátor priebehu

• Výstup hluku
• Pulzná šírková modulácia (PWM)

zamknúť Ampživšie

• Vylepšený výkon pri nízkych frekvenciách PLL zamykanie
• Minimálna frekvencia PLL bola znížená na 10 Hz
• Interný PLL signál môže byť teraz frekvenčne vynásobený až 250x alebo rozdelený až 125x na použitie pri demodulácii
• 6-miestna presnosť pre fázové hodnoty

Analyzátor frekvenčnej odozvy

• Zvýšená maximálna frekvencia zo 120 MHz na 200 MHz
• Zvýšte maximálny počet bodov zametania z 512 na 8192
• Nová dynamika Ampfunkcia litude automaticky optimalizuje výstupný signál pre najlepší dynamický rozsah merania
• Nový režim merania ln/ln1
• Upozornenia na saturáciu vstupu
• Matematický kanál teraz podporuje ľubovoľné rovnice s komplexnou hodnotou zahŕňajúce signály kanála, čo umožňuje nové typy meraní komplexných prenosových funkcií
• Vstupné signály je teraz možné merať okrem dBm aj v dBVpp a dBVrms
• Priebeh zametania sa teraz zobrazí na grafe
• Frekvenčnú os je teraz možné uzamknúť, aby sa zabránilo náhodným zmenám počas dlhého pohybu

Laserový zámok

• Vylepšená bloková schéma zobrazuje dráhy signálu skenovania a modulácie
• Nové zamykanie stagFunkcia es umožňuje prispôsobenie procedúry uzamknutia
• Vylepšený výkon pri nízkych frekvenciách PLL zamykanie
• 6-miestna presnosť pre fázové hodnoty
• Vylepšený výkon pri nízkych frekvenciách PLL zamykanie
• Minimálna frekvencia PLL bola znížená na 10 Hz
• The PLL signál môže byť teraz frekvenčne vynásobený až 250x alebo rozdelený až na 0.125x pre použitie pri demodulácii

Iné

Do editora rovníc bola pridaná podpora pre funkciu sínus, ktorú možno použiť na generovanie vlastných kriviek v generátore ľubovoľných kriviek

Previesť binárne LI files do formátu CSV, MATLAB alebo NumPy pri sťahovaní zo zariadenia

Inovovaná podpora API

Nový balík Moku MATLAB API v3.0 poskytuje vylepšenú funkčnosť a stabilitu. Bude dostávať pravidelné aktualizácie na zlepšenie výkonu a zavedenie nových funkcií.

Obmedzenia spätnej kompatibility

API

Nový balík Moku MATLAB API v3.0 nie je spätne kompatibilný s predchádzajúcim balíkom Moku:Lab MATLAB v1.9. Argumenty skriptovania MATLABu a návratové hodnoty sú úplne odlišné. Ak máte rozsiahly vlastný vývoj softvéru s využitím Moku:Lab MATLAB, zvážte vplyv migrácie všetkého vášho softvéru, aby bol kompatibilný s novým API.

Zatiaľ čo balík Moku:Lab MATLAB už nebude dostávať aktualizácie, Liquid Instruments bude naďalej poskytovať podporu používateľom, ktorí nemôžu migrovať na nový balík API.

Nájdite podrobné exampsúbory pre každý nástroj v novom balíku Moku MATLAB API v3.0 slúžia ako základná línia pre konverziu predchádzajúceho vývoja MATLABu na nový balík API.

Regresie

RAM disk na zaznamenávanie údajov

Verzia 1.9 mala 512 MB filesystém v pamäti RAM zariadenia, ktorý by sa dal použiť na zaznamenávanie údajov pri vysokej sampling sadzby. Vo verzii 3.0 už nie je k dispozícii zapisovanie do pamäte RAM. Na umožnenie zaznamenávania údajov je potrebná karta SD. V súlade s tým sa mení aj maximálna rýchlosť snímania. Verzia 1.9 podporuje až 1 MSa/s, zatiaľ čo verzia 3.0 podporuje až 250 kSa/s na 1 kanáli a 125 kSa/s na 2 kanáloch. Dokonca aj pri nižších rýchlostiach a s kartou SD už nebudú podporované pracovné postupy, ktoré zahŕňali ukladanie viacerých vysokorýchlostných protokolov do pamäte RAM a ich neskoršie skopírovanie na kartu SD alebo klienta.

Záznam údajov do CSV

Verzia 1.9 mala možnosť ukladať údaje priamo do CSV file pri ťažbe dreva. Táto funkcia nie je priamo dostupná vo verzii 3.0. Používatelia, ktorých pracovný postup zahŕňal ukladanie CSVfiles priamo na SD kartu, alebo klient teraz bude musieť najprv skonvertovať binárne file do CSV, buď pomocou klientskej aplikácie, alebo inštaláciou samostatných tekutých nástrojov File Prevod do počítača, ktorý používajú na spracovanie údajov.

Zmeny, ktoré nie sú spätne kompatibilné

Škálovanie údajov v LIA

Vo verzii 1.9 sme implementovali škálovanie údajov tak, že vynásobením dvoch 0.1 V jednosmerných signálov vznikol výstup 0.02 V jednosmerný prúd. Vo verzii 3.0 sme to zmenili tak, že výsledkom bolo 0.01 V DC, čo viac zodpovedá intuitívnym očakávaniam zákazníkov.

Výstup generátora priebehov musí byť povolený, aby sa mohol použiť ako zdroj/spúšťač modulácie

Vo verzii 1.9 bolo možné použiť tvar vlny iného kanála ako zdroj modulácie alebo spúšťania v generátore tvarov vlny, aj keď bol výstup tohto kanála vypnutý. Toto bolo vo verzii odstránené

• Používatelia, ktorí chcú vykonávať krížovú moduláciu bez toho, aby museli odpojiť výstupy svojho zariadenia, budú musieť upraviť svoje

Moku MATLAB API

Balík Moku MATLAB API v3.0 má poskytnúť vývojárom MATLAB zdroje potrebné na ovládanie akéhokoľvek zariadenia Moku a v konečnom dôsledku možnosť začleniť tieto ovládacie prvky do väčších aplikácií pre koncových používateľov. Nový balík Moku MATLAB API v3.0 poskytuje nasledovné:

• Plne funkčný naprample MATLAB skripty pre každý z nich
• Všetky skripty MATLABu sú vybavené komentármi, ktoré sú ľahko pochopiteľné a môžu slúžiť ako východiskový bod pre koncového používateľa pre prispôsobenie a
• Sada funkcií poskytujúcich plnú kontrolu nad Moku

Aktuálne podporované nástroje

1. Generátor ľubovoľného tvaru vlny
2. Dataloger
3. Digitálny filtračný box
4. FIR Filter Builder
5. Analyzátor frekvenčnej odozvy
6. Laserový zámok
7. Uzamknutie Ampživšie
8. Osciloskop
9. Phasemeter
10. PID regulátor
11. Spektrum Analyzer
12. Generátor priebehu
13. Viacnástrojový režim
14. Kompilácia Moku Cloud

Inštalácia

Požiadavky

• MATLAB verzia 2015 alebo novšia

Ak už máte nainštalovanú predchádzajúcu verziu Moku MATLAB API, pred pokračovaním ju odinštalujte. Balík môžete odinštalovať zo Správcu doplnkov.

1. Otvorte Správcu doplnkov cez kartu Domov > Prostredie.
2. Hľadať Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Prípadne si môžete stiahnuť súbor nástrojov priamo z Liquid Instruments webmiesto na https://www.liquidinstruments.com/products/apis/matlab-api/. Ak to urobíte, budete musieť manuálne nastaviť cestu vyhľadávania.
4. Skontrolujte, či bola do panela nástrojov pridaná správna cesta výberom položky „Nastaviť cestu“ na karte Domov > Prostredie.
5. Uistite sa, že existuje vstup smerujúci na miesto inštalácie súpravy nástrojov. Typická cesta môže byť CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Stiahnite si údaje o prístroji files napísaním 'moku_download####) do príkazového okna MATLABu. ### by sa malo nahradiť aktuálnou verziou firmvéru. Svoju aktuálnu verziu firmvéru môžete nájsť prostredníctvom aplikácie Moku: desktop kliknutím pravým tlačidlom myši na svoje Moku a umiestnením kurzora myši na „Informácie o zariadení“ alebo v aplikácii iPad dlhým stlačením na svojom Moku.
7. Skontrolujte, či je váš panel nástrojov nastavený správne, zadaním „help Moku“ do príkazového okna MATLABu. Ak je tento príkaz úspešný. potom bol panel nástrojov úspešne nainštalovaný

Zmeny Moku API

Nová architektúra Moku MATLAB API je dostatočne odlišná od svojho predchodcu, a preto nie je spätne kompatibilná s existujúcimi API skriptami. Nasledujúci zjednodušený osciloskop example ukazuje rozdiely medzi starými a novými balíkmi API a slúži ako plán na prenos existujúceho kódu.

Osciloskop naprample

Postupné kroky

1. Importujte Moku MATLAB API 3.0
2. Nárokujte si vlastníctvo Moku a nahrajte bitový tok osciloskopu do
3. Nastavte časovú základňu a nastavte ľavé a pravé rozpätie pre časovú os.
4. Získajte údaje, získajte jeden rámec údajov z osciloskopu
5. Ukončite reláciu klienta tým, že sa vzdáte vlastníctva Moku

Vyššie opísaná sekvencia je zjednodušený príkladample na ilustráciu rozdielov medzi starými a novými balíkmi API. Okrem spustenia relácie klienta, nahrania bitového toku nástroja do Moku a ukončenia relácie klienta môže koncový používateľ vykonávať ľubovoľný počet funkcií v rôznom poradí, aby vyhovoval potrebám svojej aplikácie.

Rozdiely

Tu sa pozrieme na rozdiely medzi týmito dvoma APl pre každý krok v sekvencii.

Nárokujte si vlastníctvo Moku a nahrajte bitový tok osciloskopu do zariadenia. V porovnaní s Moku MATLAB 1.9 má nové API úplne iné funkcie:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Funkcia	get_by_name()	deploy_or_conn ect()	Osciloskop()
Povolené polia a hodnoty	name: string timeout: float	nástroj: trieda nástroja, ktorý chcete nasadiť	ip: string serial: string
	sila: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: float
			read_timeout: float

 

1. Nastavte časovú základňu. Funkcia je rovnaká, ale povolené argumenty sa mierne líšia:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funkcia	set_timebase()	set_timebase()
   Povolené polia a hodnoty	t1: plavák t2: plavák	t1: float t2:float striktné: bool

2. Získajte údaje. Funkcie a povolené argumenty sú rovnaké, ale vrátený typ údajov a dĺžka sa líšia:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funkcia	get_data()	get_data()
   Povolené polia a hodnoty	timeout: float wait: bool	časový limit: float wait_reacquire: bool
   Dĺžka návratu	16383 bodov na snímku	1024 bodov na snímku

3. Uvoľnite vlastníctvo Moku:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Funkcia	zavrieť()	vzdať sa vlastníctva ()

Zoznam funkcií osciloskopu

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_rampvlnaO gen_sinewaveO	vygenerovať_vlnuO get_acquisition_modeQ
gen_squarewaveQ	get_sourcesQ
gen_offQ	get_timebaseQ get_output_!loadQ
set_samplerateQ set_framerateQ	get_interpo!ationO set_output_!loadQ
	set_hysteresisQ set_interpo!ationO
	set_input_attenuationO
	set_sourceO osc_measurementQ
	zhrnutieQ

Moku MATLAB API je založené na Moku API. Úplnú dokumentáciu Moku API nájdete v príručke Moku API Reference tu https://apis.liq uidinstrume nts.com/re fe rence/.

Ďalšie podrobnosti o tom, ako začať s Moku MATLAB API, nájdete na https://a pis.liquid instruments.com/sta hodnotenie- Matlab.domov

Proces prechodu na nižšiu verziu

Ak sa ukázalo, že inovácia na verziu 3.0 obmedzuje alebo inak nepriaznivo ovplyvňuje niečo kritické pre vašu aplikáciu, môžete prejsť na predchádzajúcu verziu 1.9. To možno vykonať prostredníctvom a web prehliadač.

Kroky

1. Kontaktujte Liquid Instruments a získajte file pre verziu firmvéru 9.
2. Zadajte svoju IP adresu Moku:Lab do a web prehliadač (pozri snímku obrazovky).
3. V časti Aktualizovať firmvér vyhľadajte a vyberte firmvér file poskytované spoločnosťou Liquid Instruments.
4. Vyberte možnosť Nahrať a aktualizovať. Dokončenie procesu aktualizácie môže trvať viac ako 10 minút

© 2023 Liquid Instruments. rezervované.

laudinstruments.com

Dokumenty / zdroje

KVAPALNÉ NÁSTROJE Integračné poistky MATLAB API [pdf] Používateľská príručka MATLAB API, MATLAB API integračné poistky, integračné poistky, poistky

Referencie

• Používateľská príručka