LIQUID INSTRUMENTS MATLAB API Integration Fusibili

Guida alla migrazione dell'API MATLAB

L'aggiornamento di Moku: Lab alla versione software 3.0 sblocca una serie di nuove funzionalità. Durante l'aggiornamento, gli utenti API devono eseguire passaggi aggiuntivi per migrare i propri script al nuovo pacchetto API Moku. Questa guida alla migrazione illustra le modifiche API, le nuove funzionalità disponibili nell'aggiornamento alla versione 3.0 ed eventuali limitazioni di compatibilità con le versioni precedenti.

Sopraview

Il software Moku:Lab versione 3.0 è un aggiornamento importante che porta nuovi firmware, interfaccia utente e APl all'hardware Moku:Lab. L'aggiornamento porta Moku:Lab in linea con Moku:Pro e Moku:Go, semplificando la condivisione degli script su tutte le piattaforme Moku. L'aggiornamento sblocca una serie di nuove funzionalità per molti degli strumenti esistenti. Aggiunge anche due nuove funzionalità: modalità multi-strumento e Moku Cloud Compile. Esistono anche alcune sottili differenze comportamentali, descritte nella sezione Compatibilità con le versioni precedenti.

Si tratta di un aggiornamento importante che interessa l'architettura API e pertanto il nuovo pacchetto MATLAB API v3.0 non sarà retrocompatibile con gli script MATLAB esistenti. Gli utenti API dovranno trasferire i propri script sul nuovo pacchetto API Moku se aggiornano Moku:Lab alla versione 3.0. Gli utenti API con un significativo sviluppo di software personalizzato dovrebbero considerare attentamente il livello di impegno richiesto per trasferire il codice esistente. Moku:Lab 1.9 non è consigliato per nuove distribuzioni e tutti i clienti sono incoraggiati ad eseguire l'aggiornamento. Se si verificano problemi dopo l'aggiornamento, gli utenti avranno la possibilità di eseguire il downgrade alla versione software 1.9.

Questa guida alla migrazione descrive advantages di aggiornamenti e potenziali complicazioni per Moku:Lab versione 3.0. Descrive inoltre il processo per aggiornare l'API MATLAB e come eseguire il downgrade di Moku:Lab, se necessario.

Nuove funzionalità della versione 3.0

Nuove funzionalità

La versione software 3.0 porta per la prima volta la modalità Multi-Instrument e Moku Cloud Compile in Moku:Lab, oltre a numerosi aggiornamenti di prestazioni e usabilità in tutta la suite di strumenti.

Modalità multistrumento

La modalità multi-strumento su Moku:Lab consente agli utenti di utilizzare due strumenti contemporaneamente per creare una stazione di test personalizzata. Ogni strumento ha pieno accesso agli ingressi e alle uscite analogici insieme alle interconnessioni tra gli slot dello strumento. Le interconnessioni tra gli strumenti supportano comunicazioni digitali in tempo reale ad alta velocità e a bassa latenza fino a 2 Gb/s, in modo che gli strumenti possano funzionare in modo indipendente o essere collegati per creare pipeline avanzate di elaborazione del segnale. Gli strumenti possono essere scambiati dentro e fuori dinamicamente senza interrompere l'altro strumento. Gli utenti avanzati possono anche implementare i propri algoritmi personalizzati in modalità multi-strumento utilizzando Moku Cloud Compile.

Compilazione cloud di Moku

Moku Cloud Compile ti consente di implementare DSP personalizzato direttamente sull'FPGA Moku:Lab in modalità multi strumento. Scrivi il codice usando a web browser e compilarlo nel cloud; Moku Cloud Compile distribuisce il bitstream su uno o più dispositivi Moku di destinazione.

Oscilloscopio

• Modalità memoria profonda: salva fino a 4M samples per canale al massimoamptasso di ling (500 MSa/s)

Analizzatore di spettro

• Rumore di fondo migliorato
• Scala logaritmica Vrms e Vpp
• Cinque nuove funzioni della finestra (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Fasometro

• Offset di frequenza, fase e amplitude può ora essere emesso come volume analogicotage segnali
• Gli utenti possono ora aggiungere DC offset ai segnali di uscita
• L'uscita dell'onda sinusoidale ad aggancio di fase ora può essere moltiplicata in frequenza fino a 2x o divisa fino a 50x
• Gamma di larghezza di banda migliorata (da 1 Hz a 100 kHz)
• Funzioni avanzate di avvolgimento di fase e ripristino automatico

Generatore di forme d'onda

• Emissione di rumore
• Modulazione di larghezza di impulso (PWM)

bloccare Amppiù vivace

• Miglioramento delle prestazioni delle basse frequenze PLL bloccaggio
• La frequenza minima PLL è stata ridotta a 10 Hz
• Il segnale PLL interno può ora essere moltiplicato in frequenza fino a 250x o diviso fino a 125x per l'utilizzo nella demodulazione
• Precisione a 6 cifre per i valori di fase

Analizzatore di risposta in frequenza

• Frequenza massima aumentata da 120 MHz a 200 MHz
• Aumenta i punti di scansione massimi da 512 a 8192
• La nuova dinamica AmpLa funzione Litude ottimizza automaticamente il segnale di uscita per la migliore gamma dinamica di misurazione
• Nuova modalità di misurazione ln/ln1
• Avvisi di saturazione degli ingressi
• Il canale matematico ora supporta equazioni arbitrarie con valori complessi che coinvolgono i segnali del canale, consentendo nuovi tipi di misurazioni di funzioni di trasferimento complesse
• I segnali di ingresso possono ora essere misurati in dBVpp e dBVrms oltre che in dBm
• L'avanzamento della scansione viene ora visualizzato sul grafico
• L'asse della frequenza può ora essere bloccato per evitare modifiche accidentali durante una scansione lunga

Scatola di blocco laser

• Il diagramma a blocchi migliorato mostra i percorsi del segnale di scansione e modulazione
• La nuova chiusura stagQuesta funzione consente di personalizzare la procedura di blocco
• Miglioramento delle prestazioni delle basse frequenze PLL bloccaggio
• Precisione a 6 cifre per i valori di fase
• Miglioramento delle prestazioni delle basse frequenze PLL bloccaggio
• La frequenza minima PLL è stata ridotta a 10 Hz
• IL PLL il segnale ora può essere moltiplicato in frequenza fino a 250x o diviso fino a 0.125x per l'utilizzo nella demodulazione

Altro

Aggiunto il supporto per la funzione seno all'editor di equazioni che può essere utilizzato per generare forme d'onda personalizzate nel generatore di forme d'onda arbitrarie

Converti binario LI files nei formati CSV, MATLAB o NumPy durante il download dal dispositivo

Supporto API aggiornato

Il nuovo pacchetto Moku MATLAB API v3.0 offre funzionalità e stabilità migliorate. Riceverà aggiornamenti regolari per migliorare le prestazioni e introdurre nuove funzionalità.

Limiti di compatibilità con le versioni precedenti

API

Il nuovo pacchetto Moku MATLAB API v3.0 non è retrocompatibile con il precedente pacchetto Moku:Lab MATLAB v1.9. Gli argomenti di scripting MATLAB e i valori restituiti sono completamente diversi. Se disponi di un ampio sviluppo di software personalizzato utilizzando Moku:Lab MATLAB, considera l'impatto della migrazione di tutto il tuo software per renderlo compatibile con la nuova API.

Anche se il pacchetto Moku:Lab MATLAB non riceverà più aggiornamenti, Liquid Instruments continuerà comunque a fornire supporto agli utenti che non sono in grado di migrare al nuovo pacchetto API.

Trova dettagliati example per ogni strumento nel nuovo pacchetto Moku MATLAB API v3.0 per fungere da linea di base per la conversione dello sviluppo precedente di MATLAB nel nuovo pacchetto API.

Regressioni

Disco RAM per la registrazione dei dati

La versione 1.9 aveva 512 MB filesistema nella RAM del dispositivo, che potrebbe essere utilizzato per registrare i dati ad alta samptassi di interesse. Nella versione 3.0, la registrazione nella RAM non è più disponibile. Per abilitare la registrazione dei dati, è necessaria una scheda SD. Di conseguenza cambia anche la velocità massima di acquisizione. La versione 1.9 supporta fino a 1 MSa/s, mentre la versione 3.0 supporta fino a 250 kSa/s su 1 canale e 125 kSa/s su 2 canali. Anche a velocità inferiori e con una scheda SD, i flussi di lavoro che includevano il salvataggio di più registri ad alta velocità nella RAM e la successiva copia sulla scheda SD o sul client non saranno più supportati.

Registrazione dei dati in CSV

La versione 1.9 aveva la possibilità di salvare i dati direttamente in un CSV file durante la registrazione. Questa funzione non è direttamente disponibile nella versione 3.0. Utenti il ​​cui flusso di lavoro includeva il salvataggio di CSVfiles direttamente su una scheda SD o il client dovrà prima convertire il file binario file a CSV, utilizzando l'app client o installando Liquid Instruments autonomo File Convertitore sul computer utilizzato per l'elaborazione dei dati.

Modifiche non compatibili con le versioni precedenti

Ridimensionamento dei dati in LIA

Nella versione 1.9, abbiamo implementato il ridimensionamento dei dati in modo tale che moltiplicando due segnali da 0.1 V CC si ottiene un'uscita da 0.02 V CC. Nella versione 3.0, abbiamo modificato questo valore in modo tale che il risultato fosse 0.01 V CC, che è più in linea con le aspettative intuitive dei clienti.

L'uscita del generatore di forme d'onda deve essere abilitata per essere utilizzata come sorgente/trigger di modulazione

Nella versione 1.9, la forma d'onda di un canale diverso poteva essere utilizzata come sorgente di modulazione o trigger nel generatore di forme d'onda, anche se l'uscita di quel canale era disabilitata. Questo è stato rimosso nella versione

• Gli utenti che desiderano eseguire la modulazione incrociata senza dover scollegare le uscite del proprio dispositivo dovranno regolarle

API Moku MATLAB

Il pacchetto Moku MATLAB API v3.0 ha lo scopo di fornire agli sviluppatori MATLAB le risorse necessarie per controllare qualsiasi dispositivo Moku e, in definitiva, la capacità di incorporare questi controlli in applicazioni per l'utente finale più grandi. Il nuovo pacchetto Moku MATLAB API v3.0 fornisce quanto segue:

• Perfettamente funzionante esample script MATLAB per ciascuno
• Tutti gli script MATLAB sono dotati di commenti, che sono facili da comprendere e possono servire come punto di partenza per l'utente finale per la personalizzazione e
• Una serie di funzioni che forniscono il pieno controllo del Moku

Strumenti attualmente supportati

1. Generatore di forme d'onda arbitrarie
2. Registratore dati
3. Scatola filtro digitale
4. Generatore di filtri FIR
5. Analizzatore di risposta in frequenza
6. Scatola di blocco laser
7. Blocco Amppiù vivace
8. Oscilloscopio
9. Fasometro
10. Controllore PID
11. Analizzatore di spettro
12. Generatore di forme d'onda
13. Modalità multistrumento
14. Compilazione cloud di Moku

Installazione

Requisiti

• Versione MATLAB 2015 o successiva

Se hai già installato una versione precedente dell'API Moku MATLAB, disinstallala prima di procedere. È possibile disinstallare il pacchetto da Gestione componenti aggiuntivi.

1. Apri Gestione componenti aggiuntivi tramite la scheda Home > Ambiente.
2. Cercare Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. In alternativa, puoi scaricare la casella degli strumenti direttamente da Liquid Instruments websito a https://www.liquidinstruments.com/products/apis/matlab-api/. Se lo fai, dovrai impostare manualmente il percorso di ricerca.
4. Verifica che il percorso corretto sia stato aggiunto alla casella degli strumenti selezionando "Imposta percorso" dalla scheda Home > Ambiente.
5. Assicurarsi che sia presente una voce che punti al percorso di installazione della casella degli strumenti. Un percorso tipico potrebbe essere CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Scarica i dati dello strumento files digitando 'moku_download####) nella finestra di comando di MATLAB. Il ### dovrebbe essere sostituito con la versione firmware corrente. Yol può trovare la versione attuale del firmware tramite l'app Moku: desktop facendo clic con il pulsante destro del mouse sul tuo Moku e passando con il mouse su "Informazioni dispositivo", o nell'app per iPad premendo a lungo sul tuo Moku.
7. Verifica che la tua casella degli strumenti sia impostata correttamente digitando "help Moku" nella finestra di comando di MATLAB. Se questo comando ha esito positivo. quindi la casella degli strumenti è stata installata con successo

Moku modifiche all'API

La nuova architettura API Moku MATLAB è sufficientemente diversa dal suo predecessore e quindi non compatibile con gli script API esistenti. Il seguente oscilloscopio semplificato example mostra le differenze tra i pacchetti API legacy e nuovi e funge da road map per il porting del codice esistente.

Oscilloscopio esample

Passi di sequenza

1. Importa l'API Moku MATLAB 3.0
2. Rivendica la proprietà di Moku e carica il bitstream dell'oscilloscopio su
3. Imposta la base temporale e imposta l'intervallo di sinistra e di destra per l'asse del tempo.
4. Ottieni dati, acquisisci un singolo fotogramma dei dati dall'oscilloscopio
5. Termina la sessione del client rinunciando alla proprietà di Moku

La sequenza sopra descritta è un es. semplificatoample per illustrare le differenze tra i pacchetti API legacy e quelli nuovi. Oltre ad avviare una sessione client, caricare un bitstream dello strumento su Moku e terminare la sessione client, un utente finale può esercitare un numero qualsiasi di funzioni in vari ordini per soddisfare le esigenze della propria applicazione.

Differenze

Qui esaminiamo le differenze tra i due APl per ogni passaggio della sequenza.

Rivendica la proprietà di Moku e carica il bitstream dell'oscilloscopio sul dispositivo. Rispetto a Moku MATLAB 1.9, la nuova API ha funzioni completamente diverse:

	MokuMATLAB 1.9		MokuMATLAB 3.0
Funzione	get_by_name()	deploy_or_conn ect()	Oscilloscopio()
Campi e valori consentiti	nome: stringa timeout: float	strumento: la classe dello strumento che si desidera utilizzare	ip: stringa seriale: stringa
	forza: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: float
			read_timeout: float

 

1. Imposta la base temporale. La funzione è la stessa, ma gli argomenti consentiti sono leggermente diversi:
   

   	MokuMATLAB 1.9	MokuMATLAB 3.0
   Funzione	set_basetempo()	set_basetempo()
   Campi e valori consentiti	t1: galleggiante t2: galleggiante	t1: float t2: float strict: bool

2. Ottieni dati. Le funzioni e gli argomenti consentiti sono gli stessi, ma il tipo e la lunghezza dei dati restituiti sono diversi:
   

   	MokuMATLAB 1.9	MokuMATLAB 3.0
   Funzione	ottieni_dati()	ottieni_dati()
   Campi e valori consentiti	timeout: float attesa: bool	timeout: float wait_reacquire: bool
   Lunghezza di ritorno	16383 punti per fotogramma	1024 punti per fotogramma

3. Rilascia la proprietà Moku:
   

   	MokuMATLAB 1.9	API Moku v3.0
   Funzione	vicino()	abbandonare_proprietà()

Elenco funzioni dell'oscilloscopio

MokuMATLAB 1.9	MokuMATLAB 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 disattiva_inputO abilita_rollmodeQ
set_precision_modeQ	set_acquisition_modeQ
sync_phaseQ	sync_output_phaseQ
get_frontendQ	get_frontendQ
prendeamp!erateO get_rea!time_dataQ	prendeamp!erateO save_high_res_bufferO
gen_rampondaO gen_sinewaveO	generare_formad'ondaO get_acquisition_modeQ
gen_squarewaveQ	get_sourcesQ
gen_offQ	get_timebaseQ get_output_!oadQ
impostaamplerateQ set_framerateQ	get_interpo!ationO set_output_!loadQ
	set_isteresiQ set_interpo!ationO
	set_input_attenuazioneO
	set_sourceO osc_measurementQ
	riepilogoQ

L'API Moku MATLAB è basata sull'API Moku. Per la documentazione completa dell'API Moku, fare riferimento al riferimento all'API Moku trovato qui https://apis.liq uidinstrume nts.com/re fe rence/.

Ulteriori dettagli per iniziare con l'API Moku MATLAB sono disponibili all'indirizzo https://a pis.liquid instruments.com/sta valutazione-Matlab.casa

Processo di downgrade

Se l'aggiornamento alla versione 3.0 ha dimostrato di limitare, o altrimenti influenzare negativamente, qualcosa di critico per la tua applicazione, puoi eseguire il downgrade alla versione precedente 1.9. Questo può essere fatto attraverso a web browser.

Passi

1. Contatta Liquid Instruments e ottieni il file per la versione firmware 9.
2. Digita il tuo indirizzo IP Moku:Lab in a web browser (vedi screenshot).
3. In Aggiorna firmware, sfoglia e seleziona il firmware file fornito da Liquid Instruments.
4. Seleziona Carica e aggiorna. Il completamento del processo di aggiornamento può richiedere più di 10 minuti

© 2023 Strumenti liquidi. riservato.

laudinstruments.com

Documenti / Risorse

LIQUID INSTRUMENTS MATLAB API Integration Fusibili [pdf] Guida utente API MATLAB, fusibili di integrazione API MATLAB, fusibili di integrazione, fusibili

Riferimenti

• Manuale d'uso