LIQUID INSTRUMENTS MATLAB API Bezpieczniki integracyjne

Przewodnik po migracji API MATLAB-a

Aktualizacja oprogramowania Moku: Lab do wersji 3.0 odblokowuje szereg nowych funkcji. Podczas aktualizacji użytkownicy API muszą podjąć dodatkowe kroki, aby przenieść swoje skrypty do nowego pakietu Moku API. W tym przewodniku po migracji opisano zmiany w interfejsie API, nowe funkcje dostępne w aktualizacji wersji 3.0 oraz wszelkie ograniczenia kompatybilności wstecznej.

Nadview

Oprogramowanie Moku:Lab w wersji 3.0 to poważna aktualizacja, która wprowadza nowe oprogramowanie sprzętowe, interfejs użytkownika i APl do sprzętu Moku:Lab. Aktualizacja dostosowuje Moku:Lab do Moku:Pro i Moku:Go, ułatwiając udostępnianie skryptów na wszystkich platformach Moku. Aktualizacja odblokowuje wiele nowych funkcji w wielu istniejących instrumentach. Dodaje także dwie nowe funkcje: tryb wielu instrumentów i kompilację w chmurze Moku. Istnieją również pewne subtelne różnice w zachowaniu, opisane w sekcji Kompatybilność wsteczna.

Jest to poważna aktualizacja, która wpływa na architekturę API i dlatego nowy pakiet MATLAB API v3.0 nie będzie wstecznie kompatybilny z istniejącymi skryptami MATLAB. Użytkownicy API będą musieli przenieść swoje skrypty do nowego pakietu Moku API, jeśli zaktualizują swoje Moku:Lab do wersji 3.0. Użytkownicy interfejsów API zajmujący się znacznym rozwojem oprogramowania niestandardowego powinni dokładnie rozważyć poziom wysiłku wymaganego do przeniesienia istniejącego kodu. Moku:Lab 1.9 nie jest zalecany do nowych wdrożeń i zachęcamy wszystkich klientów do aktualizacji. Jeśli po aktualizacji pojawią się problemy, użytkownicy będą mieli możliwość przejścia na wersję oprogramowania 1.9.

W tym przewodniku po migracji opisano advantagProblemy z aktualizacją i potencjalne komplikacje dla Moku:Lab w wersji 3.0. Opisuje także proces aktualizacji API MATLAB i, jeśli to konieczne, jak obniżyć wersję Moku:Lab.

Wersja 3.0 nowe funkcje

Nowe funkcje

Wersja oprogramowania 3.0 po raz pierwszy wprowadza tryb Multi-Instrument i Moku Cloud Compile do Moku:Lab, a także wiele ulepszeń wydajności i użyteczności w całym zestawie instrumentów.

Tryb wielu instrumentów

Tryb wielu instrumentów w Moku:Lab umożliwia użytkownikom jednoczesne rozmieszczenie dwóch instrumentów w celu stworzenia niestandardowej stacji testowej. Każdy przyrząd ma pełny dostęp do wejść i wyjść analogowych wraz z połączeniami pomiędzy gniazdami przyrządów. Połączenia między instrumentami obsługują szybką komunikację cyfrową w czasie rzeczywistym o niskim opóźnieniu do 2 Gb/s, dzięki czemu instrumenty mogą działać niezależnie lub można je łączyć w celu tworzenia zaawansowanych potoków przetwarzania sygnałów. Instrumenty można dynamicznie wymieniać i wymieniać, bez zakłócania pracy drugiego instrumentu. Zaawansowani użytkownicy mogą także wdrażać własne, niestandardowe algorytmy w trybie wielu instrumentów, korzystając z Moku Cloud Compile.

Kompilacja w chmurze Moku

Moku Cloud Compile pozwala na wdrożenie niestandardowego DSP bezpośrednio na Moku:Lab FPGA w trybie wielu instrumentów. Napisz kod za pomocą a web przeglądarkę i skompiluj ją w chmurze; Moku Cloud Compile wdraża strumień bitów na jednym lub większej liczbie docelowych urządzeń Moku.

Oscyloskop

• Tryb głębokiej pamięci: zapisz do 4M samples na kanał przy pełnym sampszybkość lingu (500 MSa/s)

Spectrum Analyzer

• Ulepszony poziom szumów
• Logarytmiczna skala Vrms i Vpp
• Pięć nowych funkcji okna (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Fazomierz

• Przesunięcie częstotliwości, faza i amplitude może być teraz wyprowadzana jako analogowa głośnośćtage sygnały
• Użytkownicy mogą teraz dodawać przesunięcie DC do sygnałów wyjściowych
• Wyjściową falę sinusoidalną ze zsynchronizowaną fazą można teraz mnożyć częstotliwość do 2 50x lub dzielić w dół do 125x
• Ulepszony zakres pasma (1 Hz do 100 kHz)
• Zaawansowane funkcje zawijania faz i automatycznego resetowania

Generator przebiegów

• Wyjście hałasu
• Modulacja szerokości impulsu (PWM)

Zamknij Ampżywsze

• Poprawiona wydajność niskich częstotliwości PLL zamykający
• Minimalna częstotliwość PLL została zmniejszona do 10 Hz
• Wewnętrzny sygnał PLL można teraz mnożyć częstotliwość do 250x lub dzielić do 125x w celu wykorzystania w demodulacji
• 6-cyfrowa precyzja wartości faz

Analizator odpowiedzi częstotliwościowej

• Zwiększona częstotliwość maksymalna ze 120 MHz do 200 MHz
• Zwiększ maksymalną liczbę punktów wobulacji z 512 do 8192
• Nowa dynamika AmpFunkcja litude automatycznie optymalizuje sygnał wyjściowy w celu uzyskania najlepszego zakresu dynamiki pomiaru
• Nowy tryb pomiaru ln/ln1
• Ostrzeżenia o nasyceniu wejścia
• Kanał matematyczny obsługuje teraz dowolne równania o wartościach zespolonych obejmujące sygnały kanału, umożliwiając nowe typy pomiarów złożonych funkcji przenoszenia
• Oprócz dBm sygnały wejściowe można teraz mierzyć w dBVpp i dBVrms
• Postęp przemiatania jest teraz wyświetlany na wykresie
• Oś częstotliwości można teraz zablokować, aby zapobiec przypadkowym zmianom podczas długiego przemiatania

Pudełko z zamkiem laserowym

• Ulepszony schemat blokowy pokazuje ścieżki sygnału skanowania i modulacji
• Nowy zamek stagTa funkcja umożliwia dostosowanie procedury blokowania
• Poprawiona wydajność niskich częstotliwości PLL zamykający
• 6-cyfrowa precyzja wartości faz
• Poprawiona wydajność niskich częstotliwości PLL zamykający
• Minimalna częstotliwość PLL została zmniejszona do 10 Hz
• Ten PLL sygnał może być teraz mnożony w częstotliwości do 250x lub dzielony w dół do 0.125x w celu wykorzystania w demodulacji

Inny

Do edytora równań dodano obsługę funkcji sinus, której można używać do generowania niestandardowych przebiegów w generatorze przebiegów arbitralnych

Konwertuj plik binarny LI files do formatów CSV, MATLAB lub NumPy podczas pobierania z urządzenia

Ulepszona obsługa API

Nowy pakiet Moku MATLAB API v3.0 zapewnia zwiększoną funkcjonalność i stabilność. Będzie otrzymywać regularne aktualizacje poprawiające wydajność i wprowadzające nowe funkcje.

Ograniczenia kompatybilności wstecznej

API

Nowy pakiet Moku MATLAB API v3.0 nie jest wstecznie kompatybilny z poprzednim pakietem Moku:Lab MATLAB v1.9. Argumenty i zwracane wartości skryptu MATLAB są zupełnie inne. Jeśli tworzysz szeroko zakrojone oprogramowanie niestandardowe przy użyciu Moku:Lab MATLAB, rozważ wpływ migracji całego oprogramowania na kompatybilność z nowym interfejsem API.

Chociaż pakiet Moku:Lab MATLAB nie będzie już otrzymywać aktualizacji, firma Liquid Instruments będzie nadal zapewniać wsparcie użytkownikom, którzy nie mogą migrować do nowego pakietu API.

Znajdź szczegółowe npamppliki dla każdego instrumentu w nowym pakiecie Moku MATLAB API v3.0, które mają służyć jako baza do konwersji wcześniejszego oprogramowania MATLAB na nowy pakiet API.

Regresje

Dysk RAM do rejestracji danych

Wersja 1.9 miała 512 MB filesystem w pamięci RAM urządzenia, który może być używany do rejestrowania danych przy wysokim poziomie sampstawki lingowe. W wersji 3.0 logowanie do pamięci RAM nie jest już dostępne. Aby umożliwić rejestrację danych, wymagana jest karta SD. W związku z tym zmienia się również maksymalna prędkość akwizycji. Wersja 1.9 obsługiwała do 1 MSa/s, natomiast wersja 3.0 obsługiwała do 250 kSa/s na 1 kanale i 125 kSa/s na 2 kanałach. Nawet przy niższych prędkościach i przy użyciu karty SD przepływy pracy obejmujące zapisywanie wielu szybkich dzienników w pamięci RAM, a następnie kopiowanie ich na kartę SD lub do klienta, nie będą już obsługiwane.

Rejestrowanie danych do pliku CSV

Wersja 1.9 miała możliwość zapisywania danych bezpośrednio w pliku CSV file podczas logowania. Ta funkcja nie jest bezpośrednio dostępna w wersji 3.0. Użytkownicy, których przepływ pracy obejmował zapisywanie pliku CSVfiles bezpośrednio na kartę SD, w przeciwnym razie klient będzie musiał najpierw przekonwertować plik binarny file do pliku CSV, korzystając z aplikacji klienckiej lub instalując samodzielny Liquid Instruments File Konwerter na komputer, którego używają do przetwarzania danych.

Zmiany niekompatybilne wstecz

Skalowanie danych w LIA

W wersji 1.9 zaimplementowaliśmy skalowanie danych w taki sposób, że pomnożenie dwóch sygnałów 0.1 V DC dało wynik 0.02 V DC. W wersji 3.0 zmieniliśmy to tak, że wynik wyniósł 0.01 V DC, co jest bardziej zgodne z intuicyjnymi oczekiwaniami klientów.

Aby można było używać go jako źródła/wyzwalacza modulacji, wyjście generatora przebiegów musi być włączone

W wersji 1.9 przebieg innego kanału mógł być używany jako źródło modulacji lub wyzwalania w generatorze przebiegów, nawet jeśli wyjście tego kanału było wyłączone. Zostało to usunięte w wersji

• Użytkownicy, którzy chcą wykonywać modulację krzyżową bez konieczności odłączania wyjść swojego urządzenia, będą musieli dostosować swoje

API Moku MATLAB

Pakiet Moku MATLAB API v3.0 ma zapewnić programistom MATLAB zasoby potrzebne do kontrolowania dowolnego urządzenia Moku, a ostatecznie możliwość włączenia tych elementów sterujących do większych aplikacji dla użytkowników końcowych. Nowy pakiet Moku MATLAB API v3.0 zawiera następujące elementy:

• W pełni sprawny npample skrypty MATLAB dla każdego
• Wszystkie skrypty MATLAB są opatrzone komentarzami, które są łatwe do zrozumienia i mogą służyć użytkownikowi końcowemu jako punkt wyjścia do dostosowywania i
• Zestaw funkcji zapewniających pełną kontrolę nad Moku

Obecnie obsługiwane instrumenty

1. Generator przebiegów arbitralnych
2. Rejestrator danych
3. Pudełko filtra cyfrowego
4. Konstruktor filtrów FIR
5. Analizator odpowiedzi częstotliwościowej
6. Pudełko z zamkiem laserowym
7. Zablokowanie Ampżywsze
8. Oscyloskop
9. Fazomierz
10. Regulator PID
11. Spectrum Analyzer
12. Generator przebiegów
13. Tryb wielu instrumentów
14. Kompilacja w chmurze Moku

Instalacja

Wymagania

• MATLAB wersja 2015 lub nowsza

Jeśli masz już zainstalowaną poprzednią wersję API Moku MATLAB, odinstaluj ją przed kontynuowaniem. Możesz odinstalować pakiet z Menedżera dodatków.

1. Otwórz Menedżera dodatków poprzez kartę Strona główna > Środowisko.
2. Szukaj Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Alternatywnie możesz pobrać zestaw narzędzi bezpośrednio z Liquid Instruments webmiejsce na https://www.liquidinstruments.com/products/apis/matlab-api/. W takim przypadku konieczne będzie ręczne ustawienie ścieżki wyszukiwania.
4. Sprawdź, czy do przybornika dodano prawidłową ścieżkę, wybierając opcję „Ustaw ścieżkę” na karcie Strona główna > Środowisko.
5. Upewnij się, że istnieje wpis wskazujący miejsce instalacji skrzynki narzędziowej. Typową ścieżką może być CAUserkusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku- MATLAB.
6. Pobierz dane instrumentu files, wpisując „moku_download####) w oknie poleceń MATLAB-a. ### należy zastąpić bieżącą wersją oprogramowania sprzętowego. Yol może znaleźć aktualną wersję oprogramowania sprzętowego w aplikacji komputerowej Moku, klikając prawym przyciskiem myszy Moku i najeżdżając kursorem na „Informacje o urządzeniu” lub w aplikacji na iPada, naciskając długo Moku.
7. Potwierdź, że Twój zestaw narzędzi jest poprawnie skonfigurowany, wpisując „help Moku” w oknie poleceń MATLAB-a. Jeśli to polecenie się powiedzie. oznacza to, że zestaw narzędzi został pomyślnie zainstalowany

Zmiany w API Moku

Nowa architektura API Moku MATLAB jest wystarczająco różna od swojej poprzedniczki i dlatego nie jest kompatybilna wstecz z istniejącymi skryptami API. Poniższy uproszczony oscyloskop, npampPlik pokazuje różnice pomiędzy starszymi i nowymi pakietami API i służy jako plan działania dotyczący przenoszenia istniejącego kodu.

Oscyloskop npample

Kroki sekwencji

1. Zaimportuj interfejs API Moku MATLAB 3.0
2. Zdobądź własność Moku i prześlij strumień bitów oscyloskopu do
3. Ustaw podstawę czasu i ustaw zakres lewej i prawej strony osi czasu.
4. Zdobądź dane, zdobądź pojedynczą klatkę danych z oscyloskopu
5. Zakończ sesję klienta, zrzekając się własności Moku

Sekwencja opisana powyżej jest uproszczonym przykłademampplik ilustrujący różnice pomiędzy starszymi i nowymi pakietami API. Oprócz rozpoczęcia sesji klienta, przesłania strumienia bitów instrumentu do Moku i zakończenia sesji klienta, użytkownik końcowy może wykonywać dowolną liczbę funkcji w różnej kolejności, aby spełnić potrzeby swojej aplikacji.

Różnice

Tutaj przyglądamy się różnicom między dwoma API dla każdego kroku w sekwencji.

Zgłoś własność Moku i prześlij strumień bitów oscyloskopu do urządzenia. W porównaniu z Moku MATLAB 1.9 nowe API posiada zupełnie inne funkcje:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Funkcjonować	get_by_name()	wdrożyć_or_conn ect()	Oscyloskop()
Dozwolone pola i wartości	nazwa: limit czasu ciągu: float	instrument: klasa instrumentu, który chcesz wdrożyć	ip: ciąg serial: ciąg
	siła: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignorowanie_zajęty: bool
			stan_trwały: bool
			connect_timeout: pływak
			read_timeout: pływak

 

1. Ustaw podstawę czasu. Funkcja jest taka sama, ale dozwolone argumenty są nieco inne:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funkcjonować	set_timebase()	set_timebase()
   Dozwolone pola i wartości	t1: pływak t2: pływak	t1: float t2: float strict: bool

2. Otrzymać dane. Funkcje i dozwolone argumenty są takie same, ale zwracany typ danych i długość są różne:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Funkcjonować	otrzymać dane()	otrzymać dane()
   Dozwolone pola i wartości	limit czasu: pływak czekaj: bool	limit czasu: float wait_reacquire: bool
   Długość powrotu	16383 punkty na klatkę	1024 punkty na klatkę

3. Zwolnij własność Moku:
   

   	Moku MATLAB 1.9	Moku API v3.0
   Funkcjonować	zamknąć()	zrzec się_własności()

Lista funkcji oscyloskopu

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 wyłącz_inputO Enable_rollmodeQ
set_precision_modeQ	set_acquisition_modeQ
synchronizacja_fazyQ	synchronizacja_wyjściowa_fazaQ
get_frontendQ	get_frontendQ
get_samp!erateO get_rea!time_dataQ	get_samp!erateO save_high_res_bufferO
gen_rampfalaO gen_sinewaveO	generuj_falęO get_acquisition_modeQ
gen_squarewaveQ	get_sourcesQ
gen_offQ	get_timebaseQ get_output_!oadQ
zestawyampoceńQ set_framerateQ	get_interpo!ationO set_output_!oadQ
	set_hysterezaQ set_interpo!ationO
	set_input_attenuationO
	set_sourceO osc_measurementQ
	podsumowanieQ

Interfejs API Moku MATLAB jest oparty na interfejsie API Moku. Pełną dokumentację Moku API można znaleźć w dokumencie Moku API Reference, który można znaleźć tutaj https://apis.liq uidinstrume nts.com/re fe rekiedyś/.

Dodatkowe szczegóły dotyczące rozpoczęcia korzystania z Moku MATLAB API można znaleźć pod adresem https://a pis.liquid instruments.com/sta ocena-Matlab.dom

Proces obniżenia wersji

Jeśli okaże się, że aktualizacja do wersji 3.0 ogranicza lub w inny sposób niekorzystnie wpływa na element krytyczny dla aplikacji, możesz przejść na poprzednią wersję 1.9. Można tego dokonać poprzez a web przeglądarka.

Kroki

1. Skontaktuj się z Liquid Instruments i uzyskaj file dla wersji oprogramowania 9.
2. Wpisz swój adres IP Moku:Lab w pliku web przeglądarkę (patrz zrzut ekranu).
3. W obszarze Aktualizuj oprogramowanie sprzętowe przejrzyj i wybierz oprogramowanie sprzętowe file dostarczane przez Liquid Instruments.
4. Wybierz opcję Prześlij i zaktualizuj. Proces aktualizacji może zająć ponad 10 minut

© 2023 Instrumenty Płynne. skryty.

laudinstruments.com

Dokumenty / Zasoby

LIQUID INSTRUMENTS MATLAB API Bezpieczniki integracyjne [plik PDF] Instrukcja użytkownika MATLAB API, MATLAB API Bezpieczniki integracyjne, Bezpieczniki integracyjne, Bezpieczniki

Odniesienia

• Instrukcja obsługi