KAPALNÉ NÁSTROJE Moku Lab LabVIEW Uživatelská příručka pro migraci rozhraní API

Nadview

Moku: Software Lab verze 3.0 je hlavní aktualizací, která přináší nový firmware, uživatelská rozhraní a API do hardwaru Moku:Lab. Aktualizace přináší Moku:Lab do souladu s Moku:Fro 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: Muti-instrument Mode a Moku Cloud Compile. Existuje několik jemných rozdílů v chování, které jsou také popsány v části Zpětná kompatibilita.

Tato aktualizace také ovlivňuje architekturu Apl, a proto nový balíček API nebude zpětně kompatibilní se stávajícími skripty APL. Uživatelé APluses budou muset přenést své skripty do nového balíčku Moku Apl, pokud upgradují své Moku:Lab na verzi 3.C. 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 coce. Moku:Lab 1.9 se nedoporučuje pro nová nasazení a všem zákazníkům se doporučuje upgradovat. Nakonec Moku:Lab verze 1.9 ztratí podporu v souladu s našimi zásadami ukončení životnosti. Pokud po upgradu nastanou problémy, uživatelé budou mít možnost přejít na verzi softwaru 19.

Tento průvodce migrací popisuje advantages aktualizace a potenciální komplikace aktualizace na Moku:Lab verze 3.0. Nastiňuje také proces upgradu laboratořeVIEW Apl a jak v případě potřeby přejít na nižší verzi vašeho 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ů
Muli-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 potrubí pro zpracování signálu. Uživatelé mohou dynamicky zaměňovat nástroje dovnitř a ven, aniž by přerušili ostatní sousední. 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í digitální zpracování signálu (DSP) přímo na Moku:Lab FPGA v režimu Multi-Instrument Mode. Napište kód pomocí a web prohlížeč a zkompilujte jej v cloudu; poté použijte Moku Cloud Compile k nasazení bitového proudu do jednoho nebo více cílových zařízení Moku.

Osciloskop

• Režim hluboké paměti – ušetříte až 4 mil. samplesů na kanál při celých samprychlost lingu (500 MSa/s)

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

Phasemetr

• Uživatelé nyní mohou vydávat frekvenční offset, fázi a amplitude jako analog voltage 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í frekvenci znásobit až 250x nebo rozdělit až na 0.125x
• Vylepšená šířka 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)

Uzamčení Amplifier (LIA) 

• Vylepšený výkon nízkofrekvenčního zamykání PLL
• Minimální frekvence PLL byla snížena na 10 Hz
• Interní signál PLL lze nyní frekvenčně vynásobit až 250x nebo rozdělit až na 0.125x pro použití v 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
• Maximální počet bodů rozmítání byl zvýšen 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í In/Int
• 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í.
• Uživatelé nyní mohou kromě dBm měřit vstupní signály 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 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 uživatelům přizpůsobit postup uzamčení
• Vylepšený výkon nízkofrekvenčního zamykání P_L
• 6místná přesnost pro fázové hodnoty
• Vylepšený výkon nízkofrekvenčního zamykání P_L
• Minimální frekvence PLL snížena na 10 Hz
• Signál PLL 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 sinc, 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 API 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á Moku LabVIEW Balíček API není zpětně kompatibilní s předchozím Moku:LabLabVIEW API. Vstupy a výstupy jsou zcela odlišné. Pokud jste provedli rozsáhlý vlastní vývoj softwaru s využitím laboratoře Moku:LabVIEW API, zvažte dopad migrace veškerého vašeho softwaru, aby byl kompatibilní s novým API.

Zatímco laboratoř Moku:Lab 1.9VIEW Balíček API již nebude dostávat aktualizace, Liquid Instruments bude nadále poskytovat podporu uživatelům, kteří nemohou migrovat na nový balíček API Najít podrobné exampsoubory pro každý nástroj v nové laboratoři MokuVIEW Balíček API, který bude sloužit jako základ pro převod předchozího vývoje APL na nový balíček APL.

Regrese

RAM disk pro záznam dat
Verze 1.9 a 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. Toto již není k dispozici ve verzi 3.0. Chcete-li povolit protokolování dat, je vyžadována karta SD. To omezuje rychlost záznamu dat na přibližně 250 kSa/s pro 1 kanál a 125 kSa/s pro dva kanály.

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í CSV files 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 signálů 0.1 V DC 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 lze vlnovou křivku jiného kanálu použít jako modulaci nebo zdroj spouštění v generátoru křivek, i když byl výstup tohoto kanálu deaktivován. Toto bylo odstraněno ve verzi 3.0. Uživatelé, kteří chtějí provádět křížovou modulaci, aniž by museli odpojit výstupy svého zařízení, by museli upravit svůj pracovní postup.

Laboratoř MokuVIEW API

Laboratoř MokuVIEW Balíček API je určen k poskytování LabVIEW vývojářům zdroje potřebné k ovládání jakéhokoli zařízení Moku a v konečném důsledku i možnost začlenit tyto ovládací prvky do větších aplikací pro koncové uživatele.

Nová Moku LabVIEW Balíček API poskytuje následující:

• Plně funkční exampsouborů pro každý nástroj.
• Struktura blokového diagramu, která je snadno pochopitelná a může sloužit jako výchozí bod pro koncového uživatele pro přizpůsobení a přizpůsobení
• Funkce Asetof Vl poskytující plnou kontrolu nad zařízením 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. Uzamčení Ampdoživotní
7. Laserový zámek
8. Logický analyzátor
9. Osciloskop
10. Phasemetr
11. Spektrum Analyzer
12. Generátor křivek
13. PID regulátor
14. Režim více nástrojů
15. Kompilace Moku Cloud

Instalace

Požadavky

• LaboratořVIEW verze 2016 nebo novější
• VIPackage Manager (VIPM)

Pokud již máte předchozí verzi Moku LabVIEW APlinstalled, prosím odinstalujte, než budete pokračovat. Balíček můžete odinstalovat ze správce balíčků VI výběrem možnosti Odinstalovat balíček.

1. Stáhněte a nainstalujte Moku LabVIEW balíček od společnosti Liquid Instruments webmísto na
2. Balíček se nainstaluje prostřednictvím správce paketů VI. Po dokončení byste měli vidět balíček uvedený v části „installed“ ve Správci balíčků VI.
   Obrázek 1: Správce balíčků JKI VI
   
   Poznámka: Ostatní zde uvedené balíčky jsou závislosti používané pro streamování dat.

Změny Moku API

Nová Moku LabVIEW Architektura Apl je dostatečně odlišná od svého předchůdce, a proto není zpětně kompatibilní se stávajícími skripty API. 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
Obrázek 2: Osciloskopické srovnání Apl

Sekvenční kroky

1. Zahajte relaci klienta a nahrajte bitový tok osciloskopu do Moku
2. Nastavte časovou základnu a nastavte levé a pravé rozpětí pro časovou osu
3. Generujte tvar vlny, konfigurujte a generujte sinusovou vlnu na kanálu 1
4. Získejte data, získejte jeden snímek dat z osciloskopu.
5. CENITENES
6. Relace koncového klienta

Výše popsaná sekvence je zjednodušeným příklademample pro ilustraci rozdílů mezi staršími a novými balíčky APl. Kromě zahájení klientské relace, nahrání datové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 API pro každý krok v sekvenci.

1. Zahajte relaci Maku-Client a nahrajte bitový tok Osciloskopu do Moku
   Nové APL rozdělilo připojení klientské relace a nahrálo bitový tok nástroje do samostatných funkcí, 1A a 1B. Všechny skripty začínají těmito 2 funkcemi.
   
2. Nastavit základnu času
   Funkce přístroje v novém APl jsou nyní samostatné funkce. Dříve se jednalo o dvoufázový proces ve starším rozhraní API. První funkce převede vstupní parametry na řetězec JSON a funkce sekund odešle příkaz do Moku. Parametry funkcí ve starším Apl byly navíc obsaženy v clusterech. Většina funkčních parametrů v novém APl jsou individuální ovládací prvky.
   Obrázek 4 Nastavte časovou základnu
   
3. Generovat průběh
   Funkce generování tvaru vlny je jedinou funkcí v novém rozhraní API. V tomto případě jsou parametry funkce obsaženy v clusteru. V novém AP je několik funkcí, které vyžadují mnoho vstupních parametrů; v těchto případech se používá cluster.
   
4. Získejte data
   Funkce získat data je také jedinou funkcí v novém rozhraní API. V tomto případě jsou parametry funkce samostatnými ovládacími prvky pro obě rozhraní API. Starší ARl vyžaduje další funkci pro převod výstupních dat z formátu řetězce JSON do číselných polí pro každý kanál.
   Obrázek 7: Zavřete API
   
   
5. Ukončete relaci Moku-Client
   Funkce Close API je jedinou funkcí v novém API. Všechny skripty končí touto funkcí.
   Obrázek 7: Zavřete API
   

Porovnání palet
Ekvivalentní složky nástrojů můžete najít v hlavní paletě Liquid Instruments Moku, jak je vidět na obrázku 8. Poté v každé složce nástroje najdete ekvivalentní funkce nástroje, jak je vidět na obrázku 9 a obrázku 10.
Obrázek : Hlavní paleta, starší paleta API vlevo, nová paleta API vpravo.

Obrázek 9: Složka starších přístrojů osciloskopu vlevo, složka nového nástroje osciloskopu vpravo.

Obrázek 10: Funkce přístroje

Laboratoř MokuVIEW Apl je založeno na Moku API. Úplnou dokumentaci Moku APl naleznete v příručce Moku API Reference, kterou najdete zde https://apisliquidinstruments.com/reference/. Další podrobnosti pro začátek s Moku LabVIEW API najdete na
https://apis.liquidinstruments.com/starting-labview.html.

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 1.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.
   Obrázek 11: Postup downgrade
   

Dokumenty / zdroje

KAPALNÉ NÁSTROJE Moku Lab LabVIEW Migrace API [pdfUživatelská příručka Laboratoř Moku LabVIEW Migrace API, LabVIEW Migrace API, migrace API, migrace

Reference

• Uživatelská příručka