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 архитектурата и следователно новият пакет MATLAB API v3.0 няма да бъде обратно съвместим със съществуващите MATLAB скриптове. Потребителите на API ще трябва да пренесат своите скриптове към новия пакет Moku API, ако надстроят своя Moku:Lab до версия 3.0. Потребителите на API със значителна разработка на персонализиран софтуер трябва внимателно да обмислят нивото на усилие, необходимо за пренасяне на техния съществуващ код. Moku:Lab 1.9 не се препоръчва за нови внедрявания и всички клиенти се насърчават да надстроят. Ако възникнат проблеми след надстройката, потребителите ще имат възможност да преминат към версия на софтуера 1.9.

Това ръководство за миграция очертава advantages на актуализиране и потенциални усложнения за Moku:Lab версия 3.0. Той също така очертава процеса за надграждане на API на MATLAB и как да понижите вашия Moku:Lab, ако е необходимо.

Версия 3.0 нови функции

Нови функции

Софтуерната версия 3.0 носи за първи път Multi-Instrument Mode и Moku Cloud Compile в Moku:Lab, както и много подобрения на производителността и използваемостта в пакета от инструменти.

Режим с множество инструменти

Режимът с множество инструменти на Moku:Lab позволява на потребителите да разположат два инструмента едновременно, за да създадат персонализирана тестова станция. Всеки инструмент има пълен достъп до аналоговите входове и изходи заедно с връзките между слотовете на инструмента. Връзките между инструментите поддържат високоскоростна цифрова комуникация в реално време с ниска латентност до 2 Gb/s, така че инструментите могат да работят независимо или да бъдат свързани за изграждане на усъвършенствани тръбопроводи за обработка на сигнали. Инструментите могат да се сменят динамично навътре и навън, без да се прекъсва другият инструмент. Напредналите потребители могат също така да разположат свои собствени персонализирани алгоритми в режим с множество инструменти, използвайки Moku Cloud Compile.

Moku Cloud Compile

Moku Cloud Compile ви позволява да внедрите персонализиран DSP директно върху Moku:Lab FPGA в режим Multi instrument. Напишете код с помощта на a web браузър и го компилирайте в облака; Moku Cloud Compile разгръща побитовия поток към едно или повече целеви Moku устройства.

Осцилоскоп

• Режим на дълбока памет: спестете до 4M samples на канал при пълен sampскорост на линг (500 MSa/s)

Spectrum Analyzer

• Подобрен под на шума
• Логаритмична Vrms и Vpp скала
• Пет нови прозоречни функции (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Фазомер

• Отместване на честотата, фаза и amplitude вече може да се извежда като аналогов обемtagд сигнали
• Потребителите вече могат да добавят DC отместване към изходните сигнали
• Изходът на фазово заключената синусоида вече може да бъде умножен по честота до 2 50x или разделен на 125x
• Подобрен обхват на честотната лента (1 Hz до 100 kHz)
• Разширено фазово обвиване и функции за автоматично нулиране

Генератор на вълна

• Шум изход
• Модулация с широчина на импулса (PWM)

заключвам Ampлифир

• Подобрена производителност на ниските честоти PLL заключване
• Минималната PLL честота е намалена до 10 Hz
• Вътрешният PLL сигнал вече може да бъде умножен по честота до 250x или разделен на 125x за използване при демодулация
• 6-цифрена точност за фазовите стойности

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

• Повишена максимална честота от 120 MHz на 200 MHz
• Увеличете максималните точки за почистване от 512 на 8192
• Новата динамика Ampфункцията litude оптимизира автоматично изходния сигнал за най-добър динамичен диапазон на измерване
• Нов режим на измерване ln/ln1
• Предупреждения за насищане на входа
• Математическият канал вече поддържа произволни уравнения с комплексни стойности, включващи каналните сигнали, което позволява нови типове измервания на сложни функции на предаване
• Входните сигнали вече могат да се измерват в dBVpp и dBVrms в допълнение към dBm
• Напредъкът на почистването вече се показва на графиката
• Честотната ос вече може да бъде заключена, за да се предотвратят случайни промени по време на дълго сканиране

Кутия за лазерно заключване

• Подобрената блокова диаграма показва пътищата на сигнала за сканиране и модулация
• Новото заключване stagФункцията es позволява персонализиране на процедурата за заключване
• Подобрена производителност на ниските честоти PLL заключване
• 6-цифрена точност за фазовите стойности
• Подобрена производителност на ниските честоти PLL заключване
• Минималната PLL честота е намалена до 10 Hz
• 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 MB fileсистема в RAM на устройството, която може да се използва за регистриране на данни при високи sampлинг ставки. Във версия 3.0 записването в RAM вече не е налично. За да активирате регистриране на данни, е необходима SD карта. Съответно се променя и максималната скорост на придобиване. Версия 1.9 поддържа до 1 MSa/s, докато версия 3.0 поддържа до 250 kSa/s при 1 канал и 125 kSa/s при 2 канала. Дори при по-ниски скорости и със SD карта работните потоци, които включват запазване на множество високоскоростни регистрационни файлове в RAM и след това по-късно копирането им на SD картата или клиента, вече няма да се поддържат.

Записване на данни в CSV

Версия 1.9 имаше способността да записва данни директно в CSV file докато регистрирате. Тази функция не е директно достъпна във версия 3.0. Потребители, чийто работен процес включваше запазване на CSVfiles директно към SD карта или клиентът сега ще трябва първо да конвертира двоичния файл file към CSV, като използвате клиентското приложение или като инсталирате самостоятелния Liquid Instruments File Конвертор към компютъра, който използват за обработка на данни.

Промени без обратна съвместимост

Мащабиране на данни в LIA

Във версия 1.9 внедрихме мащабиране на данни, така че умножаването на два 0.1 V DC сигнала доведе до 0.02 V DC изход. Във версия 3.0 променихме това така, че резултатът беше 0.01 V DC, което е по-в съответствие с интуитивните очаквания на клиентите.

Изходът на Waveform Generator трябва да бъде активиран, за да се използва като модулационен източник/тригер

Във версия 1.9 вълновата форма на различен канал може да се използва като модулация или източник на задействане в генератора на вълнови форми, дори ако изходът на този канал е деактивиран. Това беше премахнато във версията

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

Moku MATLAB API

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

• Напълно функционален прample MATLAB скриптове за всеки
• Всички MATLAB скриптове са снабдени с коментари, които са лесни за разбиране и могат да служат като отправна точка на крайния потребител за персонализиране и
• Набор от функции, осигуряващи пълен контрол над Moku

Текущо поддържани инструменти

1. Генератор на произволна форма на вълната
2. Регистратор на данни
3. Цифрова филтърна кутия
4. Конструктор на FIR филтри
5. Анализатор на честотния спектър
6. Кутия за лазерно заключване
7. Заключване Ampлифир
8. Осцилоскоп
9. Фазомер
10. PID контролер
11. Spectrum Analyzer
12. Генератор на вълна
13. Режим с множество инструменти
14. Moku Cloud Compile

Монтаж

Изисквания

• 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. Уверете се, че има вход, сочещ към мястото за инсталиране на кутията с инструменти. Типичен път може да бъде CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Изтеглете данните за инструмента files, като напишете 'moku_download####) в командния прозорец на MATLAB. ### трябва да бъде заменен с текущата ви версия на фърмуера. Yol може да намери текущата ви версия на фърмуера чрез приложението Moku: за настолни компютри, като щракнете с десния бутон върху вашия Moku и задържите курсора върху „Информация за устройството“ или в приложението за iPad чрез продължително натискане на вашия Moku.
7. Потвърдете, че вашата кутия с инструменти е настроена правилно, като напишете 'help Moku' в командния прозорец на MATLAB. Ако тази команда е успешна. тогава кутията с инструменти е инсталирана успешно

Промени в Moku API

Новата API архитектура на Moku MATLAB е достатъчно различна от своя предшественик и следователно не е обратно съвместима със съществуващите API скриптове. Следният опростен осцилоскоп напрample показва разликите между наследените и новите API пакети и служи като пътна карта за пренасяне на съществуващ код.

Осцилоскоп прample

Стъпки на последователност

1. Импортирайте Moku MATLAB API 3.0
2. Заявете собственост върху Moku и качете битовия поток на осцилоскопа в
3. Задайте времева база и задайте ляв и десен диапазон за времевата ос.
4. Вземете данни, вземете един кадър от данните от осцилоскопа
5. Прекратете клиентската сесия, като се откажете от собствеността върху 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()	осцилоскоп()
Позволени полета и стойности	име: таймаут на низ: плаващ	инструмент: класът на инструмента, който желаете да разположите	ip: низ сериен: низ
	сила: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: float
			read_timeout: float

 

1. Задайте времева база. Функцията е същата, но разрешените аргументи са малко по-различни:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   функция	set_timebase()	set_timebase()
   Позволени полета и стойности	t1: float t2: float	t1: float t2: float strict: bool

2. Вземете данни. Функциите и разрешените аргументи са едни и същи, но върнатият тип и дължина на данните са различни:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   функция	get_data()	get_data()
   Позволени полета и стойности	изчакване: float изчакване: bool	изчакване: float wait_reacquire: bool
   Дължина на връщане	16383 точки на кадър	1024 точки на кадър

3. Освободете собствеността върху Moku:
   

   	Moku MATLAB 1.9	Moku API v3.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 enable_rollmodeQ
set_precision_modeQ	set_acquisition_modeQ
sync_phaseQ	sync_output_phaseQ
get_frontendQ	get_frontendQ
get_samp!erateO get_rea!време_данниQ	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
	зададен_хистерезисQ набор_интерпо!ацияO
	set_input_attenuationO
	set_sourceO osc_измерванеQ
	резюме Q

API на Moku MATLAB се основава на API на Moku. За пълната документация за API на Moku вижте справочника за API на Moku, който можете да намерите тук 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 браузър.

стъпки

1. Свържете се с Liquid Instruments и получете file за фърмуер версия 9.
2. Въведете своя IP адрес на Moku:Lab в a web браузър (вижте екранната снимка).
3. Под Актуализиране на фърмуера прегледайте и изберете фърмуера file предоставени от Liquid Instruments.
4. Изберете Качване и актуализиране. Процесът на актуализиране може да отнеме повече от 10 минути

© 2023 Liquid Instruments. запазено.

laudinstruments.com

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

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

Референции

• Ръководство за потребителя