LIQUID INSTRUMENTS MATLAB API Integration Fusibles

Guia de migració de l'API de MATLAB

L'actualització de Moku: Lab a la versió de programari 3.0 desbloqueja una sèrie de funcions noves. Quan s'actualitzen, els usuaris de l'API han de fer passos addicionals per migrar els seus scripts al nou paquet de l'API de Moku. Aquesta guia de migració descriu els canvis de l'API, les noves funcions disponibles a l'actualització de la versió 3.0 i les limitacions de compatibilitat enrere.

Acabatview

La versió 3.0 del programari Moku:Lab és una actualització important que aporta nous firmware, interfície d'usuari i APls al maquinari Moku:Lab. L'actualització posa Moku:Lab en línia amb Moku:Pro i Moku:Go, cosa que facilita compartir scripts a totes les plataformes Moku. L'actualització desbloqueja una sèrie de funcions noves per a molts dels instruments existents. També afegeix dues funcions noves: Mode multiinstrument i Moku Cloud Compile. També hi ha algunes diferències de comportament subtils, descrites a la secció de compatibilitat enrere.

Aquesta és una actualització important que afecta l'arquitectura de l'API i, per tant, el nou paquet MATLAB API v3.0 no serà compatible amb les versions anteriors dels scripts de MATLAB existents. Els usuaris de l'API hauran de portar els seus scripts al nou paquet de l'API de Moku si actualitzen el seu Moku:Lab a la versió 3.0. Els usuaris d'API amb un important desenvolupament de programari personalitzat haurien de considerar acuradament el nivell d'esforç necessari per portar el codi existent. Moku:Lab 1.9 no es recomana per a nous desplegaments i es recomana a tots els clients que actualitzin. Si sorgeixen problemes després de l'actualització, els usuaris tindran l'opció de baixar a la versió de programari 1.9.

Aquesta guia de migració descriu avançadatagd'actualització i possibles complicacions a la versió 3.0 de Moku:Lab. També descriu el procés per actualitzar l'API de MATLAB i com rebaixar el vostre Moku:Lab si cal.

Noves funcions de la versió 3.0

Noves característiques

La versió 3.0 del programari porta el Mode Multi-Instrument i Moku Cloud Compile a Moku:Lab per primera vegada, així com moltes actualitzacions de rendiment i usabilitat al conjunt d'instruments.

Mode multi-instrument

El mode multiinstrument a Moku:Lab permet als usuaris desplegar dos instruments simultàniament per crear una estació de prova personalitzada. Cada instrument té accés complet a les entrades i sortides analògiques juntament amb les interconnexions entre les ranures dels instruments. Les interconnexions entre instruments admeten comunicacions digitals en temps real d'alta velocitat, baixa latència i fins a 2 Gb/s, de manera que els instruments poden funcionar de manera independent o connectar-se per construir canalitzacions avançades de processament de senyal. Els instruments es poden canviar dinàmicament dins i fora sense interrompre l'altre instrument. Els usuaris avançats també poden implementar els seus propis algorismes personalitzats en mode multiinstrument mitjançant Moku Cloud Compile.

Moku Cloud Compile

Moku Cloud Compile us permet desplegar DSP personalitzat directament al Moku:Lab FPGA en mode multiinstrument. Escriu codi amb a web navegador i compilar-lo al núvol; Moku Cloud Compile desplega el flux de bits a un o més dispositius Moku objectiu.

Oscil·loscopi

• Mode de memòria profunda: estalvieu fins a 4M samples per canal a ple samptaxa de pesca (500 MSa/s)

Analitzador d'espectre

• Fons de soroll millorat
• Escala Vrms i Vpp logarítmiques
• Cinc funcions noves de la finestra (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Fasímetre

• Desplaçament de freqüència, fase i ampLitude ara es pot emetre com a vol analògictage senyals
• Els usuaris ara poden afegir offset DC als senyals de sortida
• La sortida d'ona sinusoïdal bloquejada en fase ara es pot multiplicar per freqüència fins a 2 50x o dividir-se a 125x
• Interval d'amplada de banda millorat (1 Hz a 100 kHz)
• Funcions avançades d'embolcall de fase i restabliment automàtic

Generador de formes d'ona

• Sortida de soroll
• Modulació d'amplada de pols (PWM)

Bloqueig Ampmés viu

• Millora del rendiment de baixa freqüència PLL bloqueig
• La freqüència mínima de PLL s'ha reduït a 10 Hz
• El senyal PLL intern ara es pot multiplicar per freqüència fins a 250x dividit fins a 125x per utilitzar-lo en demodulació
• Precisió de 6 dígits per als valors de fase

Analitzador de resposta en freqüència

• Augment de la freqüència màxima de 120 MHz a 200 MHz
• Augmenta els punts màxims d'escombrat de 512 a 8192
• La nova dinàmica AmpLa funció Litude optimitza automàticament el senyal de sortida per obtenir el millor rang dinàmic de mesura
• Nou mode de mesura ln/ln1
• Avisos de saturació d'entrada
• El canal matemàtic ara admet equacions arbitràries de valors complexos que involucren els senyals del canal, permetent nous tipus de mesures complexes de funcions de transferència.
• Els senyals d'entrada ara es poden mesurar en dBVpp i dBVrms a més de dBm
• El progrés de l'escombrat es mostra ara al gràfic
• Ara es pot bloquejar l'eix de freqüència per evitar canvis accidentals durant un escombrat llarg

Caixa de bloqueig làser

• El diagrama de blocs millorat mostra els camins del senyal d'exploració i modulació
• El nou tancament stagAquesta característica permet personalitzar el procediment de bloqueig
• Millora del rendiment de baixa freqüència PLL bloqueig
• Precisió de 6 dígits per als valors de fase
• Millora del rendiment de baixa freqüència PLL bloqueig
• La freqüència mínima de PLL s'ha reduït a 10 Hz
• El PLL El senyal ara es pot multiplicar per freqüència fins a 250x o dividir-se fins a 0.125x per utilitzar-lo en la demodulació

Altres

S'ha afegit suport per a la funció sinusoïdal a l'editor d'equacions que es pot utilitzar per generar formes d'ona personalitzades al generador de formes d'ona arbitràries

Converteix binari LI files als formats CSV, MATLAB o NumPy en baixar des del dispositiu

Suport API actualitzat

El nou paquet Moku MATLAB API v3.0 proporciona una funcionalitat i estabilitat millorades. Rebrà actualitzacions periòdiques per millorar el rendiment i introduir noves funcions.

Limitacions de compatibilitat enrere

API

El nou paquet Moku MATLAB API v3.0 no és compatible amb l'anterior paquet Moku:Lab MATLAB v1.9. Els arguments de l'script de MATLAB i els valors de retorn són completament diferents. Si teniu un desenvolupament extens de programari personalitzat amb Moku:Lab MATLAB, tingueu en compte l'impacte de la migració de tot el vostre programari perquè sigui compatible amb la nova API.

Tot i que el paquet Moku:Lab MATLAB ja no rebrà actualitzacions, Liquid Instruments continuarà donant suport als usuaris que no puguin migrar al nou paquet API.

Trobeu exampfitxers per a cada instrument del nou paquet Moku MATLAB API v3.0 per servir com a línia base per convertir el desenvolupament anterior de MATLAB al nou paquet API.

Regressions

Disc RAM per al registre de dades

La versió 1.9 tenia 512 MB filesistema a la memòria RAM del dispositiu, que es podria utilitzar per registrar dades amb s altsamptarifes de ling. A la versió 3.0, la sessió a la memòria RAM ja no està disponible. Per activar el registre de dades, cal una targeta SD. En conseqüència, també canvia la velocitat màxima d'adquisició. La versió 1.9 admet fins a 1 MSa/s, mentre que la versió 3.0 admet fins a 250 kSa/s en 1 canal i 125 kSa/s en 2 canals. Fins i tot a velocitats més baixes i amb una targeta SD, els fluxos de treball que incloïen desar diversos registres d'alta velocitat a la memòria RAM i després copiar-los a la targeta SD o al client ja no seran compatibles.

Registre de dades a CSV

La versió 1.9 tenia la possibilitat de desar dades directament en un CSV file mentre es registra. Aquesta funció no està disponible directament a la versió 3.0. Usuaris el flux de treball dels quals incloïa desar CSVfiles directament a una targeta SD o ara el client haurà de convertir primer el binari file a CSV, ja sigui mitjançant l'aplicació client o instal·lant els instruments líquids autònoms File Convertidor a l'ordinador que utilitzen per al tractament de dades.

Canvis no compatibles cap enrere

Escalat de dades a LIA

A la versió 1.9, vam implementar l'escala de dades de manera que la multiplicació de dos senyals de 0.1 V DC va donar lloc a una sortida de 0.02 V DC. A la versió 3.0, ho vam canviar de manera que el resultat fos 0.01 V DC, que s'ajusta més a les expectatives intuïtives dels clients.

La sortida del generador de formes d'ona s'ha d'habilitar per utilitzar-la com a font/disparador de modulació

A la versió 1.9, la forma d'ona d'un canal diferent es podria utilitzar com a font de modulació o disparador al generador de formes d'ona, fins i tot si la sortida d'aquest canal estava desactivada. Això es va eliminar en versió

• Els usuaris que vulguin fer una modulació creuada sense necessitat de desconnectar les sortides del seu dispositiu haurien d'ajustar la seva

Moku API MATLAB

El paquet Moku MATLAB API v3.0 està pensat per proporcionar als desenvolupadors de MATLAB els recursos necessaris per controlar qualsevol dispositiu Moku i, en definitiva, la capacitat d'incorporar aquests controls a aplicacions d'usuari final més grans. El nou paquet Moku MATLAB API v3.0 ofereix el següent:

• Totalment funcional exampscripts de MATLAB per a cadascun
• Tots els scripts de MATLAB es proporcionen amb comentaris, que són fàcils d'entendre i poden servir com a punt de partida de l'usuari final per a la personalització i
• Un conjunt de funcions que ofereixen un control total sobre el Moku

Instruments compatibles actualment

1. Generador de formes d'ona arbitràries
2. Registrador de dades
3. Caixa de filtres digitals
4. FIR Filter Builder
5. Analitzador de resposta en freqüència
6. Caixa de bloqueig làser
7. Bloqueig Ampmés viu
8. Oscil·loscopi
9. Fasímetre
10. Controlador PID
11. Analitzador d'espectre
12. Generador de formes d'ona
13. Mode multi-instrument
14. Moku Cloud Compile

Instal·lació

Requisits

• MATLAB versió 2015 o posterior

Si ja teniu instal·lada una versió anterior de l'API Moku MATLAB, desinstal·leu-la abans de continuar. Podeu desinstal·lar el paquet des del Gestor de complements.

1. Obriu el Gestor de complements mitjançant la pestanya Inici > Entorn.
2. Cerca Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Alternativament, podeu descarregar la caixa d'eines directament des de Liquid Instruments weblloc a https://www.liquidinstruments.com/products/apis/matlab-api/. Haureu d'establir el camí de cerca manualment si ho feu.
4. Comproveu que s'ha afegit el camí correcte a la caixa d'eines seleccionant "Estableix camí" a la pestanya Inici > Entorn.
5. Assegureu-vos que hi hagi una entrada que apunta a la ubicació d'instal·lació de la caixa d'eines. Un camí típic pot ser CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Descarrega les dades de l'instrument files escrivint "moku_download####) a la finestra d'ordres de MATLAB. El ### s'ha de substituir per la versió actual del firmware. Pots trobar la teva versió actual del microprogramari a través de l'aplicació d'escriptori Moku: fent clic amb el botó dret al teu Moku i passant el cursor sobre "Informació del dispositiu", o bé a l'aplicació per a l'iPad prement llargament el teu Moku.
7. Confirmeu que la vostra caixa d'eines està configurada correctament escrivint "ajuda Moku" a la finestra d'ordres de MATLAB. Si aquesta comanda té èxit. aleshores la caixa d'eines s'ha instal·lat correctament

Canvis de l'API Moku

La nova arquitectura de l'API de Moku MATLAB és prou diferent de la seva predecessora i, per tant, no és compatible amb els scripts de l'API existents. El següent oscil·loscopi simplificat example mostra les diferències entre els paquets d'API heretats i nous i serveix com a full de ruta per portar el codi existent.

Oscil·loscopi example

Passos de seqüència

1. Importa l'API Moku MATLAB 3.0
2. Reclameu la propietat de Moku i pengeu el flux de bits de l'oscil·loscopi
3. Estableix la base de temps i defineix l'espai a mà esquerra i dreta per a l'eix del temps.
4. Obteniu dades, obteniu un únic fotograma de les dades de l'oscil·loscopi
5. Finalitzeu la sessió del client renunciant a la propietat de Moku

La seqüència descrita anteriorment és un exemple simplificatample per il·lustrar les diferències entre els paquets d'API heretats i nous. A part d'iniciar una sessió de client, carregar un flux de bits d'instrument a Moku i finalitzar la sessió de client, un usuari final pot exercir qualsevol nombre de funcions en diferents ordres per satisfer les necessitats de la seva aplicació.

Diferències

Aquí, observem les diferències entre els dos APls per a cada pas de la seqüència.

Reclameu la propietat de Moku i pengeu el flux de bits de l'oscil·loscopi al dispositiu. En comparació amb Moku MATLAB 1.9, la nova API té funcions completament diferents:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Funció	get_by_name()	deploy_or_conn ect()	Oscil·loscopi ()
Camps i valors permesos	nom: string timeout: float	instrument: la classe de l'instrument que es vol desplegar	ip: cadena serial: cadena
	força: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: flotant
			read_timeout: flotant

 

1. Estableix la base de temps. La funció és la mateixa, però els arguments permesos són lleugerament diferents:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funció	set_timebase()	set_timebase()
   Camps i valors permesos	t1: flotant t2: flotant	t1: flotant t2: flotant estricte: bool

2. Obteniu dades. Les funcions i els arguments permesos són els mateixos, però el tipus i la longitud de les dades retornades són diferents:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funció	obtenir_dades()	obtenir_dades()
   Camps i valors permesos	timeout: flotant wait: bool	temps d'espera: flotant wait_reacquire: bool
   Longitud de retorn	16383 punts per fotograma	1024 punts per fotograma

3. Allibera la propietat de Moku:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Funció	tancar ()	renunciar_propietat()

Llista de funcions de l'oscil·loscopi

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
fase_sincronitzacióQ	fase_de_sortida_sincronitzacióQ
get_frontendQ	get_frontendQ
obtenir_samp!erateO get_rea!time_dataQ	obtenir_samp!erateO save_high_res_bufferO
gen_rampona O gen_sinewaveO	genera_forma d'onaO get_acquisition_modeQ
gen_squarewaveQ	get_sourcesQ
gen_offQ	get_timebaseQ get_output_!oadQ
conjunt_samplerateQ set_framerateQ	get_interpo!ationO set_output_!oadQ
	set_hysteresisQ set_interpo!ationO
	set_input_atenuationO
	set_sourceO osc_measurementQ
	resum Q

L'API Moku MATLAB es basa en l'API Moku. Per obtenir la documentació completa de l'API de Moku, consulteu la referència de l'API de Moku que trobareu aquí https://apis.liq uidinstrume nts.com/re fe rence/.

Podeu trobar detalls addicionals per començar amb l'API Moku MATLAB a https://a pis.liquid instruments.com/sta qualificació-Matlab.casa

Procés de degradació

Si s'ha demostrat que l'actualització a la versió 3.0 limita, o afecta negativament, alguna cosa crítica per a la vostra aplicació, podeu baixar a la versió anterior 1.9. Això es pot fer mitjançant a web navegador.

Passos

1. Contacteu amb Liquid Instruments i obteniu el file per a la versió de firmware 9.
2. Escriviu la vostra adreça IP de Moku:Lab a a web navegador (vegeu la captura de pantalla).
3. A Actualitzar el firmware, busqueu i seleccioneu el microprogramari file proporcionada per Liquid Instruments.
4. Seleccioneu Carrega i actualització. El procés d'actualització pot trigar més de 10 minuts a completar-se

© 2023 Liquid Instruments. reservat.

laudinstruments.com

Documents/Recursos

LIQUID INSTRUMENTS MATLAB API Integration Fusibles [pdfGuia de l'usuari API MATLAB, API MATLAB Fusibles d'integració, fusibles d'integració, fusibles

Referències

• Manual d'usuari