Le programme Google Home Developer permet aux fabricants d'appareils de connecter leurs appareils pour la maison connectée à l'écosystème Google Home. Nous étendons le chemin d'exécution locale des actions de maison connectée en permettant d'ajouter des appareils compatibles Matter pour les configurer à l'aide de l'Google Home app (GHA) et les contrôler à l'aide de Google Assistant, de GHA ou d'écrans connectés comme le 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.
Avis de non-responsabilité
Concernant les procédures décrites dans la documentation Matter, tenez compte des points suivants :
- Nous recommandons que le compte utilisé pour le développement ne dispose que d'un seul hub compatible avec Matter connecté pour les tests. Si plusieurs hubs compatibles avec Matter sont connectés en même temps ou connectés à la même structure pendant les tests, cela peut 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 indiquées dans les procédures, le cas échéant.
Mode d'emploi
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 :
Ensuite, consultez notre liste d'appareils compatibles pour vous assurer que ce que vous prévoyez d'intégrer est compatible avec l'écosystème Google Home. Ensuite, lisez la checklist du développeur pour comprendre l'ensemble du processus de développement, de la création du projet au 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 avec Thread.
- Hub
- Un appareil Google Nest compatible, tel que le Google Nest Hub (2nd gen). Un hub est requis pour contrôler les appareils compatibles avec Matter via d'autres surfaces telles que Assistant, l'GHA et les écrans connectés.
- Appareil compatible avec Matter
- Un appareil ou une carte de développement sur lesquels une version ou une application exemple compatible avec Matter ont été flashées.
- Sur un appareil mobile
- Le téléphone de test utilisé pour faciliter l'association. Il s'agit actuellement d'un téléphone Android.
Prérequis
Pour intégrer pleinement un appareil compatible avec Matter à l'écosystème Google Home, un développeur doit disposer des éléments suivants :
- Un hub Google compatible avec Thread pour servir à la fois de border router pour les appareils compatibles avec Thread et de chemin d'accès local pour router les intents de la maison connectée.
- Un appareil mobile (téléphone de test) qui répond à la configuration minimale requise :
- Android O (8.1, niveau d'API 27 ou version ultérieure)
- iOS (v16.5 ou version ultérieure)
- Capacité BLE
- Un ID fournisseur (VID) et un ID produit (PID) pour l'appareil compatible avec Matter.
- Un appareil compatible avec Matter. Cet appareil doit être l'un des types d'appareils Matter compatibles avec l'écosystème Google Home. Il peut s'agir des types suivants :
- Votre propre produit avec un micrologiciel compatible avec Matter.
- L'un des appareils Matter suivants à utiliser pour la validation de bout en bout :
| Fournisseur | Plate-forme | Assistance Thread | Guide |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | Tests OTA | |
| Nordic Semiconductor | nRF52840 DK | Tests OTA | |
| NXP | Kit de développement IOTZTB-DK006 | ||
| Realtek | Série Ameba D | ||
| Silicon Labs | Kit de développement EFR32MG24 | ||
| Kit de démarrage EFR32MG Zigbee et Thread | |||
| Telink | TLSR9528 | Guide du développeur Telink Matter | |
| Texas Instruments | Kit de développement LaunchPad CC2652R7 |
ID fournisseur
Par défaut, vous pouvez utiliser l'un des VID alloués par l'Alliance à 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 pour vous assurer qu'il vous a été délivré par l'Alliance.
Ce VID doit être implémenté dans le micrologiciel de votre appareil.
Un appareil Matter ne peut être associé à l'écosystème Google Home que dans certains scénarios d'ID de fournisseur et de type d'appareil.
- Un ID de fournisseur de test ne peut pas être utilisé sur un appareil grand public.
- Votre VID de production doit être émis par l'autorité suivante : Connectivity Standards Alliance (Alliance). Google vérifiera que vous êtes bien le propriétaire de ce VID avant que vous ne puissiez l'utiliser dans le Google Home Developer Console. Une fois cette opération effectuée, vous pourrez créer des intégrations pour ce VID.
- À des fins de développement et de Field Trial, un projet et une intégration avec la combinaison VID et PID correspondante doivent être créés dans la Developer Console. L'utilisateur qui met en service l'appareil doit être membre du projet ou figurer dans la liste des utilisateurs Field Trial.
- Les utilisateurs finaux ne peuvent utiliser votre produit qu'une fois qu'il a été certifié par l'Alliance.
Le VID et le PID ne peuvent être utilisés qu'une seule fois pour une intégration. Si vous souhaitez utiliser le même VID ou PID dans votre intégration, vous devez :
- Modifiez l'intégration en remplaçant le VID ou le PID par un autre VID ou PID.
- Supprimez l'intégration à l'aide du VID ou du PID.
| Quels types d'utilisateurs peuvent mettre en service l'appareil dans l'écosystème Google Home ? | |||
|---|---|---|---|
| Type de VID | État de la certification VID et de l'intégration de la console | Production
(Utilisateurs grand public) |
Développement
(développeurs, Field Trial utilisateurs) |
| Test | Aucune intégration dans Developer Console (ne peut pas être certifié) | ||
| Test | L'intégration existe dans Developer Console (ne peut pas être certifiée) | ||
| Production | Non certifié, l'intégration n'existe pas dans Developer Console | ||
| Production | Non certifié, l'intégration existe dans le Developer Console | ||
| Production | Certifié dans la DCL Alliance, l'intégration n'existe pas dans Developer Console | ||
| Production | Certifié dans la LDC 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'ID produit encodé dans le micrologiciel de votre appareil doit correspondre à l'ID produit de l'intégration Matter dans la Developer Console.
Fonctionnalités non compatibles
Certains clusters Matter ne sont pas encore exposés aux utilisateurs, mais ils peuvent ê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 |
|
¹ Consultez Interrupteurs marche/arrêt pour savoir comment cela affecte les interrupteurs marche/arrêt.