Environnement de développement d'appareils virtuels Matter

SDK de l'appareil

Matter Virtual Device Development Environment (MVD-DE) est un conteneur Docker dans lequel vous pouvez créer votre Matter Virtual Device (MVD) et utiliser l'application de bureau Virtual Device Controller (VDC) pour fournir une interface utilisateur graphique permettant de contrôler et d'afficher les états de vos appareils Matter virtuels. L'application offre une représentation visuelle de votre appareil virtuel, ainsi que les commandes des clusters Matter compatibles avec l'appareil.

L'application utilise un client RPC pour communiquer avec le serveur RPC de l'appareil virtuel, en envoyant des requêtes reflétant vos actions (activer, diminuer, augmenter la luminosité) et en interrogeant une fois par seconde pour récupérer l'état.

Appareils compatibles

Actuellement, MVD-DE est compatible avec les types d'appareils Matter suivants:

Type d'appareil Matter	Cluster(s) d'application	Type d'écosystème domestique
Capteur de contact	État booléen	Capteur
Éclairage à intensité variable	Contrôle Activé/Désactivé	Léger
Éclairage couleur étendue	Activer/Désactiver Commande de niveau Contrôle des couleurs	Léger
Capteur de flux	Mesure du flux	Capteur
Capteur d'humidité	Mesure d'humidité relative	Capteur
Capteur d'éclairage	Mesure de l'éclairage	Capteur
Capteur de présence	Détection d'occupation	Capteur
Voyant Marche/Arrêt	Activé/Désactivé	Léger
Prise	Contrôle Activé/Désactivé	Prise
Capteur de pression	Mesure de pression	Capteur
inférieur	Contrôle Activé/Désactivé	Haut-parleur
Switch	Activé/Désactivé	Bouton bascule
Capteur de température	Mesure de la température	Capteur

Configurer l'environnement de développement d'appareils virtuels Matter

MVD-DE est une image Docker préconfigurée disponible sur Docker Hub. Pour l'installer, exécutez la commande suivante:

user@host> docker pull us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest

Cette opération peut durer quelques minutes.

Exécuter l'environnement de développement d'appareils virtuels Matter

1. Démarrez le conteneur Docker:

   user@host> xhost local:1000
   user@host> docker run -it --ipc=host --net=host -e DISPLAY --name matter-container us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest
   

   Après avoir démarré le conteneur, vous devriez obtenir une sortie de diagnostic suivie d'un message confirmant que la configuration de votre conteneur est correcte, et enfin, de l'invite de l'interface système du conteneur:

   Environment looks good, you are ready to go!
   

2. Créez une deuxième instance de session de terminal:

   user@host> docker exec -it matter-container /bin/bash
   

3. Pour un appareil Matter virtuel, démarrez l'appareil en démarrant VDC, en lui transmettant l'argument --s et le port IP utilisé par l'appareil:

   $ electron main.js --s=localhost:33000
   

   Pour un appareil physique, démarrez VDC en lui transmettant l'argument --d suivi du port série de l'appareil:

   $ electron main.js --d=/dev/ttyUSB0
   

Si vous démarrez VDC sans fournir d'argument, l'option du socket réseau est définie par défaut sur le port localhost 33000.

Une fois que VDC peut se connecter à votre appareil, un écran indiquant son état s'affiche:

Afficher le code QR de l'appareil

VDC peut également être utilisé pour récupérer le code QR lors de la mise en service de votre appareil. Cliquez sur l'icône du code QR à côté de l'image de l'appareil pour l'afficher:

Vous pouvez utiliser ce code QR pour commander votre appareil.

Arrêter l'environnement de développement d'appareils virtuels Matter

Pour arrêter MVD-DE, appuyez sur Ctrl+Q avec l'écran de VDC, ou appuyez sur Ctrl+C dans la session de terminal où vous avez démarré l'application.

Commentaires

Pour nous envoyer des commentaires sur la façon dont nous pouvons améliorer votre expérience avec MVD-DE, veuillez remplir notre formulaire de commentaires.

Envoyer des commentaires