MGA LIQUID INSTRUMENTS MATLAB API Integration Fuse
Gabay sa Paglipat ng MATLAB API
Pag-upgrade ng Moku: Lab sa software na bersyon 3.0 ay nagbubukas ng maraming bagong feature. Kapag nag-a-update, ang mga user ng API ay dapat gumawa ng mga karagdagang hakbang upang i-migrate ang kanilang mga script sa bagong package ng Moku API. Binabalangkas ng gabay sa paglilipat na ito ang mga pagbabago sa API, mga bagong feature na available sa bersyon 3.0 na pag-update, at anumang pabalik na mga limitasyon sa compatibility.
Tapos naview
Ang Moku:Lab software version 3.0 ay isang pangunahing update na nagdadala ng bagong firmware, user interface, at APls sa Moku:Lab hardware. Dinadala ng update ang Moku:Lab na naaayon sa Moku:Pro at Moku:Go, na ginagawang madali ang pagbabahagi ng mga script sa lahat ng mga platform ng Moku. Ang pag-update ay nagbubukas ng maraming bagong feature sa marami sa mga kasalukuyang instrumento. Nagdaragdag din ito ng dalawang bagong feature: Multi-instrument Mode at Moku Cloud Compile. Mayroon ding ilang banayad na pagkakaiba sa pag-uugali, na nakabalangkas sa seksyong Backward compatibility.
Ito ay isang pangunahing pag-update na nakakaapekto sa arkitektura ng API, at samakatuwid ang bagong MATLAB API v3.0 package ay hindi magiging backward compatible sa mga kasalukuyang MATLAB script. Kakailanganin ng mga user ng API na i-port ang kanilang mga script sa bagong package ng Moku API kung i-upgrade nila ang kanilang Moku:Lab sa bersyon 3.0. Ang mga user ng API na may makabuluhang custom na software development ay dapat na maingat na isaalang-alang ang antas ng pagsisikap na kinakailangan upang mai-port ang kanilang kasalukuyang code. Moku:Lab 1.9 ay hindi inirerekomenda para sa mga bagong deployment at lahat ng mga customer ay hinihikayat na mag-upgrade. Kung may mga isyu pagkatapos mag-upgrade, ang mga user ay magkakaroon ng opsyong mag-downgrade sa software na bersyon 1.9.
Binabalangkas ng gabay sa paglilipat na ito ang advantages ng pag-update at mga potensyal na komplikasyon sa Moku:Lab na bersyon 3.0. Binabalangkas din nito ang proseso ng pag-upgrade ng MATLAB API at kung paano i-downgrade ang iyong Moku:Lab kung kinakailangan.
Bersyon 3.0 bagong mga tampok
Mga bagong feature
Ang bersyon ng software 3.0 ay nagdadala ng Multi-Instrument Mode at Moku Cloud Compile sa Moku:Lab sa unang pagkakataon, pati na rin ang maraming pag-upgrade sa pagganap at kakayahang magamit sa kabuuan ng hanay ng mga instrumento.
Multi-instrumentong Mode
Multi-instrument Mode sa Moku:Lab ay nagbibigay-daan sa mga user na mag-deploy ng dalawang instrumento nang sabay-sabay upang lumikha ng custom na istasyon ng pagsubok. Ang bawat instrumento ay may ganap na access sa mga analog input at output kasama ang mga interconnection sa pagitan ng mga puwang ng instrumento. Ang mga interconnection sa pagitan ng mga instrumento ay sumusuporta sa high-speed, low-latency, real-time na digital na komunikasyon hanggang sa 2 Gb/s, kaya ang mga instrumento ay maaaring tumakbo nang hiwalay o konektado upang bumuo ng mga advanced na signal processing pipelines. Ang mga instrumento ay maaaring dynamic na palitan sa loob at labas nang hindi nakakaabala sa ibang instrumento. Ang mga advanced na user ay maaari ding mag-deploy ng sarili nilang mga custom na algorithm sa Multi-instrument Mode gamit ang Moku Cloud Compile.
Moku Cloud Compile
Nagbibigay-daan sa iyo ang Moku Cloud Compile na direktang mag-deploy ng custom na DSP sa Moku:Lab FPGA sa Multi instrument Mode. Sumulat ng code gamit ang a web browser at i-compile ito sa cloud; Idini-deploy ng Moku Cloud Compile ang bitstream sa isa o higit pang target na mga aparatong Moku.
Oscilloscope
- Deep memory mode: makatipid ng hanggang 4M samples bawat channel sa buong sampling rate (500 MSa/s)
Spectrum analisador
- Pinahusay na ingay sa sahig
- Logarithmic Vrms at Vpp scale
- Limang bagong function ng window (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)
Phasemeter
- Frequency offset, phase, at ampAng litude ay maaari na ngayong maging output bilang analog voltage signal
- Ang mga user ay maaari na ngayong magdagdag ng DC offset sa mga output signal
- Ang phase-locked sine wave na output ay maaari na ngayong i-multiply ang frequency hanggang 2 50x o hatiin pababa sa 125x
- Pinahusay na hanay ng bandwidth (1 Hz hanggang 100 kHz)
- Advanced na phase wrapping at auto-reset na mga function
Generator ng Waveform
- Output ng ingay
- Pagbuo ng lapad ng pulso (PWM)
Lock-In Amptagapagbuhay
- Pinahusay na pagganap ng mababang dalas PLL pagla-lock
- Ang pinakamababang dalas ng PLL ay nabawasan sa 10 Hz
- Ang panloob na signal ng PLL ay maaari na ngayong i-multiply ang frequency hanggang 250x o hinati pababa sa 125x para magamit sa demodulation
- 6-digit na katumpakan para sa mga halaga ng phase
Frequency Response Analyzer
- Tumaas ang maximum na dalas mula 120 MHz hanggang 200 MHz
- Taasan ang maximum na mga sweep point mula 512 hanggang 8192
- Ang Bagong Dynamic AmpAwtomatikong ino-optimize ng feature ng litude ang output signal para sa pinakamahusay na dynamic range ng pagsukat
- Bagong mode ng pagsukat ng ln/ln1
- Mga babala sa saturation ng input
- Sinusuportahan na ngayon ng math channel ang mga arbitrary na complex-valued equation na kinasasangkutan ng mga signal ng channel, na nagbibigay-daan sa mga bagong uri ng kumplikadong mga pagsukat ng function ng paglipat
- Ang mga signal ng input ay maaari na ngayong masukat sa dBVpp at dBVrms bilang karagdagan sa dBm
- Ang pag-usad ng sweep ay ipinapakita na ngayon sa graph
- Ang frequency axis ay maaari na ngayong i-lock upang maiwasan ang mga hindi sinasadyang pagbabago sa panahon ng mahabang sweep
Laser Lock Box
- Ang pinahusay na block diagram ay nagpapakita ng scan at modulation signal path
- Ang bagong locking stagAng tampok na ito ay nagbibigay-daan sa pag-customize ng lock procedure
- Pinahusay na pagganap ng mababang dalas PLL pagla-lock
- 6-digit na katumpakan para sa mga halaga ng phase
- Pinahusay na pagganap ng mababang dalas PLL pagla-lock
- Ang pinakamababang dalas ng PLL ay nabawasan sa 10 Hz
- Ang PLL Ang signal ay maaari na ngayong i-multiply ang frequency hanggang 250x o hatiin pababa sa 0.125x para magamit sa demodulation
Iba pa
Nagdagdag ng suporta para sa sine function sa equation editor na maaaring magamit upang makabuo ng mga custom na waveform sa Arbitrary Waveform Generator
I-convert ang binary LI files sa mga CSV, MATLAB, o NumPy na mga format kapag nagda-download mula sa device
Na-upgrade na Suporta sa API
Ang bagong Moku MATLAB API v3.0 package ay nagbibigay ng pinahusay na functionality at stability. Makakatanggap ito ng mga regular na update upang mapabuti ang pagganap at magpakilala ng mga bagong feature.
Paatras na mga limitasyon sa compatibility
API
Ang bagong Moku MATLAB API v3.0 package ay hindi pabalik na tugma sa nakaraang Moku:Lab MATLAB v1.9 package. Ang mga argumento ng MATLAB scripting at mga return value ay ganap na naiiba. Kung mayroon kang malawak na custom na software development na gumagamit ng Moku:Lab MATLAB, isaalang-alang ang epekto ng paglipat ng lahat ng iyong software upang maging tugma sa bagong API.
Habang ang Moku:Lab MATLAB package ay hindi na makakatanggap ng mga update, ang Liquid Instruments ay magpapatuloy pa rin sa pagbibigay ng suporta para sa mga user na hindi makakapag-migrate sa bagong API package.
Maghanap ng detalyadong examples para sa bawat instrumento sa bagong package ng Moku MATLAB API v3.0 upang magsilbing base line para sa pag-convert ng naunang pag-develop ng MATLAB sa bagong package ng API.
Mga regression
RAM disk para sa pag-log ng data
Ang bersyon 1.9 ay may 512 MB filesystem sa RAM ng device, na maaaring magamit upang mag-log ng data sa mataas na sampling rate. Sa bersyon 3.0, ang pag-log sa RAM ay hindi na magagamit. Para paganahin ang pag-log ng data, kailangan ng SD card. Alinsunod dito, nagbabago rin ang maximum na bilis ng pagkuha. Sinusuportahan ng bersyon 1.9 ang hanggang 1 MSa/s, samantalang sinusuportahan ng bersyon 3.0 ang hanggang 250 kSa/s sa 1 channel at 125 kSa/s sa 2 channel. Kahit na sa mas mababang bilis at may SD card, ang mga workflow na kasama ang pag-save ng maraming high-speed na log sa RAM at pagkatapos ay pagkopya sa mga ito sa SD card o ang kliyente ay hindi na susuportahan.
Pag-log ng data sa CSV
Ang Bersyon 1.9 ay may kakayahang mag-save ng data nang direkta sa isang CSV file habang nagla-log. Ang tampok na ito ay hindi direktang magagamit sa bersyon 3.0. Mga user na may kasamang workflow ang pag-save ng CSVfiles direkta sa isang SD card o kailangan muna ng kliyente na i-convert ang binary file sa CSV, gamit ang client app o sa pamamagitan ng pag-install ng standalone na Liquid Instruments File I-convert sa computer na ginagamit nila para sa pagproseso ng data.
Mga pagbabagong hindi tugma sa likod
Pag-scale ng data sa LIA
Sa bersyon 1.9, ipinatupad namin ang pag-scale ng data na ang pagpaparami ng dalawang 0.1 V DC na signal ay nagresulta sa isang 0.02 V DC na output. Sa bersyon 3.0, binago namin ito upang ang resulta ay 0.01 V DC, na higit na naaayon sa mga intuitive na inaasahan ng mga customer.
Dapat na pinagana ang output ng Waveform Generator upang magamit bilang source/trigger ng modulation
Sa bersyon 1.9, maaaring gamitin ang waveform ng ibang channel bilang modulation o trigger source sa Waveform Generator, kahit na hindi pinagana ang output ng channel na iyon. Inalis ito sa bersyon
- Ang mga user na gustong gumawa ng cross-modulation nang hindi kailangang i-unplug ang mga output ng kanilang device ay kailangang ayusin ang kanilang
Moku MATLAB API
Ang Moku MATLAB API v3.0 package ay nilayon na magbigay sa mga developer ng MATLAB ng mga mapagkukunang kailangan para makontrol ang anumang aparato ng Moku at, sa huli, ang kakayahang isama ang mga kontrol na ito sa mas malalaking application ng end-user. Ang bagong Moku MATLAB API v3.0 package ay nagbibigay ng sumusunod:
- Ganap na gumagana halample MATLAB script para sa bawat isa
- Ang lahat ng mga script ng MATLAB ay binibigyan ng mga komento, na madaling maunawaan at maaaring magsilbing panimulang punto ng end user para sa pagpapasadya at
- Isang hanay ng mga function na nagbibigay ng ganap na kontrol sa Moku
Kasalukuyang sinusuportahang mga instrumento
- Arbitrary Waveform Generator
- Data Logger
- Digital Filter Box
- Tagabuo ng FIR Filter
- Frequency Response Analyzer
- Laser Lock Box
- Lock-in Amptagapagbuhay
- Oscilloscope
- Phasemeter
- Controller ng PID
- Spectrum analisador
- Generator ng Waveform
- Multi-instrumentong Mode
- Moku Cloud Compile
Pag-install
Mga kinakailangan
- MATLAB bersyon 2015 o mas bago
Kung mayroon ka nang nakaraang bersyon ng Moku MATLAB API na naka-install, mangyaring i-uninstall ito bago magpatuloy. Maaari mong i-uninstall ang package mula sa Add-on Manager.
- Buksan ang Add-on Manager sa pamamagitan ng tab na Home > Environment.
- Maghanap para sa Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
- Bilang kahalili, maaari mong i-download ang toolbox nang direkta mula sa Liquid Instruments website sa https://www.liquidinstruments.com/products/apis/matlab-api/. Kakailanganin mong itakda nang manu-mano ang landas ng paghahanap kung gagawin mo ito.
- Suriin kung naidagdag na ang tamang landas sa toolbox sa pamamagitan ng pagpili sa 'Itakda ang Landas' mula sa tab na Home > Environment.
- Tiyaking mayroong entry na tumuturo sa lokasyon ng pag-install ng toolbox. Ang isang karaniwang landas ay maaaring CAUserskusername>\AppDataRoaming\Mathworks\MATLABadd-Ons\Toolboxes\oku- MATLAB.
- I-download ang data ng instrumento files sa pamamagitan ng pag-type ng 'moku_download####) sa MATLAB Command Window. Ang ### ay dapat mapalitan ng iyong kasalukuyang bersyon ng firmware. Mahahanap ni Yol ang iyong kasalukuyang bersyon ng firmware sa pamamagitan ng Moku: desktop app sa pamamagitan ng pag-right click sa iyong Moku at pag-hover ng 'Device info', o sa iPad app sa pamamagitan ng matagal na pagpindot sa iyong Moku.
- Kumpirmahin nang tama ang iyong toolbox sa pamamagitan ng pag-type ng 'help Moku' sa MATLAB Command Window. Kung magtagumpay ang utos na ito. pagkatapos ay matagumpay na na-install ang toolbox
Mga pagbabago sa Moku API
Ang bagong arkitektura ng Moku MATLAB API ay sapat na naiiba mula sa hinalinhan nito at samakatuwid ay hindi paatras na tugma sa mga umiiral nang API script. Ang sumusunod na pinasimpleng Oscilloscope halampIpinapakita ng le ang mga pagkakaiba sa pagitan ng legacy at bagong mga API package at nagsisilbing road map para sa pag-port ng umiiral nang code.
Oscilloscope halample
Mga hakbang sa pagkakasunud-sunod
- I-import ang Moku MATLAB API 3.0
- I-claim ang pagmamay-ari ng Moku at i-upload ang Oscilloscope bitstream sa
- Itakda ang time base at itakda ang kaliwa at kanang-kamay na span para sa axis ng oras.
- Kumuha ng data, kumuha ng isang frame ng data mula sa Oscilloscope
- Tapusin ang session ng kliyente sa pamamagitan ng pagbibitiw sa pagmamay-ari ng Moku
Ang pagkakasunud-sunod na inilarawan sa itaas ay isang pinasimple na halample upang ilarawan ang mga pagkakaiba sa pagitan ng legacy at bagong mga pakete ng API. Bukod sa pagsisimula ng session ng kliyente, pag-upload ng instrument bitstream sa Moku, at pagtatapos sa session ng kliyente, maaaring gamitin ng end user ang anumang bilang ng mga function sa iba't ibang pagkakasunud-sunod upang matugunan ang mga pangangailangan ng kanilang aplikasyon.
Mga Pagkakaiba
Dito, tinitingnan namin ang mga pagkakaiba sa pagitan ng dalawang APls para sa bawat hakbang sa pagkakasunud-sunod.
I-claim ang pagmamay-ari ng Moku at i-upload ang Oscilloscope bitstream sa device. Kung ikukumpara sa Moku MATLAB 1.9, ang bagong API ay may ganap na magkakaibang mga pag-andar:
| Moku MATLAB 1.9 | Moku MATLAB 3.0 | ||
| Function | get_by_name() | deploy_or_conn ect() | Oscilloscope() |
| Mga pinapayagang field at value | pangalan: string timeout: float | instrumento: ang klase ng instrumento na gustong i-deploy | ip: string serial: string |
| puwersa: bool | set_defauIt: booI | force_connect: bool | |
| use_externa I: bool | ignore_busy: bool | ||
| persist_state: bool | |||
| connect_timeout: lumutang | |||
| read_timeout: lumutang | |||
- Itakda ang time base. Ang function ay pareho, ngunit ang mga pinapayagang argumento ay bahagyang naiiba:
Moku MATLAB 1.9 Moku MATLAB 3.0 Function set_timebase() set_timebase() Mga pinapayagang field at value t1: lumutang t2: lumutang t1: float t2:float strict: bool - Kumuha ng data. Ang mga function at ang pinapayagang argumento ay pareho, ngunit ang ibinalik na uri ng data at haba ay iba:
Moku MATLAB 1.9 Moku MATLAB 3.0 Function get_data() get_data() Mga pinapayagang field at value timeout: float wait: bool timeout: float wait_reacquire: bool Haba ng pagbabalik 16383 puntos bawat frame 1024 puntos bawat frame - Bitawan ang pagmamay-ari ng Moku:
Moku MATLAB 1.9 Moku API v3.0 Function malapit () relinquish_ownership()
Listahan ng mga function ng oscilloscope
| 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 |
| get_samp!erateO
get_rea!time_dataQ |
get_samp!erateO
save_high_res_bufferO |
| gen_rampwaveO
gen_sinewaveO |
generate_waveformO
get_acquisition_modeQ |
| gen_squarewaveQ | get_sourcesQ |
| 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 |
|
| buodQ |
Ang Moku MATLAB API ay batay sa Moku API. Para sa buong dokumentasyon ng Moku API, sumangguni sa Moku API Reference na makikita dito https://apis.liq uidinstrume nts.com/re fe rence/.
Ang mga karagdagang detalye para sa pagsisimula sa Moku MATLAB API ay matatagpuan sa https://a pis.liquid instruments.com/sta rating-Matlab.bahay
Proseso ng pag-downgrade
Kung ang pag-upgrade sa bersyon 3.0 ay napatunayang nililimitahan, o kung hindi man ay makakaapekto, isang bagay na mahalaga sa iyong aplikasyon, maaari kang mag-downgrade sa nakaraang bersyon 1.9. Magagawa ito sa pamamagitan ng a web browser.
Mga hakbang
- Makipag-ugnayan sa Liquid Instruments at kunin ang file para sa firmware na bersyon 9.
- I-type ang iyong Moku:Lab IP address sa isang web browser (tingnan ang screenshot).
- Sa ilalim ng Update Firmware, mag-browse at piliin ang firmware file ibinigay ng Liquid Instruments.
- Piliin ang I-upload at I-update. Ang proseso ng pag-update ay maaaring tumagal ng higit sa 10 minuto upang makumpleto
© 2023 Mga Instrumentong Liquid. nakalaan.
Mga Dokumento / Mga Mapagkukunan
 |
MGA LIQUID INSTRUMENTS MATLAB API Integration Fuse [pdf] Gabay sa Gumagamit MATLAB API, MATLAB API Integration Fuse, Integration Fuse, Fuse |