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 des commandes pour les 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 de l'alimentation, diminution de la luminosité, éclairage) et interroge une fois par seconde pour récupérer l'état.

Appareils compatibles

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

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

Configurer l'environnement de développement des 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 des 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é, des résultats de diagnostic doivent s'afficher, suivis 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 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'argument, il utilisera par défaut l'option de socket réseau via le port localhost 33000.

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

Interface utilisateur graphique de l'appareil virtuel

Afficher le code QR de l'appareil

Vous pouvez également utiliser VDC pour récupérer le code QR dans le cadre du flux 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 correspondant:

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 des appareils virtuels Matter

Pour arrêter MVD-DE, appuyez sur les touches Ctrl+Q avec l'écran de VDC au premier plan, ou appuyez sur les touches Ctrl+C dans la session de terminal où 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 de commentaires.

Envoyez-nous vos commentaires