VÆSKE INSTRUMENTER MATLAB API Integration Sikringer

MATLAB API Migration Guide

Oppgradering av Moku: Lab til programvareversjon 3.0 låser opp en rekke nye funksjoner. Ved oppdatering må API-brukere ta ekstra skritt for å migrere skriptene sine til den nye Moku API-pakken. Denne migreringsveiledningen skisserer API-endringer, nye funksjoner tilgjengelig i versjon 3.0-oppdateringen og eventuelle bakoverkompatibilitetsbegrensninger.

Overview

Moku:Lab-programvareversjon 3.0 er en stor oppdatering som bringer ny fastvare, brukergrensesnitt og APler til Moku:Lab-maskinvaren. Oppdateringen bringer Moku:Lab på linje med Moku:Pro og Moku:Go, noe som gjør det enkelt å dele skript på tvers av alle Moku-plattformer. Oppdateringen låser opp en rekke nye funksjoner til mange av de eksisterende instrumentene. Den legger også til to nye funksjoner: Multi-instrument Mode og Moku Cloud Compile. Det er også noen subtile atferdsforskjeller, skissert i delen bakoverkompatibilitet.

Dette er en stor oppdatering som påvirker API-arkitekturen, og derfor vil den nye MATLAB API v3.0-pakken ikke være bakoverkompatibel med eksisterende MATLAB-skript. API-brukere må portere skriptene sine til den nye Moku API-pakken hvis de oppgraderer Moku:Lab til versjon 3.0. API-brukere med betydelig tilpasset programvareutvikling bør nøye vurdere innsatsnivået som kreves for å portere deres eksisterende kode. Moku:Lab 1.9 anbefales ikke for nye distribusjoner, og alle kunder oppfordres til å oppgradere. Hvis det oppstår problemer etter oppgradering, vil brukerne ha muligheten til å nedgradere til programvareversjon 1.9.

Denne migrasjonsveiledningen skisserer advantagoppdateringer og potensielle komplikasjoner til Moku:Lab versjon 3.0. Den skisserer også prosessen for å oppgradere MATLAB API og hvordan du nedgraderer Moku:Lab om nødvendig.

Versjon 3.0 nye funksjoner

Nye funksjoner

Programvareversjon 3.0 bringer Multi-Instrument Mode og Moku Cloud Compile til Moku:Lab for første gang, i tillegg til mange ytelses- og brukeroppgraderinger på tvers av instrumentpakken.

Multi-instrument-modus

Multi-instrument Mode på Moku:Lab lar brukere distribuere to instrumenter samtidig for å lage en tilpasset teststasjon. Hvert instrument har full tilgang til de analoge inngangene og utgangene sammen med sammenkoblinger mellom instrumentsporene. Sammenkoblingene mellom instrumenter støtter høyhastighets, lav latens, sanntids digital kommunikasjon opp til 2 Gb/s, slik at instrumenter kan kjøres uavhengig eller kobles til for å bygge avanserte signalbehandlingsrørledninger. Instrumenter kan byttes dynamisk inn og ut uten å avbryte det andre instrumentet. Avanserte brukere kan også distribuere sine egne tilpassede algoritmer i Multi-instrument Mode ved å bruke Moku Cloud Compile.

Moku Cloud Compile

Moku Cloud Compile lar deg distribuere tilpasset DSP direkte på Moku:Lab FPGA i multiinstrumentmodus. Skriv kode med a web nettleser og kompiler den i skyen; Moku Cloud Compile distribuerer bitstrømmen til en eller flere Moku-målenheter.

Oscilloskop

• Dyp minnemodus: spar opptil 4M samples per kanal ved full sampling rate (500 MSa/s)

Spectrum Analyzer

• Forbedret støygulv
• Logaritmisk Vrms og Vpp skala
• Fem nye vindusfunksjoner (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Fasemåler

• Frekvensoffset, fase og amplitude kan nå sendes ut som analog voltage signaler
• Brukere kan nå legge til DC offset til utgangssignaler
• Den faselåste sinusbølgeutgangen kan nå frekvens multipliseres opp til 2 50x eller deles ned til 125x
• Forbedret båndbreddeområde (1 Hz til 100 kHz)
• Avansert faseinnpakning og automatisk tilbakestillingsfunksjoner

Bølgeformgenerator

• Støyutgang
• Pulsbreddemodulering (PWM)

Låse inn Amplivligere

• Forbedret ytelse av lav frekvens PLL låsing
• Minimum PLL-frekvens er redusert til 10 Hz
• Det interne PLL-signalet kan nå frekvens multipliseres opp til 250x eller deles ned til 125x for bruk i demodulasjon
• 6-sifret presisjon for faseverdier

Frekvensresponsanalysator

• Økt maksimal frekvens fra 120 MHz til 200 MHz
• Øk maksimale sveipepunkter fra 512 til 8192
• Den nye dynamikken Amplitude-funksjonen optimerer utgangssignalet automatisk for det beste dynamiske måleområdet
• Ny ln/ln1 målemodus
• Advarsler om inndatametning
• Matematikkkanalen støtter nå vilkårlige ligninger med kompleks verdi som involverer kanalsignalene, noe som muliggjør nye typer komplekse overføringsfunksjonsmålinger
• Inngangssignaler kan nå måles i dBVpp og dBVrms i tillegg til dBm
• Fremdriften av sveipet vises nå på grafen
• Frekvensaksen kan nå låses for å forhindre utilsiktede endringer under et langt sveip

Laser låseboks

• Det forbedrede blokkskjemaet viser skanne- og modulasjonssignalveier
• Den nye låsen stages-funksjonen lar deg tilpasse låseprosedyren
• Forbedret ytelse av lav frekvens PLL låsing
• 6-sifret presisjon for faseverdier
• Forbedret ytelse av lav frekvens PLL låsing
• Minimum PLL-frekvens er redusert til 10 Hz
• De PLL signalet kan nå frekvens multipliseres opp til 250x eller delt ned til 0.125x for bruk i demodulasjon

Annen

Lagt til støtte for sinusfunksjonen til ligningseditoren som kan brukes til å generere tilpassede bølgeformer i den vilkårlige bølgeformgeneratoren

Konverter binær LI files til CSV-, MATLAB- eller NumPy-formater når du laster ned fra enheten

Oppgradert API-støtte

Den nye Moku MATLAB API v3.0-pakken gir forbedret funksjonalitet og stabilitet. Den vil motta regelmessige oppdateringer for å forbedre ytelsen og introdusere nye funksjoner.

Bakoverkompatibilitetsbegrensninger

API

Den nye Moku MATLAB API v3.0-pakken er ikke bakoverkompatibel med den forrige Moku:Lab MATLAB v1.9-pakken. MATLAB-skriptargumentene og returverdiene er helt forskjellige. Hvis du har omfattende tilpasset programvareutvikling som bruker Moku:Lab MATLAB, bør du vurdere virkningen av å migrere all programvare for å være kompatibel med den nye APIen.

Mens Moku:Lab MATLAB-pakken ikke lenger vil motta oppdateringer, vil Liquid Instruments fortsatt gi støtte til brukere som ikke kan migrere til den nye API-pakken.

Finn detaljert eksamples for hvert instrument i den nye Moku MATLAB API v3.0-pakken for å tjene som en basislinje for konvertering av tidligere MATLAB-utvikling til den nye API-pakken.

Regresjoner

RAM-disk for datalogging

Versjon 1.9 hadde en 512 MB filesystem i enhetens RAM, som kan brukes til å logge data på høy sampling rater. I versjon 3.0 er logging til RAM ikke lenger tilgjengelig. For å aktivere datalogging kreves et SD-kort. Følgelig endres også den maksimale innhentingshastigheten. Versjon 1.9 støttet opptil 1 MSa/s, mens versjon 3.0 støtter opptil 250 kSa/s ved 1 kanal og 125 kSa/s ved 2 kanaler. Selv ved lavere hastigheter og med et SD-kort, vil ikke lenger arbeidsflyter som inkluderte lagring av flere høyhastighetslogger til RAM og deretter kopiere dem til SD-kortet eller klienten støttes.

Datalogging til CSV

Versjon 1.9 hadde muligheten til å lagre data direkte til en CSV file mens du logger. Denne funksjonen er ikke direkte tilgjengelig på versjon 3.0. Brukere hvis arbeidsflyt inkluderte lagring av CSVfiles direkte til et SD-kort eller klienten må nå først konvertere binæren file til CSV, enten ved å bruke klientappen eller ved å installere de frittstående Liquid Instruments File Konverter til datamaskinen som de bruker til databehandling.

Ikke-bakoverkompatible endringer

Dataskalering i LIA

I versjon 1.9 implementerte vi dataskalering slik at multiplisering av to 0.1 V DC-signaler resulterte i en 0.02 V DC-utgang. I versjon 3.0 endret vi dette slik at resultatet ble 0.01 V DC, noe som er mer i tråd med kundenes intuitive forventninger.

Waveform Generator-utgang må være aktivert for bruk som modulasjonskilde/trigger

I versjon 1.9 kan en annen kanals bølgeform brukes som en modulasjons- eller triggerkilde i bølgeformgeneratoren, selv om den kanalens utgang var deaktivert. Dette ble fjernet i versjon

• Brukere som ønsker å utføre kryssmodulering uten å måtte koble fra utgangene på enheten, må justere

Moku MATLAB API

Moku MATLAB API v3.0-pakken er ment å gi MATLAB-utviklere ressursene som trengs for å kontrollere enhver Moku-enhet, og til slutt muligheten til å inkorporere disse kontrollene i større sluttbrukerapplikasjoner. Den nye Moku MATLAB API v3.0-pakken gir følgende:

• Fullt funksjonell eksample MATLAB-skript for hver
• Alle MATLAB-skript er utstyrt med kommentarer, som er enkle å forstå og kan tjene som sluttbrukers utgangspunkt for tilpasning og
• Et sett med funksjoner som gir full kontroll over Moku

Instrumenter som støttes for øyeblikket

1. Vilkårlig bølgeformgenerator
2. Datalogger
3. Digital filterboks
4. FIR-filterbygger
5. Frekvensresponsanalysator
6. Laser låseboks
7. Innlåsing Amplivligere
8. Oscilloskop
9. Fasemåler
10. PID-kontroller
11. Spectrum Analyzer
12. Bølgeformgenerator
13. Multi-instrument-modus
14. Moku Cloud Compile

Installasjon

Krav

• MATLAB versjon 2015 eller nyere

Hvis du allerede har en tidligere versjon av Moku MATLAB API installert, vennligst avinstaller den før du fortsetter. Du kan avinstallere pakken fra Add-on Manager.

1. Åpne Add-on Manager via fanen Hjem > Miljø.
2. Søk etter Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Alternativt kan du laste ned verktøykassen direkte fra Liquid Instruments webstedet på https://www.liquidinstruments.com/products/apis/matlab-api/. Du må angi søkebanen manuelt hvis du gjør dette.
4. Kontroller at riktig bane er lagt til verktøykassen ved å velge 'Sett bane' fra fanen Hjem > Miljø.
5. Sørg for at det er en oppføring som peker til installasjonsstedet for verktøykassen. En typisk bane kan være CAUserkusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Last ned instrumentdata files ved å skrive 'moku_download####) i MATLAB-kommandovinduet. ### bør erstattes med din gjeldende fastvareversjon. Yol kan finne din nåværende fastvareversjon gjennom Moku: desktop-appen ved å høyreklikke på Moku-en din og holde musepekeren "Enhetsinfo", eller i iPad-appen ved å trykke lenge på Moku-en din.
7. Bekreft at verktøykassen er riktig konfigurert ved å skrive 'help Moku' i MATLAB-kommandovinduet. Hvis denne kommandoen lykkes. da er verktøykassen installert

Moku API endringer

Den nye Moku MATLAB API-arkitekturen er tilstrekkelig forskjellig fra forgjengeren og er derfor ikke bakoverkompatibel med eksisterende API-skript. Følgende forenklede Oscilloskop eksample viser forskjellene mellom den eldre og nye API-pakken og fungerer som et veikart for portering av eksisterende kode.

Oscilloskop eksample

Sekvenstrinn

1. Importer Moku MATLAB API 3.0
2. Gjør krav på Moku-eierskapet og last opp Oscilloskop-bitstrømmen til
3. Still inn tidsbase og still inn venstre og høyre spenn for tidsaksen.
4. Få data, skaff en enkelt ramme av dataene fra oscilloskopet
5. Avslutt klientøkten ved å gi fra seg Moku-eierskapet

Sekvensen beskrevet ovenfor er et forenklet eksample for å illustrere forskjellene mellom den eldre og nye API-pakken. Bortsett fra å begynne en klientøkt, laste opp en instrumentbitstrøm til Moku og avslutte klientøkten, kan en sluttbruker utøve et hvilket som helst antall funksjoner i forskjellige rekkefølge for å møte behovene til applikasjonen deres.

Forskjeller

Her ser vi på forskjellene mellom de to AP-ene for hvert trinn i sekvensen.

Gjør krav på Moku-eierskap og last opp Oscilloskop-bitstrømmen til enheten. Sammenlignet med Moku MATLAB 1.9 har den nye APIen helt andre funksjoner:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Funksjon	get_by_name()	deploy_or_connect ect()	Oscilloskop()
Tillatte felt og verdier	navn: streng timeout: flyte	instrument: klassen til instrumentet som ønsker å distribuere	ip: streng seriell: streng
	kraft: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: flyte
			read_timeout: flyte

 

1. Sett tidsgrunnlag. Funksjonen er den samme, men de tillatte argumentene er litt forskjellige:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funksjon	set_timebase()	set_timebase()
   Tillatte felt og verdier	t1: flyte t2:flyte	t1: flyte t2:float streng: bool

2. Få data. Funksjonene og de tillatte argumentene er de samme, men den returnerte datatypen og lengden er forskjellige:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funksjon	get_data()	get_data()
   Tillatte felt og verdier	timeout: flyte vent: bool	timeout: float wait_reacquire: bool
   Returlengde	16383 poeng per ramme	1024 poeng per ramme

3. Slipp Moku-eierskapet:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Funksjon	lukke()	relinquish_ownership()

Liste over oscilloskopfunksjoner

Moku MATLAB 1.9	Moku MATLAB 3.0
sett_kildeO	sett_kilderO
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
få_samp!erateO get_rea!time_dataQ	få_samp!erateO save_high_res_bufferO
gen_rampbølgeO gen_sinewaveO	generere_bølgeformO get_acquisition_modeQ
gen_squarewaveQ	get_sourcesQ
gen_offQ	get_timebaseQ get_output_!oadQ
setteneamplæreQ set_framerateQ	get_interpo!ationO set_output_!oadQ
	set_hysteresisQ set_interpo!ationO
	set_input_attenuationO
	sett_kildeO osc_measurementQ
	sammendragQ

Moku MATLAB API er basert på Moku API. For fullstendig Moku API-dokumentasjon, se Moku API-referansen som finnes her https://apis.liq uidinstrume nts.com/re fe rence/.

Ytterligere detaljer for å komme i gang med Moku MATLAB API finner du på https://a pis.liquid instruments.com/sta vurdering-Matlab.hjem

Nedgraderingsprosess

Hvis oppgraderingen til versjon 3.0 har vist seg å begrense, eller på annen måte påvirke noe som er kritisk for applikasjonen din, kan du nedgradere til forrige versjon 1.9. Dette kan gjøres gjennom en web nettleser.

Trinn

1. Kontakt Liquid Instruments og få tak i file for fastvareversjon 9.
2. Skriv inn Moku:Lab IP-adressen din i en web nettleser (se skjermbilde).
3. Under Oppdater fastvare, bla gjennom og velg fastvaren file levert av Liquid Instruments.
4. Velg Last opp og oppdater. Oppdateringsprosessen kan ta mer enn 10 minutter å fullføre

© 2023 Liquid Instruments. forbeholdt.

laudinstruments.com

Dokumenter / Ressurser

VÆSKE INSTRUMENTER MATLAB API Integration Sikringer [pdfBrukerhåndbok MATLAB API, MATLAB API integrasjonssikringer, integrasjonssikringer, sikringer

Referanser

• Brukerhåndbok