Інтэграцыйныя засцерагальнікі 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. Абнаўленне адкрывае мноства новых функцый для многіх існуючых інструментаў. Ён таксама дадае дзве новыя функцыі: рэжым некалькіх інструментаў і Moku Cloud Compile. Ёсць таксама некаторыя тонкія адрозненні ў паводзінах, апісаныя ў раздзеле "Зваротная сумяшчальнасць".
Гэта сур'ёзнае абнаўленне, якое ўплывае на архітэктуру API, і таму новы пакет API MATLAB v3.0 не будзе мець зваротнай сумяшчальнасці з існуючымі сцэнарыямі MATLAB. Карыстальнікам API трэба будзе перанесці свае скрыпты ў новы пакет Moku API, калі яны абновяць свой 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
Moku Cloud Compile дазваляе разгортваць карыстальніцкі DSP непасрэдна на Moku:Lab FPGA у рэжыме некалькіх інструментаў. Напісаць код з дапамогай a web браўзер і сабраць яго ў воблаку; Moku Cloud Compile разгортвае бітавы паток на адну або некалькі мэтавых прылад Moku.
Асцылограф
- Рэжым глыбокай памяці: захавайце да 4 млн сampлес на канал пры поўнай сampхуткасць лінга (500 Мвыб/с)
Аналізатар спектру
- Палепшаны ўзровень шуму
- Лагарыфмічная сярэдняя і Vpp шкала
- Пяць новых аконных функцый (Бартлетта, Хэмінга, Натала, Гаўса, Кайзера)
Фаземетр
- Зрушэнне частоты, фаза і amplitude цяпер можна выводзіць як аналагавы voltagе сігналы
- Цяпер карыстальнікі могуць дадаваць зрушэнне пастаяннага току да выхадных сігналаў
- Выхад сінусоіднай хвалі з фазавай блакіроўкай цяпер можа быць памножаны на частату да 2 50x або падзелены на 125x
- Палепшаны дыяпазон прапускной здольнасці (ад 1 Гц да 100 кГц)
- Пашыраныя функцыі пераносу фаз і аўтаматычнага скіду
Генератар формаў хваль
- Шум выводзіцца
- Шырока імпульсная мадуляцыя (ШІМ)
Блакаванне Ampзадымнік
- Палепшаная прадукцыйнасць нізкіх частот PLL замыканне
- Мінімальная частата PLL была зніжана да 10 Гц
- Унутраны сігнал PLL цяпер можа быць памножаны на частату да 250x або падзелены на 125x для выкарыстання ў дэмадуляцыі
- 6-значная дакладнасць значэнняў фазы
Аналізатар частотнай характарыстыкі
- Максімальная частата павялічана са 120 МГц да 200 МГц
- Павялічце максімальныя кропкі разгорткі з 512 да 8192
- Новая дынаміка Ampфункцыя litude аўтаматычна аптымізуе выхадны сігнал для лепшага дынамічнага дыяпазону вымярэнняў
- Новы рэжым вымярэння ln/ln1
- Папярэджанні пра насычанасць уводу
- Матэматычны канал цяпер падтрымлівае адвольныя комплексныя ўраўненні, якія ўключаюць сігналы канала, дазваляючы новыя тыпы складаных вымярэнняў перадаткавай функцыі
- Уваходныя сігналы цяпер можна вымяраць у dBVpp і dBVrms у дадатак да дБм
- Прагрэс разгорткі цяпер адлюстроўваецца на графіцы
- Цяпер вось частаты можна заблакіраваць, каб прадухіліць выпадковыя змены падчас доўгай разгорткі
Скрынка лазернага замка
- Палепшаная блок-схема паказвае шляхі сканавання і мадуляцыі сігналаў
- Новы замак сtagГэтая функцыя дазваляе наладзіць працэдуру блакіроўкі
- Палепшаная прадукцыйнасць нізкіх частот 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 В пастаяннага току, што больш адпавядае інтуітыўным чаканням кліентаў.
Выхад генератара сігналу павінен быць уключаны для выкарыстання ў якасці крыніцы/трыгера мадуляцыі
У версіі 1.9 форма сігналу іншага канала можа выкарыстоўвацца ў якасці крыніцы мадуляцыі або запуску ў генератары сігналаў, нават калі выхад гэтага канала быў адключаны. Гэта было выдалена ў версіі
- Карыстальнікі, якія жадаюць зрабіць крос-мадуляцыю без неабходнасці адключаць выхады сваёй прылады, павінны будуць наладзіць іх
Moku MATLAB API
Пакет Moku MATLAB API v3.0 прызначаны для прадастаўлення распрацоўшчыкам MATLAB рэсурсаў, неабходных для кіравання любой прыладай Moku, і, у канчатковым рахунку, магчымасці ўбудаваць гэтыя элементы кіравання ў больш буйныя дадаткі канчатковых карыстальнікаў. Новы пакет Moku MATLAB API v3.0 забяспечвае наступнае:
- Цалкам функцыянальны напрample скрыпты MATLAB для кожнага
- Усе скрыпты MATLAB забяспечаны каментарыямі, якія лёгка зразумець і могуць служыць канчатковаму карыстальніку адпраўной кропкай для наладкі і
- Набор функцый, якія забяспечваюць поўны кантроль над Moku
У цяперашні час падтрымліваюцца інструменты
- Генератар адвольнай формы
- Рэгістратар даных
- Скрынка лічбавага фільтра
- Канструктар фільтраў FIR
- Аналізатар частотнай характарыстыкі
- Скрынка лазернага замка
- Блакаванне Ampзадымнік
- Асцылограф
- Фаземетр
- ПІД кантролер
- Аналізатар спектру
- Генератар формаў хваль
- Рэжым некалькіх інструментаў
- Кампіляцыя 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\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: радок паслядоўны: радок |
| сіла: бул | set_defauIt: booI | прымусовае_злучэнне: бул | |
| выкарыстоўваць_вонкавы I: бул | ignore_busy: бул | ||
| persist_state: бул | |||
| час чакання злучэння: плавае | |||
| read_timeout: float | |||
- Усталюйце базу часу. Функцыя такая ж, але дазволеныя аргументы трохі адрозніваюцца:
Moku MATLAB 1.9 Moku MATLAB 3.0 Функцыя set_timebase() set_timebase() Дазволеныя палі і значэнні t1: float t2: float t1: float t2: float строгі: бул - Атрымаць дадзеныя. Функцыі і дазволеныя аргументы аднолькавыя, але тып і даўжыня вяртаемых даных адрозніваюцца:
Moku MATLAB 1.9 Moku MATLAB 3.0 Функцыя атрымаць_дадзеныя() атрымаць_дадзеныя() Дазволеныя палі і значэнні тайм-аўт: float чакаць: bool тайм-аўт: float wait_reacquire: bool Зваротная даўжыня 16383 кропкі за кадр 1024 кропкі за кадр - Адпусціце права ўласнасці на Moku:
Moku MATLAB 1.9 Moku API версіі 3.0 Функцыя зачыніць() адмовіцца ад уласнасці()
Спіс функцый асцылографа
| Moku MATLAB 1.9 | Moku MATLAB 3.0 |
| ўсталяваць_крыніцуO | набор_крыніцO |
| ўсталяваць_трыгерO | ўсталяваць_трыгерO |
| атрымаць_дадзеныяQ | атрымаць_дадзеныяQ |
| 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 |
| атрымаць_samp!erateO
get_rea!time_dataQ |
атрымаць_samp!erateO
save_high_res_bufferO |
| ген_рampхваляO
gen_sinewaveO |
генераваць_форму хваліO
get_acquisition_modeQ |
| gen_squarewaveQ | get_sourcesQ |
| gen_offQ | get_timebaseQ
get_output_!oadQ |
| набор_сampчытацьQ
set_framerateQ |
get_interpo!ationO набор_вываду_!нагрузкаQ |
| усталяваны_гістэрэзісQ
набор_інтэрпа!ацыіО |
|
| набор_паслаблення_уваходуO | |
| ўсталяваць_крыніцуO
osc_вымярэннеQ |
|
| рэзюмэQ |
API Moku MATLAB заснаваны на API Moku. Для атрымання поўнай дакументацыі па 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. Гэта можна зрабіць праз 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, інтэграцыйныя засцерагальнікі, засцерагальнікі |