Premiers pas avec Matter

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Version bêta de l'aperçu pour les développeurs

Le programme pour les développeurs de Google Home permet aux fabricants d'appareils de connecter leurs appareils connectés à l'écosystème Google Home. Nous étendons le parcours de traitement en local des actions de maison connectée avec la possibilité d'ajouter des appareils compatibles avec Matter pour les configurer à l'aide de Google Home app (GHA) sur Android, et de les contrôler avec Google Assistant, GHA ou des écrans connectés comme Google Nest Hub (2nd gen).

Cette documentation explique comment créer et intégrer une plate-forme compatible avec Matter dans l'écosystème Google Home.

Clauses de non-responsabilité

Concernant les procédures décrites dans cet aperçu pour les développeurs de Matter, tenez compte des points suivants:

  • Le compte utilisé pour le développement ne doit être associé qu'à un seul hub compatible Matter pour les tests. Plusieurs hubs compatibles Matter connectés en même temps ou connectés à la même structure lors des tests peuvent entraîner un comportement imprévisible.
  • Toutes les procédures supposent l'utilisation d'une machine Linux exécutant Ubuntu 20.04 pour créer et flasher des exemples Matter, qui ont été testés par Google. Bien que les machines MacOS soient compatibles, Linux est recommandé. Les instructions spécifiques à Mac sont décrites dans les procédures si nécessaire.
  • Seule la version Android de GHA est compatible.

Définitions

Les termes suivants sont utilisés dans cette documentation:

  • hub : un appareil Google Nest compatible, tel que Google Nest Hub (2nd gen). Un hub est nécessaire pour contrôler les appareils compatibles Matter via GHA.

  • Routeur de bordure : hub Google qui met en œuvre un routeur de bordure Thread à usage général pour les appareils compatibles avec Thread.

  • Appareil compatible Matter : appareil ou carte de développement sur lequel un build ou un exemple d'application Matter a été activé.

  • Appareil mobile : téléphone de test utilisé pour effectuer l'association. Il s'agit actuellement d'un téléphone Android.

Prérequis

Pour intégrer complètement un appareil compatible Matter avec l'écosystème Google Home, un développeur doit disposer des éléments suivants:

  1. Nest Hub (2nd gen) servant de routeur de bordure pour les appareils compatibles avec Thread et de chemin de traitement local pour acheminer les intents de la maison connectée.
  2. Un appareil mobile (téléphone test) qui répond à la configuration minimale requise :
    • Android O (8.1, niveau d'API 27) ou version ultérieure (la compatibilité avec iOS sera ajoutée ultérieurement)
    • Fonctionnalité BLE
  3. Un ID de fournisseur (VID) et un ID de produit (PID) pour l'appareil compatible avec Matter.
  4. Un appareil sur lequel Matter est activé. Il doit s'agir de l'un des types d'appareils Matter actuellement compatibles avec l'écosystème Google Home, et peut être :
    • Votre propre produit avec un micrologiciel compatible Matter.
    • Carte de développement d'une plate-forme fournisseur compatible pouvant servir d'appareil compatible avec Matter pour la validation de bout en bout. Plates-formes compatibles :
Tableau: Matter exemples de fournisseurs de silicium
Sous-revendeur Plate-forme Guides Assistance Thread
Bouffalo Lab BL602 Démarrage rapide
Espressif ESP32 Démarrage rapide
Semiconducteur nordique nRF52840 DK Démarrage rapide
Nouvelle expérience utilisateur Kit de développement IOTZTB-DK006 Démarrage rapide
Realtek Ameba série D Démarrage rapide
Silicon Labs Kit de démarrage EFR32MG Zigbee et Thread Démarrage rapide

ID fournisseur

Utilisez votre ID de fournisseur (VID) conformément à la spécification CSA Matter. Si aucun VID ne vous a été attribué, utilisez l'un des VID attribués par la CSA à des fins de test : 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

Ce VID doit être implémenté dans le micrologiciel de votre appareil.

ID produit

Les informations sur l'appareil sont lues à l'aide des clusters Matter Descriptor, plutôt que de l'ID produit. Vous pouvez attribuer n'importe quel ID produit lors du développement, conformément au schéma de numérotation de votre entreprise, à condition qu'il corresponde à l'ID produit de votre intégration Matter, si celui-ci est spécifié.

Fonctionnalités non compatibles

Certaines fonctionnalités de la spécification Matter ne sont pas entièrement compatibles avec l'écosystème Google Home:

  • La mise à jour OTA du micrologiciel n'est pas compatible.

En outre, un certain nombre d'autres clusters Matter ne sont pas encore exposés aux utilisateurs, bien qu'ils puissent être utilisés par le système. Dans la plupart des cas, cela signifie que les attributs exposés via ces clusters ne sont pas visibles par les utilisateurs finaux:

Tableau: Matter clusters non exposés aux utilisateurs de l'écosystème Google Home
Type de cluster Clusters
Éléments de base
  • Liaison
  • Libellé
  • Libellé fixe
  • Libellé d'utilisateur
  • Actions
  • Clé de groupe
  • Configuration de la localisation
  • Localisation au format horaire
  • Localisation d'unités
  • Configuration de la source d'alimentation
  • Source d'alimentation
  • Clusters de diagnostics (journaux de diagnostic, diagnostics généraux, diagnostics logiciels, diagnostics de réseau Thread, diagnostics de réseau Wi-Fi, diagnostics de réseau Ethernet)
  • Synchronisation temporelle
  • Mode sélectionné
Application
  • Les groupes et les scènes ne sont pas directement compatibles. Des fonctionnalités équivalentes sont disponibles via les routines.
  • Tous les clusters multimédias. Des fonctionnalités équivalentes sont disponibles via Google Cast.