FLJÓTANDI INSTRUMENTS MATLAB API samþættingaröryggi

MATLAB API Migration Guide

Að uppfæra Moku: Lab í hugbúnaðarútgáfu 3.0 opnar fjölda nýrra eiginleika. Við uppfærslu verða API notendur að gera auka skref til að flytja forskriftir sínar yfir í nýja Moku API pakkann. Þessi flutningshandbók lýsir breytingum á API, nýjum eiginleikum sem eru fáanlegir í útgáfu 3.0 uppfærslunni og hvers kyns afturábakssamhæfistakmörkunum.

Yfirview

Moku:Lab hugbúnaðarútgáfa 3.0 er mikil uppfærsla sem færir nýjan fastbúnað, notendaviðmót og APls til Moku:Lab vélbúnaðar. Uppfærslan færir Moku:Lab í takt við Moku:Pro og Moku:Go, sem gerir það auðvelt að deila forskriftum á öllum Moku kerfum. Uppfærslan opnar fjölda nýrra eiginleika fyrir mörg núverandi hljóðfæri. Það bætir einnig við tveimur nýjum eiginleikum: Multi-instrument Mode og Moku Cloud Compile. Það er líka nokkur lúmskur munur á hegðun, lýst í kaflanum um afturábak eindrægni.

Þetta er mikil uppfærsla sem hefur áhrif á API arkitektúrinn og því mun nýi MATLAB API v3.0 pakkinn ekki vera afturábaksamhæfður við núverandi MATLAB forskriftir. API notendur þurfa að flytja forskriftir sínar yfir í nýja Moku API pakkann ef þeir uppfæra Moku:Lab í útgáfu 3.0. API notendur með verulega sérsniðna hugbúnaðarþróun ættu að íhuga vandlega hversu mikil áreynsla þarf til að flytja núverandi kóða þeirra. Ekki er mælt með Moku:Lab 1.9 fyrir nýja dreifingu og allir viðskiptavinir eru hvattir til að uppfæra. Ef vandamál koma upp eftir uppfærslu munu notendur hafa möguleika á að niðurfæra í hugbúnaðarútgáfu 1.9.

Þessi flutningshandbók útlistar advantaguppfærslur og hugsanlegar fylgikvilla Moku:Lab útgáfu 3.0. Það útlistar einnig ferlið við að uppfæra MATLAB API og hvernig á að niðurfæra Moku:Lab ef þörf krefur.

Útgáfa 3.0 nýir eiginleikar

Nýir eiginleikar

Hugbúnaðarútgáfa 3.0 færir í fyrsta skipti Multi-Instrument Mode og Moku Cloud Compile til Moku:Lab, sem og margar uppfærslur á afköstum og notagildi í tækjasvítunni.

Fjölhljóðfærastilling

Fjöltækjastilling á Moku:Lab gerir notendum kleift að nota tvö tæki samtímis til að búa til sérsniðna prófunarstöð. Hvert hljóðfæri hefur fullan aðgang að hliðstæðum inntakum og útgangum ásamt samtengingum milli hljóðfæraraufa. Samtengingar milli tækja styðja háhraða, lágt leynd, rauntíma stafræn samskipti allt að 2 Gb/s, svo tæki geta keyrt sjálfstætt eða verið tengd til að byggja upp háþróaða merkjavinnsluleiðslur. Hægt er að skipta um hljóðfæri inn og út án þess að trufla hitt hljóðfærið. Háþróaðir notendur geta einnig sett upp eigin sérsniðna reiknirit í fjöltækjastillingu með því að nota Moku Cloud Compile.

Moku Cloud Compile

Moku Cloud Compile gerir þér kleift að dreifa sérsniðnum DSP beint á Moku:Lab FPGA í fjöltækjastillingu. Skrifaðu kóða með a web vafra og safna honum saman í skýinu; Moku Cloud Compile setur bitastrauminn í eitt eða fleiri marktæki Moku.

Sveiflusjá

• Djúpt minnisstilling: sparaðu allt að 4M sekamples á rás á fullu samplengdartíðni (500 MSa/s)

Spectrum Analyzer

• Bætt hávaðagólf
• Logarithmic Vrms og Vpp kvarði
• Fimm nýjar gluggaaðgerðir (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Fasamælir

• Tíðni offset, phase, og ampLitude er nú hægt að gefa út sem hliðrænt binditage merki
• Notendur geta nú bætt við DC offset við úttaksmerki
• Nú er hægt að margfalda fasalæstu sinusbylgjuúttakið allt að 2 50x eða skipta niður í 125x
• Bætt bandbreiddarsvið (1 Hz til 100 kHz)
• Háþróuð fasa umbúðir og sjálfvirkt endurstilla aðgerðir

Bylgjuform rafall

• Hljóðframleiðsla
• Púlsbreidd mótun (PWM)

læsa inni Amplíflegri

• Bætt frammistaða lágtíðni PLL læsing
• Lágmarks PLL tíðni hefur verið lækkuð í 10 Hz
• Nú er hægt að tíðni margfalda innra PLL merki allt að 250x eða skipta niður í 125x til að nota við afmótun
• 6 stafa nákvæmni fyrir fasagildi

Tíðnisvarsgreiningartæki

• Aukin hámarkstíðni úr 120 MHz í 200 MHz
• Hækka hámarks sópapunkta úr 512 í 8192
• The New Dynamic AmpLitude eiginleiki fínstillir úttaksmerki sjálfkrafa fyrir besta mælingarsviðið
• Nýr ln/ln1 mælingarhamur
• Viðvaranir um inntaksmettun
• Stærðfræðirásin styður nú handahófskenndar jöfnur með flókið gildi sem taka þátt í rásmerkjunum, sem gerir nýjar gerðir af flóknum flutningsvirknimælingum kleift
• Nú er hægt að mæla inntaksmerki í dBVpp og dBVrms auk dBm
• Framvinda getraunarinnar er nú sýnd á línuritinu
• Nú er hægt að læsa tíðniásnum til að koma í veg fyrir óviljandi breytingar meðan á langri getraun stendur

Laser læsa kassi

• Endurbætt blokkarmynd sýnir skanna- og mótunarmerkjaleiðir
• Nýja læsingin stages eiginleiki gerir kleift að sérsníða læsingarferlið
• Bætt frammistaða lágtíðni PLL læsing
• 6 stafa nákvæmni fyrir fasagildi
• Bætt frammistaða lágtíðni PLL læsing
• Lágmarks PLL tíðni hefur verið lækkuð í 10 Hz
• The PLL Nú er hægt að margfalda merki með tíðni upp í 250x eða deila niður í 0.125x til notkunar í afmótun

Annað

Bætti við stuðningi fyrir sinusfallið í jöfnuritlinum sem hægt er að nota til að búa til sérsniðnar bylgjuform í handahófskenndu bylgjuformsrafallinu

Umbreyta tvöfaldur LI files í CSV, MATLAB eða NumPy snið þegar hlaðið er niður úr tækinu

Uppfærður API stuðningur

Nýi Moku MATLAB API v3.0 pakkinn veitir aukna virkni og stöðugleika. Það mun fá reglulegar uppfærslur til að bæta árangur og kynna nýja eiginleika.

Takmarkanir á afturábak eindrægni

API

Nýi Moku MATLAB API v3.0 pakkinn er ekki afturábaksamhæfur við fyrri Moku:Lab MATLAB v1.9 pakkann. MATLAB forskriftarrök og skilgildi eru gjörólík. Ef þú ert með umfangsmikla sérsniðna hugbúnaðarþróun sem notar Moku:Lab MATLAB skaltu íhuga áhrif þess að flytja allan hugbúnaðinn þinn til að vera samhæfður við nýja API.

Þó að Moku:Lab MATLAB pakkinn muni ekki lengur fá uppfærslur, mun Liquid Instruments samt halda áfram að veita stuðning fyrir notendur sem geta ekki flutt yfir í nýja API pakkann.

Finndu nákvæma tdamples fyrir hvert hljóðfæri í nýja Moku MATLAB API v3.0 pakkanum til að þjóna sem grunnlína til að breyta fyrri MATLAB þróun í nýja API pakkann.

Afturhvarf

RAM diskur fyrir gagnaskráningu

Útgáfa 1.9 var með 512 MB filekerfi í vinnsluminni tækisins, sem hægt væri að nota til að skrá gögn á háum samplingavextir. Í útgáfu 3.0 er ekki lengur hægt að skrá sig í vinnsluminni. Til að virkja gagnaskráningu þarf SD kort. Í samræmi við það breytist hámarksupptökuhraði líka. Útgáfa 1.9 styður allt að 1 MSa/s, en útgáfa 3.0 styður allt að 250 kSa/s á 1 rás og 125 kSa/s á 2 rásum. Jafnvel á lægri hraða og með SD-korti, verður verkflæði sem innihélt að vista margar háhraðaskrár í vinnsluminni og síðan afrita þær síðar á SD-kortið eða viðskiptavininn ekki lengur stutt.

Gagnaskráning í CSV

Útgáfa 1.9 hafði getu til að vista gögn beint í CSV file meðan á skráningu stendur. Þessi eiginleiki er ekki í boði beint í útgáfu 3.0. Notendur sem voru með vinnuflæði að vista CSVfiles beint á SD kort eða viðskiptavinurinn þarf nú fyrst að umbreyta tvöfaldanum file í CSV, annað hvort með því að nota biðlaraforritið eða með því að setja upp sjálfstæða vökvatæki File Breytir yfir í tölvuna sem þeir nota til gagnavinnslu.

Breytingar sem ekki eru afturábaksamhæfðar

Gagnaskala í LIA

Í útgáfu 1.9 innleiddum við gagnaskala þannig að margföldun tvö 0.1 V DC merki leiddi til 0.02 V DC úttaks. Í útgáfu 3.0 breyttum við þessu þannig að útkoman var 0.01 V DC, sem er meira í samræmi við innsæi væntingar viðskiptavina.

Waveform Generator úttak verður að vera virkt til að nota sem mótunaruppspretta/kveikju

Í útgáfu 1.9 var hægt að nota bylgjulögun annarrar rásar sem mótunar- eða kveikjugjafa í Waveform Generator, jafnvel þótt úttak þeirrar rásar væri óvirkt. Þetta var fjarlægt í útgáfu

• Notendur sem vilja gera krossmótun án þess að þurfa að taka úttak tækisins úr sambandi þyrftu að stilla

Moku MATLAB API

Moku MATLAB API v3.0 pakkanum er ætlað að veita MATLAB forriturum það fjármagn sem þarf til að stjórna hvaða Moku tæki sem er og að lokum getu til að fella þessar stýringar inn í stærri notendaforrit. Nýi Moku MATLAB API v3.0 pakkinn veitir eftirfarandi:

• Fullvirkt tdample MATLAB forskriftir fyrir hvern
• Allar MATLAB forskriftir eru með athugasemdum, sem auðvelt er að skilja og geta þjónað sem upphafspunktur notanda fyrir sérsnið og
• Setja af aðgerðum sem veitir fulla stjórn á Moku

Núverandi studd hljóðfæri

1. Handahófskennd bylgjuform rafall
2. Gagnaskrármaður
3. Stafræn síubox
4. FIR síunarsmiður
5. Tíðnisvarsgreiningartæki
6. Laser læsa kassi
7. Innlás Amplíflegri
8. Sveiflusjá
9. Fasamælir
10. PID stjórnandi
11. Spectrum Analyzer
12. Bylgjuform rafall
13. Fjölhljóðfærastilling
14. Moku Cloud Compile

Uppsetning

Kröfur

• MATLAB útgáfa 2015 eða síðar

Ef þú ert þegar með fyrri útgáfu af Moku MATLAB API uppsettu, vinsamlegast fjarlægðu hana áður en þú heldur áfram. Þú getur fjarlægt pakkann úr Add-on Manager.

1. Opnaðu viðbótastjórnunina í gegnum Home > Environment flipann.
2. Leitaðu að Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Að öðrum kosti geturðu hlaðið niður verkfærakistunni beint frá Liquid Instruments websíða kl https://www.liquidinstruments.com/products/apis/matlab-api/. Þú verður að stilla leitarslóðina handvirkt ef þú gerir þetta.
4. Athugaðu hvort réttri slóð hafi verið bætt við verkfærakistuna með því að velja 'Setja slóð' á Heim > Umhverfi flipanum.
5. Gakktu úr skugga um að það sé færsla sem bendir á uppsetningarstað verkfærakistunnar. Dæmigerð slóð gæti verið CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku- MATLAB.
6. Sækja gögn tækisins files með því að slá 'moku_download####) inn í MATLAB stjórnunargluggann. ### ætti að skipta út fyrir núverandi vélbúnaðarútgáfu. Yol getur fundið núverandi vélbúnaðarútgáfu þína í gegnum Moku: skrifborðsforritið með því að hægrismella á Moku þinn og sveima 'Device info', eða í iPad appinu með því að ýta lengi á Moku þinn.
7. Staðfestu að verkfærakistan þín sé rétt uppsett með því að slá inn 'hjálp Moku' í MATLAB stjórnunargluggann. Ef þessi skipun tekst. þá hefur verkfærakistan verið sett upp

Moku API breytingar

Nýi Moku MATLAB API arkitektúrinn er nægilega frábrugðinn forvera sínum og því ekki afturábak samhæfður við núverandi API forskriftir. Eftirfarandi einfaldaða sveiflusjá tdample sýnir muninn á eldri og nýjum API pakka og þjónar sem vegakort til að flytja núverandi kóða.

Sveiflusjá fyrrvample

Röð skref

1. Flyttu inn Moku MATLAB API 3.0
2. Krefjast Moku eignarhalds og hlaða sveiflusjá bitastraumnum til
3. Stilltu tímagrunn og stilltu vinstri og hægri spönn fyrir tímaásinn.
4. Fáðu gögn, eignaðu einn ramma af gögnunum frá sveiflusjánni
5. Ljúktu viðskiptavinalotu með því að afsala Moku eignarhaldinu

Röðin sem lýst er hér að ofan er einfölduð tdample til að sýna muninn á eldri og nýjum API pakka. Fyrir utan að hefja biðlarlotu, hlaða upp tækjabitastraumi í Moku og ljúka við biðlaralotu, getur notandi notað hvaða fjölda aðgerða sem er í mismunandi röð til að mæta þörfum umsóknar sinnar.

Mismunur

Hér skoðum við muninn á APlunum tveimur fyrir hvert skref í röðinni.

Krefjast Moku eignarhalds og hlaða sveiflusjá bitastraumnum í tækið. Í samanburði við Moku MATLAB 1.9 hefur nýja API gjörólíkar aðgerðir:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Virka	get_by_name()	deploy_or_conn ect()	Sveiflusjá()
Leyfilegir reitir og gildi	nafn: strengur tími: fljóta	hljóðfæri: flokkur tækisins sem vill nota	ip: strengur serial: strengur
	kraftur: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			viðvarandi_ástand: bool
			connect_timeout: fljóta
			read_timeout: fljóta

 

1. Stilltu tímagrunn. Fallið er það sama, en leyfilegu rökin eru aðeins öðruvísi:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Virka	set_timebase()	set_timebase()
   Leyfilegir reitir og gildi	t1: fljóta t2: fljóta	t1: fljóta t2: fljóta strangur: bool

2. Fáðu gögn. Aðgerðirnar og leyfilegu rökin eru þau sömu, en gagnagerðin og lengdin sem skilað er eru mismunandi:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Virka	get_data ()	get_data ()
   Leyfilegir reitir og gildi	tími: fljóta bíða: bool	tími: fljóta wait_reacquire: bool
   Lengd skila	16383 stig á ramma	1024 stig á ramma

3. Losaðu Moku eignarhaldið:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Virka	loka()	afsala_eignarhaldi()

Listi yfir sveiflusjáraðgerðir

Moku MATLAB 1.9	Moku MATLAB 3.0
set_sourceO	setja_heimildirO
set_triggerO	set_triggerO
fá_gögnQ	fá_gögnQ
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
fá_samp!erateO get_rea!time_dataQ	fá_samp!erateO save_high_res_bufferO
gen_rampbylgjaO gen_sinewaveO	mynda_bylgjuformO get_acquisition_modeQ
gen_squarewaveQ	fá_heimildirQ
gen_offQ	get_timebaseQ fá_úttak_!oadQ
sett_samplæraQ set_framerateQ	get_interpo!ationO set_output_!oadQ
	set_hysteresisQ set_interpo!ationO
	set_input_attenuationO
	set_sourceO osc_measurementQ
	samantektQ

Moku MATLAB API er byggt á Moku API. Fyrir full Moku API skjöl, vísa til Moku API tilvísunarinnar sem er að finna hér https://apis.liq uidinstrume nts.com/re fe rence/.

Viðbótarupplýsingar til að byrja með Moku MATLAB API er að finna á https://a pis.liquid instruments.com/sta einkunn-Matlab.heim

Niðurfærsluferli

Ef uppfærslan í útgáfu 3.0 hefur reynst takmarka, eða hafa á annan hátt skaðleg áhrif á, eitthvað sem er mikilvægt fyrir forritið þitt, geturðu niðurfært í fyrri útgáfu 1.9. Þetta er hægt að gera í gegnum a web vafra.

Skref

1. Hafðu samband við Liquid Instruments og fáðu file fyrir vélbúnaðarútgáfu 9.
2. Sláðu inn Moku:Lab IP tölu þína í a web vafra (sjá skjámynd).
3. Undir Update Firmware skaltu skoða og velja fastbúnaðinn file veitt af Liquid Instruments.
4. Veldu Hlaða upp og uppfæra. Uppfærsluferlið getur tekið meira en 10 mínútur að ljúka

© 2023 Liquid Instruments. frátekið.

laudinstruments.com

Skjöl / auðlindir

FLJÓTANDI INSTRUMENTS MATLAB API samþættingaröryggi [pdfNotendahandbók MATLAB API, MATLAB API samþættingaröryggi, samþættingaröryggi, öryggi

Heimildir

• Notendahandbók