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 de traitement en local des actions pour la maison connectée avec la possibilité 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 de Matter, gardez à l'esprit les points suivants:
- Nous vous recommandons de faire en sorte que le compte utilisé pour le développement ne dispose que d'un seul hub compatible avec Matter connecté à 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 créer et flasher des exemples Matter, qui ont été testés par Google. Bien que les machines macOS soient compatibles, Linux est recommandé. Des instructions spécifiques à Mac sont indiquées dans les procédures si nécessaire.
Comment créer
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 commencer 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 ce que vous prévoyez d'intégrer est compatible avec l'écosystème Google Home. Lisez ensuite la checklist pour les développeurs pour comprendre l'ensemble du flux 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 tout au long de cette documentation:
- Routeur de bordure
- 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 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 faciliter l'association. Actuellement, il s'agit d'un téléphone Android.
Conditions préalables
Pour intégrer complètement un appareil compatible Matter à l'écosystème Google Home, un développeur doit:
- 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 le routage des intents de la maison connectée.
- Un appareil mobile (téléphone de test) disposant de la configuration minimale requise :
- Android O (8.1, niveau d'API 27 ou version ultérieure)
- iOS (version 16.5 ou 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 correspondre à l'un des types d'appareils Matter compatibles avec l'écosystème Google Home et pourrait être :
- Votre propre produit avec un micrologiciel compatible Matter
- L'un des appareils Matter suivants à utiliser pour la validation de bout en bout:
| Vendor | Plate-forme | Assistance Thread | Guide |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | Tests OTA | |
| Nordic Semiconductor | nRF52840 Danemark | Tests OTA | |
| NXP | Kit de développement IOTZTB-DK006 | ||
| Realtek | Ameba série D | ||
| Silicon Labs | Kit de développement EFR32MG24 | ||
| Kit de démarrage Zigbee EFR32MG et Thread | |||
| Telink | TLSR9518 | ||
| Texas Instruments | Kit de développement LaunchPad CC2652R7 |
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 ou 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 vérifier 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 scénarios liés à l'ID de fournisseur et au type d'appareil.
- Vous ne pouvez pas utiliser un VID de test sur un appareil grand public.
- Le VID de votre 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 ne puissiez l'utiliser dans Google Home Developer Console. Vous pourrez ensuite 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 le Developer Console. L'utilisateur qui met en service l'appareil doit être membre du projet ou être inclus dans la liste des utilisateurs des tests.
- Les utilisateurs grand public ne peuvent utiliser votre produit qu'une fois qu'il a été certifié par Alliance.
| 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, utilisateurs de la phase de tests) |
| Test | Aucune intégration dans Developer Console (certification impossible) | ||
| Test | L'intégration existe dans Developer Console (ne peut pas être certifiée) | ||
| Production | Non certifié, l'intégration n'existe pas dans le Developer Console | ||
| Production | Non certifié, une intégration existe dans le Developer Console | ||
| Production | Certifié dans le DCL Alliance, l'intégration n'existe pas dans Developer Console | ||
| Production | Certifié dans la 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 générales Matter. L'identifiant produit encodé dans le micrologiciel de votre appareil doit correspondre à l'identifiant 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, 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 Pour connaître l'impact de ce changement sur les interrupteurs Marche/Arrêt, consultez la page Interrupteurs Marche/Arrêt.