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 processus de traitement local des actions pour la maison connectée. Il permet 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, de 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é

En ce qui concerne les procédures décrites dans la documentation Matter, tenez compte des points suivants:

  • Nous vous recommandons de n'avoir qu'un seul hub compatible avec Matter connecté pour les tests sur le compte utilisé pour le développement. Plusieurs hubs compatibles avec Matter connectés en même temps ou à 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 mentionnées dans les procédures si nécessaire.

Créer une application

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 se lancer est de suivre nos ateliers de programmation. 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 éléments que vous prévoyez d'intégrer sont pris en charge dans l'écosystème Google Home. Lisez ensuite la checklist pour les développeurs afin de 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 qui implémente un routeur de bordure Thread à usage général pour les appareils compatibles 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 et GHA, ainsi que des é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

Extensions d'IDE recommandées pour le développement avec Matter

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

  1. Un hub Google compatible avec Thread servant à la fois de routeur de bordure pour les appareils compatibles Thread et de chemin de traitement local pour router les intents de maison connectée.
  2. Un appareil mobile (téléphone de test) répondant à la configuration minimale suivante :
    • Android O (8.1, niveau d'API 27 ou version ultérieure)
    • iOS (version 16.5 ou ultérieure)
    • Capacité BLE
  3. Un ID fournisseur (VID) et un ID produit (PID) pour l'appareil compatible avec Matter.
  4. Un appareil compatible avec Matter Cet appareil doit correspondre à l'un des types d'appareils Matter compatibles 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:
Tableau: Matterexemples de fournisseurs de silicone
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 EFR32MG Zigbee et Thread
Telink TLSR9518
Texas Instruments Kit de développement LaunchPad CC2652R7

ID fournisseur

Par défaut, vous pouvez utiliser l'un des VID alloués par la CSA à des fins de test. Sélectionnez l'une des options suivantes : 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 afin de 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é à l'écosystème Google Home que dans certains scénarios d'ID de fournisseur et de type d'appareil.

  • Un VID 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 le propriétaire du 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 de tests sur le terrain, un projet et une intégration avec la combinaison VID/PID correspondante doivent être créés dans Developer Console. L'utilisateur qui commande l'appareil doit être membre du projet ou figurer dans la liste des utilisateurs participant aux tests.
  • Les consommateurs ne peuvent utiliser votre produit qu'une fois qu'il a été certifié par Alliance.
Tableau: scénarios d'association entre l'ID fournisseur (VID) et le type d'appareil
Quels types d'utilisateurs peuvent mettre l'appareil en service dans l'écosystème Google Home ?
Type d'ID vidéo État de la certification VID et de l'intégration de la console Production
(Utilisateurs grand public)
Développement
(développeurs, utilisateurs de tests en conditions réelles)
Test Aucune intégration dans Developer Console (certification impossible)
Test L'intégration existe dans Developer Console (elle ne peut pas être certifiée)
Production Non certifié, aucune intégration n'existe dans Developer Console
Production Non certifié, l'intégration existe dans Developer Console
Production Certifiée dans la DCL Alliance, l'intégration n'existe pas dans Developer Console
Production Certifiées 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'identifiant produit encodé dans le micrologiciel de votre appareil doit correspondre à l'identifiant produit de l'intégration de Matter dans la Play Console.

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:

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines.
  • All Media clusters. Equivalent functionality is available via Google Cast.

1 Consultez Interrupteurs Marche/Arrêt pour connaître l'impact de ce changement sur les interrupteurs.