INSTRUMEN CECAIR Fius Integrasi API MATLAB

Panduan Migrasi API MATLAB

Menaik taraf Moku: Makmal kepada perisian versi 3.0 membuka pelbagai ciri baharu. Semasa mengemas kini, pengguna API mesti mengambil langkah tambahan untuk memindahkan skrip mereka ke pakej API Moku baharu. Panduan migrasi ini menggariskan perubahan API, ciri baharu yang tersedia dalam kemas kini versi 3.0 dan sebarang had keserasian ke belakang.

Berakhirview

Moku:Perisian Lab versi 3.0 ialah kemas kini utama yang membawa perisian tegar baharu, antara muka pengguna dan APls kepada perkakasan Moku:Lab. Kemas kini membawa Moku:Lab selaras dengan Moku:Pro dan Moku:Go, menjadikannya mudah untuk berkongsi skrip merentas semua platform Moku. Kemas kini membuka kunci pelbagai ciri baharu kepada kebanyakan instrumen sedia ada. Ia juga menambah dua ciri baharu: Mod Berbilang Instrumen dan Moku Cloud Compile. Terdapat beberapa perbezaan tingkah laku yang halus juga, yang digariskan dalam bahagian keserasian ke belakang.

Ini ialah kemas kini utama yang mempengaruhi seni bina API, dan oleh itu pakej MATLAB API v3.0 baharu tidak akan serasi ke belakang dengan skrip MATLAB sedia ada. Pengguna API perlu mengalihkan skrip mereka ke pakej API Moku baharu jika mereka menaik taraf Moku:Lab mereka kepada versi 3.0. Pengguna API dengan pembangunan perisian tersuai yang ketara harus mempertimbangkan dengan teliti tahap usaha yang diperlukan untuk memindahkan kod sedia ada mereka. Moku:Lab 1.9 tidak disyorkan untuk penggunaan baharu dan semua pelanggan digalakkan untuk menaik taraf. Jika isu timbul selepas menaik taraf, pengguna akan mempunyai pilihan untuk menurunkan taraf kepada perisian versi 1.9.

Panduan migrasi ini menggariskan advantages pengemaskinian dan kemungkinan komplikasi kepada Moku:Lab versi 3.0. Ia juga menggariskan proses untuk menaik taraf API MATLAB dan cara menurunkan taraf Moku:Lab anda jika perlu.

Versi 3.0 ciri baharu

Ciri baharu

Perisian versi 3.0 membawakan Mod Berbilang Instrumen dan Kompilasi Awan Moku ke Moku:Lab buat kali pertama, serta banyak peningkatan prestasi dan kebolehgunaan merentas set instrumen.

Mod Berbilang Instrumen

Mod Berbilang Instrumen pada Moku:Lab membolehkan pengguna menggunakan dua instrumen serentak untuk mencipta stesen ujian tersuai. Setiap instrumen mempunyai akses penuh kepada input dan output analog bersama dengan sambungan antara slot instrumen. Sambungan antara instrumen menyokong komunikasi digital berkelajuan tinggi, kependaman rendah, masa nyata sehingga 2 Gb/s, jadi instrumen boleh berjalan secara bebas atau disambungkan untuk membina saluran paip pemprosesan isyarat termaju. Instrumen boleh ditukar masuk dan keluar secara dinamik tanpa mengganggu instrumen lain. Pengguna lanjutan juga boleh menggunakan algoritma tersuai mereka sendiri dalam Mod Berbilang Instrumen menggunakan Moku Cloud Compile.

Kompilasi Awan Moku

Moku Cloud Compile membolehkan anda menggunakan DSP tersuai terus ke Moku:Lab FPGA dalam Mod Berbilang Instrumen. Tulis kod menggunakan a web pelayar dan menyusunnya dalam awan; Moku Cloud Compile menggunakan aliran bit ke satu atau lebih peranti Moku sasaran.

Osiloskop

• Mod memori dalam: jimat sehingga 4M samples setiap saluran pada s penuhampkadar ling (500 MSa/s)

Analyzer Spektrum

• Lantai bunyi yang lebih baik
• Logaritma Vrms dan skala Vpp
• Lima fungsi tetingkap baharu (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Pengukur fasa

• Kekerapan mengimbangi, fasa dan amplitude kini boleh dikeluarkan sebagai vol analogtage isyarat
• Pengguna kini boleh menambah offset DC pada isyarat output
• Output gelombang sinus terkunci fasa kini boleh didarab frekuensi sehingga 2 50x atau dibahagikan kepada 125x
• Julat lebar jalur yang dipertingkatkan (1 Hz hingga 100 kHz)
• Fungsi pembalut fasa lanjutan dan set semula automatik

Penjana Bentuk Gelombang

• Keluaran bunyi
• Modulasi lebar nadi (PWM)

mengunci Amplebih hidup

• Peningkatan prestasi frekuensi rendah PLL mengunci
• Kekerapan PLL minimum telah dikurangkan kepada 10 Hz
• Isyarat PLL dalaman kini boleh didarab frekuensi sehingga 250x atau dibahagikan kepada 125x untuk digunakan dalam penyahmodulasi
• Ketepatan 6 digit untuk nilai fasa

Penganalisis Respons Kekerapan

• Meningkatkan kekerapan maksimum daripada 120 MHz kepada 200 MHz
• Tingkatkan mata sapuan maksimum daripada 512 kepada 8192
• Dinamik Baharu Ampciri litude mengoptimumkan isyarat keluaran secara automatik untuk julat dinamik pengukuran terbaik
• Mod ukuran ln/ln1 baharu
• Amaran ketepuan input
• Saluran matematik kini menyokong persamaan nilai kompleks arbitrari yang melibatkan isyarat saluran, membolehkan jenis pengukuran fungsi pemindahan kompleks baharu
• Isyarat input kini boleh diukur dalam dBVpp dan dBVrms sebagai tambahan kepada dBm
• Kemajuan sapuan kini dipaparkan pada graf
• Paksi frekuensi kini boleh dikunci untuk mengelakkan perubahan yang tidak disengajakan semasa sapuan yang panjang

Kotak Kunci Laser

• Gambar rajah blok yang dipertingkatkan menunjukkan laluan isyarat imbasan dan modulasi
• Penguncian baru stagciri es membolehkan menyesuaikan prosedur kunci
• Peningkatan prestasi frekuensi rendah PLL mengunci
• Ketepatan 6 digit untuk nilai fasa
• Peningkatan prestasi frekuensi rendah PLL mengunci
• Kekerapan PLL minimum telah dikurangkan kepada 10 Hz
• The PLL isyarat kini boleh didarab frekuensi sehingga 250x atau dibahagikan kepada 0.125x untuk digunakan dalam penyahmodulasi

Lain-lain

Menambah sokongan untuk fungsi sinus pada editor persamaan yang boleh digunakan untuk menjana bentuk gelombang tersuai dalam Penjana Gelombang Arbitrari

Tukar binari LI files ke format CSV, MATLAB atau NumPy apabila memuat turun daripada peranti

Sokongan API Dinaik Taraf

Pakej Moku MATLAB API v3.0 baharu menyediakan fungsi dan kestabilan yang dipertingkatkan. Ia akan menerima kemas kini tetap untuk meningkatkan prestasi dan memperkenalkan ciri baharu.

Had keserasian ke belakang

API

Pakej Moku MATLAB API v3.0 baharu tidak serasi ke belakang dengan pakej Moku:Lab MATLAB v1.9 sebelumnya. Argumen skrip MATLAB dan nilai pulangan adalah berbeza sepenuhnya. Jika anda mempunyai pembangunan perisian tersuai yang meluas menggunakan Moku:Lab MATLAB, pertimbangkan kesan pemindahan semua perisian anda agar serasi dengan API baharu.

Walaupun pakej Moku:Lab MATLAB tidak lagi akan menerima kemas kini, Instrumen Cecair masih akan terus memberikan sokongan untuk pengguna yang tidak dapat berhijrah ke pakej API baharu.

Cari ex terperinciamples untuk setiap instrumen dalam pakej Moku MATLAB API v3.0 baharu untuk berfungsi sebagai garis asas untuk menukar pembangunan MATLAB terdahulu kepada pakej API baharu.

Regresi

Cakera RAM untuk pengelogan data

Versi 1.9 mempunyai 512 MB filesistem dalam RAM peranti, yang boleh digunakan untuk log data pada s tinggiampkadar ling. Dalam versi 3.0, log masuk ke RAM tidak lagi tersedia. Untuk mendayakan pengelogan data, kad SD diperlukan. Sehubungan itu, kelajuan pemerolehan maksimum juga berubah. Versi 1.9 menyokong sehingga 1 MSa/s, manakala versi 3.0 menyokong sehingga 250 kSa/s pada 1 saluran dan 125 kSa/s pada 2 saluran. Walaupun pada kelajuan yang lebih rendah dan dengan kad SD, aliran kerja yang termasuk menyimpan berbilang log berkelajuan tinggi ke RAM dan kemudian menyalinnya ke kad SD atau pelanggan tidak akan disokong lagi.

Pengelogan data ke CSV

Versi 1.9 mempunyai keupayaan untuk menyimpan data terus ke CSV file semasa pembalakan. Ciri ini tidak tersedia secara langsung pada versi 3.0. Pengguna yang aliran kerjanya termasuk menyimpan CSVfiles terus ke kad SD atau pelanggan kini perlu menukar binari terlebih dahulu file kepada CSV, sama ada menggunakan apl pelanggan atau dengan memasang Instrumen Cecair kendiri File Tukar ke komputer yang mereka gunakan untuk pemprosesan data.

Perubahan tidak serasi ke belakang

Penskalaan data dalam LIA

Dalam versi 1.9, kami melaksanakan penskalaan data supaya mendarab dua isyarat 0.1 V DC menghasilkan output 0.02 V DC. Dalam versi 3.0, kami menukar ini supaya hasilnya ialah 0.01 V DC, yang lebih selaras dengan jangkaan intuitif pelanggan.

Output Penjana Bentuk Gelombang mesti didayakan untuk digunakan sebagai sumber modulasi/pencetus

Dalam versi 1.9, bentuk gelombang saluran yang berbeza boleh digunakan sebagai modulasi atau sumber pencetus dalam Penjana Bentuk Gelombang, walaupun output saluran itu dilumpuhkan. Ini telah dialih keluar dalam versi

• Pengguna yang ingin melakukan modulasi silang tanpa perlu mencabut keluaran peranti mereka perlu melaraskan

API MATLAB Moku

Pakej Moku MATLAB API v3.0 bertujuan untuk menyediakan pembangun MATLAB sumber yang diperlukan untuk mengawal mana-mana peranti Moku dan, akhirnya, keupayaan untuk menggabungkan kawalan ini ke dalam aplikasi pengguna akhir yang lebih besar. Pakej Moku MATLAB API v3.0 baharu menyediakan yang berikut:

• Berfungsi sepenuhnya example skrip MATLAB untuk setiap satu
• Semua skrip MATLAB disediakan dengan ulasan, yang mudah difahami dan boleh berfungsi sebagai titik permulaan pengguna akhir untuk penyesuaian dan
• Satu set fungsi yang menyediakan kawalan penuh ke atas Moku

Instrumen yang disokong pada masa ini

1. Penjana Gelombang Arbitrari
2. Logger Data
3. Kotak Penapis Digital
4. Pembina Penapis FIR
5. Penganalisis Respons Kekerapan
6. Kotak Kunci Laser
7. Kunci masuk Amplebih hidup
8. Osiloskop
9. Pengukur fasa
10. Pengawal PID
11. Analyzer Spektrum
12. Penjana Bentuk Gelombang
13. Mod Berbilang Instrumen
14. Kompilasi Awan Moku

Pemasangan

Keperluan

• MATLAB versi 2015 atau lebih baru

Jika anda sudah memasang versi API MATLAB sebelumnya, sila nyahpasangnya sebelum meneruskan. Anda boleh menyahpasang pakej daripada Pengurus Tambahan.

1. Buka Pengurus Tambahan melalui tab Laman Utama > Persekitaran.
2. Cari untuk Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Sebagai alternatif, anda boleh memuat turun kotak alat terus dari Instrumen Cecair webtapak di https://www.liquidinstruments.com/products/apis/matlab-api/. Anda perlu menetapkan laluan carian secara manual jika anda melakukan ini.
4. Semak bahawa laluan yang betul telah ditambahkan pada kotak alat dengan memilih 'Tetapkan Laluan' daripada tab Laman Utama > Persekitaran.
5. Pastikan terdapat entri yang menunjuk ke lokasi pemasangan kotak alat. Laluan biasa mungkin CAUserskusername>\AppDataRoaming\Mathworks\MATLABadd-Ons\Toolboxes\oku- MATLAB.
6. Muat turun data instrumen files dengan menaip 'moku_download####) ke dalam Tetingkap Perintah MATLAB. ### hendaklah digantikan dengan versi perisian tegar semasa anda. Yol boleh mencari versi perisian tegar semasa anda melalui aplikasi desktop Moku: dengan mengklik kanan pada Moku anda dan menuding 'Maklumat peranti', atau dalam apl iPad dengan menekan lama pada Moku anda.
7. Sahkan kotak alat anda disediakan dengan betul dengan menaip 'help Moku' ke dalam Tetingkap Perintah MATLAB. Jika arahan ini berjaya. maka kotak alat telah berjaya dipasang

API Moku berubah

Seni bina API Moku MATLAB baharu cukup berbeza daripada pendahulunya dan oleh itu tidak serasi ke belakang dengan skrip API sedia ada. Osiloskop mudah berikut example menunjukkan perbezaan antara legasi dan pakej API baharu dan berfungsi sebagai peta jalan untuk mengalihkan kod sedia ada.

Osiloskop example

Langkah urutan

1. Import Moku MATLAB API 3.0
2. Tuntut pemilikan Moku dan muat naik aliran bit Oscilloscope ke
3. Tetapkan asas masa dan tetapkan rentang kiri dan kanan untuk paksi masa.
4. Dapatkan data, dapatkan satu bingkai data daripada Osiloskop
5. Tamatkan sesi pelanggan dengan melepaskan pemilikan Moku

Urutan yang diterangkan di atas ialah ex yang dipermudahkanampuntuk menggambarkan perbezaan antara legasi dan pakej API baharu. Selain daripada memulakan sesi pelanggan, memuat naik aliran bit instrumen ke Moku, dan menamatkan sesi klien, pengguna akhir boleh menggunakan sebarang bilangan fungsi dalam pelbagai susunan untuk memenuhi keperluan aplikasi mereka.

Perbezaan

Di sini, kita melihat perbezaan antara dua APl untuk setiap langkah dalam urutan.

Tuntut pemilikan Moku dan muat naik aliran bit Oscilloscope ke peranti. Berbanding dengan Moku MATLAB 1.9, API baharu mempunyai fungsi yang berbeza sama sekali:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Fungsi	get_by_name()	deploy_or_conn ect()	Osiloskop()
Medan dan nilai yang dibenarkan	nama: tamat masa rentetan: terapung	instrumen: kelas instrumen yang ingin digunakan	ip: string bersiri: string
	daya: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: terapung
			read_timeout: terapung

 

1. Tetapkan asas masa. Fungsinya adalah sama, tetapi hujah yang dibenarkan sedikit berbeza:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Fungsi	set_timebase()	set_timebase()
   Medan dan nilai yang dibenarkan	t1: terapung t2: terapung	t1: terapung t2: terapung ketat: bool

2. Dapatkan data. Fungsi dan hujah yang dibenarkan adalah sama, tetapi jenis dan panjang data yang dikembalikan adalah berbeza:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Fungsi	get_data()	get_data()
   Medan dan nilai yang dibenarkan	tamat masa: terapung tunggu: bool	tamat masa: float wait_reacquire: bool
   Panjang pulangan	16383 mata setiap bingkai	1024 mata setiap bingkai

3. Lepaskan pemilikan Moku:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Fungsi	tutup()	relinquish_ownership()

Senarai fungsi osiloskop

Moku MATLAB 1.9	Moku MATLAB 3.0
set_sourceO	set_sourcesO
set_triggerO	set_triggerO
dapatkan_dataQ	dapatkan_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
dapatamp!erateO get_rea!time_dataQ	dapatamp!erateO save_high_res_bufferO
gen_rampgelombangO 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_histeresisQ set_interpo!ationO
	set_input_attenuationO
	set_sourceO osc_measurementQ
	ringkasanQ

API MATLAB Moku adalah berdasarkan API Moku. Untuk dokumentasi API Moku penuh, rujuk Rujukan API Moku yang terdapat di sini https://apis.liq uidinstrume nts.com/re fe rence/.

Butiran tambahan untuk memulakan API MATLAB Moku boleh didapati di https://a pis.liquid instruments.com/sta penilaian-Matlab.rumah

Proses turun taraf

Jika peningkatan kepada versi 3.0 telah terbukti mengehadkan, atau sebaliknya memberi kesan buruk, sesuatu yang penting kepada aplikasi anda, anda boleh menurunkan taraf kepada versi 1.9 sebelumnya. Ini boleh dilakukan melalui a web pelayar.

Langkah

1. Hubungi Instrumen Cecair dan dapatkan file untuk perisian tegar versi 9.
2. Taipkan alamat IP Moku:Lab anda ke dalam a web pelayar (lihat tangkapan skrin).
3. Di bawah Kemas Kini Perisian Tegar, semak imbas dan pilih perisian tegar file disediakan oleh Alat Cecair.
4. Pilih Muat Naik & Kemas Kini. Proses kemas kini boleh mengambil masa lebih daripada 10 minit untuk diselesaikan

© 2023 Alat Cecair. terpelihara.

laudinstruments.com

Dokumen / Sumber

INSTRUMEN CECAIR Fius Integrasi API MATLAB [pdf] Panduan Pengguna API MATLAB, Fius Integrasi API MATLAB, Fius Integrasi, Fius

Rujukan

• Manual Pengguna