LIQUID INSTRUMENTS MATLAB API Integration Fusibles

Ghid de migrare MATLAB API

Actualizarea Moku: Lab la versiunea software 3.0 deblochează o serie de funcții noi. La actualizare, utilizatorii API trebuie să facă pași suplimentari pentru a-și migra scripturile la noul pachet Moku API. Acest ghid de migrare prezintă modificările API-ului, noile funcții disponibile în actualizarea versiunii 3.0 și orice limitări de compatibilitate cu versiunea anterioară.

Pesteview

Versiunea 3.0 a software-ului Moku:Lab este o actualizare majoră care aduce nou firmware, interfață utilizator și AP-uri hardware-ului Moku:Lab. Actualizarea aduce Moku:Lab în conformitate cu Moku:Pro și Moku:Go, facilitând partajarea scripturilor pe toate platformele Moku. Actualizarea deblochează o serie de funcții noi pentru multe dintre instrumentele existente. De asemenea, adaugă două funcții noi: Modul Multi-instrument și Moku Cloud Compile. Există, de asemenea, câteva diferențe subtile de comportament, subliniate în secțiunea Compatibilitate inversă.

Aceasta este o actualizare majoră care afectează arhitectura API și, prin urmare, noul pachet MATLAB API v3.0 nu va fi compatibil cu scripturile MATLAB existente. Utilizatorii API vor trebui să-și port scripturile la noul pachet Moku API dacă își actualizează Moku:Lab la versiunea 3.0. Utilizatorii API cu dezvoltare semnificativă de software personalizat ar trebui să ia în considerare cu atenție nivelul de efort necesar pentru a-și porta codul existent. Moku:Lab 1.9 nu este recomandat pentru implementări noi și toți clienții sunt încurajați să facă upgrade. Dacă apar probleme după actualizare, utilizatorii vor avea opțiunea de a face downgrade la versiunea software 1.9.

Acest ghid de migrare prezintă advantagactualizările și potențialele complicații la Moku:Lab versiunea 3.0. De asemenea, prezintă procesul de actualizare a API-ului MATLAB și cum să downgradezi Moku:Lab, dacă este necesar.

Caracteristici noi ale versiunii 3.0

Caracteristici noi

Versiunea software 3.0 aduce pentru prima dată Modul Multi-Instrument și Moku Cloud Compile la Moku:Lab, precum și multe îmbunătățiri de performanță și de utilizare în suita de instrumente.

Modul multi-instrument

Modul cu mai multe instrumente pe Moku:Lab permite utilizatorilor să implementeze două instrumente simultan pentru a crea o stație de testare personalizată. Fiecare instrument are acces deplin la intrările și ieșirile analogice, împreună cu interconexiunile dintre sloturile pentru instrumente. Interconexiunile dintre instrumente acceptă comunicații digitale în timp real de mare viteză, cu latență scăzută, de până la 2 Gb/s, astfel încât instrumentele pot funcționa independent sau pot fi conectate pentru a construi conducte avansate de procesare a semnalului. Instrumentele pot fi schimbate în mod dinamic, fără a întrerupe celălalt instrument. Utilizatorii avansați își pot implementa, de asemenea, proprii algoritmi personalizați în modul Multi-instrument folosind Moku Cloud Compile.

Moku Cloud Compile

Moku Cloud Compile vă permite să implementați DSP personalizat direct pe Moku:Lab FPGA în modul Multi instrument. Scrieți codul folosind a web browser și compilați-l în cloud; Moku Cloud Compile implementează fluxul de biți pe unul sau mai multe dispozitive Moku țintă.

Osciloscop

• Mod memorie profundă: economisiți până la 4M sample per canal la s completamprata de limb (500 MSa/s)

Analizor de spectru

• Nivel de zgomot îmbunătățit
• Scala Vrms și Vpp logaritmice
• Cinci funcții noi de fereastră (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Fazemetru

• Offset de frecvență, fază și ampLitude poate fi scos acum ca volum analogictagsemnalele e
• Utilizatorii pot adăuga acum offset DC la semnalele de ieșire
• Ieșirea undei sinusoidală blocată în fază poate fi acum multiplicată în frecvență până la 2 50x sau împărțită la 125x
• Interval de lățime de bandă îmbunătățit (1 Hz până la 100 kHz)
• Funcții avansate de împachetare a fazelor și auto-resetare

Generator de forme de undă

• Ieșire de zgomot
• Modulația lățimii impulsurilor (PWM)

Blocare Ampmai în viață

• Performanță îmbunătățită a frecvenței joase PLL blocare
• Frecvența PLL minimă a fost redusă la 10 Hz
• Semnalul PLL intern poate fi acum multiplicat în frecvență până la 250x împărțit la 125x pentru utilizare în demodulare
• Precizie din 6 cifre pentru valorile fazei

Analizor de răspuns în frecvență

• Frecvența maximă crescută de la 120 MHz la 200 MHz
• Creșteți punctele maxime de baleiaj de la 512 la 8192
• Noua dinamică AmpCaracteristica Lititude optimizează automat semnalul de ieșire pentru cel mai bun interval dinamic de măsurare
• Mod nou de măsurare ln/ln1
• Avertismente de saturație de intrare
• Canalul matematic acceptă acum ecuații arbitrare cu valori complexe care implică semnalele canalului, permițând noi tipuri de măsurători complexe ale funcției de transfer
• Semnalele de intrare pot fi acum măsurate în dBVpp și dBVrms în plus față de dBm
• Progresul măturii este acum afișat pe grafic
• Axa frecvenței poate fi acum blocată pentru a preveni modificările accidentale în timpul unei mături lungi

Cutie de blocare cu laser

• Diagrama bloc îmbunătățită arată căile semnalului de scanare și modulație
• Noul blocare stagCaracteristica es permite personalizarea procedurii de blocare
• Performanță îmbunătățită a frecvenței joase PLL blocare
• Precizie din 6 cifre pentru valorile fazei
• Performanță îmbunătățită a frecvenței joase PLL blocare
• Frecvența PLL minimă a fost redusă la 10 Hz
• The PLL semnalul poate fi acum înmulțit în frecvență până la 250x sau împărțit la 0.125x pentru utilizare în demodulare

Alte

S-a adăugat suport pentru funcția sinusoidală la editorul de ecuații, care poate fi folosit pentru a genera forme de undă personalizate în generatorul de forme de undă arbitrare

Convertiți binar LI files în formatele CSV, MATLAB sau NumPy atunci când descărcați de pe dispozitiv

Suport API actualizat

Noul pachet Moku MATLAB API v3.0 oferă funcționalitate și stabilitate îmbunătățite. Va primi actualizări regulate pentru a îmbunătăți performanța și pentru a introduce noi funcții.

Limitări de compatibilitate inversă

API

Noul pachet Moku MATLAB API v3.0 nu este compatibil cu pachetul anterior Moku:Lab MATLAB v1.9. Argumentele de scripting MATLAB și valorile returnate sunt complet diferite. Dacă aveți o dezvoltare extinsă de software personalizat utilizând Moku:Lab MATLAB, luați în considerare impactul migrării întregului software pentru a fi compatibil cu noul API.

Deși pachetul Moku:Lab MATLAB nu va mai primi actualizări, Liquid Instruments va continua să ofere asistență pentru utilizatorii care nu pot migra la noul pachet API.

Găsiți exampfișiere pentru fiecare instrument din noul pachet Moku MATLAB API v3.0 pentru a servi drept linie de bază pentru conversia dezvoltării anterioare MATLAB în noul pachet API.

Regresii

Disc RAM pentru înregistrarea datelor

Versiunea 1.9 avea 512 MB filesistem din memoria RAM a dispozitivului, care ar putea fi folosit pentru a înregistra date la samprate de ling. În versiunea 3.0, înregistrarea în RAM nu mai este disponibilă. Pentru a activa înregistrarea datelor, este necesar un card SD. În consecință, se modifică și viteza maximă de achiziție. Versiunea 1.9 acceptă până la 1 MSa/s, în timp ce versiunea 3.0 acceptă până la 250 kSa/s la 1 canal și 125 kSa/s la 2 canale. Chiar și la viteze mai mici și cu un card SD, fluxurile de lucru care au inclus salvarea mai multor jurnale de mare viteză în RAM și apoi copierea lor pe cardul SD sau pe client nu vor mai fi acceptate.

Înregistrarea datelor în CSV

Versiunea 1.9 avea capacitatea de a salva datele direct într-un CSV file în timp ce se înregistrează. Această caracteristică nu este disponibilă direct pe versiunea 3.0. Utilizatori al căror flux de lucru a inclus salvarea CSVfiles direct pe un card SD sau clientul va trebui acum să convertească mai întâi binarul file la CSV, fie utilizând aplicația client, fie instalând instrumentele lichide independente File Convertor pe computerul pe care îl folosesc pentru prelucrarea datelor.

Modificări care nu sunt compatibile cu înapoi

Scalare a datelor în LIA

În versiunea 1.9, am implementat scalarea datelor astfel încât înmulțirea a două semnale de 0.1 V DC a dus la o ieșire de 0.02 V DC. În versiunea 3.0, am schimbat acest lucru, astfel încât rezultatul a fost 0.01 V DC, ceea ce este mai în concordanță cu așteptările intuitive ale clienților.

Ieșirea generatorului de forme de undă trebuie să fie activată pentru a fi utilizată ca sursă/declanșator de modulație

În versiunea 1.9, forma de undă a unui canal diferit ar putea fi utilizată ca sursă de modulație sau de declanșare în generatorul de forme de undă, chiar dacă ieșirea canalului respectiv a fost dezactivată. Aceasta a fost eliminată în versiune

• Utilizatorii care doresc să facă o modulare încrucișată fără a fi nevoie să deconecteze ieșirile dispozitivului lor ar trebui să își ajusteze

Moku MATLAB API

Pachetul Moku MATLAB API v3.0 este menit să ofere dezvoltatorilor MATLAB resursele necesare pentru a controla orice dispozitiv Moku și, în cele din urmă, capacitatea de a încorpora aceste controale în aplicațiile mai mari ale utilizatorilor finali. Noul pachet Moku MATLAB API v3.0 oferă următoarele:

• Complet funcțional exampscripturi MATLAB pentru fiecare
• Toate scripturile MATLAB sunt furnizate cu comentarii, care sunt ușor de înțeles și pot servi drept punct de plecare al utilizatorului final pentru personalizare și
• Un set de funcții care oferă control deplin asupra Moku

Instrumente acceptate în prezent

1. Generator de forme de undă arbitrare
2. Logger de date
3. Cutie cu filtru digital
4. FIR Filter Builder
5. Analizor de răspuns în frecvență
6. Cutie de blocare cu laser
7. Închidere Ampmai în viață
8. Osciloscop
9. Fazemetru
10. Controler PID
11. Analizor de spectru
12. Generator de forme de undă
13. Modul multi-instrument
14. Moku Cloud Compile

Instalare

Cerințe

• MATLAB versiunea 2015 sau ulterioară

Dacă aveți deja instalată o versiune anterioară a API-ului Moku MATLAB, vă rugăm să o dezinstalați înainte de a continua. Puteți dezinstala pachetul din Managerul de suplimente.

1. Deschideți Managerul de suplimente prin fila Acasă > Mediu.
2. Caută Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Alternativ, puteți descărca setul de instrumente direct din Liquid Instruments website la https://www.liquidinstruments.com/products/apis/matlab-api/. Va trebui să setați manual calea de căutare dacă faceți acest lucru.
4. Verificați dacă a fost adăugată calea corectă în caseta de instrumente, selectând „Setare cale” din fila Acasă > Mediu.
5. Asigurați-vă că există o intrare care indică locația de instalare a casetei de instrumente. O cale tipică ar putea fi CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Descărcați datele instrumentului files tastând „moku_download####) în fereastra de comandă MATLAB. ### ar trebui înlocuit cu versiunea curentă de firmware. Puteți găsi versiunea actuală a firmware-ului dvs. prin intermediul aplicației desktop Moku: făcând clic dreapta pe Moku și trecând cursorul pe „Informații despre dispozitiv”, sau în aplicația iPad apăsând lung pe Moku.
7. Confirmați-vă căsuța de instrumente este configurată corect tastând „help Moku” în fereastra de comandă MATLAB. Dacă această comandă reușește. atunci setul de instrumente a fost instalat cu succes

Modificări ale API-ului Moku

Noua arhitectură API Moku MATLAB este suficient de diferită de predecesorul său și, prin urmare, nu este compatibilă cu scripturile API existente. Următorul osciloscop simplificat exampfișierul arată diferențele dintre pachetele API vechi și cele noi și servește drept foaie de parcurs pentru portarea codului existent.

Osciloscop example

Secvența pașilor

1. Importați Moku MATLAB API 3.0
2. Revendicați proprietatea Moku și încărcați fluxul de biți Oscilloscope în
3. Setați baza de timp și setați intervalul din stânga și din dreapta pentru axa timpului.
4. Obțineți date, obțineți un singur cadru de date de la osciloscop
5. Încheiați sesiunea client renunțând la proprietatea Moku

Secvența descrisă mai sus este un exemplu simplificatample pentru a ilustra diferențele dintre pachetele API vechi și cele noi. Pe lângă începerea unei sesiuni client, încărcarea unui flux de biți de instrument în Moku și încheierea sesiunii client, un utilizator final poate exercita orice număr de funcții în ordine diferită pentru a satisface nevoile aplicației sale.

Diferențele

Aici, ne uităm la diferențele dintre cele două AP-uri pentru fiecare pas din secvență.

Revendicați proprietatea Moku și încărcați fluxul de biți Oscilloscope pe dispozitiv. În comparație cu Moku MATLAB 1.9, noul API are funcții complet diferite:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Funcţie	get_by_name()	deploy_or_conn ect()	Osciloscop()
Câmpuri și valori permise	nume: șir timeout: float	instrument: clasa instrumentului pe care doriți să o implementați	ip: șir serial: șir
	forță: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: float
			read_timeout: float

 

1. Setați baza de timp. Funcția este aceeași, dar argumentele permise sunt ușor diferite:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funcţie	set_timebase()	set_timebase()
   Câmpuri și valori permise	t1: plutitor t2: plutitor	t1: float t2:float strict: bool

2. Obțineți date. Funcțiile și argumentele permise sunt aceleași, dar tipul și lungimea datelor returnate sunt diferite:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funcţie	Obțineți date()	Obțineți date()
   Câmpuri și valori permise	timeout: float wait: bool	timeout: float wait_reacquire: bool
   Lungimea returului	16383 puncte pe cadru	1024 puncte pe cadru

3. Eliberați proprietatea Moku:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Funcţie	aproape()	abandon_ownership()

Lista de funcții ale osciloscopului

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
devineamp!erateO get_rea!time_dataQ	devineamp!erateO save_high_res_bufferO
gen_rampvalO 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_attenuationO
	set_sourceO osc_measurementQ
	rezumatQ

API-ul Moku MATLAB se bazează pe API-ul Moku. Pentru documentația completă a API-ului Moku, consultați Referința API-ului Moku găsită aici https://apis.liq uidinstrume nts.com/re fe rence/.

Detalii suplimentare pentru începerea utilizării API-ului Moku MATLAB pot fi găsite la https://a pis.liquid instruments.com/sta rating-Matlab.acasă

Procesul de downgrade

Dacă upgrade-ul la versiunea 3.0 s-a dovedit că limitează sau afectează în mod negativ ceva esențial pentru aplicația dvs., puteți trece la versiunea anterioară 1.9. Acest lucru se poate face printr-un web browser.

Pași

1. Contactați Liquid Instruments și obțineți file pentru versiunea de firmware 9.
2. Introduceți adresa IP Moku:Lab în a web browser (vezi captura de ecran).
3. Sub Actualizare firmware, răsfoiți și selectați firmware-ul file furnizate de Liquid Instruments.
4. Selectați Încărcare și actualizare. Procesul de actualizare poate dura mai mult de 10 minute

© 2023 Liquid Instruments. rezervat.

laudinstruments.com

Documente/Resurse

LIQUID INSTRUMENTS MATLAB API Integration Fusibles [pdfGhid de utilizare MATLAB API, MATLAB API Siguranțe de integrare, Siguranțe de integrare, Siguranțe

Referințe

• Manual de utilizare