LIQUID INSTRUMENTS MATLAB API integratsioonikaitsmed

MATLAB API migratsioonijuhend

Moku: Labi uuendamine tarkvaraversioonile 3.0 avab hulga uusi funktsioone. Värskendamise ajal peavad API kasutajad astuma täiendavaid samme oma skriptide uude Moku API paketti migreerimiseks. Selles migratsioonijuhendis kirjeldatakse API muudatusi, versiooni 3.0 värskenduses saadaolevaid uusi funktsioone ja kõiki tagasiühilduvuse piiranguid.

Läbiview

Moku:Lab tarkvara versioon 3.0 on suur värskendus, mis toob Moku:Labi riistvarasse uue püsivara, kasutajaliidese ja APl-d. Värskendus viib Moku:Labi kooskõlla Moku:Pro ja Moku:Go-ga, muutes skriptide jagamise kõigil Moku platvormidel lihtsaks. Värskendus avab paljudele olemasolevatele instrumentidele hulga uusi funktsioone. See lisab ka kaks uut funktsiooni: mitme instrumendi režiim ja Moku Cloud Compile. Samuti on mõningaid peeneid käitumiserinevusi, mis on välja toodud tagasiühilduvuse jaotises.

See on suur uuendus, mis mõjutab API arhitektuuri ja seetõttu ei ühildu uus MATLAB API v3.0 pakett olemasolevate MATLAB-i skriptidega. API kasutajad peavad oma skriptid portima uude Moku API paketti, kui nad uuendavad oma Moku:Lab versioonile 3.0. Märkimisväärse kohandatud tarkvaraarendusega API kasutajad peaksid hoolikalt kaaluma olemasoleva koodi teisaldamiseks vajalikku pingutust. Moku:Lab 1.9 ei ole uute juurutuste jaoks soovitatav ja kõiki kliente julgustatakse uuendama. Kui pärast täiendamist ilmnevad probleemid, on kasutajatel võimalus minna üle tarkvaraversioonile 1.9.

Selles migratsioonijuhendis kirjeldatakse ettetagMoku:Lab versiooni 3.0 värskendamise ja võimalike tüsistuste kohta. Samuti kirjeldatakse selles MATLAB API uuendamise protsessi ja seda, kuidas vajadusel Moku:Lab alandada.

Versiooni 3.0 uued funktsioonid

Uued funktsioonid

Tarkvaraversioon 3.0 toob esmakordselt Moku:Labisse Multi-Instrument Mode ja Moku Cloud Compile, samuti palju jõudluse ja kasutatavuse uuendusi kogu instrumentide komplektis.

Mitme instrumendi režiim

Moku:Labi mitme instrumendi režiim võimaldab kasutajatel kohandatud katsejaama loomiseks kasutada korraga kahte instrumenti. Igal instrumendil on täielik juurdepääs analoogsisenditele ja -väljunditele ning instrumendipesade vahelistele ühendustele. Instrumentidevahelised ühendused toetavad kiiret, madala latentsusega reaalajas digitaalset sidet kuni 2 Gb/s, nii et instrumendid võivad töötada iseseisvalt või olla ühendatud täiustatud signaalitöötluse torujuhtmete ehitamiseks. Instrumente saab dünaamiliselt sisse ja välja vahetada ilma teist instrumenti katkestamata. Kogenud kasutajad saavad kasutada ka oma kohandatud algoritme mitme instrumendi režiimis, kasutades Moku Cloud Compile'i.

Moku pilve koostamine

Moku Cloud Compile võimaldab teil juurutada kohandatud DSP otse Moku:Lab FPGA-le mitme instrumendi režiimis. Kirjutage kood kasutades a web brauser ja kompileerige see pilves; Moku Cloud Compile juurutab bitivoo ühte või mitmesse Moku sihtseadmesse.

Ostsilloskoop

• Sügav mälurežiim: säästa kuni 4M sampvähem kanali kohta täis samplingu kiirus (500 MSa/s)

Spectrum Analyzer

• Täiustatud mürapõrand
• Logaritmiline Vrms ja Vpp skaala
• Viis uue akna funktsiooni (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Faasimõõtur

• Sagedusnihe, faas ja amplitude saab nüüd väljastada analoog voltage signaale
• Kasutajad saavad nüüd lisada väljundsignaalidele alalisvoolu nihke
• Faasilukustatud siinuslaine väljundit saab nüüd sagedust korrutada kuni 2x või jagada alla 50x
• Täiustatud ribalaiuse vahemik (1 Hz kuni 100 kHz)
• Täiustatud faasimähise ja automaatse lähtestamise funktsioonid

Lainekuju generaator

• Müra väljund
• Impulsi laiuse modulatsioon (PWM)

Lukustus Ampelujõulisem

• Parem madalsageduslik jõudlus PLL lukustamine
• Minimaalne PLL sagedus on alandatud 10 Hz-ni
• Sisemist PLL-signaali saab nüüd sagedusega korrutada kuni 250x või jagada 125x, et kasutada seda demodulatsioonis
• Faasiväärtuste 6-kohaline täpsus

Sagedusvastuse analüsaator

• Maksimaalne sagedus on suurendatud 120 MHz-lt 200 MHz-ni
• Suurendage maksimaalseid pühkimispunkte 512-lt 8192-le
• Uus dünaamika AmpLiitude funktsioon optimeerib väljundsignaali automaatselt parima mõõtmisdünaamilise ulatuse saavutamiseks
• Uus ln/ln1 mõõterežiim
• Sisendküllastuse hoiatused
• Matemaatikakanal toetab nüüd suvalisi kompleksväärtusega võrrandeid, mis hõlmavad kanali signaale, võimaldades uut tüüpi keeruliste ülekandefunktsioonide mõõtmisi
• Sisendsignaale saab nüüd mõõta lisaks dBm-le ka dBVpp ja dBVrms
• Pühkimise edenemine kuvatakse nüüd graafikul
• Sagedustelje saab nüüd lukustada, et vältida juhuslikke muutusi pika pühkimise ajal

Laserlukukarp

• Täiustatud plokkskeem näitab skaneerimis- ja modulatsioonisignaali teid
• Uus lukustus stages funktsioon võimaldab lukustusprotseduuri kohandada
• Parem madalsageduslik jõudlus PLL lukustamine
• Faasiväärtuste 6-kohaline täpsus
• Parem madalsageduslik jõudlus PLL lukustamine
• Minimaalne PLL sagedus on alandatud 10 Hz-ni
• The PLL signaali saab nüüd sagedust korrutada kuni 250x või jagada alla 0.125x, et kasutada seda demodulatsioonis

muud

Võrrandiredaktorile on lisatud siinusfunktsiooni tugi, mida saab kasutada kohandatud lainekujude genereerimiseks suvalise lainekuju generaatoris

Teisenda binaarne LI files seadmest allalaadimisel CSV-, MATLAB- või NumPy-vormingusse

Täiendatud API tugi

Uus Moku MATLAB API v3.0 pakett pakub täiustatud funktsionaalsust ja stabiilsust. Seda värskendatakse regulaarselt, et parandada jõudlust ja tutvustada uusi funktsioone.

Tagasiühilduvuse piirangud

API

Uus Moku MATLAB API v3.0 pakett ei ühildu tagasi eelmise Moku:Lab MATLAB v1.9 paketiga. MATLAB-i skriptimise argumendid ja tagastusväärtused on täiesti erinevad. Kui teil on laialdane kohandatud tarkvaraarendus, kasutades Moku:Lab MATLAB-i, kaaluge kogu oma tarkvara uue API-ga ühilduvuse mõju.

Kuigi pakett Moku:Lab MATLAB enam värskendusi ei saa, jätkab Liquid Instruments toe pakkumist kasutajatele, kes ei saa uuele API paketile üle minna.

Otsige üksikasjalikku ntamples iga instrumendi jaoks uues Moku MATLAB API v3.0 paketis, et olla aluseks varasema MATLABi arenduse teisendamiseks uueks API paketiks.

Regressioonid

RAM ketas andmete logimiseks

Versioonil 1.9 oli 512 MB filesüsteemi seadme RAM-is, mida saab kasutada andmete logimiseks kõrgetel s-delampmolva määrad. Versioonis 3.0 pole RAM-i logimine enam saadaval. Andmete logimise lubamiseks on vaja SD-kaarti. Sellest lähtuvalt muutub ka maksimaalne kogumiskiirus. Versioon 1.9 toetab kiirust kuni 1 MSa/s, samas kui versioon 3.0 toetab kuni 250 kSa/s ühel kanalil ja 1 kSa/s kahel kanalil. Isegi madalamal kiirusel ja SD-kaardiga ei toetata enam töövooge, mis hõlmasid mitme kiire logi salvestamist RAM-i ja nende hilisemat kopeerimist SD-kaardile või kliendile.

Andmete logimine CSV-sse

Versioonil 1.9 oli võimalus andmeid otse CSV-sse salvestada file metsaraie ajal. See funktsioon pole versioonis 3.0 otseselt saadaval. Kasutajad, kelle töövoog hõlmas CSV salvestamistfiles otse SD-kaardile või klient peab nüüd esmalt binaarfaili teisendama file CSV-sse, kasutades kas kliendirakendust või installides eraldiseisvad Liquid Instruments File Teisendage arvutisse, mida nad kasutavad andmetöötluseks.

Tagasiühilduvad muudatused

Andmete skaleerimine LIA-s

Versioonis 1.9 rakendasime andmete skaleerimise nii, et kahe 0.1 V alalisvoolu signaali korrutamisel saadi 0.02 V alalisvoolu väljund. Versioonis 3.0 muutsime seda nii, et tulemuseks oli 0.01 V DC, mis vastab rohkem klientide intuitiivsetele ootustele.

Modulatsiooniallika/päästikuna kasutamiseks peab lainekuju generaatori väljund olema lubatud

Versioonis 1.9 saab lainekuju generaatoris modulatsiooni- või päästikallikana kasutada erineva kanali lainekuju, isegi kui selle kanali väljund oli keelatud. See eemaldati versioonist

• Kasutajad, kes soovivad teha ristmodulatsiooni ilma seadme väljundeid lahti ühendamata, peaksid oma

Moku MATLAB API

Moku MATLAB API v3.0 pakett on mõeldud selleks, et pakkuda MATLAB-i arendajatele ressursse, mida on vaja mis tahes Moku seadme juhtimiseks ja lõpuks ka võimalust lisada need juhtelemendid suurematesse lõppkasutaja rakendustesse. Uus Moku MATLAB API v3.0 pakett pakub järgmist:

• Täiesti funktsionaalne eksample MATLAB skriptid iga jaoks
• Kõik MATLAB-i skriptid on varustatud kommentaaridega, mida on lihtne mõista ja mis võivad olla lõppkasutaja kohandamise ja kohandamise lähtepunktiks.
• Funktsioonide komplekt, mis tagab täieliku kontrolli Moku üle

Hetkel toetatavad instrumendid

1. Suvaline lainekuju generaator
2. Andmelogija
3. Digitaalne filtrikast
4. FIR-filtri ehitaja
5. Sagedusvastuse analüsaator
6. Laserlukukarp
7. Lukustus Ampelujõulisem
8. Ostsilloskoop
9. Faasimõõtur
10. PID kontroller
11. Spectrum Analyzer
12. Lainekuju generaator
13. Mitme instrumendi režiim
14. Moku pilve koostamine

Paigaldamine

Nõuded

• MATLAB versioon 2015 või uuem

Kui teil on juba installitud Moku MATLAB API eelmine versioon, desinstallige see enne jätkamist. Saate paketi desinstallida lisandmoodulite haldurist.

1. Avage lisandmoodulite haldur vahekaardi Kodu > Keskkond kaudu.
2. Otsi Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Teise võimalusena saate tööriistakasti alla laadida otse Liquid Instrumentsist websait aadressil https://www.liquidinstruments.com/products/apis/matlab-api/. Kui teete seda, peate otsingutee käsitsi määrama.
4. Kontrollige, kas tööriistakasti on lisatud õige tee, valides vahekaardilt Kodu > keskkond käsku Määra tee.
5. Veenduge, et oleks olemas sisend, mis osutab tööriistakasti paigalduskohale. Tüüpiline tee võib olla CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Laadige alla instrumendi andmed files tippides MATLAB-i käsuaknasse 'moku_download####). ### tuleks asendada teie praeguse püsivara versiooniga. Yol leiab teie praeguse püsivara versiooni Moku: töölauarakenduse kaudu, paremklõpsates oma Mokul ja hõljutades kursorit „Seadme teave”, või iPadi rakenduses, vajutades pikalt oma Mokut.
7. Veenduge, et teie tööriistakast on õigesti seadistatud, tippides MATLAB-i käsuaknasse "help Moku". Kui see käsk õnnestub. siis on tööriistakast edukalt installitud

Moku API muudatused

Uus Moku MATLAB API arhitektuur erineb piisavalt oma eelkäijast ega ühildu seetõttu tagasiulatuvalt olemasolevate API skriptidega. Järgmine lihtsustatud ostsilloskoop example näitab erinevusi pärand ja uute API pakettide vahel ning toimib teekaardina olemasoleva koodi teisaldamiseks.

Ostsilloskoop example

Järjestuse sammud

1. Importige Moku MATLAB API 3.0
2. Taotlege Moku omandiõigust ja laadige Oscilloscope'i bitivoog üles
3. Seadke ajabaas ja määrake ajatelje vasak- ja parempoolne ulatus.
4. Hankige andmeid, hankige ostsilloskoobist üks andmete kaader
5. Lõpetage kliendiseanss Moku omandiõigusest loobumisega

Ülalkirjeldatud järjestus on lihtsustatud näideample, et illustreerida erinevusi vanade ja uute API pakettide vahel. Peale kliendiseansi alustamise, instrumendi bitivoo Mokusse üleslaadimise ja kliendiseansi lõpetamise saab lõppkasutaja oma rakenduse vajaduste rahuldamiseks kasutada mis tahes arvu funktsioone.

Erinevused

Siin vaatleme kahe APl erinevusi järjestuse iga etapi jaoks.

Taotlege Moku omandiõigust ja laadige Oscilloscope'i bitivoog seadmesse üles. Võrreldes Moku MATLAB 1.9-ga on uuel API-l täiesti erinevad funktsioonid:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Funktsioon	get_by_name()	juurutamine_või_ühendus ect()	Ostsilloskoop ()
Lubatud väljad ja väärtused	nimi: string timeout: float	instrument: selle instrumendi klass, mida soovite kasutusele võtta	ip: string jada: string
	jõud: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: float
			read_timeout: float

 

1. Määrake ajabaas. Funktsioon on sama, kuid lubatud argumendid on veidi erinevad:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funktsioon	set_timebase()	set_timebase()
   Lubatud väljad ja väärtused	t1: ujuki t2: ujuki	t1: float t2: float range: bool

2. Hankige andmeid. Funktsioonid ja lubatud argumendid on samad, kuid tagastatud andmetüüp ja pikkus on erinevad:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funktsioon	hanki_andmed()	hanki_andmed()
   Lubatud väljad ja väärtused	timeout: float oota: bool	timeout: float oota_reacquire: bool
   Tagastamise pikkus	16383 punkti kaadri kohta	1024 punkti kaadri kohta

3. Moku omandiõiguse vabastamine:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Funktsioon	sulge ()	loovuta_omandiõigus()

Ostsilloskoobi funktsioonide loend

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
sync_phaseQ	sync_output_phaseQ
get_frontendQ	get_frontendQ
get_samp!erateO get_rea!time_dataQ	get_samp!erateO save_high_res_bufferO
gen_ramplaineO gen_sinewaveO	genereeri_lainekujuO get_acquisition_modeQ
gen_squarewaveQ	hanki_allikadQ
gen_offQ	get_timebaseQ get_output_!oadQ
set_samplerateQ set_framerateQ	get_interpo!ationO set_output_!oadQ
	set_hysteresisQ set_interpo!ationO
	set_input_attenuationO
	set_sourceO osc_measurementQ
	kokkuvõteQ

Moku MATLAB API põhineb Moku API-l. Täieliku Moku API dokumentatsiooni saamiseks vaadake Moku API viidet, mis leiate siit https://apis.liq uidinstrume nts.com/re fe rence/.

Lisateavet Moku MATLAB API-ga alustamise kohta leiate aadressilt https://a pis.liquid instruments.com/sta hinnang- Matlab.koju

Ülemineku protsess

Kui versiooni 3.0 täiendamine piirab või muul viisil kahjustab teie rakenduse jaoks olulist, võite minna üle eelmisele versioonile 1.9. Seda saab teha läbi a web brauser.

Sammud

1. Võtke ühendust Liquid Instrumentsiga ja hankige file püsivara versiooni 9 jaoks.
2. Sisestage oma Moku:Lab IP-aadress a web brauser (vt ekraanipilti).
3. Sirvige jaotises Uuenda püsivara ja valige püsivara file pakub Liquid Instruments.
4. Valige Laadi üles ja värskenda. Värskendusprotsess võib kesta rohkem kui 10 minutit

© 2023 Liquid Instruments. reserveeritud.

laudinstruments.com

Dokumendid / Ressursid

LIQUID INSTRUMENTS MATLAB API integratsioonikaitsmed [pdfKasutusjuhend MATLAB API, MATLAB API integratsioonikaitsmed, integratsioonikaitsmed, kaitsmed

Viited

• Kasutusjuhend