Le programme Google Home Developer permet aux fabricants d'appareils leurs appareils connectés avec l'écosystème Google Home. Nous étendons Chemin de traitement local des actions pour maison connectée avec possibilité d'ajouter Appareils compatibles Matter pouvant être configurés à l'aide du Google Home app (GHA) et les contrôler à l'aide de Google Assistant, GHA, ou des écrans connectés comme Google Nest Hub (2nd gen)
Ce document explique comment créer et intégrer un compatible avec Matter de l'écosystème Google Home.
Avis de non-responsabilité
Concernant les procédures décrites dans les Matter de la documentation, gardez à l'esprit les points suivants:
- Le compte utilisé pour le développement ne doit comporter qu'un seul compte Hub compatible avec Matter connecté à des fins de test. Multiples Hubs compatibles avec Matter connectés au en même temps ou connectés à la même structure pendant les 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 de compiler et de flasher des exemples Matter, qui ont été testés par Google. Bien que les machines macOS soient compatibles, Linux est recommandé. Sur Mac des instructions sont indiquées dans les procédures si nécessaire.
Comment créer
Pour créer un appareil compatible Matter qui s'intègre à écosystème Google Home, vous travaillerez avec une carte de développement compatible Matter et le Matter SDK.
Le moyen le plus simple de commencer est de suivre nos ateliers de programmation. Mer 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 les fonctionnalités que vous prévoyez d'intégrer est pris en charge dans l'écosystème Google Home. Consultez ensuite la checklist pour les développeurs afin de comprendre de développement, de la création 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
- Un hub qui implémente une bordure Thread à usage général Routeur pour les appareils compatibles Thread.
- Hub
- Un appareil Google Nest compatible, comme le Google Nest Hub (2nd gen) Un hub est nécessaire pour contrôler les appareils compatibles avec Matter via d'autres surfaces comme Assistant, GHA et les écrans connectés.
- Appareil compatible avec Matter
- Un appareil ou une carte de développement qui a été flashé avec une Build ou exemple d'application 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.
Prérequis
Pour intégrer complètement un appareil compatible Matter avec 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 Thread et de routeur chemin de traitement pour router les intents de la maison connectée.
- Un appareil mobile (téléphone de test) répondant à la configuration minimale requise:
<ph type="x-smartling-placeholder">
- </ph>
- 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 le appareil compatible avec Matter.
- Un appareil compatible avec Matter. Cet appareil doit être l'un des
Matter types d'appareils compatibles avec les
de l'écosystème Google Home, et pourrait être:
<ph type="x-smartling-placeholder">
- </ph>
- Votre propre produit avec un micrologiciel compatible Matter
- L'un des Matter appareils 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 Danemark | Tests OTA | |
NXP | Développement IOTZTB-DK006 le kit | ||
Realtek | Ameba série D | ||
Silicon Labs | Kit de développement EFR32MG24 | ||
EFR32MG Zigbee et Thread Kit de démarrage | |||
Telink | TLSR9518 | ||
Texas Instruments | Développement LaunchPad de CC2652R7 le kit |
ID fournisseur
Par défaut, vous pouvez utiliser l'un des VID alloués par la CSA à des fins de test
objectifs. Sélectionnez l'une des options suivantes:
0xFFF1
, 0xFFF2
, 0xFFF3
et 0xFFF4
.
Pour utiliser un VID de production afin que votre intégration puisse être certifiée et lancée, vous devez d'abord Faites-le valider par Google afin de vérifier qu'il vous a bien é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é que dans l'appareil Google Home dans certains scénarios liés à l'ID 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 va confirmer que vous êtes le propriétaire de ce VID avant de pouvoir l'utiliser dans Google Home Developer Console. Une fois que cela se produit, vous pourrez créer pour ce VID.
- À des fins de développement et d'essais sur le terrain, un projet et son intégration avec la combinaison du VID et du PID correspondante doit être créée dans le Developer Console. La mise en service par l'utilisateur l'appareil doit être membre du projet ou figurer dans la liste d'utilisateurs de tests en conditions réelles.
- Les consommateurs ne peuvent utiliser votre produit qu'une fois qu'il a été certifié par le Alliance
Quels types d'utilisateurs peuvent mettre en service 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 et utilisateurs Field Trial) |
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ée dans le DCL Alliance, l'intégration n'est pas existent dans Developer Console | ||
Production | Certifié dans le DCL Alliance et une intégration existe dans le Developer Console |
ID produit
Les informations concernant l'appareil sont lues à partir du Matter Cluster "Informations générales". L'identifiant produit codé dans votre le micrologiciel de l'appareil doit correspondre à l'identifiant produit de l'intégration Matter dans la console développeur.
Fonctionnalités non compatibles
Certains clusters Matter ne sont pas encore exposés aux utilisateurs 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 |
|
1 Voir Interrupteurs Marche/Arrêt pour connaître son impact sur les interrupteurs.