LIQUID INSTRUMENTS MATLAB API Integracioni osigurači

Vodič za migraciju MATLAB API-ja

Nadogradnja Moku: Lab na verziju softvera 3.0 otključava niz novih funkcija. Prilikom ažuriranja, korisnici API-ja moraju poduzeti dodatne korake da migriraju svoje skripte u novi Moku API paket. Ovaj vodič za migraciju opisuje promjene API-ja, nove funkcije dostupne u ažuriranju verzije 3.0 i sva ograničenja kompatibilnosti unatrag.

Gotovoview

Moku:Lab verzija softvera 3.0 je veliko ažuriranje koje donosi novi firmver, korisnički interfejs i APl-ove na Moku:Lab hardver. Ažuriranje dovodi Moku:Lab u liniju sa Moku:Pro i Moku:Go, što olakšava dijeljenje skripti na svim Moku platformama. Ažuriranje otključava mnoštvo novih funkcija za mnoge postojeće instrumente. Također dodaje dvije nove funkcije: Multi-instrument Mode i Moku Cloud Compile. Postoje i neke suptilne razlike u ponašanju, koje su navedene u odjeljku Kompatibilnost unatrag.

Ovo je veliko ažuriranje koje utiče na API arhitekturu, i stoga novi MATLAB API v3.0 paket neće biti kompatibilan sa postojećim MATLAB skriptama. Korisnici API-ja će morati prenijeti svoje skripte u novi Moku API paket ako nadograde svoj Moku:Lab na verziju 3.0. Korisnici API-ja sa značajnim razvojem prilagođenog softvera trebali bi pažljivo razmotriti nivo napora koji je potreban za prenos njihovog postojećeg koda. Moku:Lab 1.9 se ne preporučuje za nove implementacije i svi korisnici se podstiču na nadogradnju. Ako se problemi pojave nakon nadogradnje, korisnici će imati mogućnost da pređu na verziju softvera 1.9.

Ovaj vodič za migraciju opisuje advantages ažuriranja i potencijalne komplikacije za Moku:Lab verziju 3.0. Takođe opisuje proces nadogradnje MATLAB API-ja i način nadogradnje vašeg Moku:Lab-a ako je potrebno.

Nove funkcije verzije 3.0

Nove karakteristike

Verzija softvera 3.0 donosi Multi-Instrument Mode i Moku Cloud Compile u Moku:Lab po prvi put, kao i mnoga poboljšanja performansi i upotrebljivosti preko paketa instrumenata.

Multi-instrument Mode

Režim sa više instrumenata na Moku:Lab-u omogućava korisnicima da istovremeno koriste dva instrumenta kako bi kreirali prilagođenu test stanicu. Svaki instrument ima potpun pristup analognim ulazima i izlazima zajedno sa interkonekcijama između slotova za instrumente. Međusobne veze između instrumenata podržavaju digitalnu komunikaciju velike brzine, niske latencije, u realnom vremenu do 2 Gb/s, tako da instrumenti mogu raditi nezavisno ili biti povezani za izgradnju naprednih cevovoda za obradu signala. Instrumenti se mogu dinamički zamjenjivati ​​i izmjenjivati ​​bez prekidanja rada drugog instrumenta. Napredni korisnici također mogu implementirati vlastite prilagođene algoritme u Multi-instrument Mode koristeći Moku Cloud Compile.

Moku Cloud Compile

Moku Cloud Compile vam omogućava da implementirate prilagođeni DSP direktno na Moku:Lab FPGA u Multi instrument modu. Napišite kod koristeći a web pretraživač i kompajlirati ga u oblaku; Moku Cloud Compile postavlja bitstream na jedan ili više ciljnih Moku uređaja.

Osciloskop

• Režim duboke memorije: uštedite do 4M samples po kanalu u punom sampbrzina kretanja (500 MSa/s)

Spectrum Analyzer

• Poboljšan nivo buke
• Logaritamska Vrms i Vpp skala
• Pet novih funkcija prozora (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Phasemeter

• Pomak frekvencije, faza i amplitude sada može biti izlaz kao analogni voltage signali
• Korisnici sada mogu dodati DC offset izlaznim signalima
• Izlaz sinusnog vala s faznom blokadom sada se može frekvencijski pomnožiti do 2 50x ili podijeliti na 125x
• Poboljšani opseg propusnog opsega (1 Hz do 100 kHz)
• Napredne funkcije premotavanja faza i automatskog resetovanja

Generator talasnih oblika

• Izlaz buke
• Modulacija širine impulsa (PWM)

zaključati Amplifier

• Poboljšane performanse niskih frekvencija PLL zaključavanje
• Minimalna PLL frekvencija je smanjena na 10 Hz
• Interni PLL signal sada se može frekvencijski pomnožiti do 250x ili podijeliti na 125x za korištenje u demodulaciji
• 6-cifrena preciznost za vrijednosti faze

Analizator frekvencijskog odziva

• Povećana maksimalna frekvencija sa 120 MHz na 200 MHz
• Povećajte maksimalne poene sa 512 na 8192
• The New Dynamic AmpLitude funkcija automatski optimizuje izlazni signal za najbolji dinamički opseg merenja
• Novi ln/ln1 način mjerenja
• Upozorenja o zasićenju unosa
• Matematički kanal sada podržava proizvoljne jednadžbe kompleksnih vrijednosti koje uključuju signale kanala, omogućavajući nove vrste složenih mjerenja funkcije prijenosa
• Ulazni signali se sada mogu mjeriti u dBVpp i dBVrms pored dBm
• Napredak sweep-a je sada prikazan na grafikonu
• Frekvencijska os se sada može zaključati kako bi se spriječile slučajne promjene tokom dugog pregleda

Laser Lock Box

• Poboljšani blok dijagram prikazuje putanje signala skeniranja i modulacije
• Novo zaključavanje stagOva funkcija omogućava prilagođavanje procedure zaključavanja
• Poboljšane performanse niskih frekvencija PLL zaključavanje
• 6-cifrena preciznost za vrijednosti faze
• Poboljšane performanse niskih frekvencija PLL zaključavanje
• Minimalna PLL frekvencija je smanjena na 10 Hz
• The PLL signal se sada može frekvencijski pomnožiti do 250x ili podijeliti do 0.125x za korištenje u demodulaciji

Ostalo

Dodata podrška za sinusnu funkciju uređivaču jednadžbi koja se može koristiti za generiranje prilagođenih valnih oblika u generatoru proizvoljnih valnih oblika

Pretvori binarno LI files u CSV, MATLAB ili NumPy formate prilikom preuzimanja sa uređaja

Nadograđena podrška za API

Novi Moku MATLAB API v3.0 paket pruža poboljšanu funkcionalnost i stabilnost. Primaće redovna ažuriranja radi poboljšanja performansi i uvođenja novih funkcija.

Ograničenja kompatibilnosti unatrag

API

Novi Moku MATLAB API v3.0 paket nije kompatibilan sa prethodnim Moku:Lab MATLAB v1.9 paketom. MATLAB skriptni argumenti i povratne vrijednosti su potpuno različite. Ako imate opsežan prilagođeni razvoj softvera koristeći Moku:Lab MATLAB, razmislite o uticaju migracije vašeg softvera na kompatibilnost sa novim API-jem.

Dok Moku:Lab MATLAB paket više neće primati ažuriranja, Liquid Instruments će i dalje nastaviti pružati podršku korisnicima koji nisu u mogućnosti da pređu na novi API paket.

Pronađite detaljan pramples za svaki instrument u novom Moku MATLAB API v3.0 paketu koji će služiti kao osnovna linija za konverziju prethodnog razvoja MATLAB-a u novi API paket.

Regresije

RAM disk za evidentiranje podataka

Verzija 1.9 imala je 512 MB filesistem u RAM-u uređaja, koji bi se mogao koristiti za evidentiranje podataka na visokim sampling rates. U verziji 3.0, prijavljivanje u RAM više nije dostupno. Za omogućavanje evidentiranja podataka potrebna je SD kartica. Shodno tome, mijenja se i maksimalna brzina akvizicije. Verzija 1.9 podržava do 1 MSa/s, dok verzija 3.0 podržava do 250 kSa/s na 1 kanalu i 125 kSa/s na 2 kanala. Čak i pri nižim brzinama i sa SD karticom, više neće biti podržani radni tokovi koji su uključivali spremanje više brzih dnevnika u RAM i kasnije njihovo kopiranje na SD karticu ili klijenta.

Zapisivanje podataka u CSV

Verzija 1.9 imala je mogućnost spremanja podataka direktno u CSV file prilikom logovanja. Ova funkcija nije direktno dostupna u verziji 3.0. Korisnici čiji je radni tok uključivao spremanje CSV-afiles direktno na SD karticu ili će klijent sada morati prvo pretvoriti binarnu datoteku file u CSV, bilo pomoću klijentske aplikacije ili instaliranjem samostalnih Liquid Instruments File Pretvoriti na računar koji koriste za obradu podataka.

Promjene koje nisu kompatibilne unatrag

Skaliranje podataka u LIA

U verziji 1.9 implementirali smo skaliranje podataka tako da je množenje dva 0.1 V DC signala rezultiralo 0.02 V DC izlaza. U verziji 3.0 smo to promijenili tako da je rezultat bio 0.01 V DC, što je više u skladu sa intuitivnim očekivanjima kupaca.

Izlaz generatora talasnog oblika mora biti omogućen da bi se koristio kao izvor/okidač modulacije

U verziji 1.9, talasni oblik drugog kanala mogao bi se koristiti kao modulacioni ili okidački izvor u Generatoru talasnog oblika, čak i ako je izlaz tog kanala onemogućen. Ovo je uklonjeno u verziji

• Korisnici koji žele raditi unakrsnu modulaciju bez potrebe da isključuju izlaze svog uređaja morat će prilagoditi svoje

Moku MATLAB API

Moku MATLAB API v3.0 paket je namijenjen da MATLAB programerima pruži resurse potrebne za kontrolu bilo kojeg Moku uređaja i, na kraju, mogućnost ugradnje ovih kontrola u veće aplikacije krajnjeg korisnika. Novi Moku MATLAB API v3.0 paket pruža sljedeće:

• Potpuno funkcionalan nprample MATLAB skripte za svaku
• Sve MATLAB skripte su opremljene komentarima, koji su laki za razumevanje i mogu poslužiti kao polazna tačka krajnjeg korisnika za prilagođavanje i
• Skup funkcija koje pružaju potpunu kontrolu nad Mokuom

Trenutno podržani instrumenti

1. Generator proizvoljnog valnog oblika
2. Data Logger
3. Digital Filter Box
4. FIR Filter Builder
5. Analizator frekvencijskog odziva
6. Laser Lock Box
7. Zaključavanje Amplifier
8. Osciloskop
9. Phasemeter
10. PID kontroler
11. Spectrum Analyzer
12. Generator talasnih oblika
13. Multi-instrument Mode
14. Moku Cloud Compile

Instalacija

Zahtjevi

• MATLAB verzija 2015 ili novija

Ako već imate instaliranu prethodnu verziju Moku MATLAB API-ja, deinstalirajte je prije nego što nastavite. Paket možete deinstalirati iz upravitelja dodataka.

1. Otvorite Upravitelj dodataka kroz karticu Početna > Okolina.
2. Traži Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Alternativno, možete preuzeti kutiju sa alatima direktno sa Liquid Instruments website at https://www.liquidinstruments.com/products/apis/matlab-api/. Morat ćete ručno postaviti putanju pretraživanja ako to učinite.
4. Provjerite je li ispravna putanja dodana u okvir s alatima odabirom 'Postavi putanju' na kartici Početna > Okruženje.
5. Uvjerite se da postoji ulaz koji upućuje na mjesto instalacije kutije s alatima. Tipična putanja može biti CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Preuzmite podatke o instrumentu files upisivanjem 'moku_download####) u MATLAB Command Window. ### treba zamijeniti vašom trenutnom verzijom firmvera. Yol može pronaći vašu trenutnu verziju firmvera putem aplikacije Moku: desktop tako što ćete kliknuti desnim tasterom miša na vaš Moku i držati pokazivač miša na 'Device info', ili u iPad aplikaciji dugim pritiskom na vaš Moku.
7. Potvrdite da je vaš alatni okvir ispravno postavljen tako što ćete ukucati 'help Moku' u MATLAB Command Window. Ako ova naredba uspije. onda je kutija s alatima uspješno instalirana

Moku API promjene

Nova Moku MATLAB API arhitektura se dovoljno razlikuje od svog prethodnika i stoga nije kompatibilna sa postojećim API skriptama. Sljedeći pojednostavljeni osciloskop prample pokazuje razlike između naslijeđenih i novih API paketa i služi kao mapa puta za prijenos postojećeg koda.

Osciloskop example

Koraci niza

1. Uvezite Moku MATLAB API 3.0
2. Zatražite vlasništvo nad Mokuom i učitajte bitstream osciloskopa
3. Postavite vremensku bazu i postavite raspon lijeve i desne strane za vremensku osu.
4. Dobijte podatke, nabavite jedan okvir podataka iz osciloskopa
5. Završite sesiju klijenta odustajanjem od Moku vlasništva

Gore opisani niz je pojednostavljeni nprampda ilustriramo razlike između naslijeđenih i novih API paketa. Osim što započne klijentsku sesiju, učita instrument bitstream u Moku i završi klijentsku sesiju, krajnji korisnik može koristiti bilo koji broj funkcija u različitim redoslijedom kako bi zadovoljio potrebe svoje aplikacije.

Razlike

Ovdje gledamo razlike između dva APl-a za svaki korak u nizu.

Zatražite vlasništvo nad Mokuom i prenesite bitstream osciloskopa na uređaj. U poređenju sa Moku MATLAB 1.9, novi API ima potpuno drugačije funkcije:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Funkcija	get_by_name()	deploy_or_conn ect()	osciloskop()
Dozvoljena polja i vrijednosti	ime: string timeout: float	instrument: klasa instrumenta koji se želi primijeniti	ip: string serijski: 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. Podesite vremensku bazu. Funkcija je ista, ali su dozvoljeni argumenti malo drugačiji:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funkcija	set_timebase()	set_timebase()
   Dozvoljena polja i vrijednosti	t1: float t2: float	t1: float t2:float strict: bool

2. Nabavite podatke. Funkcije i dozvoljeni argumenti su isti, ali vraćeni tip i dužina podataka su različiti:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funkcija	get_data()	get_data()
   Dozvoljena polja i vrijednosti	timeout: float čekanje: bool	timeout: float wait_reacquire: bool
   Dužina povrata	16383 poena po kadru	1024 poena po kadru

3. Otpustite vlasništvo nad Mokuom:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Funkcija	zatvori()	relinquish_ownership()

Lista funkcija osciloskopa

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	generate_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_atenuationO
	set_sourceO osc_measurementQ
	summaryQ

Moku MATLAB API je baziran na Moku API-ju. Za kompletnu dokumentaciju Moku API-ja pogledajte Moku API Reference koja se nalazi ovdje https://apis.liq uidinstrume nts.com/re fe rence/.

Dodatne detalje za početak rada sa Moku MATLAB API-jem možete pronaći na https://a pis.liquid instruments.com/sta rejting-Matlab.kući

Proces vraćanja na stariju verziju

Ako se pokazalo da nadogradnja na verziju 3.0 ograničava ili na neki drugi način negativno utječe na nešto kritično za vašu aplikaciju, možete vratiti na prethodnu verziju 1.9. Ovo se može uraditi putem a web pretraživač.

Koraci

1. Kontaktirajte Liquid Instruments i nabavite file za verziju firmvera 9.
2. Unesite svoju Moku:Lab IP adresu u a web pretraživač (pogledajte snimak ekrana).
3. U okviru Ažuriraj firmver, pregledajte i izaberite firmver file pruža Liquid Instruments.
4. Odaberite Upload & Update. Proces ažuriranja može potrajati više od 10 minuta

© 2023 Liquid Instruments. rezervisano.

laudistruments.com

Dokumenti / Resursi

LIQUID INSTRUMENTS MATLAB API Integracioni osigurači [pdf] Korisnički priručnik MATLAB API, MATLAB API Integracioni osigurači, Integracioni osigurači, Osigurači

Reference

• Uputstvo za upotrebu