Integracijske varovalke LIQUID INSTRUMENTS MATLAB API
Vodnik za migracijo MATLAB API
Nadgradnja Moku: Lab na različico programske opreme 3.0 odklene množico novih funkcij. Pri posodabljanju morajo uporabniki API-ja narediti dodatne korake za selitev svojih skriptov na nov paket Moku API. Ta vodnik za selitev opisuje spremembe API-ja, nove funkcije, ki so na voljo v posodobitvi različice 3.0, in morebitne omejitve združljivosti za nazaj.
konecview
Različica programske opreme Moku:Lab 3.0 je večja posodobitev, ki strojni opremi Moku:Lab prinaša novo vdelano programsko opremo, uporabniški vmesnik in APls. Posodobitev usklajuje Moku:Lab z Moku:Pro in Moku:Go, kar olajša skupno rabo skriptov na vseh platformah Moku. Posodobitev odklene številne nove funkcije za številne obstoječe instrumente. Doda tudi dve novi funkciji: Multi-instrument Mode in Moku Cloud Compile. Obstaja tudi nekaj subtilnih vedenjskih razlik, opisanih v razdelku Združljivost za nazaj.
To je velika posodobitev, ki vpliva na arhitekturo API-ja, zato novi paket MATLAB API v3.0 ne bo združljiv nazaj z obstoječimi skripti MATLAB. Uporabniki API-ja bodo morali prenesti svoje skripte v nov paket Moku API, če nadgradijo svoj Moku:Lab na različico 3.0. Uporabniki API-jev z znatnim razvojem programske opreme po meri bi morali skrbno razmisliti o stopnji napora, ki je potrebna za prenos njihove obstoječe kode. Moku:Lab 1.9 ni priporočljiv za nove uvedbe in vse stranke se spodbuja, da nadgradijo. Če se po nadgradnji pojavijo težave, bodo uporabniki imeli možnost preklopa na različico programske opreme 1.9.
Ta vodnik za selitev opisuje advantagposodobitve in morebitnih zapletov pri različici Moku:Lab 3.0. Opisuje tudi postopek nadgradnje API-ja MATLAB in kako po potrebi spremeniti Moku:Lab v nižjo različico.
Nove funkcije različice 3.0
Nove funkcije
Različica programske opreme 3.0 prvič prinaša Multi-Instrument Mode in Moku Cloud Compile v Moku:Lab, kot tudi številne nadgradnje zmogljivosti in uporabnosti celotne zbirke instrumentov.
Način za več instrumentov
Način za več instrumentov na Moku:Lab omogoča uporabnikom, da namestijo dva instrumenta hkrati, da ustvarijo testno postajo po meri. Vsak instrument ima popoln dostop do analognih vhodov in izhodov skupaj s povezavami med režami instrumentov. Medsebojne povezave med instrumenti podpirajo visoko hitrostno digitalno komunikacijo v realnem času z nizko zakasnitvijo do 2 Gb/s, tako da lahko instrumenti delujejo neodvisno ali pa jih povežete za izgradnjo naprednih cevovodov za obdelavo signalov. Instrumente je mogoče dinamično zamenjati noter in out brez prekinitve drugega instrumenta. Napredni uporabniki lahko prav tako uvedejo lastne algoritme po meri v načinu z več instrumenti z uporabo Moku Cloud Compile.
Moku Cloud Compile
Moku Cloud Compile vam omogoča uvajanje DSP-ja po meri neposredno na Moku:Lab FPGA v načinu več instrumentov. Napišite kodo z uporabo a web brskalnik in ga prevedite v oblaku; Moku Cloud Compile uvede bitni tok v eno ali več ciljnih naprav Moku.
Osciloskop
- Način globokega pomnilnika: prihranite do 4M samples na kanal pri polnem samphitrost linga (500 MSa/s)
Spektralni analizator
- Izboljšana raven hrupa
- Logaritemska Vrms in Vpp lestvica
- Pet novih okenskih funkcij (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)
Fazometer
- Frekvenčni zamik, faza in amplitude je zdaj mogoče izpisati kot analogni voltage signali
- Uporabniki lahko zdaj izhodnim signalom dodajo enosmerni odmik
- Fazno zaklenjeni sinusni izhod je zdaj mogoče frekvenco pomnožiti do 2 50x ali razdeliti na 125x
- Izboljšano območje pasovne širine (1 Hz do 100 kHz)
- Napredne funkcije za zavijanje faz in samodejne ponastavitve
Generator valovnih oblik
- Izhod hrupa
- Širinsko -impulzna modulacija (PWM)
zakleniti Amplifier
- Izboljšana zmogljivost nizkih frekvenc PLL zaklepanje
- Najmanjša frekvenca PLL je bila znižana na 10 Hz
- Notranji signal PLL je zdaj mogoče frekvenco pomnožiti do 250x ali razdeliti na 125x za uporabo pri demodulaciji
- 6-mestna natančnost za fazne vrednosti
Analizator frekvenčnega odziva
- Največja frekvenca se je povečala s 120 MHz na 200 MHz
- Povečaj največje število točk pometanja s 512 na 8192
- Nova dinamika Ampfunkcija litude samodejno optimizira izhodni signal za najboljše merilno dinamično območje
- Nov način merjenja ln/ln1
- Opozorila o nasičenosti vnosa
- Matematični kanal zdaj podpira poljubne enačbe s kompleksnimi vrednostmi, ki vključujejo kanalske signale, kar omogoča nove vrste meritev kompleksnih prenosnih funkcij
- Vhodne signale je zdaj mogoče meriti v dBVpp in dBVrms poleg dBm
- Napredek pometanja je zdaj prikazan na grafu
- Frekvenčno os je zdaj mogoče zakleniti, da preprečite nenamerne spremembe med dolgim pomikom
Škatla za lasersko ključavnico
- Izboljšan blokovni diagram prikazuje poti skeniranja in modulacije signala
- Novo zaklepanje stagTa funkcija omogoča prilagajanje postopka zaklepanja
- Izboljšana zmogljivost nizkih frekvenc PLL zaklepanje
- 6-mestna natančnost za fazne vrednosti
- Izboljšana zmogljivost nizkih frekvenc PLL zaklepanje
- Najmanjša frekvenca PLL je bila znižana na 10 Hz
- The PLL signal je zdaj mogoče frekvenco pomnožiti do 250x ali razdeliti na 0.125x za uporabo pri demodulaciji
drugo
Dodana podpora za sinusno funkcijo v urejevalnik enačb, ki se lahko uporablja za ustvarjanje valovnih oblik po meri v generatorju poljubnih valovnih oblik
Pretvori binarno LI files v formate CSV, MATLAB ali NumPy pri prenosu iz naprave
Nadgrajena podpora za API
Novi paket Moku MATLAB API v3.0 zagotavlja izboljšano funkcionalnost in stabilnost. Redno bo prejemal posodobitve za izboljšanje delovanja in uvedbo novih funkcij.
Omejitve združljivosti nazaj
API
Novi paket Moku MATLAB API v3.0 ni združljiv za nazaj s prejšnjim paketom Moku:Lab MATLAB v1.9. Argumenti skripta MATLAB in vrnjene vrednosti so popolnoma drugačni. Če imate obsežen razvoj programske opreme po meri z uporabo Moku:Lab MATLAB, razmislite o vplivu selitve vse vaše programske opreme na združljivost z novim API-jem.
Medtem ko paket Moku:Lab MATLAB ne bo več prejemal posodobitev, bo Liquid Instruments še vedno zagotavljal podporo za uporabnike, ki ne morejo migrirati na nov paket API.
Poiščite podrobno exampdatoteke za vsak instrument v novem paketu Moku MATLAB API v3.0, ki bo služil kot osnova za pretvorbo prejšnjega razvoja MATLAB v novi paket API.
Regresije
RAM disk za beleženje podatkov
Različica 1.9 je imela 512 MB filesistem v RAM-u naprave, ki bi ga lahko uporabili za beleženje podatkov pri visokih sampling stopnje. V različici 3.0 beleženje v RAM ni več na voljo. Za omogočanje beleženja podatkov je potrebna kartica SD. Skladno s tem se spremeni tudi največja hitrost zajemanja. Različica 1.9 je podpirala do 1 MSa/s, medtem ko različica 3.0 podpira do 250 kSa/s pri 1 kanalu in 125 kSa/s pri 2 kanalih. Tudi pri nižjih hitrostih in s kartico SD delovni tokovi, ki so vključevali shranjevanje več hitrih dnevnikov v RAM in nato njihovo kasnejše kopiranje na kartico SD ali odjemalca, ne bodo več podprti.
Beleženje podatkov v CSV
Različica 1.9 je imela možnost shranjevanja podatkov neposredno v CSV file med beleženjem. Ta funkcija ni neposredno na voljo v različici 3.0. Uporabniki, katerih potek dela je vključeval shranjevanje CSVfileneposredno na kartico SD ali pa bo moral odjemalec zdaj najprej pretvoriti binarno datoteko file v CSV z uporabo odjemalske aplikacije ali z namestitvijo samostojnega Liquid Instruments File Pretvornik na računalnik, ki ga uporabljajo za obdelavo podatkov.
Spremembe, ki niso združljive za nazaj
Skaliranje podatkov v LIA
V različici 1.9 smo implementirali skaliranje podatkov tako, da je pomnožitev dveh signalov 0.1 V DC povzročila izhod 0.02 V DC. V različici 3.0 smo to spremenili tako, da je bil rezultat 0.01 V DC, kar je bolj v skladu z intuitivnimi pričakovanji strank.
Izhod generatorja valovnih oblik mora biti omogočen za uporabo kot modulacijski vir/sprožilec
V različici 1.9 je bilo mogoče valovno obliko drugega kanala uporabiti kot vir modulacije ali sprožilca v Generatorju valovne oblike, tudi če je bil izhod tega kanala onemogočen. To je bilo odstranjeno v različici
- Uporabniki, ki želijo izvajati navzkrižno modulacijo, ne da bi morali odklopiti izhode svoje naprave, bi morali prilagoditi svoje
Moku MATLAB API
Paket Moku MATLAB API v3.0 je namenjen razvijalcem MATLAB zagotoviti vire, potrebne za nadzor katere koli naprave Moku, in navsezadnje možnost vključitve teh kontrol v večje aplikacije za končne uporabnike. Novi paket Moku MATLAB API v3.0 zagotavlja naslednje:
- Popolnoma funkcionalen example skripte MATLAB za vsako
- Vsi skripti MATLAB so opremljeni s komentarji, ki so lahko razumljivi in lahko končnemu uporabniku služijo kot izhodišče za prilagajanje in
- Niz funkcij, ki zagotavlja popoln nadzor nad Moku
Trenutno podprti instrumenti
- Generator poljubnih valovnih oblik
- Zapisovalnik podatkov
- Digitalna filtrirna škatla
- Graditelj filtrov FIR
- Analizator frekvenčnega odziva
- Škatla za lasersko ključavnico
- Zaklepanje Amplifier
- Osciloskop
- Fazometer
- PID krmilnik
- Spektralni analizator
- Generator valovnih oblik
- Način za več instrumentov
- Moku Cloud Compile
Namestitev
Zahteve
- MATLAB različica 2015 ali novejša
Če že imate nameščeno prejšnjo različico Moku MATLAB API, jo odstranite, preden nadaljujete. Paket lahko odstranite iz upravitelja dodatkov.
- Odprite upravitelja dodatkov prek zavihka Domov > Okolje.
- Iskanje Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
- Lahko pa tudi prenesete orodje neposredno iz Liquid Instruments webspletno mesto na https://www.liquidinstruments.com/products/apis/matlab-api/. Če to storite, boste morali pot iskanja nastaviti ročno.
- Preverite, ali je bila v orodjarno dodana pravilna pot, tako da na kartici Domov > Okolje izberete 'Nastavi pot'.
- Prepričajte se, da obstaja vnos, ki kaže na mesto namestitve orodjarne. Tipična pot je lahko CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
- Prenesite podatke instrumenta files tako, da vnesete 'moku_download####) v ukazno okno MATLAB. ### je treba zamenjati z vašo trenutno različico vdelane programske opreme. Yol lahko poišče vašo trenutno različico vdelane programske opreme prek namizne aplikacije Moku: tako, da z desnim klikom na vaš Moku in premaknete miškin kazalec na 'Device info', ali v aplikaciji iPad z dolgim pritiskom na vaš Moku.
- Potrdite, da je vaša orodjarna pravilno nastavljena, tako da v ukazno okno MATLAB vnesete 'help Moku'. Če ta ukaz uspe. potem je bil toolbox uspešno nameščen
Spremembe Moku API
Nova arhitektura Moku MATLAB API je dovolj drugačna od svoje predhodnice in zato ni združljiva nazaj z obstoječimi API skripti. Naslednji poenostavljeni osciloskop nprample prikazuje razlike med podedovanimi in novimi paketi API ter služi kot načrt za prenos obstoječe kode.
Osciloskop example
Zaporedje korakov
- Uvozite Moku MATLAB API 3.0
- Zahtevajte lastništvo Mokuja in naložite bitni tok osciloskopa na
- Nastavite časovno bazo in nastavite levo in desno razpon za časovno os.
- Pridobite podatke, pridobite en okvir podatkov iz osciloskopa
- Končajte sejo odjemalca tako, da se odpoveste lastništvu Moku
Zgoraj opisano zaporedje je poenostavljen primerample za ponazoritev razlik med podedovanimi in novimi paketi API. Poleg začetka odjemalske seje, nalaganja bitnega toka instrumenta v Moku in zaključka odjemalske seje lahko končni uporabnik izvaja poljubno število funkcij v različnem vrstnem redu, da zadosti potrebam svoje aplikacije.
razlike
Tukaj si ogledamo razlike med obema APl za vsak korak v zaporedju.
Zahtevajte lastništvo Mokuja in naložite bitni tok osciloskopa v napravo. V primerjavi z Moku MATLAB 1.9 ima novi API popolnoma drugačne funkcije:
| Moku MATLAB 1.9 | Moku MATLAB 3.0 | ||
| funkcija | get_by_name() | deploy_or_conn ect() | osciloskop() |
| Dovoljena polja in vrednosti | ime: časovna omejitev niza: float | instrument: razred instrumenta, ki ga želite uporabiti | ip: niz serijski: niz |
| sila: bool | set_defauIt: booI | prisilna_povezava: bool | |
| use_externa I: bool | ignore_busy: bool | ||
| obstojno_stanje: bool | |||
| povezava_timeout: float | |||
| read_timeout: float | |||
- Nastavite časovno bazo. Funkcija je enaka, vendar so dovoljeni argumenti nekoliko drugačni:
Moku MATLAB 1.9 Moku MATLAB 3.0 funkcija set_timebase() set_timebase() Dovoljena polja in vrednosti t1: float t2: float t1: float t2: float strict: bool - Pridobite podatke. Funkcije in dovoljeni argumenti so enaki, vendar sta vrsta in dolžina vrnjenih podatkov drugačna:
Moku MATLAB 1.9 Moku MATLAB 3.0 funkcija get_data() get_data() Dovoljena polja in vrednosti časovna omejitev: float čakati: bool časovna omejitev: float wait_reacquire: bool Dolžina povratka 16383 točk na okvir 1024 točk na okvir - Sprostite lastništvo Mokuja:
Moku MATLAB 1.9 Moku API v3.0 funkcija zapri() relinquish_ownership()
Seznam funkcij osciloskopa
| Moku MATLAB 1.9 | Moku MATLAB 3.0 |
| set_sourceO | set_sourcesO |
| nastavi_sprožilecO | nastavi_sprožilecO |
| get_dataQ | get_dataQ |
| set_frontendQ | set_frontendQ |
| set_defau!tsQ set_timebaseO
set_xmodeQ |
set_defau!tsQ set_timebaseQ onemogoči_inputO |
| set_precision_modeQ | set_acquisition_modeQ |
| faza_sinhronizacijeQ | sync_output_phaseQ |
| get_frontendQ | get_frontendQ |
| get_samp!erateO
get_rea!time_dataQ |
get_samp!erateO
save_high_res_bufferO |
| gen_rampvalO
gen_sinusni valO |
generiraj_valovno oblikoO
get_acquisition_modeQ |
| gen_squarewaveQ | get_sourcesQ |
| gen_offQ | get_timebaseQ
get_output_!oadQ |
| set_samplerateQ
set_framerateQ |
get_interpo!ationO set_output_!oadQ |
| nastavi_histerezoQ
set_interpo!ationO |
|
| set_input_attenuationO | |
| set_sourceO
osc_merjenjeQ |
|
| povzetekQ |
Moku MATLAB API temelji na Moku API. Za celotno dokumentacijo API-ja Moku glejte Referenco API-ja Moku, ki jo najdete tukaj https://apis.liq uidinstrume nts.com/re fe rence/.
Dodatne podrobnosti za začetek uporabe Moku MATLAB API lahko najdete na https://a pis.liquid instruments.com/sta ocena-Matlab.domov
Postopek znižanja
Če se je izkazalo, da nadgradnja na različico 3.0 omejuje ali kako drugače negativno vpliva na nekaj kritičnega za vašo aplikacijo, se lahko vrnete na prejšnjo različico 1.9. To je mogoče storiti prek a web brskalnik.
Koraki
- Obrnite se na podjetje Liquid Instruments in pridobite file za različico vdelane programske opreme 9.
- Vnesite svoj naslov IP Moku:Lab v a web brskalnik (glejte posnetek zaslona).
- V razdelku Posodobitev vdelane programske opreme prebrskajte in izberite vdelano programsko opremo file zagotavlja Liquid Instruments.
- Izberite Naloži in posodobi. Postopek posodobitve lahko traja več kot 10 minut
© 2023 Liquid Instruments. rezerviran.
Dokumenti / Viri
 |
Integracijske varovalke LIQUID INSTRUMENTS MATLAB API [pdf] Uporabniški priročnik MATLAB API, MATLAB API integracijske varovalke, integracijske varovalke, varovalke |