LIQUID INSTRUMENTS MATLAB API-Integrationssicherungen

MATLAB API-Migrationshandbuch

Durch das Upgrade von Moku: Lab auf die Softwareversion 3.0 werden zahlreiche neue Funktionen freigeschaltet. Bei der Aktualisierung müssen API-Benutzer zusätzliche Schritte unternehmen, um ihre Skripte auf das neue Moku-API-Paket zu migrieren. Dieser Migrationsleitfaden beschreibt API-Änderungen, neue Funktionen, die im Update auf Version 3.0 verfügbar sind, und etwaige Einschränkungen der Abwärtskompatibilität.

Überview

Die Moku:Lab-Softwareversion 3.0 ist ein großes Update, das neue Firmware, Benutzeroberfläche und APls auf die Moku:Lab-Hardware bringt. Das Update bringt Moku:Lab mit Moku:Pro und Moku:Go in Einklang und erleichtert so die gemeinsame Nutzung von Skripten auf allen Moku-Plattformen. Das Update schaltet zahlreiche neue Funktionen für viele der vorhandenen Instrumente frei. Außerdem werden zwei neue Funktionen hinzugefügt: Multi-Instrumentenmodus und Moku Cloud Compile. Es gibt auch einige subtile Verhaltensunterschiede, die im Abschnitt „Abwärtskompatibilität“ beschrieben werden.

Dies ist ein großes Update, das sich auf die API-Architektur auswirkt. Daher ist das neue MATLAB API v3.0-Paket nicht abwärtskompatibel mit vorhandenen MATLAB-Skripten. API-Benutzer müssen ihre Skripte auf das neue Moku-API-Paket portieren, wenn sie ihr Moku:Lab auf Version 3.0 aktualisieren. API-Benutzer mit umfangreicher kundenspezifischer Softwareentwicklung sollten den Aufwand sorgfältig abwägen, der für die Portierung ihres vorhandenen Codes erforderlich ist. Moku:Lab 1.9 wird nicht für neue Bereitstellungen empfohlen und allen Kunden wird empfohlen, ein Upgrade durchzuführen. Sollten nach dem Upgrade Probleme auftreten, haben Benutzer die Möglichkeit, ein Downgrade auf die Softwareversion 1.9 durchzuführen.

Dieser Migrationsleitfaden beschreibt advantagAktualisierungsprobleme und mögliche Komplikationen bei Moku:Lab Version 3.0. Außerdem wird der Prozess zum Aktualisieren der MATLAB-API beschrieben und wie Sie Ihr Moku:Lab bei Bedarf herunterstufen können.

Neue Funktionen der Version 3.0

Neue Funktionen

Die Softwareversion 3.0 bringt zum ersten Mal den Multi-Instrument-Modus und Moku Cloud Compile in Moku:Lab sowie zahlreiche Leistungs- und Benutzerfreundlichkeitsverbesserungen für die gesamte Instrumentensuite.

Multi-Instrumenten-Modus

Der Multi-Instrumentenmodus von Moku:Lab ermöglicht es Benutzern, zwei Instrumente gleichzeitig einzusetzen, um eine benutzerdefinierte Teststation zu erstellen. Jedes Instrument hat vollen Zugriff auf die analogen Ein- und Ausgänge sowie Verbindungen zwischen den Instrumentensteckplätzen. Die Verbindungen zwischen den Instrumenten unterstützen digitale Echtzeitkommunikation mit hoher Geschwindigkeit und geringer Latenz von bis zu 2 Gbit/s, sodass die Instrumente unabhängig voneinander laufen oder zum Aufbau fortschrittlicher Signalverarbeitungspipelines verbunden werden können. Instrumente können dynamisch ein- und ausgewechselt werden, ohne das andere Instrument zu unterbrechen. Fortgeschrittene Benutzer können mit Moku Cloud Compile auch ihre eigenen benutzerdefinierten Algorithmen im Multi-Instrumenten-Modus bereitstellen.

Moku Cloud kompilieren

Mit Moku Cloud Compile können Sie benutzerdefinierte DSP direkt auf dem Moku:Lab FPGA im Multi-Instrumenten-Modus bereitstellen. Schreiben Sie Code mit a web Browser herunterladen und in der Cloud kompilieren; Moku Cloud Compile stellt den Bitstream auf einem oder mehreren Moku-Zielgeräten bereit.

Oszilloskop

• Deep-Memory-Modus: Speichern Sie bis zu 4 Mio. SekundenampDateien pro Kanal bei voller AuflösungampLingrate (500 MSa/s)

Spectrum Analyzer

• Verbesserter Geräuschpegel
• Logarithmische Vrms- und Vpp-Skala
• Fünf neue Fensterfunktionen (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Phasenmesser

• Frequenzoffset, Phase und ampLitude kann jetzt als analoge Lautstärke ausgegeben werdentage signalisiert
• Benutzer können jetzt einen DC-Offset zu Ausgangssignalen hinzufügen
• Der phasenstarre Sinuswellenausgang kann jetzt bis zum 2-fachen frequenzvervielfacht oder bis zum 50-fachen heruntergeteilt werden
• Verbesserter Bandbreitenbereich (1 Hz bis 100 kHz)
• Erweiterte Phasenumbruch- und Auto-Reset-Funktionen

Wellenformgenerator

• Rauschausgang
• Pulsweitenmodulation (PWM)

einschließen Ampschwerer

• Verbesserte Leistung im Niederfrequenzbereich PLL Verriegelung
• Die minimale PLL-Frequenz wurde auf 10 Hz gesenkt
• Das interne PLL-Signal kann nun zur Verwendung bei der Demodulation bis zu 250-fach frequenzvervielfacht oder bis zu 125-fach heruntergeteilt werden
• 6-stellige Genauigkeit für Phasenwerte

Frequenzgang-Analysator

• Maximale Frequenz von 120 MHz auf 200 MHz erhöht
• Erhöhen Sie die maximalen Sweep-Punkte von 512 auf 8192
• Die neue Dynamik AmpDie Litude-Funktion optimiert das Ausgangssignal automatisch für den besten Messdynamikbereich
• Neuer ln/ln1-Messmodus
• Warnungen zur Eingabesättigung
• Der Mathematikkanal unterstützt jetzt beliebige komplexwertige Gleichungen mit den Kanalsignalen und ermöglicht so neue Arten komplexer Übertragungsfunktionsmessungen
• Eingangssignale können jetzt zusätzlich zu dBm auch in dBVpp und dBVrms gemessen werden
• Der Fortschritt des Sweeps wird nun im Diagramm angezeigt
• Die Frequenzachse kann jetzt gesperrt werden, um versehentliche Änderungen während eines langen Sweeps zu verhindern

Laser-Lock-Box

• Das verbesserte Blockdiagramm zeigt Scan- und Modulationssignalpfade
• Die neuen VerschlussstagMit dieser Funktion können Sie den Sperrvorgang individuell anpassen
• Verbesserte Leistung im Niederfrequenzbereich PLL Verriegelung
• 6-stellige Genauigkeit für Phasenwerte
• Verbesserte Leistung im Niederfrequenzbereich PLL Verriegelung
• Die minimale PLL-Frequenz wurde auf 10 Hz gesenkt
• Der PLL Das Signal kann jetzt zur Verwendung bei der Demodulation frequenzmäßig bis auf das 250-fache vervielfacht oder auf das 0.125-fache heruntergeteilt werden

Andere

Dem Gleichungseditor wurde Unterstützung für die Sinusfunktion hinzugefügt, die zum Generieren benutzerdefinierter Wellenformen im Arbitrary Waveform Generator verwendet werden kann

Binär konvertieren LI files in die Formate CSV, MATLAB oder NumPy beim Herunterladen vom Gerät

Verbesserte API-Unterstützung

Das neue Moku MATLAB API v3.0-Paket bietet verbesserte Funktionalität und Stabilität. Es wird regelmäßig aktualisiert, um die Leistung zu verbessern und neue Funktionen einzuführen.

Einschränkungen der Abwärtskompatibilität

API

Das neue Moku MATLAB API v3.0-Paket ist nicht abwärtskompatibel mit dem vorherigen Moku:Lab MATLAB v1.9-Paket. Die MATLAB-Skriptargumente und Rückgabewerte sind völlig unterschiedlich. Wenn Sie eine umfangreiche kundenspezifische Softwareentwicklung mit Moku:Lab MATLAB durchführen, sollten Sie die Auswirkungen der Migration Ihrer gesamten Software berücksichtigen, um sie mit der neuen API kompatibel zu machen.

Während das Moku:Lab MATLAB-Paket keine Updates mehr erhält, wird Liquid Instruments weiterhin Support für Benutzer bereitstellen, die nicht auf das neue API-Paket migrieren können.

Finden Sie detaillierte ExampDateien für jedes Instrument im neuen Moku MATLAB API v3.0-Paket, die als Basis für die Konvertierung früherer MATLAB-Entwicklungen in das neue API-Paket dienen.

Regressionen

RAM-Disk zur Datenprotokollierung

Version 1.9 hatte 512 MB fileSystem im RAM des Geräts, mit dem Daten bei hoher Geschwindigkeit protokolliert werden könnenampLing-Preise. In Version 3.0 ist die Protokollierung im RAM nicht mehr verfügbar. Um die Datenprotokollierung zu ermöglichen, ist eine SD-Karte erforderlich. Dementsprechend ändert sich auch die maximale Erfassungsgeschwindigkeit. Version 1.9 unterstützt bis zu 1 MSa/s, während Version 3.0 bis zu 250 kSa/s bei 1 Kanal und 125 kSa/s bei 2 Kanälen unterstützt. Selbst bei niedrigeren Geschwindigkeiten und mit einer SD-Karte werden Arbeitsabläufe, bei denen mehrere Hochgeschwindigkeitsprotokolle im RAM gespeichert und später auf die SD-Karte oder den Client kopiert wurden, nicht mehr unterstützt.

Datenprotokollierung in CSV

Version 1.9 hatte die Möglichkeit, Daten direkt in einer CSV-Datei zu speichern file beim Loggen. Diese Funktion ist in Version 3.0 nicht direkt verfügbar. Benutzer, deren Arbeitsablauf das Speichern von CSV umfasstefiles direkt auf eine SD-Karte oder der Client muss nun zuerst die Binärdatei konvertieren file in CSV umwandeln, entweder über die Client-App oder durch die Installation der eigenständigen Liquid Instruments File Konverter auf den Computer, den sie zur Datenverarbeitung verwenden.

Nicht abwärtskompatible Änderungen

Datenskalierung in LIA

In Version 1.9 haben wir die Datenskalierung so implementiert, dass die Multiplikation zweier 0.1-V-DC-Signale zu einem 0.02-V-DC-Ausgang führte. In Version 3.0 haben wir dies so geändert, dass das Ergebnis 0.01 V DC betrug, was eher den intuitiven Erwartungen der Kunden entspricht.

Der Ausgang des Wellenformgenerators muss zur Verwendung als Modulationsquelle/Trigger aktiviert sein

In Version 1.9 konnte die Wellenform eines anderen Kanals als Modulations- oder Triggerquelle im Wellenformgenerator verwendet werden, selbst wenn der Ausgang dieses Kanals deaktiviert war. Dies wurde in der Version entfernt

• Benutzer, die Crossmodulation durchführen möchten, ohne die Ausgänge ihres Geräts ausstecken zu müssen, müssen ihre Einstellungen anpassen

Moku MATLAB-API

Das Moku MATLAB API v3.0-Paket soll MATLAB-Entwicklern die Ressourcen bieten, die sie zur Steuerung jedes Moku-Geräts benötigen, und letztendlich die Möglichkeit bieten, diese Steuerelemente in größere Endbenutzeranwendungen zu integrieren. Das neue Moku MATLAB API v3.0-Paket bietet Folgendes:

• Voll funktionsfähig, example MATLAB-Skripte für jeden
• Alle MATLAB-Skripte sind mit Kommentaren versehen, die leicht verständlich sind und dem Endbenutzer als Ausgangspunkt für Anpassungen dienen können
• Eine Reihe von Funktionen, die die vollständige Kontrolle über das Moku ermöglichen

Derzeit unterstützte Instrumente

1. Beliebiger Wellenformgenerator
2. Datenlogger
3. Digitale Filterbox
4. FIR-Filter-Builder
5. Frequenzgang-Analysator
6. Laser-Lock-Box
7. Einsperren Ampschwerer
8. Oszilloskop
9. Phasenmesser
10. PID-Regler
11. Spectrum Analyzer
12. Wellenformgenerator
13. Multi-Instrumenten-Modus
14. Moku Cloud kompilieren

Installation

Anforderungen

• MATLAB-Version 2015 oder höher

Wenn Sie bereits eine frühere Version der Moku MATLAB API installiert haben, deinstallieren Sie diese bitte, bevor Sie fortfahren. Sie können das Paket über den Add-on-Manager deinstallieren.

1. Öffnen Sie den Add-on-Manager über die Registerkarte „Startseite“ > „Umgebung“.
2. Suchen nach Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Alternativ können Sie die Toolbox auch direkt von Liquid Instruments herunterladen webSeite unter https://www.liquidinstruments.com/products/apis/matlab-api/. In diesem Fall müssen Sie den Suchpfad manuell festlegen.
4. Überprüfen Sie, ob der richtige Pfad zur Toolbox hinzugefügt wurde, indem Sie auf der Registerkarte „Startseite“ > „Umgebung“ die Option „Pfad festlegen“ auswählen.
5. Stellen Sie sicher, dass ein Eintrag vorhanden ist, der auf den Installationsort der Toolbox verweist. Ein typischer Pfad könnte CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku- MATLAB sein.
6. Laden Sie die Gerätedaten herunter files, indem Sie „moku_download####) in das MATLAB-Befehlsfenster eingeben. Das ### sollte durch Ihre aktuelle Firmware-Version ersetzt werden. Yol kann Ihre aktuelle Firmware-Version über die Moku:-Desktop-App finden, indem Sie mit der rechten Maustaste auf Ihr Moku klicken und den Mauszeiger über „Geräteinformationen“ bewegen, oder in der iPad-App, indem Sie lange auf Ihr Moku drücken.
7. Bestätigen Sie, dass Ihre Toolbox korrekt eingerichtet ist, indem Sie „help Moku“ in das MATLAB-Befehlsfenster eingeben. Wenn dieser Befehl erfolgreich ist. dann wurde die Toolbox erfolgreich installiert

Änderungen an der Moku-API

Die neue Moku MATLAB API-Architektur unterscheidet sich ausreichend von ihrem Vorgänger und ist daher nicht abwärtskompatibel mit bestehenden API-Skripten. Das folgende vereinfachte Oszilloskop-Beispielample zeigt die Unterschiede zwischen den alten und neuen API-Paketen und dient als Roadmap für die Portierung vorhandenen Codes.

Oszilloskop example

Sequenzschritte

1. Importieren Sie die Moku MATLAB API 3.0
2. Beanspruchen Sie den Moku-Besitz und laden Sie den Oszilloskop-Bitstream auf hoch
3. Stellen Sie die Zeitbasis ein und legen Sie die linke und rechte Spanne für die Zeitachse fest.
4. Holen Sie sich Daten, erfassen Sie einen einzelnen Frame der Daten vom Oszilloskop
5. Beenden Sie die Client-Sitzung, indem Sie den Moku-Besitz aufgeben

Die oben beschriebene Sequenz ist ein vereinfachtes Beispielample, um die Unterschiede zwischen den alten und neuen API-Paketen zu veranschaulichen. Abgesehen vom Starten einer Client-Sitzung, dem Hochladen eines Instrumenten-Bitstreams auf Moku und dem Beenden der Client-Sitzung kann ein Endbenutzer eine beliebige Anzahl von Funktionen in unterschiedlicher Reihenfolge ausführen, um die Anforderungen seiner Anwendung zu erfüllen.

Unterschiede

Hier betrachten wir die Unterschiede zwischen den beiden APls für jeden Schritt in der Sequenz.

Beanspruchen Sie Moku-Eigentum und laden Sie den Oszilloskop-Bitstream auf das Gerät hoch. Im Vergleich zu Moku MATLAB 1.9 verfügt die neue API über völlig andere Funktionen:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Funktion	get_by_name()	Deploy_or_conn ect()	Oszilloskop()
Zulässige Felder und Werte	Name: String-Timeout: Float	Instrument: Die Klasse des Instruments, das bereitgestellt werden soll	ip: string serial: string
	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. Zeitbasis einstellen. Die Funktion ist dieselbe, die zulässigen Argumente unterscheiden sich jedoch geringfügig:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funktion	set_timebase()	set_timebase()
   Zulässige Felder und Werte	t1: float t2:float	t1: float t2:float strict: bool

2. Daten bekommen. Die Funktionen und die zulässigen Argumente sind gleich, aber der zurückgegebene Datentyp und die Länge sind unterschiedlich:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funktion	Daten bekommen()	Daten bekommen()
   Zulässige Felder und Werte	Zeitüberschreitung: float warte: bool	Zeitüberschreitung: float wait_reacquire: bool
   Rückgabelänge	16383 Punkte pro Frame	1024 Punkte pro Frame

3. Geben Sie den Moku-Eigentum frei:
   

   	Moku MATLAB 1.9	Moku-API v3.0
   Funktion	schließen()	relinquish_ownership()

Liste der Oszilloskopfunktionen

Moku MATLAB 1.9	Moku MATLAB 3.0
set_sourceO	set_sourcesO
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
get_samp!erateO get_rea!time_dataQ	get_samp!erateO save_high_res_bufferO
gen_rampWelleO gen_sinewaveO	generate_waveformO get_acquisition_modeQ
gen_squarewaveQ	get_sourcesQ
gen_offQ	get_timebaseQ get_output_!oadQ
set_samplerateQ set_framerateQ	get_interpo!ationO set_output_!oadQ
	set_hysteresisQ set_interpo!ationO
	set_input_attenuationO
	set_sourceO osc_measurementQ
	ZusammenfassungQ

Die Moku MATLAB API basiert auf der Moku API. Die vollständige Moku-API-Dokumentation finden Sie in der Moku-API-Referenz, die Sie hier finden https://apis.liq uidinstrume nts.com/re fe renz/.

Weitere Details zum Einstieg in die Moku MATLAB API finden Sie unter https://a pis.liquid instruments.com/sta Bewertung-Matlab.heim

Downgrade-Prozess

Wenn sich herausstellt, dass das Upgrade auf Version 3.0 einen für Ihre Anwendung wichtigen Punkt einschränkt oder anderweitig beeinträchtigt, können Sie ein Downgrade auf die vorherige Version 1.9 durchführen. Dies kann durch a erfolgen web Browser.

Vorgehensweise

1. Kontaktieren Sie Liquid Instruments und erhalten Sie die file für Firmware-Version 9.
2. Geben Sie Ihre Moku:Lab-IP-Adresse in ein web Browser (siehe Screenshot).
3. Suchen Sie unter „Firmware aktualisieren“ nach der Firmware und wählen Sie sie aus file bereitgestellt von Liquid Instruments.
4. Wählen Sie Hochladen und Aktualisieren. Der Aktualisierungsvorgang kann mehr als 10 Minuten dauern

© 2023 Liquid Instruments. reserviert.

laudinstruments.com

Dokumente / Ressourcen

LIQUID INSTRUMENTS MATLAB API-Integrationssicherungen [pdf] Benutzerhandbuch MATLAB API, MATLAB API-Integrationssicherungen, Integrationssicherungen, Sicherungen

Verweise

• Bedienungsanleitung