KAPALNÉ NÁSTROJE Integrační pojistky MATLAB API

Průvodce migrací rozhraní MATLAB API

Upgrade Moku: Lab na verzi softwaru 3.0 odemkne řadu nových funkcí. Při aktualizaci musí uživatelé API podniknout další kroky k migraci svých skriptů do nového balíčku Moku API. Tento průvodce migrací popisuje změny rozhraní API, nové funkce dostupné v aktualizaci verze 3.0 a všechna omezení zpětné kompatibility.

Nadview

Software Moku:Lab verze 3.0 je hlavní aktualizace, která přináší nový firmware, uživatelské rozhraní a APl hardwaru Moku:Lab. Aktualizace přináší Moku:Lab do souladu s Moku:Pro a Moku:Go, takže je snadné sdílet skripty na všech platformách Moku. Aktualizace odemyká řadu nových funkcí mnoha stávajících nástrojů. Přidává také dvě nové funkce: Multi-instrument Mode a Moku Cloud Compile. Existují také některé jemné rozdíly v chování, které jsou popsány v části Zpětná kompatibilita.

Toto je velká aktualizace, která ovlivňuje architekturu API, a proto nový balíček MATLAB API v3.0 nebude zpětně kompatibilní se stávajícími skripty MATLABu. Uživatelé API budou muset své skripty přenést do nového balíčku Moku API, pokud upgradují své Moku:Lab na verzi 3.0. Uživatelé API s významným vývojem vlastního softwaru by měli pečlivě zvážit úroveň úsilí potřebného k přenesení jejich stávajícího kódu. Moku:Lab 1.9 se nedoporučuje pro nová nasazení a všem zákazníkům se doporučuje upgradovat. Pokud po upgradu nastanou problémy, uživatelé budou mít možnost přejít na verzi softwaru 1.9.

Tento průvodce migrací popisuje advantagaktualizace a potenciální komplikace Moku:Lab verze 3.0. Nastiňuje také proces upgradu MATLAB API a jak v případě potřeby downgradovat vaše Moku:Lab.

Nové funkce verze 3.0

Nové funkce

Softwarová verze 3.0 přináší do Moku:Lab poprvé režim Multi-Instrument Mode a Moku Cloud Compile a také mnoho vylepšení výkonu a použitelnosti napříč sadou nástrojů.

Režim více nástrojů

Multi-instrument Mode na Moku:Lab umožňuje uživatelům nasadit dva přístroje současně a vytvořit tak vlastní testovací stanici. Každý nástroj má plný přístup k analogovým vstupům a výstupům spolu s propojením mezi sloty pro nástroje. Propojení mezi přístroji podporuje vysokorychlostní digitální komunikaci s nízkou latencí v reálném čase až do rychlosti 2 Gb/s, takže přístroje mohou běžet nezávisle nebo je lze připojit k vybudování pokročilých kanálů pro zpracování signálu. Nástroje lze dynamicky vyměňovat a zapínat bez přerušení druhého nástroje. Pokročilí uživatelé mohou také nasadit své vlastní algoritmy v režimu více nástrojů pomocí Moku Cloud Compile.

Kompilace Moku Cloud

Moku Cloud Compile vám umožňuje nasadit vlastní DSP přímo na Moku:Lab FPGA v režimu více nástrojů. Napište kód pomocí a web prohlížeč a kompilovat jej v cloudu; Moku Cloud Compile nasadí bitový tok do jednoho nebo více cílových zařízení Moku.

Osciloskop

• Režim hluboké paměti: úspora až 4M samplesů na kanál při plných samprychlost lingu (500 MSa/s)

Spektrum Analyzer

• Vylepšená hladina hluku
• Logaritmická stupnice Vrms a Vpp
• Pět funkcí nového okna (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Phasemetr

• Frekvenční posun, fáze a amplitude lze nyní vysílat jako analogový objemtage signály
• Uživatelé nyní mohou k výstupním signálům přidat DC offset
• Fázově uzamčený sinusový výstup lze nyní frekvenčně vynásobit až 2 50x nebo rozdělit na 125x
• Vylepšený rozsah šířky pásma (1 Hz až 100 kHz)
• Pokročilé funkce zalamování fází a automatického resetování

Generátor křivek

• Výstup hluku
• Pulzně šířková modulace (PWM)

zavřít Ampdoživotní

• Vylepšený výkon při nízkých frekvencích PLL zamykání
• Minimální frekvence PLL byla snížena na 10 Hz
• Interní signál PLL lze nyní násobit frekvencí až 250x nebo dělit až 125x pro použití při demodulaci
• 6místná přesnost pro fázové hodnoty

Analyzátor frekvenční odezvy

• Zvýšena maximální frekvence ze 120 MHz na 200 MHz
• Zvyšte maximální počet bodů rozmítání z 512 na 8192
• Nová dynamika AmpFunkce litude automaticky optimalizuje výstupní signál pro nejlepší dynamický rozsah měření
• Nový režim měření ln/ln1
• Upozornění na saturaci vstupu
• Matematický kanál nyní podporuje libovolné rovnice s komplexními hodnotami zahrnující signály kanálu, což umožňuje nové typy komplexních měření přenosových funkcí.
• Vstupní signály lze nyní kromě dBm měřit také v dBVpp a dBVrms
• Průběh rozmítání je nyní zobrazen v grafu
• Frekvenční osu lze nyní uzamknout, aby se zabránilo náhodným změnám během dlouhého rozmítání

Laserový zámek

• Vylepšené blokové schéma ukazuje cesty skenovacího a modulačního signálu
• Nové zamykání stagFunkce es umožňuje přizpůsobení postupu uzamčení
• Vylepšený výkon při nízkých frekvencích PLL zamykání
• 6místná přesnost pro fázové hodnoty
• Vylepšený výkon při nízkých frekvencích PLL zamykání
• Minimální frekvence PLL byla snížena na 10 Hz
• The PLL signál lze nyní frekvenčně vynásobit až 250x nebo rozdělit až na 0.125x pro použití v demodulaci

Ostatní

Do editoru rovnic byla přidána podpora pro funkci sinus, kterou lze použít ke generování vlastních průběhů v generátoru libovolných průběhů

Převést binární LI files do formátu CSV, MATLAB nebo NumPy při stahování ze zařízení

Upgradovaná podpora API

Nový balíček Moku MATLAB API v3.0 poskytuje vylepšenou funkčnost a stabilitu. Bude dostávat pravidelné aktualizace pro zlepšení výkonu a zavedení nových funkcí.

Omezení zpětné kompatibility

API

Nový balíček Moku MATLAB API v3.0 není zpětně kompatibilní s předchozím balíčkem Moku:Lab MATLAB v1.9. Skriptovací argumenty MATLABu a návratové hodnoty jsou zcela odlišné. Pokud máte rozsáhlý vlastní vývoj softwaru s využitím Moku:Lab MATLAB, zvažte dopad migrace veškerého vašeho softwaru na to, aby byl kompatibilní s novým API.

Přestože balíček Moku:Lab MATLAB již nebude dostávat aktualizace, Liquid Instruments bude nadále poskytovat podporu uživatelům, kteří nemohou migrovat na nový balíček API.

Najděte podrobné exampsoubory pro každý nástroj v novém balíčku Moku MATLAB API v3.0 slouží jako základní linie pro převod předchozího vývoje MATLABu na nový balíček API.

Regrese

RAM disk pro záznam dat

Verze 1.9 měla 512 MB filesystém v paměti RAM zařízení, který by mohl být použit k protokolování dat při vysokých sampling sazby. Ve verzi 3.0 již není k dispozici protokolování do paměti RAM. Chcete-li povolit protokolování dat, je vyžadována karta SD. V souladu s tím se také mění maximální rychlost snímání. Verze 1.9 podporovala až 1 MSa/s, zatímco verze 3.0 podporuje až 250 kSa/s na 1 kanálu a 125 kSa/s na 2 kanály. I při nižších rychlostech a s kartou SD již nebudou podporovány pracovní postupy, které zahrnovaly ukládání více vysokorychlostních protokolů do paměti RAM a jejich pozdější zkopírování na kartu SD nebo klienta.

Záznam dat do CSV

Verze 1.9 měla možnost ukládat data přímo do CSV file při těžbě dřeva. Tato funkce není přímo dostupná ve verzi 3.0. Uživatelé, jejichž pracovní postup zahrnoval ukládání CSVfiles přímo na SD kartu, nebo klient nyní bude muset nejprve převést binární soubor file do CSV, buď pomocí klientské aplikace, nebo instalací samostatných Liquid Instruments File Převod do počítače, který používají ke zpracování dat.

Změny, které nejsou zpětně kompatibilní

Měřítko dat v LIA

Ve verzi 1.9 jsme implementovali škálování dat tak, že vynásobením dvou 0.1 V DC signálů byl výstup 0.02 V DC. Ve verzi 3.0 jsme to změnili tak, že výsledkem bylo 0.01 V DC, což více odpovídá intuitivnímu očekávání zákazníků.

Pro použití jako zdroj/spouštěč modulace musí být povolen výstup generátoru křivek

Ve verzi 1.9 mohl být tvar vlny jiného kanálu použit jako modulační nebo spouštěcí zdroj v generátoru vlnových tvarů, i když byl výstup tohoto kanálu deaktivován. Toto bylo ve verzi odstraněno

• Uživatelé, kteří chtějí provádět křížovou modulaci, aniž by museli odpojit výstupy svého zařízení, by si museli upravit své

Moku MATLAB API

Balíček Moku MATLAB API v3.0 má poskytnout vývojářům MATLAB prostředky potřebné k ovládání jakéhokoli zařízení Moku a v konečném důsledku také možnost začlenit tyto ovládací prvky do větších aplikací pro koncové uživatele. Nový balíček Moku MATLAB API v3.0 poskytuje následující:

• Plně funkční example skripty MATLABu pro každý z nich
• Všechny skripty MATLABu jsou opatřeny komentáři, které jsou snadno srozumitelné a mohou sloužit jako výchozí bod pro koncového uživatele pro přizpůsobení a
• Sada funkcí poskytujících plnou kontrolu nad Moku

Aktuálně podporované nástroje

1. Generátor libovolného tvaru vlny
2. Datalogger
3. Digitální filtrační box
4. Tvůrce filtrů FIR
5. Analyzátor frekvenční odezvy
6. Laserový zámek
7. Uzamčení Ampdoživotní
8. Osciloskop
9. Phasemetr
10. PID regulátor
11. Spektrum Analyzer
12. Generátor křivek
13. Režim více nástrojů
14. Kompilace Moku Cloud

Instalace

Požadavky

• MATLAB verze 2015 nebo novější

Pokud již máte nainstalovanou předchozí verzi Moku MATLAB API, odinstalujte ji, než budete pokračovat. Balíček můžete odinstalovat ze Správce doplňků.

1. Otevřete Správce doplňků přes kartu Domů > Prostředí.
2. Hledat Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Případně si můžete stáhnout sadu nástrojů přímo z Liquid Instruments webmísto na https://www.liquidinstruments.com/products/apis/matlab-api/. Pokud to uděláte, budete muset cestu pro vyhledávání nastavit ručně.
4. Zkontrolujte, zda byla do panelu nástrojů přidána správná cesta, výběrem možnosti „Nastavit cestu“ na kartě Domů > Prostředí.
5. Ujistěte se, že existuje vstup směřující do umístění instalace sady nástrojů. Typická cesta může být CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Stáhněte si data přístroje files zadáním 'moku_download####) do příkazového okna MATLABu. ### by mělo být nahrazeno vaší aktuální verzí firmwaru. Yol můžete najít vaši aktuální verzi firmwaru prostřednictvím aplikace Moku: desktop kliknutím pravým tlačítkem na vaše Moku a umístěním kurzoru na „Informace o zařízení“ nebo v aplikaci iPad dlouhým stisknutím na vašem Moku.
7. Potvrďte, že je vaše sada nástrojů správně nastavena zadáním 'help Moku' do příkazového okna MATLABu. Pokud tento příkaz uspěje. pak byla sada nástrojů úspěšně nainstalována

Změny Moku API

Nová architektura Moku MATLAB API je dostatečně odlišná od svého předchůdce, a proto není zpětně kompatibilní se stávajícími API skripty. Následující zjednodušený osciloskop example ukazuje rozdíly mezi staršími a novými balíčky API a slouží jako cestovní mapa pro portování stávajícího kódu.

Osciloskop example

Sekvenční kroky

1. Importujte Moku MATLAB API 3.0
2. Nárokujte si vlastnictví Moku a nahrajte bitový tok Osciloskopu do
3. Nastavte časovou základnu a nastavte levé a pravé rozpětí pro časovou osu.
4. Získejte data, získejte jeden snímek dat z osciloskopu
5. Ukončete relaci klienta vzdáním se vlastnictví Moku

Výše popsaná sekvence je zjednodušeným příklademample pro ilustraci rozdílů mezi staršími a novými balíčky API. Kromě zahájení klientské relace, nahrání bitového toku nástroje do Moku a ukončení klientské relace může koncový uživatel provádět libovolný počet funkcí v různém pořadí, aby vyhovoval potřebám své aplikace.

Rozdíly

Zde se podíváme na rozdíly mezi dvěma APl pro každý krok v sekvenci.

Nárokujte si vlastnictví Moku a nahrajte bitový tok osciloskopu do zařízení. Ve srovnání s Moku MATLAB 1.9 má nové API zcela odlišné funkce:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Funkce	get_by_name()	deploy_or_conn ect()	Osciloskop()
Povolená pole a hodnoty	jméno: string timeout: float	nástroj: třída nástroje, který chcete nasadit	ip: řetězec serial: řetězec
	síla: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: plovoucí
			read_timeout: float

 

1. Nastavte časovou základnu. Funkce je stejná, ale povolené argumenty se mírně liší:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funkce	set_timebase()	set_timebase()
   Povolená pole a hodnoty	t1: plovoucí t2: plovoucí	t1: float t2:float strict: bool

2. Získejte data. Funkce a povolené argumenty jsou stejné, ale vrácený datový typ a délka se liší:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funkce	get_data()	get_data()
   Povolená pole a hodnoty	timeout: float wait: bool	timeout: float wait_reacquire: bool
   Délka návratu	16383 bodů na snímek	1024 bodů na snímek

3. Uvolněte vlastnictví Moku:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Funkce	blízko()	relinquish_ownership()

Seznam funkcí 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	generovat_křivkuO 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
	souhrnQ

Moku MATLAB API je založeno na Moku API. Úplnou dokumentaci k Moku API najdete v Moku API Reference zde https://apis.liq uidinstrume nts.com/re fe rence/.

Další podrobnosti o tom, jak začít s Moku MATLAB API, najdete na https://a pis.liquid instruments.com/sta hodnocení- Matlab.domov

Proces přechodu na nižší verzi

Pokud se ukázalo, že upgrade na verzi 3.0 omezuje nebo jinak nepříznivě ovlivňuje něco kritického pro vaši aplikaci, můžete přejít na předchozí verzi 1.9. To lze provést prostřednictvím a web prohlížeč.

Kroky

1. Kontaktujte Liquid Instruments a získejte file pro verzi firmwaru 9.
2. Zadejte svou IP adresu Moku:Lab do a web prohlížeč (viz snímek obrazovky).
3. V části Update Firmware vyhledejte a vyberte firmware file poskytuje společnost Liquid Instruments.
4. Vyberte Nahrát a aktualizovat. Dokončení procesu aktualizace může trvat déle než 10 minut

© 2023 Liquid Instruments. Rezervováno.

laudinstruments.com

Dokumenty / zdroje

KAPALNÉ NÁSTROJE Integrační pojistky MATLAB API [pdfUživatelská příručka MATLAB API, MATLAB API integrační pojistky, integrační pojistky, pojistky

Reference

• Uživatelská příručka