Le programme Home Developer de Google 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 local des actions pour la maison connectée en ajoutant la possibilité de configurer des appareils compatibles avec Matter-enabled devices à l'aide de la Google Home app (GHA) et de les contrôler à l'aide de l' Google Assistant, GHA, ou d'écrans connectés comme le Google Nest Hub (2nd gen).
Cette documentation explique comment commencer à 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 la Matter documentation, tenez compte des points suivants :
- Nous vous recommandons de ne connecter qu'un seul Matter-enabled hub compatible au compte utilisé pour le développement à des fins de test. Si plusieurs hubs compatibles avec Matter sont connectés en même temps ou à la même structure pendant les tests, le comportement peut être 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.
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 Matter SDK.
Le moyen le plus simple de commencer est de suivre nos ateliers de programmation. Nous vous recommandons d'effectuer 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 liste de contrôle du développeur pour comprendre l'ensemble du flux de développement, de la création du projet au lancement.
Appareils compatibles Liste de contrôle du développeur
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 nécessaire 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 qui a été flashé avec une version ou une application exemple compatible avec Matter .
- Sur un appareil mobile
- Le téléphone de test utilisé pour faciliter l'association. Il s'agit actuellement d'un Android téléphone.
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 qui sert à la fois de routeur de bordure pour les appareils compatibles avec Thread et de chemin d'exécution local pour le routage des intents pour 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 (version 16.5 ou ultérieure)
- Fonctionnalité 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 Mattercompatibles avec l'
écosystème Google Home et peut être :
- 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 | Thread Compatibilité | Guide |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | Tests OTA | |
| Nordic Semiconductor | nRF52840 DK | Tests OTA | |
| NXP | Kit de développement IOTZTB-DK006 kit | ||
| 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 CC2652R7 LaunchPad |
ID fournisseur
Par défaut, vous pouvez utiliser l'un des VID attribués par l'Alliance à des fins de
test. Sélectionnez l'un des éléments suivants :
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é émis 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 fournisseur et de type d'appareil.
- Un VID de test ne peut pas être utilisé dans un appareil grand public.
- Votre VID de production doit être émis par la Connectivity Standards Alliance (Alliance). Google validera que vous êtes le propriétaire de ce VID avant que vous puissiez l'utiliser dans la Google Home Developer Console. Une fois cette étape effectuée, vous pourrez créer des intégrations pour ce VID.
- À des fins de développement et 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 être inclus dans la liste des Field Trial utilisateurs.
- Les utilisateurs grand public ne peuvent utiliser votre produit qu'une fois qu'il a été certifié par le 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 effectuer l'une des opérations suivantes :
- Modifiez l'intégration à l'aide du VID ou du PID en 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 | Certification VID et état d'intégration de la console | Production
(Utilisateurs grand public) |
Développement
(Développeurs, Field Trial utilisateurs) |
| Test | Aucune intégration dans la Developer Console (ne peut pas être certifiée) | ||
| Test | L'intégration existe dans la Developer Console (ne peut pas être certifiée) | ||
| Production | Non certifiée, l'intégration n'existe pas dans la Developer Console | ||
| Production | Non certifiée, l'intégration existe dans la Developer Console | ||
| Production | Certifiée dans la DCL Alliance, l'intégration n'existe pas dans la Developer Console | ||
| Production | Certifiée dans la Alliance DCL et l'intégration existe dans la Developer Console | ||
ID produit
Les informations sur l'appareil sont lues à partir du Matter cluster d'informations de base. L'ID produit encodé dans le micrologiciel de votre appareil doit correspondre à l'ID produit de l'Matter intégration dans la Developer Console.
Fonctionnalités non compatibles
Certains Matter clusters 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 |
|
¹ Consultez Interrupteurs pour savoir comment cela affecte les interrupteurs.