LIQUID INSTRUMENTS MATLAB API Integration Fuzes

Gvidilo pri Migrado de MATLAB API

Ĝisdatigi Moku: Lab al programaro versio 3.0 malŝlosas multajn novajn funkciojn. Dum ĝisdatigo, API-uzantoj devas fari kromajn paŝojn por migri siajn skriptojn al la nova Moku API-pakaĵo. Ĉi tiu migradgvidilo skizas API-ŝanĝojn, novajn funkciojn disponeblajn en la ĝisdatigo de la versio 3.0 kaj iujn ajn malantaŭkongruecajn limojn.

Finiteview

Moku:Lab-programara versio 3.0 estas grava ĝisdatigo kiu alportas novan firmvaron, uzantinterfacon kaj AP-ojn al Moku:Lab-aparataro. La ĝisdatigo alportas Moku:Lab al Moku:Pro kaj Moku:Go, faciligante kunhavigi skriptojn tra ĉiuj Moku-platformoj. La ĝisdatigo malŝlosas multajn novajn funkciojn al multaj el la ekzistantaj instrumentoj. Ĝi ankaŭ aldonas du novajn funkciojn: Multi-instrumenta Reĝimo kaj Moku Cloud Compile. Estas ankaŭ kelkaj subtilaj kondutismaj diferencoj, skizitaj en la sekcio de Malantaŭa kongruo.

Ĉi tio estas grava ĝisdatigo kiu influas la API-arkitekturon, kaj tial la nova MATLAB API v3.0-pakaĵo ne estos malantaŭen kongrua kun ekzistantaj MATLAB-skriptoj. API-uzantoj devos porti siajn skriptojn al la nova Moku API-pakaĵo se ili ĝisdatigas sian Moku:Lab al versio 3.0. Uzantoj de API kun grava laŭmenda programaro devas zorge pripensi la nivelon de penado necesa por porti sian ekzistantan kodon. Moku:Lab 1.9 ne estas rekomendita por novaj deplojoj kaj ĉiuj klientoj estas instigitaj ĝisdatigi. Se problemoj aperos post ĝisdatigo, uzantoj havos la eblon malgradigi al programaro versio 1.9.

Ĉi tiu migra gvidilo skizas advantagestas de ĝisdatigo kaj eblaj komplikaĵoj al Moku:Lab versio 3.0. Ĝi ankaŭ skizas la procezon por ĝisdatigi la MATLAB-API kaj kiel malplialtigi vian Moku:Lab se necese.

Versio 3.0 novaj funkcioj

Novaj funkcioj

Programaro-versio 3.0 alportas Multi-Instrumentan Reĝimon kaj Moku Cloud Compile al Moku:Lab por la unua fojo, same kiel multajn rendimentajn kaj uzeblajn ĝisdatigojn tra la serio de instrumentoj.

Plurinstrumenta Reĝimo

Plurinstrumenta Reĝimo en Moku:Lab permesas al uzantoj disfaldi du instrumentojn samtempe por krei kutiman teststacion. Ĉiu instrumento havas plenan aliron al la analogaj enigaĵoj kaj eliroj kune kun interligoj inter instrumentfendetoj. La interkonektoj inter instrumentoj subtenas altrapidan, malalt-latentecan, realtempan ciferecan komunikadon ĝis 2 Gb/s, do instrumentoj povas funkcii sendepende aŭ esti konektitaj por konstrui altnivelajn signaltraktadduktojn. Instrumentoj povas esti dinamike interŝanĝitaj en kaj eksteren sen interrompado de la alia instrumento. Progresintaj uzantoj ankaŭ povas disfaldi siajn proprajn kutimajn algoritmojn en Plurinstrumenta Reĝimo uzante Moku Cloud Compile.

Moku Cloud Kompilo

Moku Cloud Compile permesas vin disfaldi propran DSP rekte sur la Moku:Lab FPGA en Multi-instrumenta Reĝimo. Skribu kodon uzante a web retumilo kaj kompilu ĝin en la nubo; Moku Cloud Compile deplojas la bitfluon al unu aŭ pluraj celaj Moku-aparatoj.

Osciloskopo

• Profunda memorreĝimo: ŝparu ĝis 4M samples per kanalo je plena samplingkurzo (500 MSa/s)

Spektro-Analizilo

• Plibonigita brua planko
• Logaritmaj Vrms kaj Vpp-skalo
• Kvin novaj fenestraj funkcioj (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Fazemetro

• Frekvenca ofseto, fazo, kaj amplitudo nun povas esti eligita kiel analoga voltage signaloj
• Uzantoj nun povas aldoni DC-offseton al eligsignaloj
• La faz-ŝlosita sinusonda eligo nun povas esti ofteco multiplikita ĝis 2 50x aŭ dividita malsupren al 125x
• Plibonigita bendolarĝa gamo (1 Hz ĝis 100 kHz)
• Altnivelaj fazaj envolvado kaj aŭtomata restarigo funkcioj

Generatoro de Ondoformo

• Brua eligo
• Pulslarĝmodulado (PWM)

ŝlosi enen Amppli viva

• Plibonigita rendimento de malaltfrekvenco PLL ŝlosado
• La minimuma PLL-frekvenco estis malpliigita al 10 Hz
• La interna PLL-signalo nun povas esti ofteco multiplikita ĝis 250x dividita malsupren al 125x por uzo en demodulado.
• 6-cifera precizeco por fazaj valoroj

Frekvenca Responda Analizilo

• Pliigita maksimuma frekvenco de 120 MHz ĝis 200 MHz
• Pliigu maksimumajn balaajn punktojn de 512 al 8192
• La Nova Dinamika AmpLitude-trajto optimumigas eligsignalon aŭtomate por plej bona mezura dinamika gamo
• Nova mezura reĝimo ln/ln1
• Avertoj pri saturado de enigo
• La matematikkanalo nun apogas arbitrajn komplik-valorajn ekvaciojn implikantajn la kanalsignalojn, ebligante novajn specojn de kompleksaj transiga funkcio mezuradoj
• Enirsignaloj nun povas esti mezuritaj en dBVpp kaj dBVrms krom dBm
• La progreso de la balaado nun montriĝas sur la grafikaĵo
• La frekvenca akso nun povas esti ŝlosita por malhelpi hazardajn ŝanĝojn dum longa balaado

Laser Lock Box

• La plibonigita blokdiagramo montras skanadon kaj moduladajn signalvojojn
• La nova ŝlosi stages trajto permesas personigi la seruro proceduro
• Plibonigita rendimento de malaltfrekvenco PLL ŝlosado
• 6-cifera precizeco por fazaj valoroj
• Plibonigita rendimento de malaltfrekvenco PLL ŝlosado
• La minimuma PLL-frekvenco estis malpliigita al 10 Hz
• La PLL signalo nun povas esti ofteco multiplikita ĝis 250x aŭ dividita malsupren al 0.125x por uzo en demodulado

Aliaj

Aldonita subteno por la sinusfunkcio al la ekvacia redaktilo, kiu povas esti uzata por generi specialadaptitajn ondformojn en la Arbitra Ondoforma Generatoro

Konverti binaron LI files al CSV, MATLAB, aŭ NumPy-formatoj dum elŝuto de la aparato

Ĝisdatigita API-Subteno

La nova pako Moku MATLAB API v3.0 provizas plibonigitan funkciecon kaj stabilecon. Ĝi ricevos regulajn ĝisdatigojn por plibonigi rendimenton kaj enkonduki novajn funkciojn.

Malantaŭenkongruaj limigoj

API

La nova pakaĵo Moku MATLAB API v3.0 ne estas malantaŭen kongrua kun la antaŭa pakaĵo Moku:Lab MATLAB v1.9. La MATLAB-skriptargumentoj kaj revenaj valoroj estas tute malsamaj. Se vi havas ampleksan laŭmendan programaron disvolvante uzante la Moku:Lab MATLAB, konsideru la efikon de migrado de via tuta programaro kongrua kun la nova API.

Dum la pakaĵo Moku:Lab MATLAB ne plu ricevos ĝisdatigojn, Liquid Instruments daŭre subtenos uzantojn, kiuj ne povas migri al la nova API-pakaĵo.

Trovu detalan ekzamples por ĉiu instrumento en la nova Moku MATLAB API v3.0 pakaĵo por funkcii kiel bazlinio por konverti antaŭan MATLAB-disvolviĝon al la nova API-pakaĵo.

Regresioj

RAM-disko por datumregistrado

Versio 1.9 havis 512 MB filesistemo en la RAM de la aparato, kiu povus esti uzata por registri datumojn je altaj sampling tarifoj. En versio 3.0, ensaluti al RAM ne plu disponeblas. Por ebligi datumregistradon, SD-karto estas bezonata. Sekve, la maksimuma akirrapideco ankaŭ ŝanĝiĝas. Versio 1.9 apogis ĝis 1 MSa/s, dum versio 3.0 apogas ĝis 250 kSa/s ĉe 1 kanalo kaj 125 kSa/s ĉe 2 kanaloj. Eĉ ĉe pli malaltaj rapidoj kaj kun SD-karto, laborfluoj, kiuj inkluzivis ŝpari plurajn altrapidajn protokolojn al RAM kaj poste kopii ilin al la SD-karto aŭ al la kliento, ne plu estos subtenataj.

Datumregistrado al CSV

Versio 1.9 havis la kapablon konservi datumojn rekte al CSV file dum arbohakado. Ĉi tiu funkcio ne estas rekte havebla en versio 3.0. Uzantoj kies laborfluo inkluzivis konservadon de CSVfiles rekte al SD-karto aŭ la kliento nun devos unue konverti la binaron file al CSV, aŭ uzante la klientan apon aŭ instalante la memstarajn Liquid Instruments File Konvertilo al la komputilo, kiun ili uzas por datumtraktado.

Ne-malantaŭen-kongruaj ŝanĝoj

Skalado de datumoj en LIA

En versio 1.9, ni efektivigis datumskaladon tia ke multobligi du 0.1 V DC-signalojn rezultigis 0.02 V DC-eligon. En versio 3.0, ni ŝanĝis ĉi tion tiel ke la rezulto estis 0.01 V DC, kio pli konformas al intuiciaj atendoj de klientoj.

Eligo de Waveform Generator devas esti ebligita por uzi kiel modula fonto/ellasilo

En versio 1.9, la ondoformo de malsama kanalo povus esti utiligita kiel modulado aŭ ellasilfonto en la Ondoformo-Generatoro, eĉ se la produktaĵo de tiu kanalo estis malfunkciigita. Ĉi tio estis forigita en versio

• Uzantoj, kiuj volas fari krucmoduladon sen neceso malŝalti la elirojn de sia aparato, bezonus ĝustigi sian

Moku MATLAB API

La pako Moku MATLAB API v3.0 intencas provizi MATLAB-programistojn la rimedojn necesajn por kontroli ajnan Moku-aparaton kaj, finfine, la kapablon korpigi ĉi tiujn kontrolojn en pli grandajn finuzantajn aplikojn. La nova pako Moku MATLAB API v3.0 provizas la jenon:

• Plene funkcia ekzample MATLAB-skriptoj por ĉiu
• Ĉiuj MATLAB-skriptoj estas provizitaj per komentoj, kiuj estas facile kompreneblaj kaj povas servi kiel deirpunkto de finuzanto por personigo kaj
• Aro de funkcioj provizantaj plenan kontrolon de la Moku

Nuntempe subtenataj instrumentoj

1. Generatoro de Arbitra Ondoformo
2. Datumregistrilo
3. Cifereca Filtrila Skatolo
4. FIR Filtrilo-Konstruisto
5. Frekvenca Responda Analizilo
6. Laser Lock Box
7. Enŝlosiĝo Amppli viva
8. Osciloskopo
9. Fazemetro
10. PID-regilo
11. Spektro-Analizilo
12. Generatoro de Ondoformo
13. Plurinstrumenta Reĝimo
14. Moku Cloud Kompilo

Instalado

Postuloj

• MATLAB-versio 2015 aŭ poste

Se vi jam havas antaŭan version de la Moku MATLAB API instalita, bonvolu malinstali ĝin antaŭ ol daŭrigi. Vi povas malinstali la pakaĵon de la Aldonaĵa Administranto.

1. Malfermu la Aldonan Administranton per la langeto Hejmo > Medio.
2. Serĉu Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Alternative, vi povas elŝuti la ilaron rekte de la Liquid Instruments webretejo ĉe https://www.liquidinstruments.com/products/apis/matlab-api/. Vi devos agordi la serĉvojon permane se vi faras tion.
4. Kontrolu, ke la ĝusta vojo estis aldonita al la ilujo elektante 'Agordu Padon' el la langeto Hejmo > Medio.
5. Certigu, ke estas eniro montranta la lokon de instalado de iloj. Tipa vojo povus esti CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Elŝutu la instrumentajn datumojn files tajpante 'moku_download####) en la MATLAB-Komandan Fenestron. La ### devus esti anstataŭigita per via nuna firmware-versio. Yol povas trovi vian nunan firmvarversion per la Moku: labortabla apo dekstre alklakante vian Moku kaj ŝvebante 'Informoj pri aparato', aŭ en la iPad-aplikaĵo longe premante vian Moku.
7. Konfirmu, ke via ilarkesto estas ĝuste agordita tajpante 'help Moku' en la Komandfenestron de MATLAB. Se ĉi tiu komando sukcesas. tiam la ilarkesto estas sukcese instalita

Moku API ŝanĝiĝas

La nova Moku MATLAB API-arkitekturo estas sufiĉe diferenca de sia antaŭulo kaj tial ne malantaŭen kongrua kun ekzistantaj API-skriptoj. La sekva simpligita Osciloskopo ekzample montras la diferencojn inter la heredaĵo kaj novaj API-pakaĵoj kaj funkcias kiel vojmapo por porti ekzistantan kodon.

Osciloskopo ekzample

Sekvencaj paŝoj

1. Importu la Moku MATLAB API 3.0
2. Postulu la proprieton de Moku kaj alŝutu la Oscilloscope-bitfluon al
3. Fiksu tempbazon kaj starigu la maldekstran kaj dekstran interspacon por la tempoakso.
4. Akiru datumojn, akiru ununuran kadron de la datumoj de la Osciloskopo
5. Finu klientsesion rezignante la proprieton de Moku

La sinsekvo priskribita supre estas simpligita ekzample por ilustri la diferencojn inter la heredaĵo kaj novaj API-pakaĵoj. Krom komenci klientsesion, alŝuti instrumentbitfluon al Moku, kaj fini la klientsesion, finuzanto povas ekzerci ajnan nombron da funkcioj en diversaj ordo por renkonti la bezonojn de sia aplikaĵo.

Diferencoj

Ĉi tie, ni rigardas la diferencojn inter la du AP-oj por ĉiu paŝo en la sekvenco.

Postulu la proprieton de Moku kaj alŝutu la Oscilloscope-bitfluon al la aparato. Kompare kun Moku MATLAB 1.9, la nova API havas tute malsamajn funkciojn:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Funkcio	get_by_name()	deploy_or_conn ect()	Osciloskopo ()
Permesitaj kampoj kaj valoroj	nomo: string timeout: flosilo	instrumento: la klaso de la instrumento kiun deziras deploji	ip: string serialo: string
	forto: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: flosi
			read_timeout: flosi

 

1. Agordu tempa bazo. La funkcio estas la sama, sed la permesitaj argumentoj estas iomete malsamaj:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funkcio	set_timebase ()	set_timebase ()
   Permesitaj kampoj kaj valoroj	t1: flosilo t2:flosilo	t1: flosilo t2:float strikta: bool

2. Akiru datumojn. La funkcioj kaj la permesitaj argumentoj estas la samaj, sed la redonitaj datumtipo kaj longo estas malsamaj:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funkcio	akiri_datenojn ()	akiri_datenojn ()
   Permesitaj kampoj kaj valoroj	timeout: float wait: bool	timeout: float wait_reacquire: bool
   Longo de reveno	16383 poentoj per kadro	1024 poentoj per kadro

3. Liberigu la proprieton de Moku:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Funkcio	fermi ()	rezigni_proprieton ()

Listo de funkcioj de osciloskopo

Moku MATLAB 1.9	Moku MATLAB 3.0
aro_fontoO	aro_fontojO
set_triggerO	set_triggerO
akiri_datumojnQ	akiri_datumojnQ
set_frontendQ	set_frontendQ
set_defau!tsQ set_timebaseO set_xmodeQ	set_defau!tsQ set_timebaseQ disable_inputO enable_rollmodeQ
aro_precizeca_modoQ	set_acquisition_modeQ
sync_phaseQ	sync_output_phaseQ
get_frontendQ	get_frontendQ
ricevasamp!erateO get_rea!time_dataQ	ricevasamp!erateO save_high_res_bufferO
gen_rampondoO gen_sinewaveO	generi_ondoformO get_acquisition_modeQ
gen_squarewaveQ	get_fontojQ
gen_offQ	get_timebaseQ get_output_!oadQ
aro_samplerateQ set_framerateQ	get_interpo!ationO set_output_!oadQ
	aro_histerezoQ set_interpo!ationO
	aro_enigo_malfortiĝoO
	aro_fontoO osc_measurementQ
	resumoQ

La Moku MATLAB API baziĝas sur Moku API. Por plena dokumentado de Moku API, referu al la Moku API-Referenco trovita ĉi tie https://apis.liq uidinstrume nts.com/re fe rence/.

Pliaj detaloj por komenci kun Moku MATLAB API troveblas ĉe https://a pis.liquid instruments.com/sta taksado-Matlab.hejmen

Malaltgrada procezo

Se la ĝisdatigo al versio 3.0 pruvis limigi, aŭ alie malfavore influas, ion kritikan al via aplikaĵo, vi povas malgradigi al la antaŭa versio 1.9. Ĉi tio povas esti farita per a web retumilo.

Paŝoj

1. Kontaktu Liquid Instruments kaj akiru la file por firmware versio 9.
2. Tajpu vian IP-adreson de Moku:Lab en a web retumilo (vidu ekrankopion).
3. Sub Ĝisdatigi Firmware, foliumu kaj elektu la firmvaro file provizita de Liquid Instruments.
4. Elektu Alŝuti kaj Ĝisdatigi. La ĝisdatiga procezo povas daŭri pli ol 10 minutojn por kompletigi

© 2023 Liquid Instruments. rezervita.

laudinstruments.com

Dokumentoj/Rimedoj

LIQUID INSTRUMENTS MATLAB API Integration Fuzes [pdf] Uzantogvidilo MATLAB API, MATLAB API Integration Fuses, Integration Fuses, Fuzes

Referencoj

• Uzanto Manlibro