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 un visuel de votre appareil virtuel, ainsi que les commandes Matter clusters compatibles avec l'appareil.
L'application utilise un client RPC pour communiquer avec le serveur RPC de l'appareil virtuel. envoyer des requêtes reflétant vos actions (activer/désactiver le bouton Marche/Arrêt, baisser la luminosité, augmenter la luminosité) et une interrogation par seconde pour récupérer l'état.
Appareils compatibles
Actuellement, MVD-DE accepte les éléments suivants : Matter types d'appareils:
Matter Type d'appareil | Cluster(s) d'application | Type d'écosystème domestique |
---|---|---|
Capteur de contact | État booléen | Capteur |
Lumière dimmable | Commande d'activation de 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 | Activé/Désactivé Contrôle du niveau |
Prise |
Capteur de pression | Mesure de la pression | Capteur |
Haut-parleur | 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
MVD-DE est une image Docker préconfigurée disponible sur le 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
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!
Créez une deuxième instance de session de terminal:
user@host> docker exec -it matter-container /bin/bash
Pour un appareil Matter virtuel, une fois qu'il est en cours d'exécution, démarrer VDC en lui transmettant l'argument
--s
et l'adresse IP utilisé par l'appareil:$ electron main.js --s=localhost:33000
Pour un appareil physique, démarrez VDC en lui transmettant le
--d
suivi du port série de l'appareil:$ electron main.js --d=/dev/ttyUSB0
Si vous démarrez VDC sans fournir d'argument, utilisera par défaut l'option de socket réseau en utilisant le port localhost 33000.
Une fois que le VDC pourra se connecter à votre appareil, il effectuera afficher un écran indiquant l'état de votre appareil:
Afficher le code QR de l'appareil
VDC peut également être utilisé pour récupérer le code QR en tant que une partie du flux de mise en service de votre appareil. Cliquez sur l'icône de code QR à côté image de l'appareil pour afficher le code QR de cet 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 les touches l'écran de VDC est sélectionné ou appuyez sur les touches Ctrl+C dans le 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.