LIQUID INSTRUMENTS MATLAB API Integration Fuses
MATLAB API Migration Guide
L'aghjurnamentu di Moku: Lab à a versione di u software 3.0 sblocca una mansa di funzioni novi. Quandu l'aghjurnà, l'utilizatori di l'API devenu piglià passi extra per migrà i so scripts à u novu pacchettu Moku API. Questa guida di migrazione delinea i cambiamenti di l'API, e funzioni novi dispunibili in l'aghjurnamentu di a versione 3.0, è qualsiasi limitazione di cumpatibilità inversa.
Overview
A versione 3.0 di u software Moku:Lab hè un aghjurnamentu maiò chì porta novu firmware, interfaccia d'utilizatore è APls à u hardware Moku:Lab. L'aghjurnamentu porta Moku:Lab in linea cù Moku:Pro è Moku:Go, facilitendu a sparte di script in tutte e piattaforme Moku. L'aghjurnamentu sblocca una mansa di funzioni novi à parechji strumenti esistenti. Aghjusta ancu duie funzioni novi: Modu Multi-instrumentu è Moku Cloud Compile. Ci sò ancu alcune sottili differenze di cumportamentu, delineate in a sezione di cumpatibilità inversa.
Questa hè una aghjurnazione maiò chì afecta l'architettura API, è per quessa u novu pacchettu MATLAB API v3.0 ùn serà micca retrocompatibile cù i script MATLAB esistenti. L'utilizatori di l'API anu da portà i so script à u novu pacchettu Moku API se aghjurnà u so Moku:Lab à a versione 3.0. L'utilizatori di l'API cun un sviluppu software persunalizatu significativu duveranu cunsiderà attentamente u livellu di sforzu necessariu per portà u so codice esistente. Moku:Lab 1.9 ùn hè micca cunsigliatu per novi implementazioni è tutti i clienti sò incuraghjiti à aghjurnà. In casu di prublemi dopu à l'aghjurnamentu, l'utilizatori anu l'opzione di downgrade à a versione di u software 1.9.
Questa guida di migrazione delinea avanzutages di l'aghjurnà è e pussibuli cumplicazioni à Moku:Lab versione 3.0. Descrive ancu u prucessu per aghjurnà l'API MATLAB è cumu si sminuisce u vostru Moku:Lab se ne necessariu.
Versione 3.0 novi funziunalità
Funzioni novi
A versione di u software 3.0 porta u Modu Multi-Strumentu è Moku Cloud Compile à Moku:Lab per a prima volta, è ancu parechji aghjurnamenti di rendiment è usabilità in a suite di strumenti.
Modu multi-instrumentu
Modu multi-strumenta in Moku:Lab permette à l'utilizatori di implementà dui strumenti simultaneamente per creà una stazione di prova persunalizata. Ogni strumentu hà un accessu cumpletu à l'inputs è uscite analogichi cù l'interconnessioni trà i slot di l'instrumentu. L'interconnessioni trà i strumenti supportanu a cumunicazione digitale à alta velocità, bassa latenza è in tempu reale finu à 2 Gb/s, cusì l'instrumenti ponu funziona indipindentamente o esse cunnessi per custruisce pipeline di trasfurmazione di signali avanzati. Strumenti ponu esse scambiati dinamicamente in è fora senza interrompe l'altru strumentu. L'utilizatori avanzati ponu ancu implementà i so propri algoritmi persunalizati in Modu Multi-strumenta cù Moku Cloud Compile.
Moku Cloud Compile
Moku Cloud Compile vi permette di implementà DSP persunalizati direttamente nantu à u Moku:Lab FPGA in Modu Multi Instrument. Scrivite u codice cù a web navigatore è compilallu in u nuvulu; Moku Cloud Compile implementa u bitstream à unu o più dispositi Moku di destinazione.
Oscilloscope
- Modu di memoria profonda: risparmià finu à 4M samples per canale à piena samptasso di ling (500 MSa/s)
Analizatore di Spettru
- Pianu di rumore migliuratu
- Scala logaritmica Vrms è Vpp
- Cinque novi funzioni di finestra (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)
Phasemeter
- Offset di frequenza, fasa è amplitude pò avà esse uscita cum'è vol analogicutage signali
- L'utilizatori ponu avà aghjunghje un offset DC à i segnali di output
- L'output di l'onda sinusoidale in fase di blocco pò avà esse multiplicatu in frequenza finu à 2 50x o divisu à 125x
- Gamma di larghezza di banda mejorata (1 Hz à 100 kHz)
- Funzioni avanzate di avvolgimentu di fasi è auto-reset
Generatore di forme d'onda
- Emissione di rumore
- Modulazione di larghezza di impulsu (PWM)
Lock-In Amppiù vivu
- Prestazione migliorata di bassa frequenza PLL serratura
- A frequenza minima PLL hè stata diminuita à 10 Hz
- U signale PLL internu pò avà esse multiplicatu in frequenza finu à 250xor divisu à 125x per l'usu in demodulazione.
- Precisione di 6 cifre per i valori di fasa
Analizzatore di Risposta di Frequenza
- Frequenza massima aumentata da 120 MHz à 200 MHz
- Aumenta i punti di spazzatura massimi da 512 à 8192
- A nova dinamica AmpA funzione Litude ottimizza automaticamente u segnu di output per u megliu intervallu dinamicu di misurazione
- Novu modu di misurazione ln/ln1
- Avvisi di saturazione di input
- U canali di matematica supporta avà equazioni arbitrarie di valore cumplessu chì implicanu i segnali di u canali, chì permettenu novi tipi di misurazioni cumplessi di funzioni di trasferimentu.
- I signali di input ponu avà esse misurati in dBVpp è dBVrms in più di dBm
- U prugressu di u sweep hè avà visualizatu nantu à u graficu
- L'assi di frequenza pò avà esse chjusu per prevene cambiamenti accidentali durante una longa spazzata
Laser Lock Box
- U schema di bloccu migliuratu mostra i percorsi di segnali di scansione è modulazione
- A nova serratura stages funziunalità permette persunalizà u prucedimentu serratura
- Prestazione migliorata di bassa frequenza PLL serratura
- Precisione di 6 cifre per i valori di fasa
- Prestazione migliorata di bassa frequenza PLL serratura
- A frequenza minima PLL hè stata diminuita à 10 Hz
- U PLL U signalu pò avà esse multiplicatu in frequenza finu à 250x o divisu à 0.125x per l'usu in demodulazione.
Altru
Aggiuntu supportu per a funzione sine à l'editore di equazioni chì pò esse usatu per generà forme d'onda persunalizati in u Generatore di forma d'onda arbitraria.
Cunvertisce binariu LI files à i formati CSV, MATLAB, o NumPy quandu scaricate da u dispusitivu
Supportu API aghjurnatu
U novu pacchettu Moku MATLAB API v3.0 furnisce funziunalità è stabilità rinfurzata. Riceverà aghjornamenti regulari per migliurà u rendiment è intruduce novi funziunalità.
Limitazioni di cumpatibilità retrocede
API
U novu pacchettu Moku MATLAB API v3.0 ùn hè micca retrocompatibile cù u pacchettu Moku:Lab MATLAB v1.9 precedente. L'argumenti di scripting MATLAB è i valori di ritornu sò completamente diffirenti. Se avete un vastu sviluppu di software persunalizatu chì utilizeghja Moku:Lab MATLAB, cunzidira l'impattu di a migrazione di tuttu u vostru software per esse cumpatibile cù a nova API.
Mentre u pacchettu Moku:Lab MATLAB ùn riceverà più l'aghjurnamenti, Liquid Instruments continuarà à furnisce un supportu per l'utilizatori chì ùn sò micca capaci di migrà à u novu pacchettu API.
Truvate examples per ogni strumentu in u novu pacchettu Moku MATLAB API v3.0 per serve cum'è una linea di basa per cunvertisce u sviluppu di MATLAB prima à u novu pacchettu API.
Rigressioni
Discu RAM per a registrazione di dati
A versione 1.9 avia 512 MB filesistema in a RAM di u dispusitivu, chì pudia esse usata à log data à altu sampi tassi di ling. In a versione 3.0, u logu in RAM ùn hè più dispunibule. Per attivà a registrazione di dati, una carta SD hè necessaria. Per quessa, a velocità massima di acquisizione cambia ancu. A versione 1.9 supporta finu à 1 MSa/s, mentri a versione 3.0 supporta finu à 250 kSa/s à 1 canale è 125 kSa/s à 2 canali. Ancu à velocità più bassu è cù una carta SD, i flussi di travagliu chì includenu a salvezza di parechje logs d'alta velocità in RAM è dopu copià à a carta SD o u cliente ùn saranu più supportati.
Logging di dati in CSV
A versione 1.9 hà avutu a capacità di salvà dati direttamente in un CSV file durante u logu. Questa funzione ùn hè micca dispunibule direttamente nantu à a versione 3.0. L'utilizatori chì u flussu di travagliu includeu u salvamentu di CSVfiles direttamente à una carta SD o u cliente avà bisognu di cunvertisce prima u binariu file à CSV, sia aduprendu l'app cliente o instalendu i Strumenti Liquidi standalone File Convertitore nantu à l'urdinatore chì utilizanu per u trattamentu di dati.
Cambiamenti chì ùn sò micca compatibles
Scala di dati in LIA
In a versione 1.9, avemu implementatu a scala di dati cusì chì a multiplicazione di dui signali 0.1 V DC hà risultatu in una uscita 0.02 V DC. In a versione 3.0, avemu cambiatu questu cusì chì u risultatu era 0.01 V DC, chì hè più in linea cù l'expectativa intuitive di i clienti.
L'output di u Generatore di forma d'onda deve esse attivatu per aduprà cum'è fonte di modulazione / trigger
In a versione 1.9, a forma d'onda di un canale differente puderia esse aduprata cum'è modulazione o fonte di trigger in u Generatore di forma d'onda, ancu s'ellu l'output di quellu canale era disattivatu. Questu hè statu eliminatu in a versione
- L'utilizatori chì volenu fà a modulazione incruciata senza avè bisognu di disinserisce l'outputs di u so dispusitivu avissiru bisognu di aghjustà u so
Moku MATLAB API
U pacchettu Moku MATLAB API v3.0 hè destinatu à furnisce à i sviluppatori MATLAB e risorse necessarie per cuntrullà qualsiasi dispositivu Moku è, in fine, a capacità di incorpore questi cuntrolli in applicazioni di l'utilizatori finali più grandi. U novu pacchettu Moku MATLAB API v3.0 furnisce i seguenti:
- Completamente funziunale example scripts MATLAB per ognunu
- Tutti i script MATLAB sò furniti cù cumenti, chì sò faciuli di capiscenu è ponu serve cum'è u puntu di partenza di l'utilizatori finali per a persunalizazione è
- Un inseme di funzioni chì furnisce un cuntrollu tutale di u Moku
Strumenti attualmente supportati
- Generatore di forme d'onda arbitrarie
- Data Logger
- Scatola di filtru digitale
- FIR Filter Builder
- Analizzatore di Risposta di Frequenza
- Laser Lock Box
- Lock-in Amppiù vivu
- Oscilloscope
- Phasemeter
- Controller PID
- Analizatore di Spettru
- Generatore di forme d'onda
- Modu multi-instrumentu
- Moku Cloud Compile
Installazione
Requisiti
- MATLAB versione 2015 o più tardi
Se avete digià una versione precedente di l'API Moku MATLAB installata, per piacè disinstallala prima di prucede. Pudete disinstallà u pacchettu da u Add-on Manager.
- Aprite l'Add-on Manager attraversu a tabulazione Home> Ambiente.
- Cerca Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
- In alternativa, pudete scaricà u toolbox direttamente da u Liquid Instruments websitu à https://www.liquidinstruments.com/products/apis/matlab-api/. Avete bisognu di stabilisce a strada di ricerca manualmente se fate questu.
- Verificate chì u percorsu currettu hè statu aghjuntu à a casella di l'uttellu scegliendu "Set Path" da a Home > Tabulazione Ambiente.
- Assicuratevi chì ci hè una entrata chì punta à u locu di stallazione di u toolbox. Un percorsu tipicu pò esse CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
- Scaricate i dati di u strumentu files scrivendu 'moku_download####) in a Finestra di Command MATLAB. U ### deve esse rimpiazzatu cù a vostra versione di firmware attuale. Puderete truvà a vostra versione di firmware attuale attraversu l'app Moku: desktop clicchendu u dirittu nantu à u vostru Moku è passanu "Informazioni di u dispositivu", o in l'app iPad premendu longu u vostru Moku.
- Verificate chì a vostra casella di strumenti hè stallata currettamente scrivite "help Moku" in a Finestra di Command MATLAB. Sì stu cumandamentu riesce. tandu u toolbox hè statu stallatu bè
L'API Moku cambia
A nova architettura Moku MATLAB API hè abbastanza diversa da u so predecessore è dunque ùn hè micca retrocompatibile cù i script API esistenti. L'oscilloscopiu simplificatu seguenti example mostra e differenze trà l'eredità è i novi pacchetti API è serve cum'è una mappa stradale per portà u codice esistente.
Oscilloscope example
Passi di sequenza
- Importa l'API Moku MATLAB 3.0
- Riclamà a pruprietà di Moku è caricate u bitstream Oscilloscope à
- Stabilite a basa di u tempu è stabilisce u span di manca è di diritta per l'assi di u tempu.
- Ottene dati, acquistà un unicu quadru di dati da l'oscilloscopiu
- Finisce a sessione di u cliente rinunziendu a pruprietà Moku
A sequenza descritta sopra hè un ex simplificatuample per illustrà e differenze trà i pacchetti API legacy è novi. A parte di inizià una sessione di u cliente, caricate un strumentu bitstream à Moku, è finisce a sessione di u cliente, un utilizatore finale pò esercite ogni quantità di funzioni in vari ordini per risponde à i bisogni di a so applicazione.
Differenzi
Eccu, fighjemu e sferenze trà i dui APls per ogni passu in a sequenza.
Riclamà a pruprietà di Moku è caricate u bitstream Oscilloscope à u dispusitivu. Comparatu cù Moku MATLAB 1.9, a nova API hà funzioni completamente diverse:
| Moku MATLAB 1.9 | Moku MATLAB 3.0 | ||
| Funzione | get_by_name() | deploy_or_conn ect() | Oscilloscope () |
| Campi è valori permessi | nome: string timeout: float | strumentu : a classa di u strumentu chì vulete implementà | ip: stringa seriale: stringa |
| forza : boul | set_defauIt: booI | force_connect: bool | |
| use_externa I: bool | ignore_busy : bool | ||
| persist_state: bool | |||
| connect_timeout : float | |||
| read_timeout : float | |||
- Pone a basa di u tempu. A funzione hè a stessa, ma l'argumenti permessi sò ligeramente diffirenti:
Moku MATLAB 1.9 Moku MATLAB 3.0 Funzione set_timebase() set_timebase() Campi è valori permessi t1 : flotteur t2 : flotteur t1: float t2: float strict: bool - Ottene dati. E funzioni è l'argumenti permessi sò listessi, ma u tipu di dati restituitu è a durata sò diffirenti:
Moku MATLAB 1.9 Moku MATLAB 3.0 Funzione get_data() get_data() Campi è valori permessi timeout: float wait: bool timeout: float wait_reacquire: bool Lunghezza di ritornu 16383 punti per quadru 1024 punti per quadru - Rilascia a pruprietà Moku:
Moku MATLAB 1.9 Moku API v3.0 Funzione chiudi() rinunzià_proprietà()
Lista di funzioni di l'oscilloscopiu
| 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 |
| 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_ramponda O
gen_sinewaveO |
genera_forma d'ondaO
get_acquisizione_modeQ |
| gen_squarewaveQ | get_sourcesQ |
| gen_offQ | get_timebaseQ
get_output_!oadQ |
| set_samplerate Q
set_framerateQ |
get_interpo!ationO set_output_!oadQ |
| set_hysteresisQ
set_interpo!ationO |
|
| set_input_attenuationO | |
| set_sourceO
osc_measurementQ |
|
| riassuntu Q |
L'API Moku MATLAB hè basatu annantu à l'API Moku. Per a documentazione completa di l'API Moku, riferite à a Moku API Reference truvata quì https://apis.liq uidinstrume nts.com/re fe rence/.
Ulteriori dettagli per inizià cù l'API Moku MATLAB ponu esse truvati à https://a pis.liquid instruments.com/sta valutazione- Matlab.casa
Prucessu di downgrade
Se l'aghjurnamentu à a versione 3.0 hà dimustratu per limità, o altrimenti affettà negativamente, qualcosa di criticu per a vostra applicazione, pudete retrocede à a versione precedente 1.9. Questu pò esse fattu attraversu a web navigatore.
Passi
- Cuntattate Liquid Instruments è uttene u file per a versione di firmware 9.
- Scrivite u vostru indirizzu IP Moku:Lab in a web navigatore (vede screenshot).
- Sottu Update Firmware, cercate è selezziunate u firmware file furnitu da Liquid Instruments.
- Selezziunà Caricà & Actualizazione. U prucessu di aghjurnamentu pò piglià più di 10 minuti per compie
© 2023 Liquid Instruments. riservatu.
Documenti / Risorse
 |
LIQUID INSTRUMENTS MATLAB API Integration Fuses [pdfGuida di l'utente MATLAB API, MATLAB API Fusibili di Integrazione, Fusibili di Integrazione, Fusibili |