LIQUID INSTRUMENTS MATLAB API Yntegraasje Fuses
MATLAB API Migraasje Guide
It opwurdearjen fan Moku: Lab nei softwareferzje 3.0 ûntsluten in gasthear fan nije funksjes. By it bywurkjen moatte API-brûkers ekstra stappen nimme om har skripts te migrearjen nei it nije Moku API-pakket. Dizze migraasjegids sketst API-feroarings, nije funksjes beskikber yn 'e ferzje 3.0-fernijing, en alle beheiningen foar efterútkompatibiliteit.
Oerview
Moku: Lab-softwareferzje 3.0 is in wichtige fernijing dy't nije firmware, brûkersynterface en APls bringt nei Moku:Lab-hardware. De fernijing bringt Moku:Lab yn oerienstimming mei Moku:Pro en Moku:Go, wêrtroch it maklik is om skripts te dielen oer alle Moku-platfoarms. De fernijing ûntsluten in gasthear fan nije funksjes foar in protte fan 'e besteande ynstruminten. It foeget ek twa nije funksjes ta: Multi-instrument Mode en Moku Cloud Compile. D'r binne ek wat subtile gedrachsferskillen, sketst yn 'e seksje Backward komptabiliteit.
Dit is in grutte update dy't de API-arsjitektuer beynfloedet, en dêrom sil it nije MATLAB API v3.0-pakket net efterút kompatibel wêze mei besteande MATLAB-skripts. API-brûkers sille har skripts moatte portearje nei it nije Moku API-pakket as se har Moku:Lab opwurdearje nei ferzje 3.0. API-brûkers mei signifikante oanpaste softwareûntwikkeling moatte soarchfâldich beskôgje it nivo fan ynspanning dat nedich is om har besteande koade te portearjen. Moku: Lab 1.9 wurdt net oanrikkemandearre foar nije ynset en alle klanten wurde stimulearre om te upgrade. As problemen ûntsteane nei it opwurdearjen, sille brûkers de opsje hawwe om te downgraden nei softwareferzje 1.9.
Dizze migraasjegids sketst advantages fan bywurkjen en mooglike komplikaasjes nei Moku: Lab ferzje 3.0. It sketst ek it proses om de MATLAB API te upgrade en hoe jo jo Moku:Lab as nedich kinne downgrade.
Ferzje 3.0 nije funksjes
Nije funksjes
Softwareferzje 3.0 bringt Multi-Instrument Mode en Moku Cloud Compile foar it earst nei Moku: Lab, lykas ek in protte prestaasjes en brûkberensupgrades oer de suite fan ynstruminten.
Multi-ynstrumint Mode
Multi-ynstrumintmodus op Moku: Lab kinne brûkers twa ynstruminten tagelyk ynsette om in oanpast teststasjon te meitsjen. Elk ynstrumint hat folsleine tagong ta de analoge yn- en útgongen tegearre mei ferbinings tusken ynstrumint slots. De ynterferbiningen tusken ynstruminten stypje hege snelheid, lege latency, real-time digitale kommunikaasje oant 2 Gb / s, sadat ynstruminten selsstannich kinne rinne of wurde ferbûn om avansearre pipelines foar sinjaalferwurking te bouwen. Ynstruminten kinne dynamysk yn- en útwiksele wurde sûnder it oare ynstrumint te ûnderbrekken. Avansearre brûkers kinne ek har eigen oanpaste algoritmen ynsette yn Multi-instrument Mode mei Moku Cloud Compile.
Moku Cloud kompilearje
Moku Cloud Compile lit jo oanpaste DSP direkt ynsette op 'e Moku: Lab FPGA yn Multi-ynstrumintmodus. Skriuw koade mei in web browser en kompilearje it yn 'e wolk; Moku Cloud Compile set de bitstream yn op ien of mear doel Moku-apparaten.
Ossilloskoop
- Djippe ûnthâldmodus: bewarje oant 4M samples per kanaal op folsleine sampling rate (500 MSa/s)
Spektrumanalysator
- Ferbettere lûd flier
- Logaritmyske Vrms en Vpp skaal
- Fiif nije finsterfunksjes (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)
Fasemeter
- Frekwinsje offset, faze, en amplitude kin no wurde útfierd as analog voltage sinjalen
- Brûkers kinne no DC-offset tafoegje oan útfiersinjalen
- De faze-beskoattele sinusgolfútfier kin no frekwinsje fermannichfâldige wurde oant 2 50x of ferdield nei 125x
- Ferbettere bânbreedteberik (1 Hz oant 100 kHz)
- Avansearre faze-wraping en auto-resetfunksjes
Waveform Generator
- Noise útfier
- Pulse Wide Modulation (PWM)
Ynslute Amplibbener
- Ferbettere prestaasjes fan lege frekwinsje PLL slot
- De minimale PLL-frekwinsje is fermindere nei 10 Hz
- It ynterne PLL-sinjaal kin no frekwinsje fermannichfâldige wurde oant 250x of ferdield nei 125x foar gebrûk yn demodulaasje
- 6-sifers precision foar faze wearden
Frequency Response Analyzer
- Ferhege maksimale frekwinsje fan 120 MHz nei 200 MHz
- Ferheegje maksimale sweeppunten fan 512 nei 8192
- The New Dynamic Amplitude funksje optimizes útfier sinjaal automatysk foar bêste mjitting dynamyske berik
- Nije ln/ln1 mjitmodus
- Input saturation warskôgings
- It wiskundige kanaal stipet no willekeurige fergelikingen mei komplekse wearden wêrby't de kanaalsinjalen belutsen binne, wat nije soarten mjittingen fan komplekse oerdrachtfunksje mooglik makket
- Ynfiersinjalen kinne no wurde mjitten yn dBVpp en dBVrms neist dBm
- De fuortgong fan 'e sweep wurdt no werjûn op' e grafyk
- De frekwinsje-as kin no wurde beskoattele om tafallige feroarings te foarkommen tidens in lange sweep
Laser Lock Box
- It ferbettere blokdiagram toant scan- en modulaasjesinjaalpaden
- De nije slot stages funksje kinne oanpasse it slot proseduere
- Ferbettere prestaasjes fan lege frekwinsje PLL slot
- 6-sifers precision foar faze wearden
- Ferbettere prestaasjes fan lege frekwinsje PLL slot
- De minimale PLL-frekwinsje is fermindere nei 10 Hz
- De PLL sinjaal kin no frekwinsje fermannichfâldige wurde oant 250x of ferdield nei 0.125x foar gebrûk yn demodulaasje
Oar
Stipe tafoege foar de sinusfunksje oan de fergelikingsbewurker dy't kin wurde brûkt om oanpaste golffoarmen te generearjen yn 'e willekeurige golffoarmgenerator
Konvertearje binêre LI files nei CSV-, MATLAB- of NumPy-formaten by it ynladen fan it apparaat
Upgraded API-stipe
It nije pakket Moku MATLAB API v3.0 biedt ferbettere funksjonaliteit en stabiliteit. It sil regelmjittige updates krije om prestaasjes te ferbetterjen en nije funksjes yn te fieren.
Backward komptabiliteit beheinings
API
It nije Moku MATLAB API v3.0-pakket is net efterút kompatibel mei it foarige Moku:Lab MATLAB v1.9-pakket. De MATLAB-skriptarguminten en weromwearden binne folslein oars. As jo wiidweidige oanpaste softwareûntwikkeling hawwe mei gebrûk fan de Moku:Lab MATLAB, beskôgje dan de ynfloed fan it migrearjen fan al jo software om kompatibel te wêzen mei de nije API.
Wylst it Moku:Lab MATLAB-pakket gjin updates mear sil ûntfange, sille Liquid Instruments noch trochgean mei it leverjen fan stipe foar brûkers dy't net kinne migrearje nei it nije API-pakket.
Fyn detaillearre eksamples foar elk ynstrumint yn it nije Moku MATLAB API v3.0-pakket om te tsjinjen as basisline foar it konvertearjen fan foarôfgeande MATLAB-ûntwikkeling nei it nije API-pakket.
Regressions
RAM skiif foar gegevens logging
Ferzje 1.9 hie in 512 MB filesysteem yn it apparaat syn RAM, dat koe wurde brûkt om log gegevens op hege sampling tariven. Yn ferzje 3.0 is oanmelde by RAM net mear beskikber. Foar it ynskeakeljen fan gegevenslogging is in SD-kaart nedich. Dêrtroch feroaret ek de maksimale akwisysjesnelheid. Ferzje 1.9 stipe oant 1 MSa/s, wylst ferzje 3.0 maksimaal 250 kSa/s by 1 kanaal en 125 kSa/s by 2 kanalen stipet. Sels by legere snelheden en mei in SD-kaart, workflows dy't omfette it bewarjen fan meardere hegesnelheidslogboeken nei RAM en dan letter kopiearje nei de SD-kaart as de kliïnt sille net mear wurde stipe.
Data logging nei CSV
Ferzje 1.9 hie de mooglikheid om gegevens direkt op in CSV te bewarjen file wylst logging. Dizze funksje is net direkt beskikber op ferzje 3.0. Brûkers waans workflow it opslaan fan CSV omfettefiles direkt nei in SD-kaart of de kliïnt sil no earst de binêre moatte konvertearje file nei CSV, itsij mei help fan de client app of troch it ynstallearjen fan de standalone Liquid Instruments File Converter op 'e kompjûter dy't se brûke foar gegevensferwurking.
Net-efterút-kompatible feroarings
Data skaalfergrutting yn LIA
Yn ferzje 1.9 hawwe wy gegevensskalearring ymplementearre sadat it fermannichfâldigjen fan twa 0.1 V DC-sinjalen resultearre yn in 0.02 V DC-útfier. Yn ferzje 3.0 hawwe wy dit sa feroare dat it resultaat 0.01 V DC wie, wat mear yn oerienstimming is mei de yntuïtive ferwachtingen fan klanten.
Waveform Generator-útfier moat ynskeakele wurde om te brûken as modulaasjeboarne/trigger
Yn ferzje 1.9 koe de golffoarm fan in oar kanaal brûkt wurde as modulaasje- of triggerboarne yn 'e Waveform Generator, sels as de útfier fan dat kanaal útskeakele wie. Dit waard fuortsmiten yn ferzje
- Brûkers dy't krúsmodulaasje wolle dwaan sûnder de útgongen fan har apparaat los te hoegjen, soene har oanpasse moatte
Moku MATLAB API
It pakket Moku MATLAB API v3.0 is bedoeld om MATLAB-ûntwikkelders de middels te jaan dy't nedich binne om elk Moku-apparaat te kontrolearjen en, úteinlik, de mooglikheid om dizze kontrôles op te nimmen yn gruttere ein-brûkersapplikaasjes. It nije pakket Moku MATLAB API v3.0 biedt it folgjende:
- Folslein funksjoneel eksample MATLAB skripts foar eltse
- Alle MATLAB-skripts binne foarsjoen fan opmerkings, dy't maklik te begripen binne en kinne tsjinje as in begjinpunt fan ein brûker foar oanpassing en
- In set fan funksjes dy't folsleine kontrôle leverje oer de Moku
Op it stuit stipe ynstruminten
- Willekeurige golffoarmgenerator
- Data Logger
- Digitale filterkast
- FIR Filter Bouwer
- Frequency Response Analyzer
- Laser Lock Box
- Lock-in Amplibbener
- Ossilloskoop
- Fasemeter
- PID kontrôler
- Spektrumanalysator
- Waveform Generator
- Multi-ynstrumint Mode
- Moku Cloud kompilearje
Ynstallaasje
Requirements
- MATLAB ferzje 2015 of letter
As jo al in eardere ferzje fan 'e Moku MATLAB API ynstalleare hawwe, ferwiderje dizze dan asjebleaft foardat jo trochgean. Jo kinne it pakket fuortsmite fan 'e Add-on Manager.
- Iepenje de Add-on Manager fia it ljepblêd Thús> Omjouwing.
- Sykje nei Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
- As alternatyf kinne jo de toolbox direkt downloade fan 'e Liquid Instruments website at https://www.liquidinstruments.com/products/apis/matlab-api/. Jo moatte it sykpaad manuell ynstelle as jo dit dogge.
- Kontrolearje dat it juste paad is tafoege oan 'e arkbalke troch 'Pad ynstelle' te selektearjen fan it ljepblêd Thús > Omjouwing.
- Soargje derfoar dat d'r in yngong is dy't wiist nei de ynstallaasjelokaasje fan 'e toolbox. In typysk paad kin wêze CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
- Download de ynstrumint gegevens files troch te typen 'moku_download####) yn it MATLAB Kommando-finster. De ### moat ferfongen wurde troch jo hjoeddeistige firmwareferzje. Yol kin jo hjoeddeistige firmwareferzje fine fia de Moku: buroblêd-app troch mei de rjochter te klikken op jo Moku en te hoverjen op 'Apparaatynfo', of yn 'e iPad-app troch lang op jo Moku te drukken.
- Befêstigje dat jo toolbox goed is ynsteld troch 'help Moku' yn te typen yn it MATLAB Kommando-finster. As dit kommando slagget. dan is de toolbox mei súkses ynstallearre
Moku API feroarings
De nije Moku MATLAB API-arsjitektuer is genôch oars as syn foargonger en dus net efterút kompatibel mei besteande API-skripts. De folgjende ferienfâldige Oscilloscope example toant de ferskillen tusken de legacy en nije API pakketten en tsjinnet as in road map foar it portearjen fan besteande koade.
Oscilloskoop bvample
Sequence stappen
- Ymportearje de Moku MATLAB API 3.0
- Claim it Moku-eigendom en upload de Oscilloscope-bitstream nei
- Stel de tiidbasis yn en set de lofter- en rjochterhân foar de tiidas yn.
- Krij gegevens, krije in inkeld frame fan 'e gegevens fan 'e oscilloskoop
- Beëinigje kliïntsesje troch it Moku-eigendom op te jaan
De hjirboppe beskreaune folchoarder is in ferienfâldige eksample om de ferskillen tusken de legacy en nije API-pakketten te yllustrearjen. Njonken it begjinnen fan in kliïntsesje, it uploaden fan in ynstrumintbitstream nei Moku, en it einigjen fan 'e kliïntsesje, kin in einbrûker elk oantal funksjes útoefenje yn ferskate folchoarder om te foldwaan oan 'e behoeften fan har applikaasje.
Ferskillen
Hjir sjogge wy nei de ferskillen tusken de twa APls foar elke stap yn 'e folchoarder.
Claim Moku eigendom en upload de Oscilloscope bitstream nei it apparaat. Yn ferliking mei Moku MATLAB 1.9 hat de nije API folslein oare funksjes:
| Moku MATLAB 1.9 | Moku MATLAB 3.0 | ||
| Funksje | get_by_name() | deploy_or_conn ect() | Ossilloskoop () |
| Tastiene fjilden en wearden | namme: string timeout: float | ynstrumint: de klasse fan it ynstrumint wolle ynsette | ip: string serial: string |
| krêft: bool | set_defauIt: booI | force_connect: bool | |
| use_externa I: bool | ignore_busy: bool | ||
| persist_state: bool | |||
| connect_timeout: float | |||
| read_timeout: float | |||
- Stel de tiidbasis yn. De funksje is itselde, mar de tastiene arguminten binne wat oars:
Moku MATLAB 1.9 Moku MATLAB 3.0 Funksje set_timebase() set_timebase() Tastiene fjilden en wearden t1: float t2: float t1: float t2: float strang: bool - Krij gegevens. De funksjes en de tastiene arguminten binne itselde, mar it weromjûne gegevenstype en lingte binne oars:
Moku MATLAB 1.9 Moku MATLAB 3.0 Funksje get_data() get_data() Tastiene fjilden en wearden timeout: float wachtsje: bool timeout: float wait_reacquire: bool Return lingte 16383 punten per frame 1024 punten per frame - Los it Moku-eigendom frij:
Moku MATLAB 1.9 Moku API v3.0 Funksje slute() relinquish_ownership()
Oscilloscope funksjes list
| 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 |
| set_precision_modeQ | set_acquisition_modeQ |
| sync_phaseQ | sync_output_phaseQ |
| get_frontendQ | get_frontendQ |
| krije_samp!erateO
get_rea!time_dataQ |
krije_samp!erateO
save_high_res_bufferO |
| gen_rampweach O
gen_sinewaveO |
generearje_waveformO
get_acquisition_modeQ |
| gen_squarewaveQ | get_sourcesQ |
| gen_offQ | get_timebaseQ
get_útfier_!oadQ |
| setampleare Q
set_framerateQ |
get_interpo!ationO set_útfier_!oadQ |
| set_hysteresisQ
set_interpo!ationO |
|
| set_input_attenuationO | |
| set_sourceO
osc_measurementQ |
|
| gearfettingQ |
De Moku MATLAB API is basearre op Moku API. Foar folsleine Moku API dokumintaasje, ferwize nei de Moku API Reference fûn hjir https://apis.liq uidinstrume nts.com/re fe rence/.
Oanfoljende details om te begjinnen mei Moku MATLAB API kinne fûn wurde op https://a pis.liquid instruments.com/sta wurdearring- Matlab.thús
Downgrade proses
As de upgrade nei ferzje 3.0 bewiisd hat wat kritysk foar jo applikaasje te beheinen, of oars negatyf te beynfloedzjen, kinne jo downgrade nei de foarige ferzje 1.9. Dit kin dien wurde troch in web browser.
Stappen
- Nim kontakt op mei Liquid Instruments en krije de file foar firmware ferzje 9.
- Typ jo Moku:Lab IP-adres yn in web browser (sjoch skermprint).
- Under Update Firmware, blêdzje en selektearje de firmware file fersoarge troch Liquid Instruments.
- Selektearje Upload & Update. It fernijingsproses kin mear dan 10 minuten duorje om te foltôgjen
© 2023 Liquid Instruments. reservearre.
Dokuminten / Resources
 |
LIQUID INSTRUMENTS MATLAB API Yntegraasje Fuses [pdf] Brûkersgids MATLAB API, MATLAB API Yntegraasje Fuses, Yntegraasje Fuses, Fuses |