VLOEIBARE INSTRUMENTE MATLAB API Integrasie Sekerings

MATLAB API-migrasiegids

Die opgradering van Moku: Lab na sagteware weergawe 3.0 ontsluit 'n magdom nuwe kenmerke. Wanneer hulle bywerk, moet API-gebruikers ekstra stappe doen om hul skrifte na die nuwe Moku API-pakket te migreer. Hierdie migrasiegids gee 'n uiteensetting van API-veranderinge, nuwe kenmerke wat beskikbaar is in die weergawe 3.0-opdatering, en enige beperkings op terugwaartse versoenbaarheid.

verbyview

Moku:Lab-sagtewareweergawe 3.0 is 'n belangrike opdatering wat nuwe firmware, gebruikerskoppelvlak en AP's na Moku:Lab-hardeware bring. Die opdatering bring Moku:Lab in lyn met Moku:Pro en Moku:Go, wat dit maklik maak om skrifte oor alle Moku-platforms te deel. Die opdatering ontsluit 'n magdom nuwe kenmerke vir baie van die bestaande instrumente. Dit voeg ook twee nuwe kenmerke by: Multi-instrument Mode en Moku Cloud Compile. Daar is ook 'n paar subtiele gedragsverskille, uiteengesit in die Terugwaartse versoenbaarheid-afdeling.

Dit is 'n groot opdatering wat die API-argitektuur beïnvloed, en daarom sal die nuwe MATLAB API v3.0-pakket nie agteruit versoenbaar wees met bestaande MATLAB-skrifte nie. API-gebruikers sal hul skrifte na die nuwe Moku API-pakket moet oordra as hulle hul Moku:Lab na weergawe 3.0 opgradeer. API-gebruikers met beduidende pasgemaakte sagteware-ontwikkeling moet die vlak van moeite wat nodig is om hul bestaande kode oor te dra, noukeurig oorweeg. Moku:Lab 1.9 word nie aanbeveel vir nuwe ontplooiings nie en alle kliënte word aangemoedig om op te gradeer. Indien probleme na die opgradering ontstaan, sal gebruikers die opsie hê om af te gradeer na sagteware weergawe 1.9.

Hierdie migrasiegids gee 'n uiteensetting van advantage van opdatering en moontlike komplikasies na Moku:Lab weergawe 3.0. Dit skets ook die proses om die MATLAB API op te gradeer en hoe om jou Moku:Lab af te gradeer indien nodig.

Weergawe 3.0 nuwe funksies

Nuwe kenmerke

Sagtewareweergawe 3.0 bring Multi-Instrument Mode en Moku Cloud Compile vir die eerste keer na Moku:Lab, sowel as baie werkverrigting- en bruikbaarheidsopgraderings oor die reeks instrumente.

Multi-instrument modus

Multi-instrumentmodus op Moku:Lab stel gebruikers in staat om twee instrumente gelyktydig te ontplooi om 'n pasgemaakte toetsstasie te skep. Elke instrument het volle toegang tot die analoog insette en uitsette saam met onderlinge verbindings tussen instrumentgleuwe. Die onderlinge verbindings tussen instrumente ondersteun hoëspoed, lae latensie, intydse digitale kommunikasie tot 2 Gb/s, sodat instrumente onafhanklik kan loop of gekoppel kan word om gevorderde seinverwerkingspyplyne te bou. Instrumente kan dinamies in en uit geruil word sonder om die ander instrument te onderbreek. Gevorderde gebruikers kan ook hul eie pasgemaakte algoritmes in Multi-instrument-modus gebruik deur Moku Cloud Compile te gebruik.

Moku Cloud-samestelling

Moku Cloud Compile laat jou toe om pasgemaakte DSP direk op die Moku:Lab FPGA in Multi-instrumentmodus te ontplooi. Skryf kode deur a web blaaier en stel dit in die wolk saam; Moku Cloud Compile ontplooi die bitstroom na een of meer teiken Moku-toestelle.

Ossilloskoop

• Diep geheue-modus: bespaar tot 4M samples per kanaal op volle samplingtempo (500 MSa/s)

Spektrum analiseerder

• Verbeterde geraasvloer
• Logaritmiese Vrms en Vpp skaal
• Vyf nuwe vensterfunksies (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Fasemeter

• Frekwensie offset, fase, en amplitude kan nou as analoog voltage seine
• Gebruikers kan nou DC-offset by uitsetseine voeg
• Die fase-geslote sinusgolfuitset kan nou frekwensie vermenigvuldig word tot 2 50x of afgedeel word na 125x
• Verbeterde bandwydtereeks (1 Hz tot 100 kHz)
• Gevorderde fase-omvou- en outomatiese herstelfunksies

Golfvormgenerator

• Geraas uitset
• Polswydtemodulasie (PWM)

Toesluit Amplewendiger

• Verbeterde werkverrigting van lae frekwensie PLL sluit
• Die minimum PLL-frekwensie is verlaag tot 10 Hz
• Die interne PLL sein kan nou frekwensie vermenigvuldig word tot 250x of verdeel word na 125x vir gebruik in demodulasie
• 6-syfer akkuraatheid vir fasewaardes

Frekwensie-reaksie-ontleder

• Verhoogde maksimum frekwensie van 120 MHz tot 200 MHz
• Verhoog maksimum sweeppunte van 512 na 8192
• Die Nuwe Dinamiek Amplitude funksie optimaliseer uitset sein outomaties vir die beste meting dinamiese omvang
• Nuwe ln/ln1 metingsmodus
• Invoerversadigingwaarskuwings
• Die wiskunde-kanaal ondersteun nou arbitrêre vergelykings met komplekse waardes wat die kanaalseine betrek, wat nuwe tipes komplekse oordragfunksiemetings moontlik maak
• Insetseine kan nou bykomend tot dBm in dBVpp en dBVrms gemeet word
• Die vordering van die sweep word nou op die grafiek vertoon
• Die frekwensie-as kan nou gesluit word om toevallige veranderinge tydens 'n lang veeg te voorkom

Laser Lock Box

• Die verbeterde blokdiagram toon skandering- en modulasieseinpaaie
• Die nuwe sluiting stages-funksie maak dit moontlik om die sluitprosedure aan te pas
• Verbeterde werkverrigting van lae frekwensie PLL sluit
• 6-syfer akkuraatheid vir fasewaardes
• Verbeterde werkverrigting van lae frekwensie PLL sluit
• Die minimum PLL-frekwensie is verlaag tot 10 Hz
• Die PLL sein kan nou frekwensie vermenigvuldig word tot 250x of gedeel word na 0.125x vir gebruik in demodulasie

Ander

Ondersteuning vir die sinusfunksie by die vergelykingsredigeerder gevoeg wat gebruik kan word om persoonlike golfvorms in die Arbitrary Waveform Generator te genereer

Skakel binêre LI files na CSV-, MATLAB- of NumPy-formate wanneer dit van die toestel af afgelaai word

Opgradeerde API-ondersteuning

Die nuwe Moku MATLAB API v3.0-pakket bied verbeterde funksionaliteit en stabiliteit. Dit sal gereelde opdaterings ontvang om werkverrigting te verbeter en nuwe kenmerke bekend te stel.

Terugwaartse versoenbaarheidsbeperkings

API

Die nuwe Moku MATLAB API v3.0-pakket is nie agtertoe versoenbaar met die vorige Moku:Lab MATLAB v1.9-pakket nie. Die MATLAB scripting argumente en terugkeer waardes is heeltemal anders. As jy uitgebreide pasgemaakte sagteware-ontwikkeling het wat die Moku:Lab MATLAB gebruik, oorweeg die impak van die migreer van al jou sagteware om versoenbaar te wees met die nuwe API.

Terwyl die Moku:Lab MATLAB-pakket nie meer opdaterings sal ontvang nie, sal Liquid Instruments steeds ondersteuning bied aan gebruikers wat nie na die nuwe API-pakket kan migreer nie.

Vind gedetailleerde examples vir elke instrument in die nuwe Moku MATLAB API v3.0-pakket om te dien as 'n basislyn vir die omskakeling van vorige MATLAB-ontwikkeling na die nuwe API-pakket.

Regressies

RAM-skyf vir dataregistrasie

Weergawe 1.9 het 'n 512 MB gehad filestelsel in die toestel se RAM, wat gebruik kan word om data by hoë s aan te tekenampling tariewe. In weergawe 3.0 is aanteken by RAM nie meer beskikbaar nie. Om dataregistrasie te aktiveer, word 'n SD-kaart benodig. Gevolglik verander die maksimum verkrygingspoed ook. Weergawe 1.9 ondersteun tot 1 MSa/s, terwyl weergawe 3.0 tot 250 kSa/s by 1 kanaal en 125 kSa/s by 2 kanale ondersteun. Selfs teen laer snelhede en met 'n SD-kaart, sal werkvloeie wat ingesluit het die stoor van verskeie hoëspoedlogboeke in RAM en dan later na die SD-kaart of die kliënt kopieer, nie meer ondersteun word nie.

Data aanteken na CSV

Weergawe 1.9 het die vermoë gehad om data direk na 'n CSV te stoor file terwyl jy aanteken. Hierdie kenmerk is nie direk beskikbaar op weergawe 3.0 nie. Gebruikers wie se werkvloei die stoor van CSV ingesluit hetfiles direk na 'n SD-kaart of die kliënt sal nou eers die binêre moet omskakel file na CSV, óf met behulp van die kliënt-toepassing óf deur die selfstandige Liquid Instruments te installeer File Omskakeling na die rekenaar wat hulle vir dataverwerking gebruik.

Nie-terugversoenbare veranderinge

Dataskaal in LIA

In weergawe 1.9 het ons dataskaal geïmplementeer sodat die vermenigvuldiging van twee 0.1 V GS-seine 'n 0.02 V GS-uitset tot gevolg gehad het. In weergawe 3.0 het ons dit so verander dat die resultaat 0.01 V DC was, wat meer in lyn is met kliënte se intuïtiewe verwagtinge.

Golfvormgenerator-uitset moet geaktiveer word om as modulasiebron/sneller te gebruik

In weergawe 1.9 kan 'n ander kanaal se golfvorm as 'n modulasie- of snellerbron in die golfvormgenerator gebruik word, selfs al was daardie kanaal se uitset gedeaktiveer. Dit is in weergawe verwyder

• Gebruikers wat kruismodulasie wil doen sonder om die uitsette van hul toestel te ontkoppel, sal hul

Moku MATLAB API

Die Moku MATLAB API v3.0-pakket is bedoel om MATLAB-ontwikkelaars die hulpbronne te voorsien wat nodig is om enige Moku-toestel te beheer en uiteindelik die vermoë om hierdie kontroles in groter eindgebruikertoepassings te inkorporeer. Die nuwe Moku MATLAB API v3.0-pakket bied die volgende:

• Ten volle funksionele bvample MATLAB skrifte vir elkeen
• Alle MATLAB-skrifte word van kommentaar voorsien, wat maklik is om te verstaan ​​en kan dien as 'n eindgebruiker se beginpunt vir aanpassing en
• 'n Stel funksies wat volle beheer oor die Moku bied

Tans ondersteunde instrumente

1. Arbitrêre golfvormgenerator
2. Datalogger
3. Digitale filterkas
4. FIR Filter Bouer
5. Frekwensie-reaksie-ontleder
6. Laser Lock Box
7. Toesluit Amplewendiger
8. Ossilloskoop
9. Fasemeter
10. PID-beheerder
11. Spektrum analiseerder
12. Golfvormgenerator
13. Multi-instrument modus
14. Moku Cloud-samestelling

Installasie

Vereistes

• MATLAB weergawe 2015 of later

As jy reeds 'n vorige weergawe van die Moku MATLAB API geïnstalleer het, verwyder dit asseblief voordat jy voortgaan. U kan die pakket van die Byvoegingsbestuurder verwyder.

1. Maak die Byvoegingsbestuurder oop deur die Tuis > Omgewing-oortjie.
2. Soek vir Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Alternatiewelik kan jy die gereedskapkas direk vanaf die Liquid Instruments aflaai webwebwerf by https://www.liquidinstruments.com/products/apis/matlab-api/. Jy sal die soekpad met die hand moet stel as jy dit doen.
4. Kontroleer dat die korrekte pad by die gereedskapkas gevoeg is deur 'Stel pad' van die Tuis > Omgewing-oortjie te kies.
5. Maak seker dat daar 'n inskrywing is wat na die gereedskapkas-installasieplek wys. 'n Tipiese pad kan CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB wees.
6. Laai die instrumentdata af files deur 'moku_download####) in die MATLAB-opdragvenster te tik. Die ### moet vervang word met jou huidige firmware weergawe. Yol kan jou huidige firmware-weergawe vind deur die Moku: lessenaar-toepassing deur regs te klik op jou Moku en 'Toestelinligting' te beweeg, of in die iPad-toepassing deur lank op jou Moku te druk.
7. Bevestig jou gereedskapkas is korrek opgestel deur 'help Moku' in die MATLAB-opdragvenster in te tik. As hierdie opdrag slaag. dan is die gereedskapkas suksesvol geïnstalleer

Moku API veranderinge

Die nuwe Moku MATLAB API-argitektuur verskil genoegsaam van sy voorganger en is dus nie agtertoe versoenbaar met bestaande API-skrifte nie. Die volgende vereenvoudigde ossilloskoop bvample toon die verskille tussen die nalatenskap en nuwe API-pakkette en dien as 'n padkaart vir die oordrag van bestaande kode.

Ossilloskoop bvample

Volgorde stappe

1. Voer die Moku MATLAB API 3.0 in
2. Eis die Moku-eienaarskap op en laai die ossilloskoop-bitstroom op na
3. Stel tydbasis en stel die linker- en regterkantse span vir die tyd-as.
4. Kry data, verkry 'n enkele raam van die data van die ossilloskoop
5. Beëindig kliëntsessie deur die Moku-eienaarskap prys te gee

Die volgorde hierbo beskryf is 'n vereenvoudigde eksample om die verskille tussen die nalatenskap en nuwe API-pakkette te illustreer. Afgesien van die begin van 'n kliëntsessie, die oplaai van 'n instrument-bitstroom na Moku, en die beëindiging van die kliëntsessie, kan 'n eindgebruiker enige aantal funksies in verskillende volgorde uitoefen om aan die behoeftes van hul toepassing te voldoen.

Verskille

Hier kyk ons ​​na die verskille tussen die twee AP's vir elke stap in die volgorde.

Eis Moku-eienaarskap op en laai die ossilloskoop-bitstroom op na die toestel. In vergelyking met Moku MATLAB 1.9, het die nuwe API heeltemal verskillende funksies:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Funksie	kry_by_naam()	deploy_or_connect ect()	Ossilloskoop()
Toegelate velde en waardes	naam: string timeout: float	instrument: die klas van die instrument wat wil ontplooi	ip: string reeks: string
	krag: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			aanhou_toestand: bool
			connect_timeout: float
			read_timeout: dryf

 

1. Stel tydbasis in. Die funksie is dieselfde, maar die toegelate argumente verskil effens:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funksie	stel_tydbasis()	stel_tydbasis()
   Toegelate velde en waardes	t1: dryf t2: dryf	t1: float t2:float streng: bool

2. Kry data. Die funksies en die toegelate argumente is dieselfde, maar die datatipe en lengte wat teruggestuur word verskil:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funksie	kry_data()	kry_data()
   Toegelate velde en waardes	timeout: float wag: bool	timeout: float wait_reacquire: bool
   Terugkeer lengte	16383 punte per raam	1024 punte per raam

3. Stel die Moku-eienaarskap vry:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Funksie	sluit()	relinquish_ownership()

Ossilloskoop funksies lys

Moku MATLAB 1.9	Moku MATLAB 3.0
stel_bronO	stel_bronneO
stel_triggerO	stel_triggerO
kry_dataQ	kry_dataQ
set_frontendQ	set_frontendQ
set_defau!tsQ set_timebaseO stel_xmodeQ	set_defau!tsQ set_timebaseQ disable_inputO enable_rollmodeQ
set_precision_modeQ	stel_verkrygingsmodusQ
sync_faseQ	sync_output_phaseQ
kry_frontendQ	kry_frontendQ
kry_samp!erateO kry_rea!tyd_dataQ	kry_samp!erateO stoor_hoë_res_bufferO
gen_rampgolf O gen_sinewaveO	genereer_golfvormO kry_verkrygingsmodusQ
gen_squarewaveQ	kry_bronneQ
gen_afQ	kry_tydbasisQ kry_afvoer_!oadQ
stel_sampleerQ set_framerateQ	kry_interpo!asieO stel_afvoer_!oadQ
	stel_hystereseQ stel_interpo!asieO
	set_input_attenuationO
	stel_bronO osc_measurementQ
	opsommingQ

Die Moku MATLAB API is gebaseer op Moku API. Vir volledige Moku API-dokumentasie, verwys na die Moku API-verwysing wat hier gevind word https://apis.liq uidinstrume nts.com/re fe rence/.

Bykomende besonderhede om met Moku MATLAB API te begin kan gevind word by https://a pis.liquid instruments.com/sta gradering- Matlab.tuis

Afgraderingsproses

As die opgradering na weergawe 3.0 bewys het om iets krities vir jou toepassing te beperk of andersins nadelig te beïnvloed, kan jy afgradeer na die vorige weergawe 1.9. Dit kan gedoen word deur a web blaaier.

Trappe

1. Kontak Liquid Instruments en verkry die file vir firmware weergawe 9.
2. Tik jou Moku:Lab IP-adres in 'n web blaaier (sien skermskoot).
3. Onder Update Firmware, blaai en kies die firmware file verskaf deur Liquid Instruments.
4. Kies Laai op en werk op. Die opdateringsproses kan meer as 10 minute neem om te voltooi

© 2023 Liquid Instruments. voorbehou.

laudinstruments.com

Dokumente / Hulpbronne

VLOEIBARE INSTRUMENTE MATLAB API Integrasie Sekerings [pdf] Gebruikersgids MATLAB API, MATLAB API Integrasie Sekerings, Integrasie Sekerings, Sekerings

Verwysings

• Gebruikershandleiding