FLYDENDE INSTRUMENTER MATLAB API Integrationssikringer

MATLAB API Migration Guide

Opgradering af Moku: Lab til softwareversion 3.0 låser op for et væld af nye funktioner. Ved opdatering skal API-brugere tage ekstra skridt for at migrere deres scripts til den nye Moku API-pakke. Denne migreringsvejledning skitserer API-ændringer, nye funktioner tilgængelige i version 3.0-opdateringen og eventuelle bagudkompatibilitetsbegrænsninger.

Overview

Moku:Lab-softwareversion 3.0 er en større opdatering, der bringer ny firmware, brugergrænseflade og AP'er til Moku:Lab-hardware. Opdateringen bringer Moku:Lab på linje med Moku:Pro og Moku:Go, hvilket gør det nemt at dele scripts på tværs af alle Moku-platforme. Opdateringen låser op for et væld af nye funktioner til mange af de eksisterende instrumenter. Det tilføjer også to nye funktioner: Multi-instrument Mode og Moku Cloud Compile. Der er også nogle subtile adfærdsforskelle, som er beskrevet i afsnittet bagudkompatibilitet.

Dette er en større opdatering, der påvirker API-arkitekturen, og derfor vil den nye MATLAB API v3.0-pakke ikke være bagudkompatibel med eksisterende MATLAB-scripts. API-brugere skal portere deres scripts til den nye Moku API-pakke, hvis de opgraderer deres Moku:Lab til version 3.0. API-brugere med betydelig tilpasset softwareudvikling bør nøje overveje det indsatsniveau, der kræves for at portere deres eksisterende kode. Moku:Lab 1.9 anbefales ikke til nye implementeringer, og alle kunder opfordres til at opgradere. Hvis der opstår problemer efter opgradering, vil brugerne have mulighed for at nedgradere til softwareversion 1.9.

Denne migrationsvejledning skitserer advantagopdateringer og potentielle komplikationer til Moku:Lab version 3.0. Den skitserer også processen for at opgradere MATLAB API, og hvordan du nedgraderer din Moku:Lab, hvis det er nødvendigt.

Version 3.0 nye funktioner

Nye funktioner

Softwareversion 3.0 bringer Multi-Instrument Mode og Moku Cloud Compile til Moku:Lab for første gang, såvel som mange opgraderinger af ydeevne og brugervenlighed på tværs af pakken af ​​instrumenter.

Multi-instrument tilstand

Multi-instrument Mode på Moku:Lab giver brugerne mulighed for at implementere to instrumenter samtidigt for at skabe en brugerdefineret teststation. Hvert instrument har fuld adgang til de analoge ind- og udgange sammen med sammenkoblinger mellem instrumentslots. Sammenkoblingerne mellem instrumenter understøtter højhastigheds-, lav-latens, realtids digital kommunikation op til 2 Gb/s, så instrumenter kan køre uafhængigt eller tilsluttes for at bygge avancerede signalbehandlingspipelines. Instrumenter kan skiftes dynamisk ind og ud uden at afbryde det andet instrument. Avancerede brugere kan også implementere deres egne brugerdefinerede algoritmer i Multi-instrument Mode ved hjælp af Moku Cloud Compile.

Moku Cloud-kompilering

Moku Cloud Compile giver dig mulighed for at implementere brugerdefineret DSP direkte på Moku:Lab FPGA i Multi instrument Mode. Skriv kode ved hjælp af a web browser og kompiler den i skyen; Moku Cloud Compile implementerer bitstrømmen til en eller flere Moku-målenheder.

Oscilloskop

• Deep memory mode: spar op til 4M samples pr. kanal ved fuld sampling rate (500 MSa/s)

Spectrum Analyzer

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

Fasemåler

• Frekvens offset, fase og amplitude kan nu udsendes som analog voltage signaler
• Brugere kan nu tilføje DC offset til udgangssignaler
• Den faselåste sinusbølgeudgang kan nu frekvensmultipliceres op til 2 50x eller divideres ned til 125x
• Forbedret båndbreddeområde (1 Hz til 100 kHz)
• Avanceret faseindpakning og auto-reset funktioner

Bølgeformgenerator

• Støjoutput
• Pulsbreddemodulation (PWM)

Lock-In Amplivligere

• Forbedret ydeevne af lav frekvens PLL låsning
• Den mindste PLL-frekvens er blevet reduceret til 10 Hz
• Det interne PLL-signal kan nu frekvens multipliceres op til 250x eller divideres ned til 125x til brug ved demodulation
• 6-cifret præcision for faseværdier

Frekvensresponsanalysator

• Øget maksimal frekvens fra 120 MHz til 200 MHz
• Forøg maksimale sweep-punkter fra 512 til 8192
• Den nye dynamik Amplitude-funktionen optimerer udgangssignalet automatisk for det bedste dynamiske målområde
• Ny ln/ln1 måletilstand
• Advarsler om inputmætning
• Den matematiske kanal understøtter nu vilkårlige ligninger med kompleks værdi, der involverer kanalsignalerne, hvilket muliggør nye typer af komplekse overførselsfunktionsmålinger
• Indgangssignaler kan nu måles i dBVpp og dBVrms ud over dBm
• Fremdriften af ​​sweep vises nu på grafen
• Frekvensaksen kan nu låses for at forhindre utilsigtede ændringer under et langt sweep

Laser låseboks

• Det forbedrede blokdiagram viser scannings- og moduleringssignalveje
• Den nye låse stages-funktionen gør det muligt at tilpasse låseproceduren
• Forbedret ydeevne af lav frekvens PLL låsning
• 6-cifret præcision for faseværdier
• Forbedret ydeevne af lav frekvens PLL låsning
• Den mindste PLL-frekvens er blevet reduceret til 10 Hz
• De PLL signal kan nu frekvens multipliceres op til 250x eller divideres ned til 0.125x til brug ved demodulation

Andre

Tilføjet understøttelse af sinusfunktionen til ligningseditoren, som kan bruges til at generere brugerdefinerede bølgeformer i den vilkårlige bølgeformgenerator

Konverter binær LI files til CSV-, MATLAB- eller NumPy-formater, når du downloader fra enheden

Opgraderet API-support

Den nye Moku MATLAB API v3.0-pakke giver forbedret funktionalitet og stabilitet. Den vil modtage regelmæssige opdateringer for at forbedre ydeevnen og introducere nye funktioner.

Bagudkompatibilitetsbegrænsninger

API

Den nye Moku MATLAB API v3.0-pakke er ikke bagudkompatibel med den tidligere Moku:Lab MATLAB v1.9-pakke. MATLAB-scriptargumenterne og returværdierne er helt forskellige. Hvis du har omfattende brugerdefineret softwareudvikling, der bruger Moku:Lab MATLAB, skal du overveje virkningen af ​​at migrere al din software for at være kompatibel med den nye API.

Mens Moku:Lab MATLAB-pakken ikke længere vil modtage opdateringer, vil Liquid Instruments stadig fortsætte med at yde support til brugere, der ikke er i stand til at migrere til den nye API-pakke.

Find detaljeret examples for hvert instrument i den nye Moku MATLAB API v3.0-pakke for at tjene som en basislinje for konvertering af tidligere MATLAB-udvikling til den nye API-pakke.

Regressioner

RAM-disk til datalogning

Version 1.9 havde en 512 MB filesystem i enhedens RAM, som kunne bruges til at logge data ved høj sampling satser. I version 3.0 er det ikke længere muligt at logge på RAM. For at aktivere datalogning kræves et SD-kort. Følgelig ændres den maksimale optagelseshastighed også. Version 1.9 understøttede op til 1 MSa/s, hvorimod version 3.0 understøtter op til 250 kSa/s ved 1 kanal og 125 kSa/s ved 2 kanaler. Selv ved lavere hastigheder og med et SD-kort, vil arbejdsgange, som omfattede lagring af flere højhastighedslogfiler til RAM og derefter senere kopiering af dem til SD-kortet eller klienten, ikke længere blive understøttet.

Datalogning til CSV

Version 1.9 havde mulighed for at gemme data direkte til en CSV file mens du logger. Denne funktion er ikke direkte tilgængelig på version 3.0. Brugere, hvis arbejdsgang omfattede lagring af CSVfiles direkte til et SD-kort, eller klienten skal nu først konvertere det binære file til CSV, enten ved at bruge klientappen eller ved at installere de selvstændige Liquid Instruments File Konverter til den computer, som de bruger til databehandling.

Ikke-bagudkompatible ændringer

Dataskalering i LIA

I version 1.9 implementerede vi dataskalering, således at multiplikation af to 0.1 V DC-signaler resulterede i et 0.02 V DC-output. I version 3.0 ændrede vi dette således, at resultatet blev 0.01 V DC, hvilket er mere i overensstemmelse med kundernes intuitive forventninger.

Waveform Generator output skal være aktiveret for at kunne bruges som moduleringskilde/trigger

I version 1.9 kunne en anden kanals bølgeform bruges som en modulerings- eller triggerkilde i bølgeformgeneratoren, selvom den pågældende kanals output var deaktiveret. Dette blev fjernet i version

• Brugere, der ønsker at udføre krydsmodulation uden at skulle afbryde udgangene på deres enhed, skal justere deres

Moku MATLAB API

Moku MATLAB API v3.0-pakken er beregnet til at give MATLAB-udviklere de nødvendige ressourcer til at kontrollere enhver Moku-enhed og i sidste ende evnen til at inkorporere disse kontroller i større slutbrugerapplikationer. Den nye Moku MATLAB API v3.0-pakke giver følgende:

• Fuldt funktionel example MATLAB scripts for hver
• Alle MATLAB scripts er forsynet med kommentarer, som er lette at forstå og kan tjene som slutbrugerens udgangspunkt for tilpasning og
• Et sæt funktioner, der giver fuld kontrol over Moku

Aktuelt understøttede instrumenter

1. Vilkårlig bølgeformgenerator
2. Datalogger
3. Digital filterboks
4. FIR Filter Builder
5. Frekvensresponsanalysator
6. Laser låseboks
7. Indlåsning Amplivligere
8. Oscilloskop
9. Fasemåler
10. PID controller
11. Spectrum Analyzer
12. Bølgeformgenerator
13. Multi-instrument tilstand
14. Moku Cloud-kompilering

Installation

Krav

• MATLAB version 2015 eller nyere

Hvis du allerede har en tidligere version af Moku MATLAB API installeret, skal du afinstallere den, før du fortsætter. Du kan afinstallere pakken fra Add-on Manager.

1. Åbn Add-on Manager via fanen Hjem > Miljø.
2. Søg efter Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Alternativt kan du downloade værktøjskassen direkte fra Liquid Instruments website kl https://www.liquidinstruments.com/products/apis/matlab-api/. Du bliver nødt til at indstille søgestien manuelt, hvis du gør dette.
4. Kontroller, at den korrekte sti er blevet tilføjet til værktøjskassen ved at vælge 'Set sti' fra fanen Hjem > Miljø.
5. Sørg for, at der er en indgang, der peger på installationsstedet for værktøjskassen. En typisk sti kan være CAUserkusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Download instrumentdata files ved at skrive 'moku_download####) i MATLAB-kommandovinduet. ### bør erstattes med din nuværende firmwareversion. Yol kan finde din aktuelle firmwareversion gennem Moku: desktop-appen ved at højreklikke på din Moku og holde musen over 'Enhedsoplysninger' eller i iPad-appen ved at trykke længe på din Moku.
7. Bekræft, at din værktøjskasse er konfigureret korrekt ved at skrive 'help Moku' i MATLAB-kommandovinduet. Hvis denne kommando lykkes. så er værktøjskassen blevet installeret

Moku API ændringer

Den nye Moku MATLAB API-arkitektur er tilstrækkeligt forskellig fra sin forgænger og er derfor ikke bagudkompatibel med eksisterende API-scripts. Følgende forenklede Oscilloskop example viser forskellene mellem de gamle og nye API-pakker og fungerer som en køreplan for portering af eksisterende kode.

Oscilloskop example

Sekvens trin

1. Importer Moku MATLAB API 3.0
2. Gør krav på Moku-ejerskabet og upload Oscilloskop-bitstrømmen til
3. Indstil tidsbasis og indstil venstre og højre spændvidde for tidsaksen.
4. Hent data, hent en enkelt ramme af dataene fra oscilloskopet
5. Afslut klientsession ved at opgive Moku-ejerskabet

Den ovenfor beskrevne sekvens er et forenklet example for at illustrere forskellene mellem de gamle og nye API-pakker. Bortset fra at begynde en klientsession, uploade en instrument-bitstream til Moku og afslutte klientsessionen, kan en slutbruger udøve et vilkårligt antal funktioner i forskellig rækkefølge for at opfylde behovene i deres applikation.

Forskelle

Her ser vi på forskellene mellem de to APl'er for hvert trin i sekvensen.

Gør krav på Moku-ejerskab og upload Oscilloskop-bitstrømmen til enheden. Sammenlignet med Moku MATLAB 1.9 har den nye API helt andre funktioner:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Fungere	get_by_name()	deploy_or_conn ect()	Oscilloskop()
Tilladte felter og værdier	navn: streng timeout: float	instrument: den klasse af instrumentet, der ønskes implementeret	ip: streng seriel: streng
	kraft: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: float
			read_timeout: float

 

1. Indstil tidsgrundlag. Funktionen er den samme, men de tilladte argumenter er lidt forskellige:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Fungere	set_timebase()	set_timebase()
   Tilladte felter og værdier	t1: float t2: float	t1: float t2:float strict: bool

2. Hent data. Funktionerne og de tilladte argumenter er de samme, men den returnerede datatype og længde er forskellige:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Fungere	get_data()	get_data()
   Tilladte felter og værdier	timeout: float vent: bool	timeout: float wait_reacquire: bool
   Returlængde	16383 point pr	1024 point pr

3. Frigiv Moku-ejerskabet:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Fungere	tæt()	afstå_ejerskab()

Oscilloskopfunktionsliste

Moku MATLAB 1.9	Moku MATLAB 3.0
sæt_kildeO	sæt_kilderO
sæt_triggerO	sæt_triggerO
get_dataQ	get_dataQ
set_frontendQ	set_frontendQ
set_defau!tsQ set_timebaseO sæt_xmodeQ	set_defau!tsQ set_timebaseQ disable_inputO enable_rollmodeQ
set_precision_modeQ	set_acquisition_modeQ
sync_faseQ	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
sæt_samplæreQ sæt_framerateQ	get_interpo!ationO set_output_!oadQ
	set_hysteresisQ set_interpo!ationO
	set_input_attenuationO
	sæt_kildeO osc_measurementQ
	resuméQ

Moku MATLAB API er baseret på Moku API. For fuldstændig Moku API-dokumentation henvises til Moku API-referencen, der findes her https://apis.liq uidinstrume nts.com/re fe rence/.

Yderligere detaljer for at komme i gang med Moku MATLAB API kan findes på https://a pis.liquid instruments.com/sta bedømmelse-Matlab.hjem

Nedgraderingsproces

Hvis opgraderingen til version 3.0 har vist sig at begrænse eller på anden måde påvirke noget af afgørende betydning for din applikation, kan du nedgradere til den tidligere version 1.9. Dette kan gøres gennem en web browser.

Trin

1. Kontakt Liquid Instruments og få fat i file til firmwareversion 9.
2. Indtast din Moku:Lab IP-adresse i en web browser (se skærmbillede).
3. Under Opdater firmware skal du gennemse og vælge firmwaren file leveret af Liquid Instruments.
4. Vælg Upload og opdater. Opdateringsprocessen kan tage mere end 10 minutter at fuldføre

© 2023 Liquid Instruments. reserveret.

laudinstruments.com

Dokumenter/ressourcer

FLYDENDE INSTRUMENTER MATLAB API Integrationssikringer [pdfBrugervejledning MATLAB API, MATLAB API Integrationssikringer, Integrationssikringer, Sikringer

Referencer

• Brugermanual