Le programme Google Home Developer permet aux fabricants d'appareils d'associer leurs appareils connectés à l'écosystème Google Home. Nous étendons le processus de traitement local des actions pour la maison connectée. Il permet d'ajouter des appareils compatibles avec Matter pour la configuration à l'aide de Google Home app (GHA) et de les contrôler à l'aide de Google Assistant, de GHA ou d'é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é
En ce qui concerne les procédures décrites dans la documentation Matter, tenez compte des points suivants:
- Nous vous recommandons de n'associer qu'un seul hub compatible Matter au compte utilisé pour le développement à des fins de test. 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 compiler 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 appelées dans les procédures si nécessaire.
Créer une application
Pour créer un appareil compatible avec Matter qui s'intègre à l'écosystème Google Home, vous devez utiliser une carte de développement compatible avec Matter et le SDK Matter.
Le moyen le plus simple de vous lancer est de suivre nos ateliers de programmation. Nous vous recommandons de suivre au moins l'un des ateliers de programmation suivants:
Consultez ensuite notre liste d'appareils compatibles pour vous assurer que ceux que vous prévoyez d'intégrer sont compatibles avec l'écosystème Google Home. Lisez ensuite la checklist pour les développeurs afin de comprendre l'intégralité du flux de développement, de la création du projet à son lancement.
Appareils compatibles Checklist pour les développeurs
Définitions
Les termes suivants sont utilisés dans cette documentation:
- Routeur de bordure
- Un hub qui implémente un routeur de bordure Thread à usage général pour les appareils compatibles Thread.
- Hub
- Un appareil Google Nest compatible, tel que Google Nest Hub (2nd gen). Un hub est nécessaire pour contrôler les appareils compatibles avec Matter via d'autres surfaces telles que Assistant, GHA et des écrans connectés.
- Appareil compatible avec Matter
- Un appareil ou une carte de développement qui a été flashé avec un build ou une application exemple compatible avec Matter.
- Sur un appareil mobile
- Téléphone de test utilisé pour l'association. Il s'agit actuellement d'un téléphone Android.
Conditions préalables
Pour intégrer complètement un appareil compatible avec Matter dans l'écosystème Google Home, le développeur doit avoir:
- Un hub Google compatible avec Thread servant à la fois 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.
- 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)
- iOS (version 16.5 ou ultérieure)
- Technologie BLE
- Un ID fournisseur (VID) et un ID produit (PID) pour l'appareil compatible avec Matter.
- Un appareil compatible avec Matter Cet appareil doit correspondre à l'un des types d'appareils Matter compatibles avec l'écosystème Google Home et peut être :
- Votre propre produit avec un micrologiciel compatible avec Matter.
- Carte de développement d'une plate-forme de fournisseur compatible pouvant servir d'appareil compatible avec 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 |
|
Semiconducteurs nordiques | nRF52840 DK | Démarrage rapide
Tests OTA |
|
NXP | Kit de développement IOTZTB-DK006 | Démarrage rapide | |
Realtek | Ameba série D | Démarrage rapide | |
Silicon Labs | Kit de développement EFR32MG24 | Démarrage rapide | |
Kit de démarrage Zigbee et Thread EFR32MG | Démarrage rapide | ||
Telink | TLSR9518 | Démarrage rapide | |
Texas Instruments | Kit de développement LaunchPad CC2652R7 | Démarrage rapide |
ID fournisseur
Par défaut, vous pouvez utiliser l'un des VID 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 le faire valider par Google afin de vous assurer qu'il vous a été délivré par la CSA.
Ce VID doit être implémenté dans le micrologiciel de votre appareil.
Un appareil Matter ne peut être associé dans l'écosystème Google Home que dans certains cas d'ID de fournisseur et de type d'appareil.
- Un VID test ne peut pas être utilisé sur un appareil grand public.
- Votre VID de production doit être émis par le Connectivity Standards Alliance (Alliance). Google vérifiera que vous êtes le propriétaire de ce VID avant que vous puissiez l'utiliser dans Google Home Developer Console. Vous pourrez alors créer des intégrations pour ce VID.
- À des fins de développement et de tests sur le terrain, un projet et une intégration avec la combinaison VID et PID correspondante doivent être créés dans Developer Console. L'utilisateur qui met l'appareil en service doit être membre du projet ou figurer dans la liste des utilisateurs du test.
- Les consommateurs ne peuvent utiliser votre produit qu'une fois qu'il a été certifié par l'Alliance.
Quels types d'utilisateurs peuvent mettre l'appareil en service dans l'écosystème Google Home ? | |||
---|---|---|---|
Type de VID | Certification VID et état d'intégration de la console | Production
(utilisateurs grand public) |
Développement
(développeurs, utilisateurs de tests en conditions réelles) |
Test | Aucune intégration dans Developer Console (certification impossible) | ||
Test | L'intégration existe dans la Developer Console (non certifiée) | ||
Production | Non certifiée, l'intégration n'existe pas dans le Developer Console | ||
Production | Non certifié, l'intégration existe dans Developer Console | ||
Production | Certifiée dans le DCL Alliance, l'intégration n'existe pas dans le Developer Console | ||
Production | Certifiée dans le DCL Alliance, et l'intégration existe dans la Developer Console |
ID produit
Les informations sur l'appareil sont lues à partir du cluster d'informations de base Matter. L'identifiant produit encodé dans le micrologiciel de votre appareil doit correspondre à l'identifiant produit de l'intégration Matter dans la Play Console.
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 sont pas visibles par les utilisateurs finaux:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
1 Consultez Interrupteurs Marche/Arrêt pour connaître l'impact de ce changement sur les interrupteurs.