INSTRUMENTS LIQUIDES Fusibles d'intégration API MATLAB

Guide de migration des API MATLAB

La mise à niveau de Moku : Lab vers la version 3.0 du logiciel débloque une multitude de nouvelles fonctionnalités. Lors de la mise à jour, les utilisateurs de l'API doivent prendre des mesures supplémentaires pour migrer leurs scripts vers le nouveau package API Moku. Ce guide de migration décrit les modifications apportées à l'API, les nouvelles fonctionnalités disponibles dans la mise à jour de la version 3.0 et les limitations de compatibilité ascendante.

Surview

La version 3.0 du logiciel Moku:Lab est une mise à jour majeure qui apporte un nouveau micrologiciel, une interface utilisateur et des APl au matériel Moku:Lab. La mise à jour aligne Moku:Lab sur Moku:Pro et Moku:Go, facilitant le partage de scripts sur toutes les plates-formes Moku. La mise à jour débloque une multitude de nouvelles fonctionnalités pour de nombreux instruments existants. Il ajoute également deux nouvelles fonctionnalités : le mode multi-instrument et la compilation Moku Cloud. Il existe également quelques différences comportementales subtiles, décrites dans la section Compatibilité descendante.

Il s'agit d'une mise à jour majeure qui affecte l'architecture de l'API et, par conséquent, le nouveau package MATLAB API v3.0 ne sera pas rétrocompatible avec les scripts MATLAB existants. Les utilisateurs de l'API devront porter leurs scripts vers le nouveau package API Moku s'ils mettent à niveau leur Moku:Lab vers la version 3.0. Les utilisateurs d’API ayant développé d’importants logiciels personnalisés doivent soigneusement réfléchir au niveau d’effort requis pour porter leur code existant. Moku:Lab 1.9 n'est pas recommandé pour les nouveaux déploiements et tous les clients sont encouragés à effectuer une mise à niveau. Si des problèmes surviennent après la mise à niveau, les utilisateurs auront la possibilité de revenir à la version 1.9 du logiciel.

Ce guide de migration décrit les avantagestages de mise à jour et complications potentielles de Moku:Lab version 3.0. Il décrit également le processus de mise à niveau de l'API MATLAB et comment rétrograder votre Moku:Lab si nécessaire.

Nouvelles fonctionnalités de la version 3.0

Nouvelles fonctionnalités

La version 3.0 du logiciel apporte pour la première fois le mode multi-instruments et Moku Cloud Compile à Moku:Lab, ainsi que de nombreuses mises à niveau de performances et de convivialité dans la suite d'instruments.

Mode multi-instruments

Le mode multi-instruments sur Moku:Lab permet aux utilisateurs de déployer deux instruments simultanément pour créer une station de test personnalisée. Chaque instrument a un accès complet aux entrées et sorties analogiques ainsi qu'aux interconnexions entre les emplacements d'instrument. Les interconnexions entre les instruments prennent en charge une communication numérique en temps réel à haut débit et à faible latence jusqu'à 2 Gbit/s, de sorte que les instruments peuvent fonctionner indépendamment ou être connectés pour créer des pipelines de traitement de signal avancés. Les instruments peuvent être échangés dynamiquement sans interrompre l’autre instrument. Les utilisateurs avancés peuvent également déployer leurs propres algorithmes personnalisés en mode multi-instruments à l'aide de Moku Cloud Compile.

Compilation du nuage Moku

Moku Cloud Compile vous permet de déployer un DSP personnalisé directement sur le FPGA Moku:Lab en mode multi-instruments. Écrire du code à l'aide d'un web navigateur et compilez-le dans le cloud ; Moku Cloud Compile déploie le flux binaire sur un ou plusieurs appareils Moku cibles.

Oscilloscope

• Mode mémoire profonde : économisez jusqu'à 4 M samples par canal au maximumamptaux de ling (500 MSa/s)

Analyseur de spectre

• Bruit de fond amélioré
• Échelle logarithmique Vrms et Vpp
• Cinq nouvelles fonctions de fenêtre (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Phasemètre

• Décalage de fréquence, phase et ampla altitude peut maintenant être sortie sous forme de vol analogiquetage signaux
• Les utilisateurs peuvent désormais ajouter un décalage CC aux signaux de sortie
• La sortie d'onde sinusoïdale à verrouillage de phase peut désormais être multipliée en fréquence jusqu'à 2 50x ou divisée jusqu'à 125x.
• Plage de bande passante améliorée (1 Hz à 100 kHz)
• Fonctions avancées d'enroulement de phase et de réinitialisation automatique

Générateur de forme d'onde

• Sortie de bruit
• Modulation de largeur d'impulsion (PWM)

Verrouillage Amplifier

• Performances améliorées des basses fréquences PLL verrouillage
• La fréquence PLL minimale a été réduite à 10 Hz
• Le signal PLL interne peut désormais être multiplié en fréquence jusqu'à 250x ou divisé jusqu'à 125x pour une utilisation en démodulation
• Précision à 6 chiffres pour les valeurs de phase

Analyseur de réponse en fréquence

• Fréquence maximale augmentée de 120 MHz à 200 MHz
• Augmenter le nombre maximum de points de balayage de 512 à 8192 XNUMX
• La nouvelle dynamique Ampla fonction de latitude optimise automatiquement le signal de sortie pour une meilleure plage dynamique de mesure
• Nouveau mode de mesure ln/ln1
• Avertissements de saturation d'entrée
• Le canal mathématique prend désormais en charge les équations arbitraires à valeurs complexes impliquant les signaux du canal, permettant de nouveaux types de mesures de fonctions de transfert complexes
• Les signaux d'entrée peuvent désormais être mesurés en dBVpp et dBVrms en plus du dBm
• La progression du balayage est maintenant affichée sur le graphique
• L'axe des fréquences peut désormais être verrouillé pour éviter les changements accidentels lors d'un long balayage

Boîte de verrouillage laser

• Le schéma fonctionnel amélioré montre les chemins des signaux de balayage et de modulation.
• Les nouveaux verrouillagestagLa fonctionnalité es permet de personnaliser la procédure de verrouillage
• Performances améliorées des basses fréquences PLL verrouillage
• Précision à 6 chiffres pour les valeurs de phase
• Performances améliorées des basses fréquences PLL verrouillage
• La fréquence PLL minimale a été réduite à 10 Hz
• Le PLL le signal peut désormais être multiplié en fréquence jusqu'à 250x ou divisé jusqu'à 0.125x pour une utilisation en démodulation

Autre

Ajout de la prise en charge de la fonction sinusoïdale dans l'éditeur d'équations qui peut être utilisée pour générer des formes d'onde personnalisées dans le générateur de formes d'onde arbitraires.

Convertir binaire LI files aux formats CSV, MATLAB ou NumPy lors du téléchargement depuis l'appareil

Prise en charge des API améliorées

Le nouveau package Moku MATLAB API v3.0 offre des fonctionnalités et une stabilité améliorées. Il recevra des mises à jour régulières pour améliorer les performances et introduire de nouvelles fonctionnalités.

Limitations de la rétrocompatibilité

API

Le nouveau package Moku MATLAB API v3.0 n'est pas rétrocompatible avec le précédent package Moku:Lab MATLAB v1.9. Les arguments de script MATLAB et les valeurs de retour sont totalement différents. Si vous développez de nombreux logiciels personnalisés à l'aide de Moku:Lab MATLAB, réfléchissez à l'impact de la migration de tous vos logiciels pour qu'ils soient compatibles avec la nouvelle API.

Bien que le package Moku:Lab MATLAB ne reçoive plus de mises à jour, Liquid Instruments continuera à fournir une assistance aux utilisateurs qui ne peuvent pas migrer vers le nouveau package API.

Trouver un ex détailléampfichiers pour chaque instrument du nouveau package Moku MATLAB API v3.0 pour servir de base de référence pour la conversion du développement MATLAB antérieur vers le nouveau package API.

Régressions

Disque RAM pour l'enregistrement des données

La version 1.9 avait 512 Mo filesystème dans la RAM de l'appareil, qui pourrait être utilisé pour enregistrer des données à haute samptarifs de location. Dans la version 3.0, la connexion à la RAM n'est plus disponible. Pour activer l'enregistrement des données, une carte SD est requise. En conséquence, la vitesse d'acquisition maximale change également. La version 1.9 prenait en charge jusqu'à 1 MSa/s, tandis que la version 3.0 prend en charge jusqu'à 250 kSa/s sur 1 canal et 125 kSa/s sur 2 canaux. Même à des vitesses inférieures et avec une carte SD, les flux de travail qui comprenaient la sauvegarde de plusieurs journaux à grande vitesse dans la RAM, puis leur copie ultérieure sur la carte SD ou sur le client ne seront plus pris en charge.

Enregistrement des données au format CSV

La version 1.9 avait la possibilité de sauvegarder les données directement dans un CSV file lors de la journalisation. Cette fonctionnalité n'est pas directement disponible sur la version 3.0. Utilisateurs dont le flux de travail comprenait l'enregistrement de CSVfiles directement sur une carte SD ou le client devra maintenant d'abord convertir le binaire file au format CSV, soit à l'aide de l'application cliente, soit en installant les instruments liquides autonomes File Convertisseur sur l'ordinateur qu'ils utilisent pour le traitement des données.

Modifications non rétrocompatibles

Mise à l'échelle des données dans LIA

Dans la version 1.9, nous avons implémenté une mise à l'échelle des données de telle sorte que la multiplication de deux signaux de 0.1 V CC aboutissait à une sortie de 0.02 V CC. Dans la version 3.0, nous avons modifié cela de telle sorte que le résultat soit 0.01 V CC, ce qui correspond davantage aux attentes intuitives des clients.

La sortie du générateur de formes d'onde doit être activée pour être utilisée comme source/déclencheur de modulation

Dans la version 1.9, la forme d'onde d'un canal différent pouvait être utilisée comme source de modulation ou de déclenchement dans le générateur de forme d'onde, même si la sortie de ce canal était désactivée. Ceci a été supprimé dans la version

• Les utilisateurs qui souhaitent effectuer une modulation croisée sans avoir besoin de débrancher les sorties de leur appareil devront ajuster leur

API Moku MATLAB

Le package Moku MATLAB API v3.0 est destiné à fournir aux développeurs MATLAB les ressources nécessaires pour contrôler n'importe quel appareil Moku et, à terme, la possibilité d'incorporer ces contrôles dans des applications d'utilisateur final plus vastes. Le nouveau package Moku MATLAB API v3.0 fournit les éléments suivants :

• Ex entièrement fonctionnelamples scripts MATLAB pour chacun
• Tous les scripts MATLAB sont fournis avec des commentaires faciles à comprendre et peuvent servir de point de départ à l'utilisateur final pour la personnalisation et
• Un ensemble de fonctions offrant un contrôle total sur le Moku

Instruments actuellement pris en charge

1. Générateur de formes d'onde arbitraires
2. Enregistreur de données
3. Boîte de filtre numérique
4. Générateur de filtres FIR
5. Analyseur de réponse en fréquence
6. Boîte de verrouillage laser
7. Verrouillage Amplifier
8. Oscilloscope
9. Phasemètre
10. Contrôleur PID
11. Analyseur de spectre
12. Générateur de forme d'onde
13. Mode multi-instruments
14. Compilation du nuage Moku

Installation

Exigences

• MATLAB version 2015 ou ultérieure

Si vous disposez déjà d'une version précédente de l'API Moku MATLAB, veuillez la désinstaller avant de continuer. Vous pouvez désinstaller le package à partir du gestionnaire de modules complémentaires.

1. Ouvrez le gestionnaire de modules complémentaires via l'onglet Accueil > Environnement.
2. Rechercher Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Alternativement, vous pouvez télécharger la boîte à outils directement depuis Liquid Instruments website à https://www.liquidinstruments.com/products/apis/matlab-api/. Vous devrez définir le chemin de recherche manuellement si vous faites cela.
4. Vérifiez que le chemin correct a été ajouté à la boîte à outils en sélectionnant « Définir le chemin » dans l'onglet Accueil > Environnement.
5. Assurez-vous qu’il existe une entrée pointant vers l’emplacement d’installation de la boîte à outils. Un chemin typique peut être CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Téléchargez les données de l'instrument files en tapant 'moku_download####) dans la fenêtre de commande MATLAB. Le ### doit être remplacé par la version actuelle de votre micrologiciel. Yol peut trouver la version actuelle de votre micrologiciel via l'application de bureau Moku : en cliquant avec le bouton droit sur votre Moku et en survolant « Informations sur l'appareil », ou dans l'application iPad en appuyant longuement sur votre Moku.
7. Confirmez que votre boîte à outils est correctement configurée en tapant « help Moku » dans la fenêtre de commande MATLAB. Si cette commande réussit. alors la boîte à outils a été installée avec succès

Modifications de l'API Moku

La nouvelle architecture API Moku MATLAB est suffisamment différente de son prédécesseur et n'est donc pas rétrocompatible avec les scripts API existants. L'ex-oscilloscope simplifié suivantampLe fichier montre les différences entre les anciens et les nouveaux packages d'API et sert de feuille de route pour le portage du code existant.

Oscilloscope example

Étapes de la séquence

1. Importez l'API Moku MATLAB 3.0
2. Réclamez la propriété de Moku et téléchargez le flux binaire de l'oscilloscope sur
3. Définissez la base de temps et définissez les intervalles gauche et droit pour l'axe du temps.
4. Obtenez des données, acquérez une seule image des données de l'oscilloscope
5. Mettre fin à la session client en renonçant à la propriété de Moku

La séquence décrite ci-dessus est un ex simplifiéample pour illustrer les différences entre les anciens et les nouveaux packages API. Outre le début d'une session client, le téléchargement d'un flux binaire d'instrument sur Moku et la fin de la session client, un utilisateur final peut exercer un certain nombre de fonctions dans différents ordres pour répondre aux besoins de son application.

Différences

Ici, nous examinons les différences entre les deux APL pour chaque étape de la séquence.

Réclamez la propriété de Moku et téléchargez le flux binaire de l'oscilloscope sur l'appareil. Par rapport à Moku MATLAB 1.9, la nouvelle API a des fonctions complètement différentes :

	Moku MATLAB 1.9		Moku MATLAB 3.0
Fonction	get_by_name()	déployer_or_conn ect()	Oscilloscope()
Champs et valeurs autorisés	nom : chaîne délai d'attente : float	instrument : la classe de l'instrument que vous souhaitez déployer	ip : chaîne série : chaîne
	forcer : booléen	set_defauIt : booI	force_connect : booléen
		use_externa I : booléen	ignore_busy : booléen
			persist_state : booléen
			connect_timeout : flottant
			read_timeout : flottant

 

1. Définir la base de temps. La fonction est la même, mais les arguments autorisés sont légèrement différents :
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Fonction	set_timebase()	set_timebase()
   Champs et valeurs autorisés	t1 : flottant t2 : flottant	t1 : float t2 :float strict :booléen

2. Obtenez des données. Les fonctions et les arguments autorisés sont les mêmes, mais le type et la longueur des données renvoyées sont différents :
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Fonction	get_data()	get_data()
   Champs et valeurs autorisés	délai d'attente : float wait : bool	délai d'attente : float wait_reacquire : bool
   Longueur de retour	16383 points par image	1024 points par image

3. Libérez la propriété de Moku :
   

   	Moku MATLAB 1.9	API Moku v3.0
   Fonction	fermer()	abandonner_propriété()

Liste des fonctions de l'oscilloscope

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_timebaseQ set_xmodeQ	set_defau!tsQ set_timebaseQ désactiver_inputO activer_rollmodeQ
set_precision_modeQ	set_acquisition_modeQ
sync_phaseQ	sync_output_phaseQ
get_frontendQ	get_frontendQ
obtenir_samp!erateO get_rea!time_dataQ	obtenir_samp!erateO save_high_res_bufferO
gen_rampvagueO 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_hystérésisQ set_interpo!ationO
	set_input_attenuationO
	set_sourceO osc_measurementQ
	résuméQ

L'API Moku MATLAB est basée sur l'API Moku. Pour la documentation complète de l'API Moku, reportez-vous à la référence de l'API Moku trouvée ici https://apis.liq uidinstrume nts.com/re fe redepuis/.

Des détails supplémentaires pour démarrer avec l'API Moku MATLAB peuvent être trouvés sur https://a pis.liquid instruments.com/sta notation-Matlab.maison

Processus de rétrogradation

S'il s'avère que la mise à niveau vers la version 3.0 limite ou affecte négativement quelque chose de critique pour votre application, vous pouvez revenir à la version précédente 1.9. Cela peut être fait grâce à un web navigateur.

Mesures

1. Contactez Liquid Instruments et obtenez le file pour la version 9 du micrologiciel.
2. Tapez votre adresse IP Moku:Lab dans un web navigateur (voir capture d'écran).
3. Sous Mettre à jour le micrologiciel, parcourez et sélectionnez le micrologiciel file fourni par Liquid Instruments.
4. Sélectionnez Télécharger et mettre à jour. Le processus de mise à jour peut prendre plus de 10 minutes

© 2023 Instruments liquides. réservé.

laudinstruments.com

Documents / Ressources

INSTRUMENTS LIQUIDES Fusibles d'intégration API MATLAB [pdf] Guide de l'utilisateur API MATLAB, Fusibles d'intégration API MATLAB, Fusibles d'intégration, Fusibles

Références

• Manuel d'utilisation