STRUMENTI LIQUIDI Moku Lab LabVIEW Guida per l'utente alla migrazione dell'API

Sopraview

Moku: La versione 3.0 del software Lab è un importante aggiornamento che apporta nuovo firmware, interfacce utente e API all'hardware Moku:Lab. L'aggiornamento porta Moku:Lab in linea con Moku:Fro 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à: Muti-instrument Mode e Moku Cloud Compile. Esistono alcune sottili differenze comportamentali descritte nella sezione Compatibilità con le versioni precedenti.

Questo aggiornamento riguarda anche l'architettura APl, e quindi il nuovo pacchetto API non sarà retrocompatibile con gli script APl esistenti. Gli APluser dovranno portare i propri script al nuovo pacchetto Moku APl se aggiorneranno il loro Moku:Lab alla versione 3.C. Gli utenti dell'API con un significativo sviluppo di software personalizzato dovrebbero considerare attentamente il livello di impegno richiesto per portare il loro coce esistente. Moku:Lab 1.9 non è consigliato per nuove distribuzioni e tutti i clienti sono incoraggiati a eseguire l'aggiornamento. Alla fine, Moku:Lab versione 1.9 perderà il supporto, in conformità con la nostra politica di fine vita. In caso di problemi dopo l'aggiornamento, gli utenti avranno la possibilità di eseguire il downgrade alla versione software 19.

Questa guida alla migrazione descrive advantages di aggiornamento e potenziali complicazioni dell'aggiornamento a Moku:Lab versione 3.0. Descrive inoltre il processo per aggiornare il laboratorioVIEW APl e come eseguire il downgrade del tuo 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à Muli-instrument su Moku:Lab consente agli utenti di distribuire due strumenti contemporaneamente per creare una stazione di test personalizzata. Ogni strumento ha pieno accesso agli ingressi e alle uscite analogiche, insieme alle interconnessioni tra gli slot degli strumenti. Le interconnessioni tra gli strumenti supportano la comunicazione digitale in tempo reale ad alta velocità, bassa latenza fino a 2 Gb/s, in modo che gli strumenti possano funzionare in modo indipendente o essere collegati per creare pipeline di elaborazione del segnale avanzate. Gli utenti possono scambiare dinamicamente gli strumenti dentro e fuori senza interrompere l'altro adiacente. Gli utenti avanzati possono anche distribuire i propri algoritmi personalizzati in modalità multi-strumento utilizzando Moku Cloud Compile.

Compilazione cloud di Moku
Moku Cloud Compile consente di implementare l'elaborazione del segnale digitale (DSP) personalizzata direttamente sull'FPGA Moku:Lab in modalità multi-strumento. Scrivi il codice usando a web browser e compilarlo nel cloud; quindi utilizzare Moku Cloud Compile per distribuire il bitstream su uno o più dispositivi Moku di destinazione.

Oscilloscopio

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

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

Fasometro

• Gli utenti possono ora emettere offset di frequenza, fase e amplitude come vol analogicotage segnali
• Gli utenti possono ora aggiungere DC offset ai segnali di uscita
• L'uscita dell'onda sinusoidale ad aggancio di fase può ora essere moltiplicata in frequenza fino a 250x o divisa fino a 0.125x
• 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)

Blocco Amplificatore (LIA) 

• Prestazioni migliorate del blocco PLL a bassa frequenza
• 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 0.125x per l'uso in demodulazione
• Precisione a 6 cifre per i valori di fase

Analizzatore di risposta in frequenza

• Frequenza massima aumentata da 120 MHz a 200 MHz
• Punti massimi di sweep aumentati da 512 a 8192
• Nuova dinamica AmpLa funzione Litude ottimizza automaticamente il segnale di uscita per la migliore gamma dinamica di misurazione
• Nuova modalità di misura In/Int
• 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
• Gli utenti possono ora misurare i segnali di ingresso in dBVpp e dBVrms oltre a dBm
• L'avanzamento della scansione viene ora visualizzato sul grafico
• L'asse della frequenza può ora essere bloccato per evitare modifiche accidentali durante lo sweep lungo

Scatola di blocco laser

• Il diagramma a blocchi migliorato mostra i percorsi del segnale di scansione e modulazione
• Nuova chiusura stagQuesta funzione consente agli utenti di personalizzare la procedura di blocco
• Prestazioni migliorate del blocco P_L a bassa frequenza
• Precisione a 6 cifre per i valori di fase
• Prestazioni migliorate del blocco P_L a bassa frequenza
• Frequenza PLL minima ridotta a 10 Hz
• Il segnale PLL può ora essere moltiplicato in frequenza fino a 250x o diviso fino a 0.125x per l'uso in demodulazione.

ALTRO

• Aggiunto il supporto per la funzione sinc all'editor di equazioni che può essere utilizzato per generare forme d'onda personalizzate nel generatore di forme d'onda arbitrarie
• Converti LI binario files nei formati CSV, MATLAB o NumPy durante il download dal dispositivo

Supporto API aggiornato
Il nuovo pacchetto API Moku 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 Laboratorio MokuVIEW Il pacchetto API non è retrocompatibile con il precedente Moku:LabLabVIEW API. Gli input e gli output sono completamente diversi. Se hai svolto un ampio sviluppo di software personalizzato utilizzando Moku:Lab LabVIEW API, considera l'impatto della migrazione di tutto il tuo software per renderlo compatibile con la nuova API.

Mentre il Moku:Lab 1.9 LabVIEW Il pacchetto API non riceverà più aggiornamenti, Liquid Instruments continuerà a fornire supporto agli utenti che non sono in grado di migrare al nuovo pacchetto API Trova dettagli example per ogni strumento nel nuovo Moku LabVIEW Pacchetto API da utilizzare come base per la conversione dello sviluppo APl precedente nel nuovo pacchetto APl.

Regressioni

Disco RAM per la registrazione dei dati
La versione 1.9 a aveva 512 MB filesistema nella RAM del dispositivo, che potrebbe essere utilizzato per registrare i dati ad alta samptassi di ling. Questo non è più disponibile nella versione 3.0. Per abilitare la registrazione dei dati, è necessaria una scheda SD. Ciò limita la velocità di registrazione dei dati a circa 250 kSa/s per 1 canale e 125 kSa/s per due canali.

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 CSV files 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 che usano 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 risultasse un'uscita da 0.02 V CC. Nella versione 3.0, l'abbiamo modificato 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 3.0. Gli utenti che desiderano eseguire la modulazione incrociata senza dover scollegare le uscite del proprio dispositivo dovranno regolare il proprio flusso di lavoro.

Laboratorio MokuVIEW API

Il Laboratorio MokuVIEW Il pacchetto API ha lo scopo di fornire LabVIEW sviluppatori le risorse necessarie per controllare qualsiasi dispositivo Moku e, in ultima analisi, la capacità di incorporare questi controlli in applicazioni più grandi per l'utente finale.

Il nuovo Laboratorio MokuVIEW Il pacchetto API fornisce quanto segue:

• Perfettamente funzionante esample per ogni strumento.
• Una struttura del diagramma a blocchi di facile comprensione che può servire come punto di partenza per la personalizzazione e l'adattamento dell'utente finale
• Una serie di funzioni Vl che forniscono il pieno controllo del dispositivo 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. Blocco Amppiù vivace
7. Scatola di blocco laser
8. Logic Analyzer
9. Oscilloscopio
10. Fasometro
11. Analizzatore di spettro
12. Generatore di forme d'onda
13. Controllore PID
14. Modalità multistrumento
15. Compilazione cloud di Moku

Installazione

Requisiti

• LaboratorioVIEW versione 2016 o successiva
• Gestore pacchetto VIP (VIPM)

Se hai già una versione precedente di Moku LabVIEW APLinstallato, disinstallalo prima di procedere. È possibile disinstallare il pacchetto dal gestore pacchetti VI selezionando Disinstalla pacchetto.

1. Scarica e installa Moku LabVIEW pacchetto da Liquid Instruments websito a
2. Il pacchetto verrà installato tramite il gestore di pacchetti VI. Una volta completato, dovresti essere in grado di vedere il pacchetto elencato sotto "installato" in VI Package Manager.
   Figura 1: Gestore pacchetti JKI VI
   
   Nota: Gli altri pacchetti qui elencati sono dipendenze utilizzate per lo streaming di dati.

Moku modifiche all'API

Il nuovo Laboratorio MokuVIEW L'architettura APl è sufficientemente diversa dal suo predecessore e quindi non è retrocompatibile con gli script API esistenti. Il seguente oscilloscopio semplificato esample mostra le differenze tra i pacchetti API legacy e nuovi e funge da road map per il porting del codice esistente.

Oscilloscopio esample
Figura 2: Confronto APL dell'oscilloscopio

Passi di sequenza

1. Inizia la sessione del client e carica il bitstream dell'oscilloscopio su Moku
2. Impostare la base dei tempi e impostare l'intervallo sinistro e destro per l'asse dei tempi
3. Genera forma d'onda, configura e genera un'onda sinusoidale sul canale 1
4. Ottieni dati, acquisisci un singolo fotogramma dei dati dall'oscilloscopio.
5. CENITENI
6. Termina la sessione del cliente

La sequenza sopra descritta è un es. semplificatoample per illustrare le differenze tra i pacchetti APL legacy e quelli nuovi. A parte l'inizio di una sessione client, il caricamento di un bitstream dello strumento su Moku e la fine della sessione client, un utente finale può esercitare un numero qualsiasi di funzioni in ordine diverso per soddisfare le esigenze della propria applicazione.

Differenze
Qui esaminiamo le differenze tra le due API per ogni fase della sequenza.

1. Inizia la sessione Maku-Client e carica il bitstream dell'oscilloscopio su Moku
   Il nuovo APl ha suddiviso la connessione della sessione client e il caricamento del bitstream dello strumento in funzioni separate, 1A e 1B. Tutti gli script iniziano con queste 2 funzioni.
   
2. Base oraria fissa
   Le funzioni dello strumento nel nuovo APl sono ora funzioni singole. In precedenza, questo era un processo in due passaggi nell'API legacy. La prima funzione converte i parametri di input in una stringa JSON e la seconda funzione invia il comando al Moku. Inoltre, i parametri delle funzioni nell'API legacy erano contenuti nei cluster. La maggior parte dei parametri funzionali nel nuovo APl sono controlli individuali.
   Figura 4 Impostare la base dei tempi
   
3. Genera forma d'onda
   La funzione di generazione della forma d'onda è una singola funzione nella nuova API. In questo caso, i parametri della funzione sono contenuti in un cluster. Ci sono diverse funzioni nel nuovo AP che richiedono molti parametri di input; in questi casi viene utilizzato un cluster.
   
4. Ottieni dati
   Anche la funzione get data è una singola funzione nella nuova API. In questo caso, i parametri della funzione sono controlli individuali per entrambe le API. L'ARl legacy richiede una funzione aggiuntiva per convertire i dati di output dal formato stringa JSON in array numerici per ciascun canale.
   Figura 7: Chiudi API
   
   
5. Termina la sessione Moku-Client
   La funzione Chiudi API è una singola funzione nella nuova API. Tutti gli script terminano con questa funzione.
   Figura 7: Chiudi API
   

Confronto tavolozza
È possibile trovare cartelle di strumenti equivalenti nella tavolozza principale di Liquid Instruments Moku, visualizzata nella Figura 8. Quindi, in ogni cartella di strumenti si troveranno le funzioni di strumenti equivalenti, visualizzate nella Figura 9 e nella Figura 10.
Figura : Tavolozza principale, tavolozza API legacy a sinistra, nuova tavolozza API a destra.

Figura 9: cartella dello strumento dell'oscilloscopio precedente a sinistra, nuova cartella dello strumento dell'oscilloscopio a destra.

Figura 10: Funzioni dello strumento

Il Laboratorio MokuVIEW APl è basato sull'API Moku. Per la documentazione completa di Moku APl, fare riferimento al Moku API Reference che si trova qui https://apisliquidinstruments.com/reference/. Ulteriori dettagli per iniziare con Moku LabVIEW L'API è disponibile all'indirizzo
https://apis.liquidinstruments.com/starting-labview.html.

Processo di downgrade

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

Passi

1. Contatta Liquid Instruments e ottieni il file per la versione firmware 1.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. Selezionare Carica e aggiorna. Il completamento del processo di aggiornamento può richiedere più di 10 minuti.
   Figura 11: Procedura di downgrade
   

Documenti / Risorse

STRUMENTI LIQUIDI Moku Lab LabVIEW Migrazione dell'API [pdf] Guida utente Laboratorio Laboratorio MokuVIEW Migrazione delle API, laboratorioVIEW Migrazione API, migrazione API, migrazione

Riferimenti

• Manuale d'uso