Environnement de développement d'appareils virtuels Matter

Litige    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 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

  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 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:

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 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:

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 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.

Envoyez-nous vos commentaires