Premiers pas avec Matter

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 d'exécution local des actions pour la maison connectée en ajoutant la possibilité de configurer des appareils compatibles Matter à l'aide de Google Home app (GHA) et de les contrôler à l'aide de Google Assistant, GHA ou d'écrans connectés comme Google Nest Hub (2nd gen).

Cette documentation explique comment commencer à créer et à intégrer une plate-forme compatible 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 n'associer qu'un seul hub compatible avec Matter au compte utilisé pour le développement, à des fins de test. Si plusieurs hubs compatibles Matter sont connectés en même temps ou à la même structure pendant les tests, cela peut entraîner un comportement imprévisible.
• Toutes les procédures supposent l'utilisation d'une machine Linux exécutant Ubuntu 20.04 pour la création et le flashage des exemples Matter, qui ont été testés par Google. Les machines macOS sont compatibles, mais 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 et 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 :

Ensuite, consultez 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. Ensuite, parcourez la liste de contrôle pour les développeurs afin de comprendre l'ensemble du flux de développement, de la création du projet au lancement.

Appareils compatibles Check-list pour les développeurs

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 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 sur lesquels un build ou une application exemple compatible avec Matter a été installé.

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

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

1. 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 Smart Home.
2. 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
3. Un identifiant fournisseur (VID) et un identifiant produit (PID) pour l'appareil compatible avec Matter.
4. 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 de l'un des éléments suivants :
   • Votre propre produit avec un micrologiciel compatible avec Matter.
   • L'un des appareils Matter suivants à utiliser pour la validation de bout en bout :

Tableau : exemples Matter fournis par les fabricants de semi-conducteurs

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
	EFR32MG Zigbee and Thread Starter Kit
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é 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 d'ID de 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 Connectivity Standards Alliance (Alliance). Google vérifiera que vous êtes bien le propriétaire de ce VID avant de vous autoriser à l'utiliser dans Google Home Developer Console. Une fois cette opération effectuée, vous pourrez créer des intégrations pour ce VID.
• Pour le développement et les Field Trial, 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 dans la liste des utilisateurs Field Trial.
• Les utilisateurs finaux ne peuvent utiliser votre produit qu'une fois qu'il a été certifié par 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 :

• 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.

Tableau : Scénarios d'association de l'ID fournisseur (VID) et du type d'appareil

		Quels types d'utilisateurs peuvent configurer l'appareil dans l'écosystème Google Home ?
Type de VID	État de la certification VID et de l'intégration à la console	Production (utilisateurs grand public)	Développement (développeurs, utilisateurs Field Trial)
Test	Aucune intégration dans 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é, intégration existante dans 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 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 Developer Console.

Fonctionnalités non compatibles

Certains clusters Matter ne sont pas encore visibles par les utilisateurs, mais ils peuvent être utilisés par le système. Dans la plupart des cas, cela signifie que les attributs exposés par ces clusters ne sont pas visibles par les utilisateurs finaux :

¹ Consultez Interrupteurs marche/arrêt pour savoir comment cela affecte les interrupteurs marche/arrêt.