Appareil virtuel Matter

Matter SDK de l'appareil

Les appareils virtuels Matter sont utiles pour développer et tester des solutions Matter. Ils peuvent être mis en service à l'aide de Google Home app (GHA) et contrôlés à l'aide de GHA et Google Assistant, tout comme les appareils Matter physiques.

Pour les développeurs d'applications et autres personnes qui doivent tester ou émuler un appareil Matter virtuel, mais qui ne disposent pas des ressources nécessaires pour créer leur propre appareil Matter physique ou virtuel, Google propose Matter Virtual Device (MVD). MVD est un outil de bureau Linux ou macOS autonome léger qui simule différents types d'appareils Matter virtuels et fournit une interface utilisateur graphique pour contrôler et afficher les états de l'appareil Matter virtuel.

Contrairement à un appareil Matter physique, MVD ne s'appuie pas sur le Bluetooth® à basse consommation (BLE) ni sur Thread® pour rejoindre un tissu Matter. Elle utilise plutôt la connexion réseau Wi-Fi existante de la machine Linux ou macOS hôte pour la mise en service.

Par rapport à d'autres outils

MVD diffère de Virtual Device Controller (VDC) en ce qu'il s'agit d'une solution autonome, combinant un appareil virtuel et une UI pour le contrôler. En revanche, VDC permet de contrôler un appareil Matter virtuel distinct, tel que celui que nous créons dans Matter Virtual Device Development Environment (MVD-DE).

Vous avez peut-être déjà travaillé avec l'atelier de programmation MVD-DE. Dans cet atelier de programmation, vous allez créer un seul type d'appareil virtuel : une ampoule connectée. En revanche, MVD contient plusieurs appareils virtuels prédéfinis différents et inclut une UI intégrée pour les exécuter et les contrôler.

Tableau: Comparaison des outils d'appareils virtuels Matter
MVD VDC MVD-DE (atelier de programmation)
Émuler un appareil Matter
Contrôler un appareil Matter émulé
Effort de développement requis
Télécharger moins de 100 Mo 9 GB 20 Go

Appareils compatibles

MVD est compatible avec les types d'appareils Matter suivants:

Tableau: Types d'appareils Matter compatibles avec MVD
Matter Type d'appareil Clusters d'applications Type d'écosystème domestique
Purificateur d'air 0x0202
0x0006
0x0071
Purificateur d'air
Capteur de qualité de l'air 0x005b
0x0402
0x0405
0x040c
0x040d
0x042a
0x042d
0x042e
Capteur
Lecteur vidéo de base 0x0006
0x0506
0x0509
Téléviseur
Lumière de température des couleurs 0x0300
0x0008
0x0006
Léger
Capteur de contact 0x0045
Capteur
Lumière dimmable 0x0008
0x0006
Léger
Serrure 0x0101
Verrouiller
Lumière de couleur étendue 0x0300
0x0008
0x0006
Léger
Ventilateur 0x0202
0x0006
Ventilateur
Capteur de débit 0x0404
Capteur
Commutateur générique 0x003b
Bouton bascule
Capteur d'humidité 0x0405
Capteur
Capteur de lumière 0x0400
Capteur
Capteur de présence 0x0406
Capteur
Voyant Marche/Arrêt 0x0008
0x0006
Léger
Interrupteur marche/arrêt 0x0006
Bouton bascule
Unité enfichable Marche/Arrêt 0x0008
0x0006
Prise
Capteur de pression 0x0403
Capteur
Pompe 0x0006
0x0200
0x0402
0x0403
0x0404
Pompe à eau
Aspirateur robot 0x0054
0x0055
0x0061
Aspirateur
Climatiseur 0x0006
0x0201
0x0202
Ac
Détecteur de fumée et de monoxyde de carbone 0x005C
Fumée
Capteur de température (Temperature Sensor) 0x0402
Capteur
Thermostat 0x0201
Thermostat
Habillage de fenêtre 0x0102
Stores

Installer MVD

MVD s'exécute sur des machines équipées de processeurs x86 64 bits exécutant Debian (11 ou version ultérieure), Ubuntu (20.04 ou version ultérieure) ou macOS.

Linux

téléchargez le package Debian (.deb) MVD ;

Télécharger le fichier de signature ASCII blindée (.asc)

Exécutez ensuite dpkg pour installer le package Debian (.deb) MVD:

sudo dpkg -i mvd_1.5.0_amd64.deb

macOS

Télécharger le fichier dmg MVD (macOS x86)

Télécharger le fichier dmg MVD (ARM64 M1)

Double-cliquez ensuite sur le fichier dmg pour ouvrir la fenêtre d'installation.

Pour terminer l'installation, sélectionnez et faites glisser l'icône mvd vers le dossier Applications:

Installation macOS

Vérifier l'utilisation des ports

Le module de contrôleur de MVD utilise le port TCP 33000 pour effectuer des appels RPC à l'appareil virtuel. Par conséquent, si ce port est déjà utilisé par un autre processus sur votre ordinateur, veillez à le libérer.

Pour savoir si un processus utilise le port 33000:

Linux

sudo fuser -v 33000/tcp

macOS

lsof -i:33000

Vous pouvez arrêter n'importe quel processus utilisant le port TCP 33000 avec une seule commande:

Linux

sudo fuser -k 33000/tcp

macOS

lsof -ti:33000 | xargs kill

Exécuter MVD

Linux

Sous Linux, exécutez MVD à partir de votre dossier d'applications ou du terminal:

mvd

macOS

Sous macOS, utilisez Launchpad pour ouvrir MVD ou exécutez MVD à partir du terminal:

cd /Applications
open mvd.app

Configurer votre appareil

L'écran principal s'affiche au démarrage et vous permet de configurer un appareil virtuel:

  • Type d'appareil: sélectionnez le type d'appareil (par exemple, "Lumière", "Contacteur", "Capteur", etc.).
  • Nom de l'appareil: attribuez un nom convivial à l'appareil.
  • Discriminateur: nombre de 12 bits utilisé pour distinguer plusieurs annonces d'appareils pouvant générer des commissions. (par défaut: 3840)
  • Port Matter: port pour la mise en service et la communication Matter via des réseaux IP. Matter utilise le port TCP/UDP 5540 par défaut, mais vous pouvez configurer l'appareil virtuel pour qu'il utilise un autre port, à condition qu'aucun autre service ne l'utilise.
  • ID du fournisseur: seul l'ID de fournisseur de test 0xFFF1 est accepté.
  • ID produit: seuls les ID de produit de test 0x8000 à 0x801F sont acceptés.

Écran de configuration de l'appareil virtuel

Configurer le pare-feu

Linux

Si un pare-feu est en cours d'exécution sur votre ordinateur, arrêtez-le ou autorisez les connexions TCP/UDP entrantes sur le port Matter.

Pour afficher les règles de pare-feu netfilter actives, exécutez la commande suivante:

sudo iptables -L -n

Si vous utilisez ufw, vous pouvez le désactiver avec:

sudo ufw disable

Vous pouvez la réactiver avec:

sudo ufw enable

macOS

Pour configurer ou désactiver le pare-feu sous macOS:

  1. Accédez au menu Pomme , puis sélectionnez System Settings (Paramètres système).
  2. Cliquez sur Réseau dans la liste de la barre latérale.
  3. Cliquez sur Pare-feu.
  4. Désactivez le pare-feu.

Exécuter votre appareil

Une fois l'appareil configuré, cliquez sur Créer un appareil. Lorsque l'appareil est créé, l'écran Manette s'affiche. Selon le type d'appareil que vous avez sélectionné, une ou plusieurs des commandes suivantes peuvent s'afficher:

  • Marche/Arrêt: option commune à la plupart des appareils.
  • Niveau: par exemple, une ampoule peut être équipée d'un curseur de niveau pour régler la luminosité.
  • Couleur: par exemple, une ampoule de couleur peut disposer de cette commande.
  • Occupation: le capteur d'occupation propose cette commande pour simuler l'état occupé ou non.

Tous les appareils virtuels disposent des commandes suivantes:

  • QRCode: affiche le code QR utilisé pour la mise en service.
  • Redémarrer: redémarre l'appareil virtuel. L'appareil est brièvement déconnecté du réseau.
  • Réinitialiser: rétablit la configuration d'usine de l'appareil actuel et efface tous les états, y compris la mise en service, l'état des commandes actuelles, etc.
  • Supprimer: détruit l'appareil et revient à l'écran Créer un appareil.

Écran de contrôle de l'appareil virtuel

Mettre en service votre appareil

L'appareil peut être mis en service dès sa création.

Vous devez remplir quelques conditions préalables pour mettre en service l'appareil:

  • Vous devez disposer d'un projet dans Google Home Developer Console. Ce projet doit contenir une intégration Matter ayant la même combinaison VID/PID que celle que vous avez utilisée pour configurer votre appareil virtuel. Pour en savoir plus, consultez le guide de création de projets.

  • Vous devez disposer d'un Google Nest Hub compatible avec Matter.

  • Vous devez disposer d'un téléphone Android fonctionnant sous Android 8.1 ou version ultérieure, avec GHA installé.

  • Le téléphone Android doit être connecté au même réseau Wi-Fi que le hub.

  • La machine hôte doit être connectée au réseau Wi-Fi.

Pour mettre en service l'appareil à l'aide de GHA, cliquez sur QRCode pour afficher le code QR de l'appareil, puis suivez les instructions de la section Associer un appareil Matter, qui explique comment intégrer un appareil Matter à l'aide de GHA. Vous pouvez également mettre en service l'appareil à l'aide de Google Home Sample App for Matter.

Consultez notre Présentation de Matter pour découvrir le fonctionnement de la mise en service Matter.

Contrôler l'appareil

Une fois un appareil virtuel mis en service, vous pouvez le contrôler à l'aide de l'application Google Home ou de l'Assistant Google par commande vocale. Vous avez alors deux possibilités :

  • Contrôler l'appareil via GHA ou Assistant tout en surveillant les changements d'état sur l'appareil virtuel, ou
  • Contrôlez l'appareil à l'aide de Sample App for Matter tout en surveillant les changements d'état sur l'appareil virtuel.
  • Contrôlez l'état de l'appareil via MVD lui-même tout en surveillant les changements d'état dans GHA ou Assistant.

Tester avec l'appareil

Pour tester avec Assistant, nous vous recommandons d'utiliser un simulateur d'énoncés tel que l'extension Google Home pour VS Code ou le plug-in Google Home pour Android Studio.

Afficher les informations sur l'appareil

L'écran Détails de l'appareil affiche des informations détaillées sur l'appareil:

  • Nom:nom descriptif attribué à l'appareil.
  • Type d'appareil: type d'appareil sélectionné.
  • Discriminateur: discriminateur de l'appareil actuel.
  • Vendor ID (ID du fournisseur) : ID du fournisseur de l'appareil actuel.
  • ID produit: ID produit actuel de l'appareil.
  • Port RPC: port RPC par lequel l'appareil communique avec les contrôleurs (IUG).
  • Port Matter: port utilisé par l'appareil actuel pour communiquer via un réseau IP.
  • Code d'accès: code utilisé pour mettre en service l'appareil via le réseau.
  • Dossier de configuration: dossier dans lequel l'appareil virtuel stocke la configuration.
  • Informations de commission: affiche le ou les fabrics auxquels l'appareil a rejoint et l'ID de nœud de l'appareil dans le fabric.

Afficher les journaux de l'appareil

Si vous avez lancé MVD à partir du terminal, la sortie du journal s'affiche sur stdout. Vous pouvez également consulter les journaux de l'appareil dans l'onglet Journaux de l'appareil.

Arrêter l'appareil

Pour arrêter et détruire l'appareil, cliquez sur Supprimer.

Arrêter l'application

Fermer la fenêtre de contrôle détruit l'appareil et arrête l'application MVD. Si vous avez lancé l'application à partir du terminal, vous pouvez également l'arrêter en saisissant Ctrl-C dans le terminal.

Obtenir de l'aide

Pour obtenir de l'aide concernant MVD, signaler un bug ou demander une nouvelle fonctionnalité, contactez l'assistance Google.

Pour accéder à cette page, cliquez sur le bouton d'aide  en haut à droite de la fenêtre.

Signaler un bug

Si vous pensez avoir détecté un défaut dans la MVD, vous pouvez signaler un bug en cliquant sur le bouton "Problème" en haut à droite de la fenêtre.

Envoyer des commentaires

Pour nous faire part de ce que vous aimez dans MVD ou de ce que nous pourrions améliorer, remplissez notre formulaire de commentaires.

Vous pouvez lancer le formulaire à partir du bouton de commentaires en haut à droite de la fenêtre ou en cliquant sur le bouton ci-dessous.

Envoyer vos commentaires