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 (activation/désactivation, luminosité) et 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:

Type d'appareil Matter Cluster(s) d'application Type d'écosystème domestique
Capteur de contact État booléen Capteur
Lumière à intensité variable Bouton Marche/Arrêt
pour contrôler le niveau
Léger
Éclairage de couleur étendu Activé/Désactivé
Contrôle du niveau
Contrôle des couleurs
Léger
Capteur de débit Mesure de flux Capteur
Capteur d'humidité Mesure de l'humidité relative Capteur
Capteur d'éclairage Mesure de l'éclairage Capteur
Détecteur de présence Détection de l'occupation Capteur
Voyant Marche/Arrêt Activé/Désactivé Léger
Prise Bouton Marche/Arrêt
pour contrôler le niveau
Prise
Capteur de pression Mesure de la pression Capteur
inférieur Bouton Marche/Arrêt
pour contrôler le 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

Le fichier 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 voir un résultat de diagnostic, suivi d'un message confirmant que la configuration de votre conteneur est correcte, puis 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 virtuel Matter, 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'argument, l'option de socket réseau sera définie par défaut sur le port localhost 33000.

Une fois que VDC peut se connecter à votre appareil, il affiche un écran indiquant l'état de l'appareil:

Interface utilisateur graphique de l'appareil virtuel

Afficher le code QR de l'appareil

VDC peut également être utilisé pour récupérer le code QR dans le cadre du processus de mise en service de votre 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:

Contrôleur d'appareil virtuel 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 d'appareils virtuels Matter

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

Commentaires

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

Envoyez-nous vos commentaires