VLOEIBARE INSTRUMENTE Moku Lab LabVIEW API-migrasie-gebruikersgids

verbyview

Moku: Lab sagteware weergawe 3.0 is 'n groot opdatering wat nuwe firmware, gebruikerskoppelvlakke en API's na Moku:Lab hardeware bring. Die opdatering bring Moku:Lab in lyn met Moku:Fro en Moku:Go, wat dit maklik maak om skrifte oor alle Moku-platforms te deel. Die opdatering ontsluit 'n magdom nuwe kenmerke vir baie van die bestaande instrumente. dit voeg ook twee nuwe kenmerke by: Muti-instrumentmodus en Moku Cloud Compile. Daar is 'n paar subtiele gedragsverskille wat ook in die afdeling vir agteruit versoenbaarheid uiteengesit word.

Hierdie opdatering beïnvloed ook die APl-argitektuur, en daarom sal die nuwe API-pakket nie agteruit versoenbaar wees met bestaande APl-skrifte nie. APlusers sal hul skrifte na die nuwe Moku APl-pakket moet oordra as hulle hul Moku:Lab na weergawe 3.C opgradeer. API-gebruikers met beduidende pasgemaakte sagteware-ontwikkeling moet die vlak van moeite wat nodig is om hul bestaande coce oor te dra, noukeurig oorweeg. Moku:Lab 1.9 word nie aanbeveel vir nuwe ontplooiings nie en alle kliënte word aangemoedig om op te gradeer. Uiteindelik sal Moku:Lab weergawe 1.9 ondersteuning verloor, in ooreenstemming met ons lewenseindebeleid. As daar probleme ontstaan ​​na die opgradering, sal gebruikers die opsie hê om af te gradeer na sagteware weergawe 19.

Hierdie migrasiegids gee 'n uiteensetting van advantage van opdatering en moontlike komplikasies van opdatering na Moku:Lab weergawe 3.0. Dit skets ook die proses om die Lab op te gradeerVIEW APl en hoe om jou Moku:Lab af te gradeer indien nodig.

Weergawe 3.0 nuwe funksies

Nuwe kenmerke
Sagtewareweergawe 3.0 bring Multi-Instrument Mode en Moku Cloud Compile vir die eerste keer na Moku:Lab, sowel as baie werkverrigting- en bruikbaarheidsopgraderings oor die reeks instrumente.

Multi-instrument modus
Muli-instrument-modus op Moku:Lab stel gebruikers in staat om twee instrumente gelyktydig te ontplooi om 'n pasgemaakte toetsstasie te skep. Elke instrument het volle toegang tot die analoog insette en uitsette, tesame met onderlinge verbindings tussen instrumentgleuwe. Die onderlinge verbindings tussen instrumente ondersteun hoëspoed, lae latensie, intydse digitale kommunikasie tot 2 Gb/s, sodat instrumente onafhanklik kan loop of gekoppel kan word om gevorderde seinverwerkingspyplyne te bou. Gebruikers kan instrumente dinamies in en uit ruil sonder om die ander aangrensende te onderbreek. Gevorderde gebruikers kan ook hul eie pasgemaakte algoritmes in Multi-instrument-modus gebruik deur Moku Cloud Compile te gebruik.

Moku Cloud-samestelling
Moku Cloud Compile laat jou toe om pasgemaakte digitale seinverwerking (DSP) direk op die Moku:Lab FPGA in Multi-instrument Mode te ontplooi. Skryf kode deur a web blaaier en stel dit in die wolk saam; gebruik dan Moku Cloud Compile om die bitstroom na een of meer teiken Moku-toestelle te ontplooi.

Ossilloskoop

• Diep geheue-modus — bespaar tot 4M samples per kanaal by die volle samplingtempo (500 MSa/s)

• Verbeterde geraasvloer
• Logaritmiese Vrms en Vpp skaal
• Vyf nuwe vensterfunksies (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Fasemeter

• Gebruikers kan nou frekwensie offset, fase, en amplitude as analoog voltage seine
• Gebruikers kan nou DC-offset by uitsetseine voeg
• Die fasegeslote sinusgolfuitset kan nou frekwensie vermenigvuldig word tot 250x of afgedeel word na 0.125x
• Verbeterde bandwydte (1 Hz tot 100 kHz)
• Gevorderde fase-omvou- en outomatiese herstelfunksies

Golfvormgenerator

• Geraas uitset
• Polswydtemodulasie (PWM)

Toesluit Ampverligter (LIA) 

• Verbeterde werkverrigting van lae-frekwensie PLL-sluiting
• Die minimum PLL-frekwensie is verlaag tot 10 Hz
• Die interne PLL-sein kan nou frekwensie vermenigvuldig word tot 250x of verdeel word na 0.125x vir gebruik in demodulasie
• 6-syfer akkuraatheid vir fasewaardes

Frekwensie-reaksie-ontleder

• Verhoogde maksimum frekwensie van 120 MHz tot 200 MHz
• Verhoogde maksimum sweeppunte van 512 na 8192
• Nuwe Dinamiese Amplitude funksie optimaliseer uitset sein outomaties vir die beste meting dinamiese omvang
• Nuwe In/Int metingsmodus
• Invoerversadigingwaarskuwings
• Die wiskunde-kanaal ondersteun nou arbitrêre vergelykings met komplekse waardes wat die kanaalseine betrek, wat nuwe tipes komplekse oordragfunksiemetings moontlik maak
• Gebruikers kan nou insetseine meet in dBVpp en dBVrms bykomend tot dBm
• Die vordering van die sweep word nou op die grafiek vertoon
• Die frekwensie-as kan nou gesluit word om toevallige veranderinge tydens langsvee te voorkom

Laser Lock Box

• Verbeterde blokdiagram toon skandering- en modulasieseinpaaie
• Nuwe sluit stages-funksie laat gebruikers toe om hul sluitprosedure aan te pas
• Verbeterde werkverrigting van lae-frekwensie P_L sluiting
• 6-syfer akkuraatheid vir fasewaardes
• Verbeterde werkverrigting van lae-frekwensie P_L sluiting
• Minimum PLL frekwensie afgeneem tot 10 Hz
• Die PLL-sein kan nou frekwensie vermenigvuldig word tot 250x of afgedeel word na 0.125x vir gebruik in demodulasie.

ANDER

• Bygevoeg ondersteuning vir die sinc-funksie by die vergelykingsredigeerder wat gebruik kan word om pasgemaakte golfvorms in die Arbitrary Waveform Generator te genereer
• Skakel binêre LI files na CSV-, MATLAB- of NumPy-formate wanneer dit van die toestel af afgelaai word

Opgradeerde API-ondersteuning
Die nuwe Moku API-pakket bied verbeterde funksionaliteit en stabiliteit. Dit sal gereelde opdaterings ontvang om werkverrigting te verbeter en nuwe kenmerke bekend te stel.

Terugwaartse versoenbaarheidsbeperkings

API
Die nuwe Moku LabVIEW API-pakket is nie agtertoe versoenbaar met die vorige Moku:LabLab nieVIEW API. Insette en uitsette verskil heeltemal. As jy uitgebreide persoonlike sagteware-ontwikkeling gedoen het deur gebruik te maak van die Moku:Lab LabVIEW API, oorweeg die impak van die migreer van al jou sagteware om versoenbaar te wees met die nuwe API.

Terwyl die Moku:Lab 1.9 LabVIEW API-pakket sal nie meer opdaterings ontvang nie, Liquid Instruments sal voortgaan om ondersteuning te bied vir gebruikers wat nie na die nuwe API-pakket kan migreer nie. Vind gedetailleerde examples vir elke instrument in die nuwe Moku LabVIEW API-pakket om as 'n basislyn te dien vir die omskakeling van vorige APl-ontwikkeling na die nuwe APl-pakket.

Regressies

RAM-skyf vir dataregistrasie
Weergawe 1.9 a het 512 MB gehad filestelsel in die toestel se RAM, wat gebruik kan word om data by hoë s aan te tekenampling tariewe. Dit is nie meer beskikbaar in weergawe 3.0 nie. Om dataregistrasie te aktiveer, word 'n SD-kaart benodig. Dit beperk dataregistrasiespoed tot ongeveer 250 kSa/s vir 1 kanaal en 125 kSa/s vir twee kanale.

Data aanteken na CSV
Weergawe 1.9 het die vermoë gehad om data direk na 'n CSV te stoor file terwyl jy aanteken. Hierdie kenmerk is nie direk beskikbaar op weergawe 3.0 nie. Gebruikers wie se werkvloei die stoor van CSV ingesluit het files direk na 'n SD-kaart of die kliënt sal nou eers die binêre moet omskakel file na CSV, óf met behulp van die kliënt-toepassing óf deur die selfstandige Liquid Instruments te installeer File Omskakelaar na die rekenaar wat hulle vir dataverwerking gebruik.

Nie-terugversoenbare veranderinge

Dataskaal in LIA
In weergawe 1.9 het ons dataskaal geïmplementeer sodat die vermenigvuldiging van twee 0.1V GS-seine 'n 0.02 V GS-uitset tot gevolg gehad het. In weergawe 3.0 het ons dit so verander dat die resultaat 0.01V DC was, wat meer in lyn is met kliënte se intuïtiewe verwagtinge.

Golfvormgenerator-uitset moet geaktiveer word om as modulasiebron/sneller te gebruik
In weergawe 1.9 kan 'n ander kanaal se golfvorm as 'n modulasie- of snellerbron in die golfvormgenerator gebruik word, selfs al was daardie kanaal se uitset gedeaktiveer. Dit is verwyder in weergawe 3.0. Gebruikers wat kruismodulasie wil doen sonder om die uitsette van hul toestel te ontkoppel, sal hul werkvloei moet aanpas.

Moku LabVIEW API

Die Moku LabVIEW API-pakket is bedoel om Lab te verskafVIEW ontwikkelaars die hulpbronne wat nodig is om enige Moku-toestel te beheer en uiteindelik die vermoë om hierdie kontroles in groter eindgebruikertoepassings te inkorporeer.

Die nuwe Moku LabVIEW API-pakket bied die volgende:

• Ten volle funksionele bvamples vir elke instrument.
• 'n Blokdiagramstruktuur wat maklik is om te verstaan ​​en kan dien as 'n eindgebruiker se beginpunt vir aanpassing en aanpassing
• Asetof Vlfunksies bied volle beheer oor die Moku-toestel.

Tans ondersteunde instrumente

1. Arbitrêre golfvormgenerator
2. Datalogger
3. Digitale filterkas
4. FIR Filter Bouer
5. Frekwensie-reaksie-ontleder
6. Toesluit Amplewendiger
7. Laser Lock Box
8. Logiese ontleder
9. Ossilloskoop
10. Fasemeter
11. Spektrum analiseerder
12. Golfvormgenerator
13. PID-beheerder
14. Multi-instrument modus
15. Moku Cloud-samestelling

Installasie

Vereistes

• LabVIEW weergawe 2016 of later
• VIP-pakketbestuurder (VIPM)

As jy reeds 'n vorige weergawe van die Moku Lab hetVIEW APlgeïnstalleer, verwyder dit asseblief voordat u voortgaan. U kan die pakket van die VI-pakketbestuurder verwyder deur Uninstall Package te kies.

1. Laai die Moku Lab af en installeer ditVIEW pakket van die Liquid Instruments webwebwerf by
2. Die pakket sal deur die VI-pakkiebestuurder geïnstalleer word. Sodra dit voltooi is, behoort jy die pakket te kan sien wat onder "geïnstalleer" in VI Pakketbestuurder gelys word.
   Figuur 1: JKI VI Pakketbestuurder
   
   Let wel: Die ander pakkette wat hier gelys word, is afhanklikhede wat gebruik word vir datastroom.

Moku API veranderinge

Die nuwe Moku LabVIEW APl-argitektuur verskil genoegsaam van sy voorganger en is dus nie agteruit versoenbaar met bestaande API-skrifte nie. Die volgende vereenvoudigde ossilloskoop bvample toon die verskille tussen die nalatenskap en nuwe API-pakkette en dien as 'n padkaart vir die oordrag van bestaande kode.

Ossilloskoop bvample
Figuur 2: Ossilloskoop APl vergelyking

Volgorde stappe

1. Begin kliëntsessie en laai Ossilloskoop-bitstroom op na Moku
2. Stel tydbasis en stel die linker- en regterkantse span vir die tyd-as
3. Genereer golfvorm, konfigureer en genereer 'n sinusgolf op kanaal 1
4. Kry data, verkry 'n enkele raam van die data van die ossilloskoop.
5. CENITENES
6. Eindig Kliëntsessie

Die volgorde hierbo beskryf is 'n vereenvoudigde eksample om die verskille tussen die erfenis- en nuwe APl-pakkette te illustreer. Afgesien van die begin van 'n kliëntsessie, die oplaai van 'n instrument-bitstroom na Moku, en die beëindiging van die kliëntsessie, kan 'n eindgebruiker enige aantal funksies in verskillende volgorde uitoefen om aan die behoeftes van hul toepassing te voldoen.

Verskille
Hier kyk ons ​​na die verskille tussen die twee API's vir elke stap in die volgorde.

1. Begin Maku-Client-sessie en laai Ossilloscope bitstream op na Moku
   Die nuwe APl het die kliëntsessieverbinding verdeel en die instrument-bitstroom opgelaai in afsonderlike funksies, 1A en 1B. Alle skrifte begin met hierdie 2 funksies.
   
2. Stel tyd basis
   Instrumentfunksies in die nuwe APl is nou enkelfunksies. Voorheen was dit 'n 2-stap-proses in die verouderde API. Die eerste funksie verander die invoerparameters na 'n JSON-string en die sekondes-funksie stuur die opdrag na die Moku. Boonop is funksieparameters in die verouderde APl in trosse vervat. Die meerderheid funksieparameters in die nuwe APl is individuele kontroles.
   Figuur 4 Stel tydbasis
   
3. Genereer golfvorm
   Die genereer golfvorm funksie is 'n enkele funksie in die nuwe API. In hierdie geval is die funksieparameters in 'n groep vervat. Daar is verskeie funksies in die nuwe AP wat baie invoerparameters vereis; in daardie gevalle word 'n groepering gebruik.
   
4. Kry data
   Die kry data-funksie is ook 'n enkele funksie in die nuwe API. In hierdie geval is die funksieparameters individuele kontroles vir beide API's. Die nalatenskap ARl vereis 'n bykomende funksie om die uitvoerdata van die JSON-stringformaat in numeriese skikkings vir elke kanaal om te skakel.
   Figuur 7: Maak API toe
   
   
5. Beëindig Moku-kliënt-sessie
   Die Close API-funksie is 'n enkele funksie in die nuwe API. Alle skrifte eindig met hierdie funksie.
   Figuur 7: Maak API toe
   

Palet vergelyking
Jy kan ekwivalente instrumentvouers vind in die Liquid Instruments Moku-hoofpalet, gesien in Figuur 8. Dan, in elke instrumentvouer sal jy die ekwivalente instrumentfunksies vind, gesien in Figuur 9 en Figuur 10.
Figuur : Hoofpalet, verouderde API-palet links, nuwe API-palet regs.

Figuur 9: Legacy Ossilloscope instrument vouer links, nuwe Ossilloscope instrument vouer regs.

Figuur 10: Instrumentfunksies

Die Moku LabVIEW Apl is gebaseer op Moku API. Vir volledige Moku APl-dokumentasie, verwys na die Moku API-verwysing wat hier gevind word https://apisliquidinstruments.com/reference/. Bykomende besonderhede om met Moku Lab te beginVIEW API kan gevind word by
https://apis.liquidinstruments.com/starting-labview.html.

Afgraderingsproses

As die opgradering na weergawe 3.0 bewys het dat dit iets krities vir jou toepassing beperk, of andersins nadelig beïnvloed, kan jy afgradeer na die vorige weergawe 1.9. Dit kan gedoen word deur a web blaaier.

Trappe

1. Kontak Liquid Instruments en verkry die file vir firmware weergawe 1.9.
2. Tik jou Moku:Lab IP-adres in 'n web blaaier (sien skermskoot).
3. Onder Update Firmware, blaai en kies die firmware file verskaf deur Liquid Instruments.
4. Kies Laai op en werk op. Die opdateringsproses kan meer as 10 minute neem om te voltooi.
   Figuur 11: Afgraderingsprosedure
   

Dokumente / Hulpbronne

VLOEIBARE INSTRUMENTE Moku Lab LabVIEW API-migrasie [pdf] Gebruikersgids Moku Lab LabVIEW API-migrasie, laboratoriumVIEW API-migrasie, API-migrasie, migrasie

Verwysings

• Gebruikershandleiding