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 fournit 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 (mise en marche, atténuation, luminosité) et en effectuant une interrogation toutes les secondes pour récupérer l'état.

Appareils compatibles

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

Matter Type d'appareil Clusters d'applications Type d'écosystème domestique
Capteur de contact État booléen Capteur
Lumière dimmable Activé/Désactivé
Contrôle du niveau
Léger
Lumière de couleur étendue Activé/Désactivé
Contrôle du niveau
Contrôle de la couleur
Léger
Capteur de débit Mesure du débit Capteur
Capteur d'humidité Mesure de l'humidité relative Capteur
Capteur d'éclairement Mesure de l'éclairement Capteur
Capteur de présence Détection de présence Capteur
Voyant Marche/Arrêt Activé/Désactivé Léger
Prise Activé/Désactivé
Contrôle du niveau
Prise
Capteur de pression Mesure de la pression Capteur
Haut-parleur Activé/Désactivé
Contrôle du niveau
Haut-parleur
Changer Activé/Désactivé Bouton bascule
Capteur de température (Temperature Sensor) 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
    

    Une fois le conteneur démarré, vous devriez voir une sortie de diagnostic suivie d'un message confirmant que la configuration de votre conteneur est correcte, puis l'invite de shell 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, une fois l'appareil en cours d'exécution, démarrez 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'arguments, l'option de socket réseau utilisant le port localhost 33000 est utilisée par défaut.

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

Interface utilisateur graphique du dispositif virtuel

Afficher le code QR de l'appareil

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

Virtual Device Controller affichant le code QR de l'appareil

Vous pouvez utiliser ce code QR pour mettre en service votre appareil.

Arrêter l'environnement de développement de l'appareil virtuel Matter

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

Commentaires

Pour nous faire part de vos commentaires sur la façon dont nous pouvons améliorer votre expérience avec MVD-DE, remplissez notre formulaire.

Envoyer vos commentaires