Інтеграція LIQUID INSTRUMENTS MATLAB API
Керівництво з міграції MATLAB API
Оновлення Moku: Lab до версії програмного забезпечення 3.0 відкриває безліч нових функцій. Під час оновлення користувачі API повинні вжити додаткових заходів, щоб перенести свої сценарії на новий пакет Moku API. У цьому посібнику з міграції описано зміни API, нові функції, доступні в оновленні версії 3.0, і будь-які обмеження зворотної сумісності.
закінченоview
Програмне забезпечення Moku:Lab версії 3.0 — це велике оновлення, яке приносить нове мікропрограмне забезпечення, інтерфейс користувача та APls для обладнання Moku:Lab. Оновлення приводить Moku:Lab у відповідність до Moku:Pro та Moku:Go, що полегшує спільний доступ до сценаріїв на всіх платформах Moku. Оновлення відкриває безліч нових функцій для багатьох існуючих інструментів. Він також додає дві нові функції: Multi-instrument Mode та Moku Cloud Compile. Існують також деякі незначні поведінкові відмінності, описані в розділі «Зворотна сумісність».
Це велике оновлення, яке впливає на архітектуру API, тому новий пакет API MATLAB v3.0 не буде зворотно сумісний із існуючими сценаріями MATLAB. Користувачам API потрібно буде перенести свої сценарії на новий пакет API Moku, якщо вони оновлять свій Moku:Lab до версії 3.0. Користувачі API із значною розробкою спеціального програмного забезпечення повинні ретельно проаналізувати рівень зусиль, необхідних для портування свого існуючого коду. Moku:Lab 1.9 не рекомендується для нових розгортань, і всім клієнтам рекомендується оновити. Якщо після оновлення виникнуть проблеми, користувачі матимуть можливість повернутися до версії програмного забезпечення 1.9.
У цьому посібнику з міграції описано передtagоновлення та можливі ускладнення Moku:Lab версії 3.0. У ньому також описано процес оновлення API MATLAB і те, як за потреби повернути Moku:Lab до попередньої версії.
Нові функції версії 3.0
Нові функції
Версія програмного забезпечення 3.0 вперше приносить Multi-Instrument Mode та Moku Cloud Compile до Moku:Lab, а також багато оновлень продуктивності та зручності використання в наборі інструментів.
Режим кількох інструментів
Режим кількох приладів у Moku:Lab дозволяє користувачам розгортати два прилади одночасно для створення спеціальної тестової станції. Кожен прилад має повний доступ до аналогових входів і виходів разом із з’єднаннями між слотами приладів. Взаємозв’язки між приладами підтримують високошвидкісний цифровий зв’язок у режимі реального часу з низькою затримкою до 2 Гбіт/с, тому прилади можуть працювати незалежно або під’єднуватися для створення розширених конвеєрів обробки сигналів. Інструменти можна динамічно міняти місцями, не перериваючи інший інструмент. Досвідчені користувачі також можуть розгортати власні алгоритми в режимі кількох інструментів за допомогою Moku Cloud Compile.
Moku Cloud Compile
Moku Cloud Compile дозволяє розгортати спеціальний DSP безпосередньо на Moku:Lab FPGA у режимі кількох інструментів. Напишіть код за допомогою a web браузер і зібрати його в хмарі; Moku Cloud Compile розгортає бітовий потік на одному або кількох цільових пристроях Moku.
Осцилограф
- Режим глибокої пам'яті: зберігайте до 4 млн сampна канал при повному сampшвидкість лінгу (500 Мвиб/с)
Аналізатор спектру
- Покращений рівень шуму
- Логарифмічна шкала Vrms і Vpp
- П'ять нових віконних функцій (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)
Фазометр
- Зсув частоти, фаза і amplitude тепер можна виводити як аналоговий voltage сигнали
- Тепер користувачі можуть додавати зсув постійного струму до вихідних сигналів
- Вихід синусоїдальної хвилі з синхронізованим фазовим підстроюванням тепер можна помножити на частоту до 2 50x або розділити на 125x
- Покращений діапазон пропускної здатності (від 1 Гц до 100 кГц)
- Розширені функції згортання фаз і автоматичного скидання
Генератор сигналів
- Вихід шуму
- Широтно -імпульсна модуляція (ШІМ)
Зафіксувати Ampлібератор
- Покращена продуктивність низьких частот PLL блокування
- Мінімальна частота PLL була знижена до 10 Гц
- Внутрішній сигнал PLL тепер можна помножити на частоту до 250x або розділити на 125x для використання в демодуляції
- 6-значна точність значень фази
Аналізатор частотної характеристики
- Максимальна частота збільшена зі 120 МГц до 200 МГц
- Збільшено максимальну кількість точок розгортки з 512 до 8192
- Нова динаміка Ampфункція litude автоматично оптимізує вихідний сигнал для найкращого динамічного діапазону вимірювання
- Новий режим вимірювання ln/ln1
- Попередження про насиченість вхідних даних
- Математичний канал тепер підтримує довільні рівняння з комплексними значеннями, що включають сигнали каналу, що дозволяє використовувати нові типи вимірювань складної функції передачі
- Вхідні сигнали тепер можна вимірювати в dBVpp і dBVrms на додаток до дБм
- Хід розгортки тепер відображається на графіку
- Вісь частот тепер можна заблокувати, щоб запобігти випадковим змінам під час тривалої розгортки
Коробка лазерного замка
- Покращена блок-схема показує шляхи сканування та модуляції сигналу
- Новий замок stagЦя функція дозволяє налаштувати процедуру блокування
- Покращена продуктивність низьких частот PLL блокування
- 6-значна точність значень фази
- Покращена продуктивність низьких частот PLL блокування
- Мінімальна частота PLL була знижена до 10 Гц
- The PLL сигнал тепер можна помножити на частоту до 250x або розділити на 0.125x для використання в демодуляції
інше
Додано підтримку функції синусоїди в редакторі рівнянь, який можна використовувати для створення власних форм сигналу в генераторі довільних сигналів
Перетворення двійкових LI files у формати CSV, MATLAB або NumPy під час завантаження з пристрою
Оновлена підтримка API
Новий пакет Moku MATLAB API v3.0 забезпечує розширену функціональність і стабільність. Він отримуватиме регулярні оновлення для покращення продуктивності та впровадження нових функцій.
Обмеження зворотної сумісності
API
Новий пакет Moku MATLAB API v3.0 не сумісний із попереднім пакетом Moku:Lab MATLAB v1.9. Аргументи сценаріїв MATLAB і значення, що повертаються, абсолютно різні. Якщо ви розробляєте програмне забезпечення на замовлення за допомогою Moku:Lab MATLAB, подумайте про наслідки перенесення всього програмного забезпечення на сумісність із новим API.
Хоча пакет Moku:Lab MATLAB більше не отримуватиме оновлень, Liquid Instruments продовжить надавати підтримку користувачам, які не можуть перейти на новий пакет API.
Знайти детальний прикладampфайли для кожного інструменту в новому пакеті Moku MATLAB API v3.0, щоб служити базовою лінією для перетворення попередньої розробки MATLAB на новий пакет API.
регресії
RAM диск для реєстрації даних
Версія 1.9 мала 512 Мб fileсистеми в оперативній пам’яті пристрою, яка може використовуватися для реєстрації даних на високих sampлінг ставки. У версії 3.0 журналювання в оперативну пам’ять більше не доступне. Щоб увімкнути реєстрацію даних, потрібна SD-карта. Відповідно, змінюється і максимальна швидкість збору даних. Версія 1.9 підтримувала до 1 Мвиб/с, тоді як версія 3.0 підтримувала до 250 кВиб/с на 1 каналі та 125 кВиб/с на 2 каналах. Навіть на нижчих швидкостях і з SD-картою робочі процеси, які включали збереження кількох високошвидкісних журналів в оперативну пам’ять, а потім копіювання їх на SD-карту або клієнт, більше не підтримуватимуться.
Запис даних у CSV
У версії 1.9 була можливість зберігати дані безпосередньо в CSV file під час реєстрації. Ця функція недоступна безпосередньо у версії 3.0. Користувачі, чий робочий процес включав збереження CSVfiles безпосередньо на карту SD, інакше клієнту тепер потрібно буде спочатку перетворити двійковий файл file у CSV, використовуючи клієнтську програму або встановивши окремий Liquid Instruments File Конвертер на комп'ютер, який вони використовують для обробки даних.
Несумісні зміни
Масштабування даних в LIA
У версії 1.9 ми реалізували масштабування даних таким чином, що множення двох сигналів 0.1 В постійного струму призвело до виходу 0.02 В постійного струму. У версії 3.0 ми змінили це так, що результат склав 0.01 В постійного струму, що більше відповідає інтуїтивним очікуванням клієнтів.
Вихід Waveform Generator має бути ввімкнено, щоб використовувати його як джерело/тригер модуляції
У версії 1.9 форма хвилі іншого каналу могла використовуватися як джерело модуляції або тригера в Генераторі сигналів, навіть якщо вихід цього каналу було вимкнено. Це було видалено у версії
- Користувачі, які бажають виконувати крос-модуляцію без необхідності від’єднувати виходи свого пристрою, повинні налаштувати свої
Moku MATLAB API
Пакет Moku MATLAB API v3.0 призначений для того, щоб надати розробникам MATLAB ресурси, необхідні для керування будь-яким пристроєм Moku, і, зрештою, можливість інтегрувати ці засоби керування у великі програми для кінцевих користувачів. Новий пакет Moku MATLAB API v3.0 надає наступне:
- Повністю функціональний напрample сценарії MATLAB для кожного
- Усі сценарії MATLAB забезпечені коментарями, які легко зрозуміти та можуть служити відправною точкою для кінцевого користувача для налаштування та
- Набір функцій, що забезпечують повний контроль над Moku
Підтримувані інструменти
- Генератор сигналів довільної форми
- Реєстратор даних
- Блок цифрових фільтрів
- FIR Filter Builder
- Аналізатор частотної характеристики
- Коробка лазерного замка
- Блокування Ampлібератор
- Осцилограф
- Фазометр
- ПІД контролер
- Аналізатор спектру
- Генератор сигналів
- Режим кількох інструментів
- Moku Cloud Compile
монтаж
Вимоги
- MATLAB версії 2015 або новішої
Якщо у вас уже встановлено попередню версію API Moku MATLAB, видаліть її, перш ніж продовжити. Ви можете видалити пакет із диспетчера надбудов.
- Відкрийте диспетчер надбудов на вкладці «Домашня сторінка» > «Середовище».
- шукати Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
- Крім того, ви можете завантажити інструментарій безпосередньо з Liquid Instruments webсайт за адресою https://www.liquidinstruments.com/products/apis/matlab-api/. Якщо ви зробите це, вам доведеться встановити шлях пошуку вручну.
- Перевірте, чи правильний шлях додано до панелі інструментів, вибравши «Установити шлях» на вкладці «Домашня сторінка» > «Середовище».
- Переконайтеся, що є вхід, який вказує на місце встановлення панелі інструментів. Типовим шляхом може бути CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
- Завантажте дані приладу files, ввівши 'moku_download####) у вікні команд MATLAB. ### слід замінити поточною версією мікропрограми. Yol може знайти вашу поточну версію мікропрограми за допомогою Moku: комп’ютерної програми, клацнувши правою кнопкою миші на вашому Moku та навівши курсор на пункт «Інформація про пристрій», або в додатку iPad, довго натискаючи на Moku.
- Переконайтеся, що панель інструментів налаштована правильно, ввівши «help Moku» у вікні команд MATLAB. Якщо ця команда виконана успішно. тоді панель інструментів успішно встановлена
Зміни Moku API
Нова архітектура Moku MATLAB API значно відрізняється від своєї попередниці, тому не сумісна з існуючими сценаріями API. Наступний спрощений осцилограф напрample показує відмінності між застарілими та новими пакетами API та служить дорожньою картою для перенесення існуючого коду.
Осцилограф прample
Послідовність кроків
- Імпортуйте Moku MATLAB API 3.0
- Заявіть право власності на Moku та завантажте бітовий потік осцилографа
- Встановіть базу часу та встановіть лівий і правий діапазон для осі часу.
- Отримайте дані, отримайте один кадр даних з осцилографа
- Завершіть сеанс клієнта, відмовившись від права власності на Moku
Послідовність, описана вище, є спрощеним прикладомample, щоб проілюструвати відмінності між застарілими та новими пакетами API. Окрім початку сеансу клієнта, завантаження бітового потоку інструменту в Moku та завершення сеансу клієнта, кінцевий користувач може використовувати будь-яку кількість функцій у різному порядку відповідно до потреб своєї програми.
відмінності
Тут ми розглядаємо відмінності між двома APl для кожного кроку в послідовності.
Заявіть право власності на Moku та завантажте бітовий потік осцилографа на пристрій. У порівнянні з Moku MATLAB 1.9 новий API має зовсім інші функції:
| Moku MATLAB 1.9 | Moku MATLAB 3.0 | ||
| функція | get_by_name() | deploy_or_conn ect() | Осцилограф() |
| Дозволені поля та значення | ім'я: тайм-аут рядка: float | інструмент: клас інструменту, який потрібно розгорнути | ip: рядок serial: рядок |
| сила: бул | set_defauIt: booI | force_connect: bool | |
| use_externa I: bool | ignore_busy: лог | ||
| persist_state: bool | |||
| connect_timeout: float | |||
| read_timeout: float | |||
- Встановити базу часу. Функція та сама, але дозволені аргументи дещо відрізняються:
Moku MATLAB 1.9 Moku MATLAB 3.0 функція set_timebase() set_timebase() Дозволені поля та значення t1: float t2: float t1: float t2: float strict: bool - Отримати дані. Функції та дозволені аргументи однакові, але тип і довжина повернутих даних відрізняються:
Moku MATLAB 1.9 Moku MATLAB 3.0 функція get_data() get_data() Дозволені поля та значення тайм-аут: float wait: bool тайм-аут: float wait_reacquire: bool Зворотна довжина 16383 точки на кадр 1024 точки на кадр - Відпустіть право власності на Moku:
Moku MATLAB 1.9 Moku API версії 3.0 функція закрити() relinquish_ownership()
Список функцій осцилографа
| 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_rampхвиляО
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 |
| встановити_гістерезисQ
встановити_інтерпо!аціюO |
|
| set_input_attenuationO | |
| set_sourceO
osc_measurementQ |
|
| резюмеQ |
Moku MATLAB API заснований на Moku API. Щоб отримати повну документацію щодо Moku API, зверніться до довідника Moku API Reference тут https://apis.liq uidinstrume nts.com/re fe rence/.
Додаткову інформацію щодо початку роботи з Moku MATLAB API можна знайти за адресою https://a pis.liquid instruments.com/sta рейтинг-Matlab.додому
Процес пониження
Якщо доведено, що оновлення до версії 3.0 обмежує або іншим чином негативно впливає на щось критичне для вашої програми, ви можете повернутися до попередньої версії 1.9. Це можна зробити через a web браузер.
Кроки
- Зверніться до компанії Liquid Instruments і отримайте file для версії прошивки 9.
- Введіть IP-адресу Moku:Lab у поле a web браузер (див. скріншот).
- У розділі «Оновити мікропрограму» перегляньте та виберіть мікропрограму file надається компанією Liquid Instruments.
- Виберіть Завантажити й оновити. Процес оновлення може тривати більше 10 хвилин
© 2023 Liquid Instruments. зарезервований.
Документи / Ресурси
 |
Інтеграція LIQUID INSTRUMENTS MATLAB API [pdfПосібник користувача MATLAB API, інтеграційні запобіжники MATLAB API, інтеграційні запобіжники, запобіжники |