LIQUID INSTRUMENTS MATLAB API Интеграция предохранителей

Руководство по миграции MATLAB API

Обновление Moku: Lab до версии 3.0 открывает множество новых функций. При обновлении пользователи API должны предпринять дополнительные шаги для переноса своих скриптов в новый пакет API Moku. В этом руководстве по миграции описаны изменения API, новые функции, доступные в обновлении версии 3.0, а также любые ограничения обратной совместимости.

Надview

Программное обеспечение Moku:Lab версии 3.0 — это крупное обновление, которое добавляет новую прошивку, пользовательский интерфейс и API для оборудования Moku:Lab. Обновление приводит Moku:Lab в соответствие с Moku:Pro и Moku:Go, упрощая обмен скриптами на всех платформах Moku. Обновление открывает множество новых функций для многих существующих инструментов. Он также добавляет две новые функции: многоинструментальный режим и облачную компиляцию Moku. Есть также некоторые тонкие поведенческие различия, описанные в разделе «Обратная совместимость».

Это серьезное обновление, которое влияет на архитектуру API, поэтому новый пакет MATLAB API 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

Moku Cloud Compile позволяет развертывать собственный DSP непосредственно на FPGA Moku:Lab в режиме нескольких приборов. Напишите код, используя web браузер и скомпилировать его в облаке; Moku Cloud Compile развертывает битовый поток на одном или нескольких целевых устройствах Moku.

Осциллограф

• Режим глубокой памяти: экономия до 4 МБ сampфайлов на канал при полной скоростиampскорость передачи данных (500 Мвыб/с)

Анализатор спектра

• Улучшенный уровень шума
• Логарифмическая шкала Vrms и Vpp
• Пять новых оконных функций (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Фазометр

• Смещение частоты, фазы и ampLitude теперь может выводиться как аналоговый vol.tagэлектронные сигналы
• Теперь пользователи могут добавлять смещение постоянного тока к выходным сигналам.
• Синусоидальный выходной сигнал с фазовой синхронизацией теперь можно умножить по частоте до 2 50x или разделить до 125x.
• Улучшенный диапазон полосы пропускания (от 1 Гц до 100 кГц)
• Расширенные функции переноса фаз и автоматического сброса

Генератор сигналов

• Выходной шум
• Широтно-импульсная модуляция (ШИМ)

Блокировка Ampпожизненнее

• Улучшены характеристики низких частот. ПЛЛ блокировка
• Минимальная частота PLL снижена до 10 Гц.
• Внутренний сигнал ФАПЧ теперь можно умножить по частоте до 250x или разделить до 125x для использования при демодуляции.
• 6-значная точность для значений фазы

Анализатор частотной характеристики

• Увеличена максимальная частота со 120 МГц до 200 МГц.
• Увеличьте максимальное количество точек развертки с 512 до 8192.
• Новая динамика AmpФункция высоты автоматически оптимизирует выходной сигнал для лучшего динамического диапазона измерения
• Новый режим измерения ln/ln1
• Предупреждения о перенасыщении входа
• Математический канал теперь поддерживает произвольные уравнения с комплексными значениями, включающие сигналы канала, что позволяет использовать новые типы измерений сложных передаточных функций.
• Входные сигналы теперь можно измерять не только в дБм, но и в dBVpp и dBVrms.
• Ход развертки теперь отображается на графике
• Ось частоты теперь можно заблокировать, чтобы предотвратить случайные изменения во время длинной развертки.

Ящик с лазерным замком

• Улучшенная блок-схема показывает пути прохождения сигналов сканирования и модуляции.
• Новый замокtagФункция es позволяет настроить процедуру блокировки
• Улучшены характеристики низких частот. ПЛЛ блокировка
• 6-значная точность для значений фазы
• Улучшены характеристики низких частот. ПЛЛ блокировка
• Минимальная частота PLL снижена до 10 Гц.
• The ПЛЛ сигнал теперь можно умножить по частоте до 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система в оперативной памяти устройства, которую можно было бы использовать для регистрации данных при высокой скоростиampлинговые ставки. В версии 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 В постоянного тока, что больше соответствует интуитивным ожиданиям клиентов.

Выход генератора сигналов должен быть включен для использования в качестве источника/триггера модуляции.

В версии 1.9 сигнал другого канала можно было использовать в качестве источника модуляции или запуска в генераторе сигналов, даже если выход этого канала был отключен. Это было удалено в версии

• Пользователям, которые хотят выполнять перекрестную модуляцию без необходимости отключения выходов своего устройства, необходимо настроить

Моку MATLAB API

Пакет Moku MATLAB API v3.0 предназначен для предоставления разработчикам MATLAB ресурсов, необходимых для управления любым устройством Moku, и, в конечном итоге, возможности включения этих элементов управления в более крупные приложения для конечных пользователей. Новый пакет Moku MATLAB API v3.0 предоставляет следующее:

• Полностью функциональный бывшийampсценарии MATLAB для каждого
• Все сценарии MATLAB снабжены комментариями, которые легко понять и которые могут служить конечным пользователем отправной точкой для настройки и настройки.
• Набор функций, обеспечивающих полный контроль над Moku.

Поддерживаемые в настоящее время инструменты

1. Генератор сигналов произвольной формы
2. Регистратор данных
3. Коробка цифрового фильтра
4. Конструктор КИХ-фильтров
5. Анализатор частотной характеристики
6. Ящик с лазерным замком
7. Блокировка Ampпожизненнее
8. Осциллограф
9. Фазометр
10. ПИД-регулятор
11. Анализатор спектра
12. Генератор сигналов
13. Мультиинструментальный режим
14. Облачная компиляция Moku

Установка

Требования

• MATLAB версии 2015 или новее

Если у вас уже установлена ​​предыдущая версия Moku MATLAB API, удалите ее, прежде чем продолжить. Вы можете удалить пакет из диспетчера дополнений.

1. Откройте диспетчер дополнений на вкладке «Главная» > «Среда».
2. Искать Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Кроме того, вы можете загрузить набор инструментов непосредственно с сайта Liquid Instruments. webсайт на https://www.liquidinstruments.com/products/apis/matlab-api/. В этом случае вам придется установить путь поиска вручную.
4. Убедитесь, что на панель инструментов добавлен правильный путь, выбрав «Установить путь» на вкладке «Главная» > «Среда».
5. Убедитесь, что существует запись, указывающая на место установки набора инструментов. Типичный путь может быть CAUserskuusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku- MATLAB.
6. Загрузите данные прибора files, набрав «moku_download####) в командном окне MATLAB. ### следует заменить текущей версией прошивки. Йол может найти текущую версию прошивки через приложение Moku: для настольного компьютера, щелкнув правой кнопкой мыши по вашему Moku и наведя курсор на «Информация об устройстве», или в приложении для iPad, нажав и удерживая Moku.
7. Подтвердите, что ваш набор инструментов настроен правильно, набрав «help Moku» в командном окне MATLAB. Если эта команда успешна. тогда набор инструментов был успешно установлен

Изменения API Моку

Новая архитектура API Moku MATLAB существенно отличается от своей предшественницы и, следовательно, не имеет обратной совместимости с существующими сценариями API. Следующий упрощенный пример осциллографаampФайл показывает различия между устаревшим и новым пакетами API и служит дорожной картой для переноса существующего кода.

Осциллограф эксample

Последовательность шагов

1. Импортируйте Moku MATLAB API 3.0.
2. Заявите право собственности на Moku и загрузите битовый поток осциллографа в
3. Установите временную базу и установите левый и правый диапазон оси времени.
4. Получите данные, получите один кадр данных с осциллографа.
5. Завершить сеанс клиента, отказавшись от владения Moku.

Описанная выше последовательность представляет собой упрощенный примерample, чтобы проиллюстрировать различия между устаревшими и новыми пакетами API. Помимо начала сеанса клиента, загрузки битового потока инструмента в Moku и завершения сеанса клиента, конечный пользователь может выполнять любое количество функций в различном порядке для удовлетворения потребностей своего приложения.

Различия

Здесь мы рассмотрим различия между двумя APl на каждом этапе последовательности.

Заявите право собственности на Moku и загрузите битовый поток осциллографа на устройство. По сравнению с Moku MATLAB 1.9 новый API имеет совершенно другие функции:

	Моку MATLAB 1.9		Моку MATLAB 3.0
Функция	get_by_name()	развертывание_or_conn ect()	Осциллограф()
Разрешенные поля и значения	имя: строка, тайм-аут: с плавающей запятой	инструмент: класс инструмента, который вы хотите развернуть	ip: строка серийный номер: строка
	сила: бул	set_defauIt: буИ	Force_connect: логическое значение
		use_externa I: bool	ignore_busy: логическое значение
			persist_state: логическое значение
			Connect_timeout: плавающий
			read_timeout: с плавающей запятой

 

1. Установите временную базу. Функция та же, но разрешенные аргументы немного отличаются:
   

   	Моку MATLAB 1.9	Моку MATLAB 3.0
   Функция	set_timebase()	set_timebase()
   Разрешенные поля и значения	t1: с плавающей запятой t2: с плавающей запятой	t1: float t2: float strict: bool

2. Получить данные. Функции и разрешенные аргументы одинаковы, но тип и длина возвращаемых данных различны:
   

   	Моку MATLAB 1.9	Моку MATLAB 3.0
   Функция	получить данные()	получить данные()
   Разрешенные поля и значения	тайм-аут: плавающее ожидание: bool	тайм-аут: с плавающей запятой wait_reacquire: bool
   Длина возврата	16383 очков за кадр	1024 очков за кадр

3. Освободите владение Моку:
   

   	Моку MATLAB 1.9	Моку API v3.0
   Функция	закрывать()	отказаться от_владения()

Список функций осциллографа

Моку MATLAB 1.9	Моку 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 Enable_rollmodeQ
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	генерировать_волновую формуO 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
	резюмеQ

API Moku MATLAB основан на API Moku. Полную документацию по API Moku можно найти в справочнике по API Moku, который можно найти здесь. https://apis.liq uidinstrume nts.com/re fe reнс /.

Дополнительную информацию о начале работы с Moku MATLAB API можно найти по адресу https://a pis.liquid instruments.com/sta рейтинг-Матлаб.дом

Процесс перехода на более раннюю версию

Если окажется, что обновление до версии 3.0 ограничивает или иным образом отрицательно влияет на что-то критическое для вашего приложения, вы можете вернуться к предыдущей версии 1.9. Это можно сделать через web браузер.

Шаги

1. Свяжитесь с Liquid Instruments и получите file для версии прошивки 9.
2. Введите свой IP-адрес Moku:Lab в web браузер (см. скриншот).
3. В разделе «Обновление прошивки» найдите и выберите прошивку. file предоставлено Liquid Instruments.
4. Выберите «Загрузить и обновить». Процесс обновления может занять более 10 минут.

© 2023 Ликвид Инструментс. сдержанный.

laudinstruments.com

Документы/Ресурсы

LIQUID INSTRUMENTS MATLAB API Интеграция предохранителей [pdf] Руководство пользователя MATLAB API, Интеграционные предохранители MATLAB API, Интеграционные предохранители, Предохранители

Ссылки

• Руководство пользователя