ТЕЧНИ ИНСТРУМЕНТИ 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 платформи. Ажурирањето отклучува мноштво нови функции на многу од постоечките инструменти. Додава и две нови функции: режим на повеќе инструменти и Moku Cloud Compile. Има и некои суптилни разлики во однесувањето, наведени во делот за компатибилност наназад.
Ова е големо ажурирање кое влијае на архитектурата на API и затоа новиот пакет MATLAB API v3.0 нема да биде компатибилен со постојните MATLAB скрипти. Корисниците на API ќе треба да ги пренесат своите скрипти во новиот Moku API пакет доколку ја надградат својата Moku:Lab на верзијата 3.0. Корисниците на API со значителен сопствен развој на софтвер треба внимателно да го разгледаат нивото на напор што е потребно за пренесување на нивниот постоечки код. Moku:Lab 1.9 не се препорачува за нови распоредувања и сите клиенти се охрабруваат да го надградат. Ако се појават проблеми по надградбата, корисниците ќе имаат можност да се намалат на верзијата на софтверот 1.9.
Овој водич за миграција ги прикажува напреднитеtagАжурирање и потенцијални компликации на Moku:Lab верзија 3.0. Исто така, го опишува процесот за надградба на MATLAB API и како да го деградирате вашиот Moku:Lab доколку е потребно.
Нови функции во верзијата 3.0
Нови карактеристики
Софтверската верзија 3.0 носи Multi-Instrument Mode и Moku Cloud Compile во Moku:Lab за прв пат, како и многу надградби на перформансите и употребливоста низ пакетот инструменти.
Режим на повеќе инструменти
Мулти-инструментниот режим на Moku:Lab им овозможува на корисниците да распоредат два инструменти истовремено за да создадат сопствена тест станица. Секој инструмент има целосен пристап до аналогните влезови и излези заедно со меѓусебните врски помеѓу отворите за инструменти. Меѓусебните врски помеѓу инструментите поддржуваат дигитална комуникација со голема брзина, мала латентност, во реално време до 2 Gb/s, така што инструментите можат да работат независно или да се поврзат за да се изградат напредни цевководи за обработка на сигналот. Инструментите може динамички да се заменуваат во и надвор без да се прекине другиот инструмент. Напредните корисници исто така можат да распоредат свои сопствени алгоритми во режим на повеќе инструменти користејќи Moku Cloud Compile.
Компајлирање на Moku Cloud
Moku Cloud Compile ви овозможува да распоредите сопствен DSP директно на Moku:Lab FPGA во режим на повеќе инструменти. Напишете код користејќи a web прелистувач и компајлирај го во облакот; Moku Cloud Compile го распоредува битстримот на еден или повеќе целни Moku уреди.
Осцилоскоп
- Режим на длабока меморија: заштедете до 4M samples по канал на целосна sampстапка на линг (500 MSa/s)
Спектрален анализатор
- Подобрен под за бучава
- Логаритмска Vrms и Vpp скала
- Пет нови функции на прозорецот (Бартлет, Хаминг, Нутал, Гаусиан, Кајзер)
Фаземетар
- Поместување на фреквенцијата, фаза и amplitude сега може да се емитува како аналоген voltage сигнали
- Корисниците сега можат да додадат DC поместување на излезните сигнали
- Излезот на синусниот бран заклучен со фази сега може да се множи со фреквенција до 2 50x или да се подели на 125x
- Подобрен опсег на пропусниот опсег (1 Hz до 100 kHz)
- Напредни функции за завиткување фази и автоматско ресетирање
Генератор на бранови форми
- Излез на бучава
- Модулација на ширина на пулсот (PWM)
Заклучи во Ampживописен
- Подобрени перформанси на ниска фреквенција PLL заклучување
- Минималната PLL фреквенција е намалена на 10 Hz
- Внатрешниот PLL сигнал сега може да се множи со фреквенција до 250xor поделен на 125x за употреба при демодулација
- 6-цифрена прецизност за фазни вредности
Анализатор на фреквентен одговор
- Зголемена максимална фреквенција од 120 MHz на 200 MHz
- Зголемете ги максималните точки на бришење од 512 на 8192
- Новиот Динамик AmpФункцијата litude автоматски го оптимизира излезниот сигнал за најдобар динамички опсег за мерење
- Нов режим на мерење ln/ln1
- Влезни предупредувања за сатурација
- Математичкиот канал сега поддржува произволни равенки со сложена вредност кои ги вклучуваат сигналите на каналот, овозможувајќи нови типови мерења на сложени преносни функции
- Влезните сигнали сега може да се мерат во dBVpp и dBVrms покрај dBm
- Напредокот на чистењето сега е прикажан на графиконот
- Оската на фреквенцијата сега може да се заклучи за да се спречат случајни промени за време на долго чистење
Кутија за заклучување со ласер
- Подобрениот блок дијаграм ги прикажува патеките на сигналот за скенирање и модулација
- Новото заклучување сtages функцијата овозможува прилагодување на постапката за заклучување
- Подобрени перформанси на ниска фреквенција PLL заклучување
- 6-цифрена прецизност за фазни вредности
- Подобрени перформанси на ниска фреквенција PLL заклучување
- Минималната PLL фреквенција е намалена на 10 Hz
- На 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 меморијата на уредот, кој може да се користи за евидентирање податоци на високи сampстапки на линг. Во верзијата 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, или користејќи ја клиентската апликација или со инсталирање на самостојните течни инструменти File Конвертор на компјутерот што го користат за обработка на податоци.
Не-назад-компатибилни промени
Скалирање на податоци во LIA
Во верзијата 1.9, имплементиравме скалирање на податоци така што множењето на два DC сигнали од 0.1 V резултираше со излез од 0.02 V DC. Во верзијата 3.0, го променивме ова така што резултатот беше 0.01 V DC, што е повеќе во согласност со интуитивните очекувања на клиентите.
Излезот на генератор на бранови мора да биде овозможен за користење како извор/активатор на модулација
Во верзијата 1.9, брановиот облик на различен канал може да се користи како модулација или извор на активирање во Генераторот на бранови форми, дури и ако излезот на тој канал е оневозможен. Ова беше отстрането во верзијата
- Корисниците кои сакаат да направат вкрстена модулација без потреба од исклучување на излезите на нивниот уред, ќе треба да ги прилагодат своите
Moku MATLAB API
Пакетот Moku MATLAB API v3.0 е наменет да им обезбеди на програмерите на MATLAB ресурсите потребни за контрола на кој било уред Moku и, на крајот, способноста да се вклучат овие контроли во поголеми апликации на крајните корисници. Новиот Moku MATLAB API v3.0 пакет го обезбедува следново:
- Целосно функционален прample MATLAB скрипти за секој
- Сите скрипти на MATLAB се обезбедени со коментари, кои се лесни за разбирање и можат да послужат како почетна точка на крајниот корисник за прилагодување и
- Збир на функции кои обезбедуваат целосна контрола над Моку
Моментално поддржани инструменти
- Произволен генератор на бранови форми
- Дневник на податоци
- Дигитална филтер кутија
- FIR филтер Градител
- Анализатор на фреквентен одговор
- Кутија за заклучување со ласер
- Заклучување Ampживописен
- Осцилоскоп
- Фаземетар
- PID контролер
- Спектрален анализатор
- Генератор на бранови форми
- Режим на повеќе инструменти
- Компајлирање на Moku Cloud
Инсталација
Барања
- MATLAB верзија 2015 или понова
Ако веќе имате инсталирано претходна верзија на Moku MATLAB API, ве молиме деинсталирајте ја пред да продолжите. Можете да го деинсталирате пакетот од Управувачот со додатоци.
- Отворете го Управникот со додатоци преку табулаторот Дома > Животна средина.
- Пребарај за 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\MATLABAd-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
Редоследот опишан погоре е поедноставен прampза да се илустрираат разликите помеѓу наследените и новите API пакети. Покрај започнувањето на сесијата на клиентот, поставувањето на битстрим на инструментот во Moku и завршувањето на сесијата на клиентот, крајниот корисник може да изврши било кој број функции во различен редослед за да ги задоволи потребите на нивната апликација.
Разлики
Овде, ги разгледуваме разликите помеѓу двата APls за секој чекор во низата.
Побарајте ја сопственоста на Moku и поставете го битстримот на осцилоскоп на уредот. Во споредба со Moku MATLAB 1.9, новиот API има сосема различни функции:
| Moku MATLAB 1.9 | Moku MATLAB 3.0 | ||
| Функција | get_by_name () | deploy_or_conn ect() | Осцилоскоп () |
| Дозволени полиња и вредности | име: истек на стринг: плови | инструмент: класата на инструментот што сака да се распореди | ip: стринг сериски: стринг |
| сила: бул | set_defauIt: booI | force_connect: бул | |
| use_externa I: бул | ignore_busy: бул | ||
| persist_state: бул | |||
| connect_timeout: плови | |||
| read_timeout: плови | |||
- Поставете временска база. Функцијата е иста, но дозволените аргументи се малку различни:
Moku MATLAB 1.9 Moku MATLAB 3.0 Функција set_timebase() set_timebase() Дозволени полиња и вредности t1: float t2:float t1: float t2:float строг: bool - Добијте податоци. Функциите и дозволените аргументи се исти, но вратениот тип на податоци и должина се различни:
Moku MATLAB 1.9 Moku MATLAB 3.0 Функција get_data () get_data () Дозволени полиња и вредности тајмаут: плови чекај: бул тајмаут: float wait_reacquire: bool Должина на враќање 16383 поени по рамка 1024 поени по рамка - Ослободете ја сопственоста на Moku:
Moku MATLAB 1.9 Moku API v3.0 Функција затвори () relinquish_ownership()
Список на функции на осцилоскоп
| Moku MATLAB 1.9 | Moku MATLAB 3.0 |
| постави_изворО | поставете_извориО |
| 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 |
| земаamp!erateO
get_rea!time_dataQ |
земаamp!erateO
save_high_res_bufferO |
| gen_rampбранО
gen_sinewaveO |
генерира_бранова формаО
get_acquisition_modeQ |
| gen_squarewaveQ | get_sourcesQ |
| gen_offQ | get_timebaseQ
get_output_!oadQ |
| сет_сamplerateQ
set_framerateQ |
get_interpo!ationO set_output_!oadQ |
| set_hysteresisQ
set_interpo!ationO |
|
| постави_влез_слабеењеО | |
| постави_изворО
osc_measurementQ |
|
| резимеП |
Moku MATLAB API се базира на Moku API. За целосна документација за Moku API, погледнете ја референцата на Moku API што се наоѓа овде https://apis.liq uidinstrume nts.com/re fe rence/.
Дополнителни детали за започнување со Moku MATLAB API може да се најдат на https://a pis.liquid instruments.com/sta рејтинг- Matlab.дома
Процес на деградирање
Ако надградбата до верзијата 3.0 се покажа дека ограничува или на друг начин негативно влијае на нешто критично за вашата апликација, можете да ја намалите верзијата на претходната верзија 1.9. Ова може да се направи преку а web прелистувач.
Чекори
- Контактирајте со Liquid Instruments и набавете го file за верзијата на фирмверот 9.
- Внесете ја вашата IP адреса Moku:Lab во a web прелистувач (види слика од екранот).
- Под Ажурирање на фирмверот, прелистајте и изберете го фирмверот file обезбедени од Liquid Instruments.
- Изберете Постави и ажурирање. Процесот на ажурирање може да потрае повеќе од 10 минути за да се заврши
© 2023 Liquid Instruments. резервирани.
Документи / ресурси
 |
ТЕЧНИ ИНСТРУМЕНТИ MATLAB API Интеграциски осигурувачи [pdf] Упатство за корисникот MATLAB API, MATLAB API Осигурувачи за интеграција, осигурувачи за интеграција, осигурувачи |