Cette page a été traduite par l'API Cloud Translation.

Premiers pas avec Matter

Version Preview développeur

Le programme Google Home pour les développeurs permet aux fabricants d'appareils de connecter leurs appareils connectés à l'écosystème Google Home. Nous étendons le chemin d'accès local du traitement des actions de 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 ou 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é

Concernant les procédures décrites dans cette Preview développeur de Matter, tenez compte des points suivants:

Le compte utilisé pour le développement ne doit être associé qu'à un seul hub compatible avec Matter pour les tests. Plusieurs hubs compatibles avec Matter connectés 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 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 décrites dans les procédures si nécessaire.

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 Google Nest Hub (2nd gen). Un hub est nécessaire pour contrôler les appareils compatibles Matter via d'autres surfaces telles que Assistant, GHA et les écrans connectés.
Appareil compatible avec Matter: Appareil ou carte de développement flashé avec une application ou un exemple d'application compatible avec Matter.
Sur un appareil mobile: Téléphone de test utilisé pour l'association. Il s'agit actuellement d'un téléphone Android.

Prérequis

Extensions IDE recommandées pour le développement Matter

Pour intégrer complètement un appareil compatible Matter à l'écosystème Google Home, un développeur doit:

Un hub Google compatible avec Thread en tant que routeur de bordure pour les appareils compatibles avec Thread et en tant que chemin de traitement local pour acheminer les intents de la maison connectée.
Un appareil mobile (téléphone de test) répondant à 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 Matter.
Un appareil sur lequel Matter est activé. Il doit s'agir de l'un des types d'appareils Matter actuellement compatibles avec l'écosystème Google Home et peut être :
- Votre produit avec un micrologiciel compatible Matter.
- Carte de développement d'une plate-forme de fournisseur compatible pouvant servir d'appareil compatible avec Matter pour la validation de bout en bout. Les plates-formes suivantes sont compatibles :

*Tableau: Matter exemples de fournisseurs de silicium*
Fournisseur	Plate-forme	Guides
Bouffalo Lab	BL602	Démarrage rapide
Bouffalo Lab	BL702	Démarrage rapide
Espressif	ESP32	Démarrage rapide Tests OTA
Semiconducteur nordique	nRF52840 DK	Démarrage rapide Tests OTA
NXP	Kit de développement IOTZTB-DK006	Démarrage rapide
Realtek	Ameba série D	Démarrage rapide
Silicon Labs	Kit de développement EFR32MG24	Démarrage rapide
Silicon Labs	Kit de démarrage EFR32MG Zigbee et Thread	Démarrage rapide
Télink	TLSR9518	Démarrage rapide
Instruments du Texas	Kit de développement CC2652R7 LaunchPad	Démarrage rapide

ID fournisseur

Par défaut, vous pouvez utiliser l'un des ID vidéo 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 la faire valider par Google afin de vous assurer qu'elle vous a bien été délivrée 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 d'ID fournisseur et de type d'appareil.

Un VID de test ne peut pas être utilisé sur un appareil grand public.
Votre ID de production de production doit être émis par la CSA. Google vérifiera que vous êtes le propriétaire de ce VID avant que vous puissiez l'utiliser dans le Google Home Developer Console. Vous pourrez ensuite créer des intégrations pour ce VID.
À des fins de développement et d'essai sur le terrain, un projet et l'intégration avec la combinaison du VID et du PID correspondant doivent être créés dans le Developer Console. L'utilisateur qui commande l'appareil doit être membre du projet ou figurer dans la liste des utilisateurs sur le terrain.
Les utilisateurs grand public ne peuvent utiliser votre produit qu'une fois certifié par la CSA.

*Tableau: scénarios d'association de l'ID de fournisseur (VID) et du type d'appareil*
		Quels types d'utilisateurs peuvent commander l'appareil dans l'écosystème Google Home ?
Type d'ID vidéo	État de la certification VID et intégration à la console	Production (utilisateurs grand public)	Développement (développeurs, utilisateurs de la version d'essai)
Test	Aucune intégration dans le Developer Console (ne peut pas être certifié)
Test	L'intégration existe dans le Developer Console (ne peut pas être certifiée)
Production	Non certifié, l'intégration n'existe pas dans le Developer Console
Production	Non certifié, l'intégration existe dans Developer Console
Production	Certifié dans la DCL CSA, l'intégration n'existe pas dans le Developer Console
Production	Certifié dans le CCL CSA 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 Play 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 seront pas visibles par les utilisateurs finaux:

*Tableau: Matter clusters non exposés aux utilisateurs de l'écosystème Google Home*
Type de cluster	Clusters
Core	Liaison 1 Libellé Libellé fixe Libellé de l'utilisateur Actions Clé du groupe Configuration de la localisation Localisation au format horaire Localisation des unités Configuration de la source d'alimentation Source d'alimentation Clusters de diagnostic (journaux de diagnostic, diagnostics généraux, diagnostics logiciels, diagnostics de réseau Thread, diagnostics de réseau Wi-Fi, diagnostics de réseau Ethernet) Synchronisation de l'heure Sélection du mode
Application	Les groupes et les scènes ne sont pas directement pris en charge. Des fonctionnalités équivalentes sont disponibles via les routines. Tous les clusters de médias. Des fonctionnalités équivalentes sont disponibles via Google Cast.

1 Consultez la section Marche/Arrêt pour les interrupteurs.

Checklist des développeurs