LIQUID INSTRUMENTS MATLAB API Integration Fuses

Vodič za migraciju MATLAB API-ja

Nadogradnja Moku: Lab na verziju softvera 3.0 otključava niz novih značajki. Prilikom ažuriranja korisnici API-ja moraju poduzeti dodatne korake kako bi premjestili svoje skripte na novi Moku API paket. Ovaj vodič za migraciju opisuje izmjene API-ja, nove značajke dostupne u ažuriranju verzije 3.0 i sva ograničenja kompatibilnosti sa prethodnim verzijama.

Nadview

Verzija softvera Moku:Lab 3.0 veliko je ažuriranje koje donosi novi firmware, korisničko sučelje i APl-ove za Moku:Lab hardver. Ažuriranje usklađuje Moku:Lab s Moku:Pro i Moku:Go, što olakšava dijeljenje skripti na svim Moku platformama. Ažuriranje otključava niz novih značajki za mnoge postojeće instrumente. Također dodaje dvije nove značajke: Multi-instrument Mode i Moku Cloud Compile. Postoje i neke suptilne razlike u ponašanju, navedene u odjeljku o povratnoj kompatibilnosti.

Ovo je veliko ažuriranje koje utječe na arhitekturu API-ja i stoga novi paket MATLAB API v3.0 neće biti kompatibilan s postojećim MATLAB skriptama. Korisnici API-ja morat će svoje skripte prenijeti na novi Moku API paket ako nadograde svoj Moku:Lab na verziju 3.0. Korisnici API-ja sa značajnim prilagođenim razvojem softvera trebali bi pažljivo razmotriti razinu napora potrebnog za prijenos postojećeg koda. Moku:Lab 1.9 se ne preporučuje za nove implementacije i svi korisnici se potiču na nadogradnju. Ako se pojave problemi nakon nadogradnje, korisnici će imati opciju vraćanja na verziju softvera 1.9.

Ovaj vodič za migraciju opisuje naprednetagažuriranja i mogućih komplikacija za Moku:Lab verziju 3.0. Također opisuje postupak nadogradnje MATLAB API-ja i kako vratiti Moku:Lab na stariju verziju ako je potrebno.

Nove značajke verzije 3.0

Nove značajke

Verzija softvera 3.0 po prvi put donosi Multi-Instrument Mode i Moku Cloud Compile u Moku:Lab, kao i mnoge nadogradnje performansi i upotrebljivosti u nizu instrumenata.

Način rada s više instrumenata

Način rada s više instrumenata na Moku:Lab omogućuje korisnicima da postave dva instrumenta istovremeno kako bi stvorili prilagođenu ispitnu stanicu. Svaki instrument ima potpuni pristup analognim ulazima i izlazima zajedno s međusobnim vezama između utora instrumenata. Međusobne veze između instrumenata podržavaju digitalnu komunikaciju u stvarnom vremenu velike brzine, niske latencije do 2 Gb/s, tako da instrumenti mogu raditi neovisno ili biti povezani za izgradnju naprednih cjevovoda za obradu signala. Instrumenti se mogu dinamički mijenjati unutra i van bez prekidanja drugog instrumenta. Napredni korisnici također mogu implementirati vlastite prilagođene algoritme u načinu rada s više instrumenata koristeći Moku Cloud Compile.

Moku Cloud Compile

Moku Cloud Compile omogućuje implementaciju prilagođenog DSP-a izravno na Moku:Lab FPGA u načinu rada s više instrumenata. Napišite kod pomoću a web preglednik i prevesti ga u oblak; Moku Cloud Compile implementira bitstream na jedan ili više ciljnih Moku uređaja.

Osciloskop

• Način duboke memorije: uštedite do 4M samples po kanalu pri punom sampbrzina linga (500 MSa/s)

Spectrum Analyzer

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

Fazometar

• Frekvencijski pomak, faza i amplitude se sada može ispisati kao analogni voltage signali
• Korisnici sada mogu dodati DC offset izlaznim signalima
• Fazno zaključani izlaz sinusnog vala sada se može frekvencijski pomnožiti do 2 50x ili podijeliti na 125x
• Poboljšani raspon propusnosti (1 Hz do 100 kHz)
• Napredne funkcije prelamanja faza i automatskog ponovnog postavljanja

Generator valnog oblika

• Izlaz buke
• Modulacija širine impulsa (PWM)

zaključati u Amplifter

• Poboljšana izvedba niske frekvencije 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 do 125x za korištenje u demodulaciji
• 6-znamenkasta preciznost za fazne vrijednosti

Analizator frekvencijskog odziva

• Povećana najveća frekvencija sa 120 MHz na 200 MHz
• Povećajte maksimalne bodove čišćenja s 512 na 8192
• Nova dinamika Ampznačajka litude automatski optimizira izlazni signal za najbolji dinamički raspon mjerenja
• Novi ln/ln1 način mjerenja
• Upozorenja o zasićenosti unosa
• Matematički kanal sada podržava proizvoljne jednadžbe složenih vrijednosti koje uključuju signale kanala, omogućujući nove vrste mjerenja složenih funkcija prijenosa
• Ulazni signali se sada mogu mjeriti u dBVpp i dBVrms uz dBm
• Napredak čišćenja sada je prikazan na grafikonu
• Os frekvencije sada se može zaključati kako bi se spriječile slučajne promjene tijekom dugog pretraživanja

Kutija za lasersko zaključavanje

• Poboljšani blok dijagram prikazuje putanje signala skeniranja i modulacije
• Nova brava stagOva značajka omogućuje prilagodbu postupka zaključavanja
• Poboljšana izvedba niske frekvencije PLL zaključavanje
• 6-znamenkasta preciznost za fazne vrijednosti
• Poboljšana izvedba niske frekvencije 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 na 0.125x za korištenje u demodulaciji

ostalo

Dodana 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 formate CSV, MATLAB ili NumPy prilikom preuzimanja s uređaja

Nadograđena API podrška

Novi paket Moku MATLAB API v3.0 pruža poboljšanu funkcionalnost i stabilnost. Primat će redovita ažuriranja za poboljšanje performansi i uvođenje novih značajki.

Ograničenja kompatibilnosti s prethodnim verzijama

API

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

Dok paket Moku:Lab MATLAB više neće primati ažuriranja, Liquid Instruments će i dalje pružati podršku korisnicima koji ne mogu migrirati na novi API paket.

Pronađite detaljan exampdatoteke za svaki instrument u novom paketu Moku MATLAB API v3.0 koji će poslužiti kao osnova za pretvaranje prethodnog razvoja MATLAB-a u novi paket API-ja.

Regresije

RAM disk za bilježenje podataka

Verzija 1.9 imala je 512 MB filesustav u RAM-u uređaja, koji se može koristiti za bilježenje podataka na visokim sampling stope. U verziji 3.0, prijavljivanje u RAM više nije dostupno. Za omogućavanje bilježenja podataka potrebna je SD kartica. Sukladno tome, mijenja se i maksimalna brzina akvizicije. Verzija 1.9 podržavala je 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, tijekovi rada koji su uključivali spremanje više brzih zapisa u RAM i zatim njihovo kasnije kopiranje na SD karticu ili klijenta više neće biti podržani.

Zapisivanje podataka u CSV

Verzija 1.9 imala je mogućnost spremanja podataka izravno u CSV file prilikom sječe. Ova značajka nije izravno dostupna na verziji 3.0. Korisnici čiji tijek rada uključuje spremanje CSV-afiles izravno na SD karticu ili će klijent sada morati prvo pretvoriti binarnu datoteku file u CSV, bilo korištenjem klijentske aplikacije ili instaliranjem samostalnog Liquid Instruments File Pretvarač na računalo koje koriste za obradu podataka.

Promjene koje nisu kompatibilne s prethodnim verzijama

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 to smo promijenili tako da je rezultat bio 0.01 V DC, što je više u skladu s intuitivnim očekivanjima kupaca.

Izlaz generatora valnih oblika mora biti omogućen za korištenje kao izvor modulacije/okidač

U verziji 1.9, valni oblik drugog kanala mogao se koristiti kao izvor modulacije ili okidača u Generatoru valnog oblika, čak i ako je izlaz tog kanala bio onemogućen. Ovo je uklonjeno u verziji

• Korisnici koji žele napraviti unakrsnu modulaciju bez potrebe za odspajanjem izlaza svog uređaja morali bi prilagoditi svoje

Moku MATLAB API

Paket Moku MATLAB API v3.0 namijenjen je pružanju MATLAB programerima resursa potrebnih za kontrolu bilo kojeg Moku uređaja i, u konačnici, mogućnost ugradnje ovih kontrola u veće aplikacije za krajnje korisnike. Novi paket Moku MATLAB API v3.0 pruža sljedeće:

• Potpuno funkcionalan example MATLAB skripte za svaki
• Sve MATLAB skripte opremljene su komentarima koji su laki za razumijevanje i krajnjem korisniku mogu poslužiti kao početna točka za prilagodbu i
• Skup funkcija pruža potpunu kontrolu nad Mokuom

Trenutno podržani instrumenti

1. Generator proizvoljnih valnih oblika
2. Data Logger
3. Kutija za digitalni filter
4. FIR Filter Builder
5. Analizator frekvencijskog odziva
6. Kutija za lasersko zaključavanje
7. Zaključavanje Amplifter
8. Osciloskop
9. Fazometar
10. PID regulator
11. Spectrum Analyzer
12. Generator valnog oblika
13. Način rada s više instrumenata
14. Moku Cloud Compile

Montaža

Zahtjevi

• MATLAB verzija 2015 ili novija

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

1. Otvorite Upravitelj dodataka preko kartice Početna > Okruženje.
2. Tražiti Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Alternativno, možete preuzeti alatnu kutiju izravno s Liquid Instruments webmjesto na https://www.liquidinstruments.com/products/apis/matlab-api/. Ako to učinite, morat ćete ručno postaviti put pretraživanja.
4. Provjerite je li točna putanja dodana u okvir s alatima odabirom 'Postavi putanju' na kartici Početna > Okruženje.
5. Provjerite postoji li ulaz koji pokazuje na mjesto instalacije kutije s alatima. Tipična staza može biti CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Preuzmite podatke o instrumentu files upisivanjem 'moku_download####) u naredbeni prozor MATLAB. ### treba zamijeniti vašom trenutnom verzijom firmvera. Yol može pronaći vašu trenutnu verziju firmvera putem Moku: aplikacije za stolna računala desnim klikom na Moku i lebdeći mišem na 'Device info' ili u iPad aplikaciji dugim pritiskom na Moku.
7. Potvrdite da je vaš alatni okvir ispravno postavljen upisivanjem 'help Moku' u MATLAB naredbeni prozor. Ako ova naredba uspije. tada je alatna kutija uspješno instalirana

Promjene Moku API-ja

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

Osciloskop prample

Slijed koraka

1. Uvezite Moku MATLAB API 3.0
2. Zatražite vlasništvo nad Mokuom i prenesite bitstream osciloskopa na
3. Postavite vremensku bazu i postavite raspon lijeve i desne strane za vremensku os.
4. Dobijte podatke, nabavite jedan okvir podataka iz osciloskopa
5. Završite klijentsku sesiju odricanjem vlasništva nad Mokuom

Gore opisani niz je pojednostavljeni example za ilustraciju razlika između naslijeđenih i novih API paketa. Osim početka klijentske sesije, učitavanja bitstreama instrumenta u Moku i završetka klijentske sesije, krajnji korisnik može koristiti bilo koji broj funkcija 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 usporedbi s 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()
Dopuštena polja i vrijednosti	naziv: string timeout: float	instrument: klasa instrumenta koju želite postaviti	ip: niz serijski: niz
	snaga: bool	set_defauIt: booI	prisilno_spojiti: bool
		use_externa I: bool	ignoriraj_zauzeto: bool
			ustrajno_stanje: bool
			connect_timeout: float
			istek_čitanja: float

 

1. Postavite vremensku bazu. Funkcija je ista, ali se dopušteni argumenti malo razlikuju:
   

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

2. Dobiti podatke. Funkcije i dopušteni argumenti su isti, ali vrsta vraćenih podataka i duljina su različiti:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funkcija	get_data()	get_data()
   Dopuštena polja i vrijednosti	timeout: float čekati: bool	timeout: float wait_reacquire: bool
   Dužina povratka	16383 boda po okviru	1024 boda po okviru

3. Otpustite vlasništvo nad Mokuom:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Funkcija	zatvoriti()	odreći se vlasništva()

Popis funkcija osciloskopa

Moku MATLAB 1.9	Moku MATLAB 3.0
skup_izvorO	skup_izvoraO
postavi_okidačO	postavi_okidačO
get_dataQ	get_dataQ
set_frontendQ	set_frontendQ
set_defau!tsQ set_timebaseO postavi_xmodeQ	set_defau!tsQ set_timebaseQ onemogući_unosO enable_rollmodeQ
set_precision_modeQ	postavi_način_suzimanjaQ
faza_sinkronizacijeQ	faza_izlaza_sinkronizacijeQ
get_frontendQ	get_frontendQ
get_samp!erateO get_rea!vremenski_podaciQ	get_samp!erateO spremi_međuspremnik_visoke_razlučivostiO
gen_rampvalO gen_sinusni valO	generirati_valni oblikO get_acquisition_modeQ
gen_kvadratni valQ	get_sourcesQ
gen_offQ	get_timebaseQ get_output_!oadQ
set_samplerateQ set_framerateQ	get_interpo!ationO set_izlaz_!putQ
	postavljena_histerezaQ set_interpo!acijaO
	set_input_attenuationO
	skup_izvorO osc_mjerenjeQ
	sažetakP

Moku MATLAB API temelji se na Moku API-ju. Za punu Moku API dokumentaciju, pogledajte Moku API Reference koja se nalazi ovdje https://apis.liq uidinstrume nts.com/re fe rence/.

Dodatne pojedinosti za početak rada s Moku MATLAB API-jem možete pronaći na https://a pis.liquid instruments.com/sta ocjena-Matlab.dom

Proces vraćanja na stariju verziju

Ako se pokazalo da nadogradnja na verziju 3.0 ograničava ili na drugi način nepovoljno utječe na nešto kritično za vašu aplikaciju, možete se vratiti na prethodnu verziju 1.9. To se može učiniti putem a web preglednik.

Koraci

1. Kontaktirajte Liquid Instruments i nabavite file za verziju firmvera 9.
2. Upišite svoju Moku:Lab IP adresu u a web preglednik (pogledajte snimak zaslona).
3. Pod Ažuriranje firmvera, pregledajte i odaberite firmver file pruža Liquid Instruments.
4. Odaberite Prijenos i ažuriranje. Postupak ažuriranja može trajati više od 10 minuta

© 2023 Liquid Instruments. Rezervirano.

laudinstruments.com

Dokumenti / Resursi

LIQUID INSTRUMENTS MATLAB API Integration Fuses [pdf] Korisnički priručnik MATLAB API, MATLAB API integracijski osigurači, integracijski osigurači, osigurači

Reference

• korisnički priručnik