Version preview pour les développeurs
Le programme Google Developers permet aux fabricants de connecter leurs appareils connectés à l'écosystème Google Home. Nous étendons le processus de traitement local des actions pour la maison connectée avec la possibilité d'ajouter Matter -enabled devices for setup using the Google Home app (GHA) on Android and control them using Google Assistant , GHA, or smart displays like the 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 : Matter, veuillez tenir compte des points suivants :
- Le compte utilisé pour le développement ne doit comporter qu'un seul hub compatible avec Matter connecté à des tests. Plusieurs hubs compatibles avec 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 faire clignoter 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 énoncées 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:
- Routeur de bordure
- Un hub qui implémente un usage général Thread Border Router for Thread-enabled devices.
- Hub
- Un appareil compatible Google Nest device, such as the Google Nest Hub (2nd gen). A hub is required to control Matter-enabled devices through other surfaces such as Assistant, the GHA, and smart displays.
- Appareil compatible avec Matter
- Appareil ou carte de développement sur lesquels une version compatible avec Matter ou une application exemple a été activée
- Sur un appareil mobile
- Téléphone test utilisé pour l'association. Il s'agit actuellement d'un Android phone.
Prérequis
Pour intégrer complètement un appareil compatible Matter à l'écosystème Google Home, un développeur doit:
- Un hub Google compatible avec Thread, qui sert à la fois de routeur de bordure pour les appareils compatibles avec Thread et de chemin d'accès local pour acheminer les intents de la maison connectée.
- Un appareil mobile (téléphone de test) répondant à 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
- Un ID de fournisseur (VID) et un ID de produit (PID) pour l'appareil compatible avec Matter.
- Un appareil sur lequel Matter est activé. Il doit s'agir de l'un des
Matter types d'appareils actuellement compatibles avec l'écosystème Google Home, qui peut être :
- Votre propre produit avec un micrologiciel compatible avec Matter.
- Tableau de développement d'une plate-forme de fournisseur compatible pouvant servir d'appareil compatible Matter pour la validation de bout en bout. Les plates-formes suivantes sont compatibles :
| Fournisseur | Plate-forme | Guides | Assistance Thread |
|---|---|---|---|
| Bouffalo Lab | BL602 | Démarrage rapide | |
| BL702 | Démarrage rapide | ||
| Espressif | ESP32 | Démarrage rapide
Tests OTA |
|
| Semiconducteur nordique | nRF52840 DK | Démarrage rapide
Tests OTA |
|
| NXP | IOTZTB-DK006 Kit de développement | Démarrage rapide | |
| Realtek | Ameba série D | Démarrage rapide | |
| Silicon Labs | Kit de démarrage EFR32MG Zigbee et Thread | Démarrage rapide | |
| Kit de développement EFR32MG24 | Démarrage rapide | ||
| Telink | TLSR9518 | Démarrage rapide |
ID fournisseur
Par défaut, vous pouvez utiliser l'un des ID vidéo alloués par la CSA à des fins de test. Sélectionnez l'une des options suivantes : 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Pour utiliser un VID de production afin que votre intégration puisse être certifiée et lancée, vous devez d'abord la faire valider par Google afin de vous assurer qu'elle vous a été délivrée par la CSA.
Ce VID doit être mis en œuvre dans le micrologiciel de votre appareil.
Un appareil Matter ne peut être associé à l'écosystème Google Home que dans certains cas d'identifiant de fournisseur et de type d'appareil.
- Un VID test ne peut pas être utilisé sur un appareil grand public.
- Pour qu'un appareil de production (consommateur) soit associé, il doit être certifié dans la CSL CSA.
- À des fins de développement et d'essai sur le terrain, un appareil doit être enregistré dans Google Home Developer Console .
| Quels types d'utilisateurs peuvent mettre l'appareil en service dans l'écosystème Google Home ? | |||
|---|---|---|---|
| Type d'ID vidéo | Certification VID et statut d'enregistrement | Production
(utilisateurs grand public) |
Développement
(développeurs, utilisateurs sur l'essai) |
| Test | Non enregistré (non certifié) | N/A | N/A |
| Test | Enregistré dans le Developer Console (non certifié) | N/A | |
| Production | Non certifié, non enregistré | N/A | |
| Production | Non certifié, enregistré dans Developer Console | ||
| Production | Certifié dans la CSA DCL, non enregistré | N/A | |
| Production | Certifié dans la DCL CSA et enregistré dans Developer Console | ||
ID produit
Les informations sur l'appareil sont lues à l'aide de clusters Matter Descriptor, et non 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, le cas échéant.
Fonctionnalités non compatibles
Certains 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 seront pas visibles par les utilisateurs finaux:
| Type de cluster | Clusters |
|---|---|
| Core |
|
| Application |
|