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 élargissons le chemin d'exécution local des actions pour la maison connectée en permettant d'ajouter des appareils compatibles avec Matter à configurer à l'aide de Google Home app (GHA) et de les contrôler à l'aide de Google Assistant, GHA ou d'écrans connectés tels que 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 documentation Matter, tenez compte des points suivants:
- Nous vous recommandons de ne connecter qu'un seul hub compatible avec Matter au compte utilisé pour le développement à des fins de test. Le fait de connecter plusieurs hubs compatibles avec Matter en même temps ou à la même structure lors des tests peut 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. Les machines macOS sont compatibles, mais nous vous recommandons d'utiliser Linux. Des instructions spécifiques à Mac sont indiquées dans les procédures, le cas échéant.
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 d'effectuer au moins l'un des ateliers de programmation suivants:
Consultez ensuite notre liste des appareils compatibles pour vous assurer que ce que vous prévoyez d'intégrer est compatible avec l'écosystème Google Home. Consultez 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 dans cette documentation:
- Routeur de bordure
- Hub implémentant un routeur de bordure Thread à usage général pour les appareils compatibles avec Thread.
- Hub
- Un appareil Google Nest compatible, tel que l'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 les é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. Il s'agit actuellement d'un téléphone Android.
Prérequis
Pour intégrer complètement 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 routeur de bordure pour les appareils compatibles avec Thread et de chemin d'accès local pour router les intents de maison connectée.
- Un appareil mobile (téléphone de test) répondant aux conditions minimales requises :
- 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 être l'un des types d'appareils Matter compatibles avec l'écosystème Google Home. Il peut s'agir des appareils 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 | Ameba D Series | ||
Silicon Labs | Kit de développement EFR32MG24 | ||
Kit de démarrage Zigbee et Thread EFR32MG | |||
Telink | TLSR9518 | ||
Texas Instruments | Kit de développement LaunchPad CC2652R7 |
ID fournisseur
Par défaut, vous pouvez utiliser l'un des VID attribué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 pour vous assurer qu'il vous a été attribué par la CSA.
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 VID de 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 bien le propriétaire de ce VID avant que vous 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 d'essais 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 en service l'appareil doit être membre du projet ou figurer sur la liste des utilisateurs des essais sur le terrain.
- Les utilisateurs consommateurs ne peuvent utiliser votre produit qu'une fois qu'il a été certifié par la Alliance.
Le VID et le PID ne peuvent être utilisés qu'une seule fois pour une seule 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.
- 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 du VID et état de l'intégration à la console | Production
(Utilisateurs grand public) |
Développement
(développeurs, utilisateurs du programme pilote) |
Test | Aucune intégration dans le 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ée, l'intégration existe dans Developer Console | ||
Production | Certifié dans le fichier de contrôle de licence Alliance, l'intégration n'existe pas dans le fichier Developer Console | ||
Production | Certifié dans la DCL Alliance et l'intégration existe dans le 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 console de développement.
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 |
|
¹ Pour en savoir plus sur l'impact de cette modification sur les boutons marche/arrêt, consultez la section Boutons marche/arrêt.