INSTRUMEN CAIR Sekering Integrasi MATLAB API
Panduan Migrasi MATLAB API
Meningkatkan Moku: Lab ke perangkat lunak versi 3.0 akan membuka sejumlah fitur baru. Saat memperbarui, pengguna API harus mengambil langkah ekstra untuk memigrasikan skrip mereka ke paket Moku API yang baru. Panduan migrasi ini menguraikan perubahan API, fitur baru yang tersedia dalam pembaruan versi 3.0, dan segala batasan kompatibilitas mundur.
Lebihview
Perangkat lunak Moku:Lab versi 3.0 adalah pembaruan besar yang menghadirkan firmware baru, antarmuka pengguna, dan APl ke perangkat keras Moku:Lab. Pembaruan ini menjadikan Moku:Lab sejalan dengan Moku:Pro dan Moku:Go, sehingga memudahkan untuk berbagi skrip di semua platform Moku. Pembaruan ini membuka sejumlah fitur baru pada banyak instrumen yang ada. Ia juga menambahkan dua fitur baru: Mode Multi-instrumen dan Moku Cloud Compile. Ada juga beberapa perbedaan perilaku yang tidak kentara, yang dijelaskan di bagian Kompatibilitas mundur.
Ini adalah pembaruan besar yang mempengaruhi arsitektur API, dan oleh karena itu paket MATLAB API v3.0 yang baru tidak akan kompatibel dengan skrip MATLAB yang ada. Pengguna API perlu mem-porting skrip mereka ke paket Moku API baru jika mereka meningkatkan Moku:Lab ke versi 3.0. Pengguna API dengan pengembangan perangkat lunak khusus yang signifikan harus mempertimbangkan dengan cermat tingkat upaya yang diperlukan untuk mem-porting kode yang ada. Moku:Lab 1.9 tidak direkomendasikan untuk penerapan baru dan semua pelanggan dianjurkan untuk melakukan peningkatan. Jika masalah muncul setelah peningkatan, pengguna akan memiliki opsi untuk menurunkan versi ke perangkat lunak versi 1.9.
Panduan migrasi ini menguraikan advantages pembaruan dan potensi komplikasi pada Moku:Lab versi 3.0. Ini juga menguraikan proses untuk meningkatkan MATLAB API dan cara menurunkan versi Moku:Lab Anda jika perlu.
Versi 3.0 fitur baru
Fitur baru
Perangkat lunak versi 3.0 menghadirkan Mode Multi-Instrumen dan Moku Cloud Compile ke Moku:Lab untuk pertama kalinya, serta banyak peningkatan kinerja dan kegunaan di seluruh rangkaian instrumen.
Mode Multi-instrumen
Mode Multi-instrumen di Moku:Lab memungkinkan pengguna untuk menyebarkan dua instrumen secara bersamaan untuk membuat stasiun pengujian khusus. Setiap instrumen memiliki akses penuh ke input dan output analog serta interkoneksi antar slot instrumen. Interkoneksi antar instrumen mendukung komunikasi digital real-time berkecepatan tinggi, latensi rendah, hingga 2 Gb/s, sehingga instrumen dapat berjalan secara mandiri atau dihubungkan untuk membangun jalur pemrosesan sinyal yang canggih. Instrumen dapat ditukar masuk dan keluar secara dinamis tanpa mengganggu instrumen lainnya. Pengguna tingkat lanjut juga dapat menerapkan algoritme khusus mereka sendiri dalam Mode Multi-instrumen menggunakan Moku Cloud Compile.
Kompilasi Moku Cloud
Moku Cloud Compile memungkinkan Anda menerapkan DSP khusus langsung ke Moku:Lab FPGA dalam Mode Multi Instrumen. Tulis kode menggunakan a web browser dan kompilasi di cloud; Moku Cloud Compile menyebarkan bitstream ke satu atau lebih perangkat target Moku.
Osiloskop
- Mode memori dalam: hemat hingga 4M dtkamples per saluran dengan kecepatan penuhamptingkat ling (500 MSa/dtk)
Spectrum Analyzer
- Lantai kebisingan yang ditingkatkan
- Skala Vrms dan Vpp Logaritmik
- Lima fungsi jendela baru (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)
Pengukur fase
- Offset frekuensi, fase, dan amplitude sekarang dapat dikeluarkan sebagai analog voltagsinyal e
- Pengguna sekarang dapat menambahkan offset DC ke sinyal keluaran
- Keluaran gelombang sinus fase terkunci sekarang dapat dikalikan frekuensi hingga 2 50x atau dibagi hingga 125x
- Rentang bandwidth yang ditingkatkan (1 Hz hingga 100 kHz)
- Pembungkusan fase lanjutan dan fungsi reset otomatis
Generator Bentuk Gelombang
- Output kebisingan
- Modulasi lebar pulsa (PWM)
mengunci Amppengangkat
- Peningkatan kinerja frekuensi rendah PLL penguncian
- Frekuensi PLL minimum telah diturunkan menjadi 10 Hz
- Sinyal PLL internal sekarang dapat dikalikan frekuensinya hingga 250x atau dibagi menjadi 125x untuk digunakan dalam demodulasi
- Presisi 6 digit untuk nilai fase
Penganalisis Respons Frekuensi
- Peningkatan frekuensi maksimum dari 120 MHz menjadi 200 MHz
- Tingkatkan poin sapuan maksimum dari 512 menjadi 8192
- Dinamika Baru AmpFitur litude mengoptimalkan sinyal keluaran secara otomatis untuk rentang dinamis pengukuran terbaik
- Mode pengukuran ln/ln1 baru
- Masukkan peringatan saturasi
- Saluran matematika sekarang mendukung persamaan bernilai kompleks arbitrer yang melibatkan sinyal saluran, memungkinkan pengukuran fungsi transfer kompleks jenis baru
- Sinyal masukan kini dapat diukur dalam dBVpp dan dBVrms selain dBm
- Kemajuan penyisiran sekarang ditampilkan pada grafik
- Sumbu frekuensi sekarang dapat dikunci untuk mencegah perubahan yang tidak disengaja selama sapuan panjang
Kotak Kunci Laser
- Diagram blok yang ditingkatkan menunjukkan jalur sinyal pemindaian dan modulasi
- Penguncian baru stagFitur es memungkinkan penyesuaian prosedur kunci
- Peningkatan kinerja frekuensi rendah PLL penguncian
- Presisi 6 digit untuk nilai fase
- Peningkatan kinerja frekuensi rendah PLL penguncian
- Frekuensi PLL minimum telah diturunkan menjadi 10 Hz
- Itu PLL sinyal sekarang dapat dikalikan frekuensinya hingga 250x atau dibagi menjadi 0.125x untuk digunakan dalam demodulasi
Lainnya
Menambahkan dukungan untuk fungsi sinus ke editor persamaan yang dapat digunakan untuk menghasilkan bentuk gelombang khusus di Generator Bentuk Gelombang Sewenang-wenang
Konversi biner LI files ke format CSV, MATLAB, atau NumPy saat mengunduh dari perangkat
Dukungan API yang ditingkatkan
Paket Moku MATLAB API v3.0 yang baru menyediakan fungsionalitas dan stabilitas yang ditingkatkan. Ini akan menerima pembaruan rutin untuk meningkatkan kinerja dan memperkenalkan fitur-fitur baru.
Batasan kompatibilitas mundur
API
Paket Moku MATLAB API v3.0 yang baru tidak kompatibel dengan paket Moku:Lab MATLAB v1.9 sebelumnya. Argumen skrip MATLAB dan nilai kembalian sepenuhnya berbeda. Jika Anda memiliki pengembangan perangkat lunak kustom ekstensif yang menggunakan Moku:Lab MATLAB, pertimbangkan dampak migrasi semua perangkat lunak Anda agar kompatibel dengan API baru.
Meskipun paket Moku:Lab MATLAB tidak lagi menerima pembaruan, Liquid Instruments akan terus memberikan dukungan bagi pengguna yang tidak dapat bermigrasi ke paket API baru.
Temukan contoh detailnyaampfile untuk setiap instrumen dalam paket Moku MATLAB API v3.0 baru yang berfungsi sebagai garis dasar untuk mengkonversi pengembangan MATLAB sebelumnya ke paket API baru.
Regresi
Disk RAM untuk pencatatan data
Versi 1.9 memiliki 512 MB filesistem dalam RAM perangkat, yang dapat digunakan untuk mencatat data pada s tinggiamptarif ling. Di versi 3.0, login ke RAM tidak lagi tersedia. Untuk mengaktifkan pencatatan data, diperlukan kartu SD. Oleh karena itu, kecepatan akuisisi maksimum juga berubah. Versi 1.9 mendukung hingga 1 MSa/s, sedangkan versi 3.0 mendukung hingga 250 kSa/s pada 1 saluran dan 125 kSa/s pada 2 saluran. Bahkan pada kecepatan yang lebih rendah dan dengan kartu SD, alur kerja yang mencakup menyimpan beberapa log berkecepatan tinggi ke RAM dan kemudian menyalinnya ke kartu SD atau klien tidak lagi didukung.
Pencatatan data ke CSV
Versi 1.9 memiliki kemampuan untuk menyimpan data langsung ke CSV file saat masuk. Fitur ini tidak langsung tersedia pada versi 3.0. Pengguna yang alur kerjanya mencakup penyimpanan CSVfiles langsung ke kartu SD atau klien sekarang harus mengonversi biner terlebih dahulu file ke CSV, baik menggunakan aplikasi klien atau dengan menginstal Liquid Instruments mandiri File Konverter ke komputer yang mereka gunakan untuk pemrosesan data.
Perubahan yang tidak kompatibel ke belakang
Penskalaan data di LIA
Di versi 1.9, kami menerapkan penskalaan data sehingga mengalikan dua sinyal 0.1 V DC menghasilkan output 0.02 V DC. Pada versi 3.0, kami mengubahnya sehingga hasilnya menjadi 0.01 V DC, yang lebih sesuai dengan ekspektasi intuitif pelanggan.
Output Generator Bentuk Gelombang harus diaktifkan untuk digunakan sebagai sumber/pemicu modulasi
Dalam versi 1.9, bentuk gelombang saluran yang berbeda dapat digunakan sebagai sumber modulasi atau pemicu di Generator Bentuk Gelombang, meskipun keluaran saluran tersebut dinonaktifkan. Ini telah dihapus dalam versi
- Pengguna yang ingin melakukan modulasi silang tanpa perlu mencabut output perangkatnya perlu menyesuaikannya
API MATLAB Moku
Paket Moku MATLAB API v3.0 dimaksudkan untuk memberikan pengembang MATLAB sumber daya yang dibutuhkan untuk mengontrol perangkat Moku dan, pada akhirnya, kemampuan untuk menggabungkan kontrol ini ke dalam aplikasi pengguna akhir yang lebih besar. Paket Moku MATLAB API v3.0 yang baru menyediakan hal berikut:
- Mantan yang berfungsi penuhample skrip MATLAB untuk masing-masing
- Semua skrip MATLAB dilengkapi dengan komentar, yang mudah dipahami dan dapat berfungsi sebagai titik awal pengguna akhir untuk penyesuaian dan
- Seperangkat fungsi yang memberikan kontrol penuh atas Moku
Instrumen yang didukung saat ini
- Generator Bentuk Gelombang Sewenang-wenang
- Pencatat Data
- Kotak Filter Digital
- Pembuat Filter FIR
- Penganalisis Respons Frekuensi
- Kotak Kunci Laser
- Penguncian Amppengangkat
- Osiloskop
- Pengukur fase
- Pengontrol PID
- Spectrum Analyzer
- Generator Bentuk Gelombang
- Mode Multi-instrumen
- Kompilasi Moku Cloud
Instalasi
Persyaratan
- MATLAB versi 2015 atau lebih baru
Jika Anda sudah menginstal Moku MATLAB API versi sebelumnya, harap hapus instalasinya sebelum melanjutkan. Anda dapat menghapus instalasi paket dari Add-on Manager.
- Buka Add-on Manager melalui tab Beranda > Lingkungan.
- Pencarian untuk Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
- Alternatifnya, Anda dapat mengunduh toolbox langsung dari Liquid Instruments websitus di https://www.liquidinstruments.com/products/apis/matlab-api/. Anda harus mengatur jalur pencarian secara manual jika Anda melakukan ini.
- Periksa apakah jalur yang benar telah ditambahkan ke toolbox dengan memilih 'Set Path' dari tab Home > Environment.
- Pastikan ada entri yang menunjuk ke lokasi instalasi toolbox. Jalur yang umum mungkin adalah CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku- MATLAB.
- Unduh data instrumen files dengan mengetikkan 'moku_download####) ke dalam Jendela Perintah MATLAB. ### harus diganti dengan versi firmware Anda saat ini. Yol dapat menemukan versi firmware Anda saat ini melalui Moku: aplikasi desktop dengan mengklik kanan Moku Anda dan mengarahkan 'Info perangkat', atau di aplikasi iPad dengan menekan lama Moku Anda.
- Konfirmasikan kotak peralatan Anda telah diatur dengan benar dengan mengetikkan 'help Moku' ke dalam Jendela Perintah MATLAB. Jika perintah ini berhasil. maka toolbox telah berhasil diinstal
Perubahan API Moku
Arsitektur Moku MATLAB API yang baru cukup berbeda dari pendahulunya dan oleh karena itu tidak kompatibel dengan skrip API yang ada. Osiloskop yang disederhanakan berikut ini example menunjukkan perbedaan antara paket API lama dan baru dan berfungsi sebagai peta jalan untuk mem-porting kode yang ada.
Osiloskop example
Urutan langkah
- Impor Moku MATLAB API 3.0
- Klaim kepemilikan Moku dan unggah bitstream Oscilloscope ke
- Tetapkan basis waktu dan atur rentang kiri dan kanan untuk sumbu waktu.
- Dapatkan data, dapatkan satu frame data dari Osiloskop
- Akhiri sesi klien dengan melepaskan kepemilikan Moku
Urutan yang dijelaskan di atas adalah contoh yang disederhanakanample untuk mengilustrasikan perbedaan antara paket API lama dan baru. Selain memulai sesi klien, mengunggah bitstream instrumen ke Moku, dan mengakhiri sesi klien, pengguna akhir dapat menjalankan sejumlah fungsi dalam berbagai urutan untuk memenuhi kebutuhan aplikasi mereka.
Perbedaan
Di sini, kita melihat perbedaan antara dua APl untuk setiap langkah dalam urutannya.
Klaim kepemilikan Moku dan unggah bitstream Osiloskop ke perangkat. Dibandingkan dengan Moku MATLAB 1.9, API baru ini memiliki fungsi yang sangat berbeda:
| Moku MATLAB 1.9 | Moku MATLAB 3.0 | ||
| Fungsi | dapatkan_oleh_nama() | deploy_or_conn dll() | Osiloskop() |
| Bidang dan nilai yang diizinkan | nama: batas waktu string: float | instrumen: kelas instrumen yang ingin digunakan | ip: string serial: string |
| kekuatan: bodoh | set_defauIt: booI | force_connect: bodoh | |
| use_externa I: bodoh | abaikan_sibuk: bodoh | ||
| persist_state: bodoh | |||
| connect_timeout: mengambang | |||
| read_timeout: mengambang | |||
- Tetapkan basis waktu. Fungsinya sama, tetapi argumen yang diperbolehkan sedikit berbeda:
Moku MATLAB 1.9 Moku MATLAB 3.0 Fungsi set_timebase() set_timebase() Bidang dan nilai yang diizinkan t1: mengambang t2: mengambang t1: float t2:float ketat: bool - Dapatkan datanya. Fungsi dan argumen yang diperbolehkan adalah sama, namun tipe dan panjang data yang dikembalikan berbeda:
Moku MATLAB 1.9 Moku MATLAB 3.0 Fungsi dapatkan_data() dapatkan_data() Bidang dan nilai yang diizinkan batas waktu: float tunggu: bool batas waktu: float wait_reacquire: bool Panjang pengembalian 16383 poin per bingkai 1024 poin per bingkai - Melepaskan kepemilikan Moku:
Moku MATLAB 1.9 MokuAPI v3.0 Fungsi menutup() melepaskan_kepemilikan()
Daftar 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 nonaktifkan_inputO |
| set_precision_modeQ | set_acquisition_modeQ |
| sinkronisasi_faseQ | sinkronisasi_output_phaseQ |
| dapatkan_frontendQ | dapatkan_frontendQ |
| mendapatamp!erateO
get_rea!time_dataQ |
mendapatamp!erateO
simpan_high_res_bufferO |
| gen_rampgelombangO
gen_sinewaveO |
menghasilkan_bentuk gelombangO
get_acquisition_modeQ |
| gen_squarewaveQ | dapatkan_sumberQ |
| gen_offQ | dapatkan_timebaseQ
dapatkan_output_!oadQ |
| set_sampbelajarQ
set_framerateQ |
get_interpo!ationO set_output_!bebanQ |
| set_histeresisQ
set_interpo!asiO |
|
| set_input_attenuationO | |
| set_sourceO
osc_measurementQ |
|
| ringkasanQ |
Moku MATLAB API didasarkan pada Moku API. Untuk dokumentasi Moku API selengkapnya, lihat Referensi Moku API yang ada di sini https://apis.liq uidinstrume nts.com/re fe resekali/.
Detail tambahan untuk memulai dengan Moku MATLAB API dapat ditemukan di https://a pis.liquid instruments.com/sta Peringkat-Matlab.rumah
Proses penurunan versi
Jika pemutakhiran ke versi 3.0 terbukti membatasi, atau berdampak buruk, sesuatu yang penting bagi aplikasi Anda, Anda dapat menurunkan versi ke versi 1.9 sebelumnya. Hal ini dapat dilakukan melalui a web peramban.
Tangga
- Hubungi Liquid Instruments dan dapatkan file untuk firmware versi 9.
- Ketikkan alamat IP Moku:Lab Anda ke dalam a web browser (lihat tangkapan layar).
- Di bawah Perbarui Firmware, telusuri dan pilih firmware file disediakan oleh Instrumen Cair.
- Pilih Unggah & Perbarui. Proses pembaruan dapat memakan waktu lebih dari 10 menit untuk diselesaikan
© 2023 Instrumen Cair. disimpan.
Dokumen / Sumber Daya
 |
INSTRUMEN CAIR Sekering Integrasi MATLAB API [Bahasa Indonesia:] Panduan Pengguna MATLAB API, Sekering Integrasi MATLAB API, Sekering Integrasi, Sekring |