VLOEIBARE INSTRUMENTEN MATLAB API-integratiezekeringen
MATLAB API-migratiehandleiding
Door Moku: Lab te upgraden naar softwareversie 3.0 ontgrendel je een groot aantal nieuwe functies. Bij het updaten moeten API-gebruikers extra stappen ondernemen om hun scripts naar het nieuwe Moku API-pakket te migreren. Deze migratiehandleiding beschrijft API-wijzigingen, nieuwe functies die beschikbaar zijn in de update van versie 3.0 en eventuele beperkingen voor achterwaartse compatibiliteit.
Overview
Moku:Lab-softwareversie 3.0 is een grote update die nieuwe firmware, gebruikersinterface en APls naar Moku:Lab-hardware brengt. De update brengt Moku:Lab in lijn met Moku:Pro en Moku:Go, waardoor het eenvoudig wordt om scripts te delen op alle Moku-platforms. De update ontgrendelt een groot aantal nieuwe functies voor veel van de bestaande instrumenten. Het voegt ook twee nieuwe functies toe: Multi-instrument Mode en Moku Cloud Compile. Er zijn ook enkele subtiele gedragsverschillen, beschreven in het gedeelte Achterwaartse compatibiliteit.
Dit is een grote update die van invloed is op de API-architectuur en daarom zal het nieuwe MATLAB API v3.0-pakket niet achterwaarts compatibel zijn met bestaande MATLAB-scripts. API-gebruikers moeten hun scripts overzetten naar het nieuwe Moku API-pakket als ze hun Moku:Lab upgraden naar versie 3.0. API-gebruikers met aanzienlijke softwareontwikkeling op maat moeten zorgvuldig overwegen hoeveel moeite het kost om hun bestaande code over te zetten. Moku:Lab 1.9 wordt niet aanbevolen voor nieuwe implementaties en alle klanten worden aangemoedigd om te upgraden. Als er problemen optreden na het upgraden, hebben gebruikers de mogelijkheid om te downgraden naar softwareversie 1.9.
Deze migratiegids schetst advantagUpdates en mogelijke complicaties voor Moku:Lab versie 3.0. Het schetst ook het proces om de MATLAB API te upgraden en hoe u uw Moku:Lab indien nodig kunt downgraden.
Versie 3.0 nieuwe functies
Nieuwe functies
Softwareversie 3.0 brengt voor het eerst Multi-Instrument Mode en Moku Cloud Compile naar Moku:Lab, evenals vele prestatie- en bruikbaarheidsupgrades voor de hele reeks instrumenten.
Multi-instrumentmodus
Met de multi-instrumentmodus op Moku:Lab kunnen gebruikers twee instrumenten tegelijkertijd inzetten om een aangepast teststation te creëren. Elk instrument heeft volledige toegang tot de analoge in- en uitgangen, samen met verbindingen tussen instrumentslots. De onderlinge verbindingen tussen instrumenten ondersteunen snelle, realtime digitale communicatie met lage latentie tot 2 Gb/s, zodat instrumenten onafhankelijk kunnen werken of kunnen worden aangesloten om geavanceerde signaalverwerkingspijplijnen te bouwen. Instrumenten kunnen dynamisch in en uit worden gewisseld zonder het andere instrument te onderbreken. Gevorderde gebruikers kunnen ook hun eigen aangepaste algoritmen implementeren in de multi-instrumentmodus met behulp van Moku Cloud Compile.
Moku Cloud-compilatie
Met Moku Cloud Compile kunt u aangepaste DSP rechtstreeks op de Moku:Lab FPGA implementeren in Multi-instrumentmodus. Schrijf code met behulp van a web browser en compileer deze in de cloud; Moku Cloud Compile implementeert de bitstream naar een of meer doel-Moku-apparaten.
Oscilloscoop
- Diepe geheugenmodus: bespaar tot 4M sampbestanden per kanaal op volledige samplengsnelheid (500 MSa/s)
Spectrum Analyzer
- Verbeterde ruisvloer
- Logaritmische Vrms- en Vpp-schaal
- Vijf nieuwe vensterfuncties (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)
Fasemeter
- Frequentie-offset, fase en amplitude kan nu worden uitgevoerd als analoog voltage signalen
- Gebruikers kunnen nu DC-offset toevoegen aan uitgangssignalen
- De fasevergrendelde sinusgolfuitgang kan nu in frequentie worden vermenigvuldigd tot 2 50x of worden verdeeld tot 125x
- Verbeterd bandbreedtebereik (1 Hz tot 100 kHz)
- Geavanceerde functies voor faseomloop en automatische reset
Golfvormgenerator
- Geluidsuitvoer
- Pulsbreedtemodulatie (PWM)
opsluiten Ampverliezer
- Verbeterde prestaties van lage frequenties PLL vergrendeling
- De minimale PLL-frequentie is verlaagd naar 10 Hz
- Het interne PLL-signaal kan nu in frequentie worden vermenigvuldigd tot 250x of worden verlaagd tot 125x voor gebruik bij demodulatie
- 6-cijferige precisie voor fasewaarden
Frequentieresponsanalysator
- Verhoogde maximale frequentie van 120 MHz naar 200 MHz
- Verhoog de maximale sweeppunten van 512 naar 8192
- De nieuwe dynamiek AmpDe litude-functie optimaliseert het uitgangssignaal automatisch voor het beste dynamische meetbereik
- Nieuwe ln/ln1-meetmodus
- Waarschuwingen voor invoerverzadiging
- Het wiskundige kanaal ondersteunt nu willekeurige vergelijkingen met complexe waarden waarbij de kanaalsignalen betrokken zijn, waardoor nieuwe typen complexe overdrachtsfunctiemetingen mogelijk worden
- Ingangssignalen kunnen nu naast dBm ook worden gemeten in dBVpp en dBVrms
- De voortgang van de sweep wordt nu weergegeven in de grafiek
- De frequentie-as kan nu worden vergrendeld om onbedoelde wijzigingen tijdens een lange sweep te voorkomen
Laser-lockbox
- Het verbeterde blokdiagram toont scan- en modulatiesignaalpaden
- De nieuwe vergrendeling stagMet deze functie kunt u de vergrendelingsprocedure aanpassen
- Verbeterde prestaties van lage frequenties PLL vergrendeling
- 6-cijferige precisie voor fasewaarden
- Verbeterde prestaties van lage frequenties PLL vergrendeling
- De minimale PLL-frequentie is verlaagd naar 10 Hz
- De PLL signaal kan nu in frequentie worden vermenigvuldigd tot 250x of worden verdeeld tot 0.125x voor gebruik bij demodulatie
Ander
Ondersteuning toegevoegd voor de sinusfunctie aan de vergelijkingseditor die kan worden gebruikt om aangepaste golfvormen te genereren in de Arbitrary Waveform Generator
Converteer binair LI files naar CSV-, MATLAB- of NumPy-formaten bij het downloaden vanaf het apparaat
Verbeterde API-ondersteuning
Het nieuwe Moku MATLAB API v3.0-pakket biedt verbeterde functionaliteit en stabiliteit. Het zal regelmatig updates ontvangen om de prestaties te verbeteren en nieuwe functies te introduceren.
Achterwaartse compatibiliteitsbeperkingen
API
Het nieuwe Moku MATLAB API v3.0-pakket is niet achterwaarts compatibel met het vorige Moku:Lab MATLAB v1.9-pakket. De MATLAB-scriptargumenten en retourwaarden zijn totaal verschillend. Als u uitgebreide aangepaste softwareontwikkeling heeft met behulp van Moku:Lab MATLAB, overweeg dan de impact van het migreren van al uw software om compatibel te zijn met de nieuwe API.
Hoewel het Moku:Lab MATLAB-pakket geen updates meer zal ontvangen, zal Liquid Instruments nog steeds ondersteuning bieden aan gebruikers die niet naar het nieuwe API-pakket kunnen migreren.
Vind gedetailleerde exampbestanden voor elk instrument in het nieuwe Moku MATLAB API v3.0-pakket om als basis te dienen voor het converteren van eerdere MATLAB-ontwikkelingen naar het nieuwe API-pakket.
Regressies
RAM-schijf voor datalogging
Versie 1.9 had een grootte van 512 MB filesysteem in het RAM-geheugen van het apparaat, dat kan worden gebruikt om gegevens met hoge s te loggenamplange tarieven. In versie 3.0 is inloggen op RAM niet langer beschikbaar. Om datalogging mogelijk te maken, is een SD-kaart vereist. Dienovereenkomstig verandert ook de maximale acquisitiesnelheid. Versie 1.9 ondersteunde tot 1 MSa/s, terwijl versie 3.0 tot 250 kSa/s op 1 kanaal en 125 kSa/s op 2 kanalen ondersteunt. Zelfs bij lagere snelheden en met een SD-kaart worden workflows waarbij meerdere hogesnelheidslogboeken in het RAM worden opgeslagen en deze later naar de SD-kaart of de client worden gekopieerd, niet langer ondersteund.
Gegevensregistratie naar CSV
Versie 1.9 had de mogelijkheid om gegevens rechtstreeks op een CSV op te slaan file tijdens het loggen. Deze functie is niet direct beschikbaar in versie 3.0. Gebruikers van wie de workflow het opslaan van CSV omvattefiles rechtstreeks naar een SD-kaart, anders moet de client nu eerst het binaire bestand converteren file naar CSV, met behulp van de client-app of door de zelfstandige Liquid Instruments te installeren File Converter op de computer die ze gebruiken voor gegevensverwerking.
Niet-achterwaarts compatibele wijzigingen
Gegevensschaling in LIA
In versie 1.9 hebben we de gegevensschaling zo geïmplementeerd dat het vermenigvuldigen van twee signalen van 0.1 V DC resulteerde in een uitvoer van 0.02 V DC. In versie 3.0 hebben we dit zodanig gewijzigd dat het resultaat 0.01 V DC was, wat beter aansluit bij de intuïtieve verwachtingen van klanten.
De uitgang van de golfvormgenerator moet zijn ingeschakeld om als modulatiebron/trigger te kunnen worden gebruikt
In versie 1.9 kon de golfvorm van een ander kanaal worden gebruikt als modulatie- of triggerbron in de golfvormgenerator, zelfs als de uitvoer van dat kanaal was uitgeschakeld. Dit is in versie verwijderd
- Gebruikers die cross-modulatie willen uitvoeren zonder de uitgangen van hun apparaat te hoeven loskoppelen, moeten hun instellingen aanpassen
Moku MATLAB-API
Het Moku MATLAB API v3.0-pakket is bedoeld om MATLAB-ontwikkelaars de middelen te bieden die nodig zijn om elk Moku-apparaat te besturen en uiteindelijk de mogelijkheid om deze besturingselementen in grotere eindgebruikerstoepassingen te integreren. Het nieuwe Moku MATLAB API v3.0-pakket biedt het volgende:
- Volledig functioneel bijvample MATLAB-scripts voor elk
- Alle MATLAB-scripts zijn voorzien van commentaar, die gemakkelijk te begrijpen zijn en als uitgangspunt voor de eindgebruiker kunnen dienen voor maatwerk en
- Een reeks functies die volledige controle over de Moku bieden
Momenteel ondersteunde instrumenten
- Willekeurige golfvormgenerator
- Gegevenslogger
- Digitale filterbox
- FIR-filterbouwer
- Frequentieresponsanalysator
- Laser-lockbox
- Vastzetten Ampverliezer
- Oscilloscoop
- Fasemeter
- PID-regelaar
- Spectrum Analyzer
- Golfvormgenerator
- Multi-instrumentmodus
- Moku Cloud-compilatie
Installatie
Vereisten
- MATLAB versie 2015 of hoger
Als u al een eerdere versie van de Moku MATLAB API hebt geïnstalleerd, verwijder deze dan voordat u doorgaat. U kunt het pakket verwijderen via Add-on Manager.
- Open Add-onbeheer via het tabblad Home > Omgeving.
- Zoeken naar Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
- Als alternatief kunt u de toolbox rechtstreeks vanuit Liquid Instruments downloaden weblocatie bij https://www.liquidinstruments.com/products/apis/matlab-api/. Als u dit doet, moet u het zoekpad handmatig instellen.
- Controleer of het juiste pad aan de werkset is toegevoegd door 'Pad instellen' te selecteren op het tabblad Home > Omgeving.
- Zorg ervoor dat er een ingang is die naar de installatielocatie van de gereedschapskist wijst. Een typisch pad zou CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB kunnen zijn.
- Download de instrumentgegevens files door 'moku_download####) in het MATLAB-opdrachtvenster te typen. De ### moet worden vervangen door uw huidige firmwareversie. Yol kan je huidige firmwareversie vinden via de Moku: desktop-app door met de rechtermuisknop op je Moku te klikken en 'Apparaatinfo' te bewegen, of in de iPad-app door lang op je Moku te drukken.
- Bevestig dat uw toolbox correct is ingesteld door 'help Moku' in het MATLAB-opdrachtvenster te typen. Als deze opdracht slaagt. dan is de toolbox succesvol geïnstalleerd
Moku API-wijzigingen
De nieuwe Moku MATLAB API-architectuur verschilt voldoende van zijn voorganger en is daarom niet achterwaarts compatibel met bestaande API-scripts. De volgende vereenvoudigde oscilloscoop example toont de verschillen tussen de oude en nieuwe API-pakketten en dient als routekaart voor het porten van bestaande code.
Oscilloscoop bijvample
Volgorde stappen
- Importeer de Moku MATLAB API 3.0
- Claim het Moku-eigendom en upload de Oscilloscope-bitstream naar
- Stel de tijdbasis in en stel het linker- en rechterbereik voor de tijdas in.
- Haal gegevens op, verkrijg een enkel frame van de gegevens van de oscilloscoop
- Beëindig de cliëntsessie door afstand te doen van het eigendom van Moku
De hierboven beschreven reeks is een vereenvoudigde example om de verschillen tussen de oude en nieuwe API-pakketten te illustreren. Naast het starten van een clientsessie, het uploaden van een instrumentbitstream naar Moku en het beëindigen van de clientsessie, kan een eindgebruiker een willekeurig aantal functies uitoefenen in verschillende volgorde om aan de behoeften van zijn toepassing te voldoen.
Verschillen
Hier kijken we voor elke stap in de reeks naar de verschillen tussen de twee APl's.
Claim het Moku-eigendom en upload de oscilloscoop-bitstream naar het apparaat. Vergeleken met Moku MATLAB 1.9 heeft de nieuwe API compleet andere functies:
| Moku MATLAB 1.9 | Moku MATLAB 3.0 | ||
| Functie | get_by_name() | implement_or_conn ect() | Oscilloscoop() |
| Toegestane velden en waarden | naam: string time-out: float | instrument: de klasse van het instrument dat u wilt inzetten | ip: string serieel: string |
| kracht: bol | set_defauIt: booI | force_connect: bool | |
| use_externa I: bool | negeer_busy: bool | ||
| persistent_state: bool | |||
| connect_timeout: zweven | |||
| read_timeout: zweven | |||
- Tijdbasis instellen. De functie is hetzelfde, maar de toegestane argumenten zijn iets anders:
Moku MATLAB 1.9 Moku MATLAB 3.0 Functie set_timebase() set_timebase() Toegestane velden en waarden t1: zwevend t2: zwevend t1: zwevend t2: zwevend strikt: bool - Gegevens verkrijgen. De functies en de toegestane argumenten zijn hetzelfde, maar het geretourneerde gegevenstype en de lengte zijn verschillend:
Moku MATLAB 1.9 Moku MATLAB 3.0 Functie gegevens verkrijgen() gegevens verkrijgen() Toegestane velden en waarden time-out: zweven wachten: bool time-out: float wait_reacquire: bool Retourlengte 16383 punten per frame 1024 punten per frame - Geef het Moku-eigendom vrij:
Moku MATLAB 1.9 Moku-API v3.0 Functie dichtbij() afstand doen van eigendom()
Lijst met oscilloscoopfuncties
| 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 uitschakelen_inputO |
| set_precision_modeQ | set_acquisition_modeQ |
| sync_phaseQ | sync_output_phaseQ |
| get_frontendQ | get_frontendQ |
| krijg_samp!erateO
get_rea!time_dataQ |
krijg_samp!erateO
save_high_res_bufferO |
| gen_rampgolfO
gen_sinusgolfO |
genereren_golfvormO
get_acquisition_modeQ |
| gen_squarewaveQ | get_sourcesQ |
| gen_offQ | get_timebaseQ
get_output_!oadQ |
| set_sampleerQ
set_framerateQ |
get_interpo!ationO set_output_!oadQ |
| set_hysteresisQ
set_interpo!ationO |
|
| set_input_attenuationO | |
| set_sourceO
osc_measurementQ |
|
| samenvattingQ |
De Moku MATLAB API is gebaseerd op de Moku API. Voor de volledige Moku API-documentatie raadpleegt u de Moku API Reference die u hier kunt vinden https://apis.liq uidinstrume nts.com/re fe rens/.
Aanvullende details om aan de slag te gaan met Moku MATLAB API zijn te vinden op https://a pis.liquid instruments.com/sta beoordeling-Matlab.thuis
Downgradeproces
Als is gebleken dat de upgrade naar versie 3.0 iets essentieels voor uw toepassing beperkt of anderszins nadelig beïnvloedt, kunt u downgraden naar de vorige versie 1.9. Dit kan via een web browser.
Stappen
- Neem contact op met Liquid Instruments en verkrijg de file voor firmwareversie 9.
- Typ uw Moku:Lab IP-adres in een web browser (zie schermafbeelding).
- Blader onder Firmware bijwerken naar de firmware en selecteer deze file geleverd door Liquid Instruments.
- Selecteer Uploaden en bijwerken. Het updateproces kan meer dan 10 minuten duren
© 2023 Vloeibare instrumenten. gereserveerd.
Documenten / Bronnen
 |
VLOEIBARE INSTRUMENTEN MATLAB API-integratiezekeringen [pdf] Gebruikershandleiding MATLAB API, MATLAB API Integratiezekeringen, Integratiezekeringen, Zekeringen |