Premiers pas avec Matter

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

  Version preview pour les développeurs  

Le programme Google Developers permet aux fabricants de connecter leurs appareils connectés à l'écosystème Google Home. Nous étendons le processus de traitement local des actions pour la maison connectée avec la possibilité d'ajouter Matter -enabled devices for setup using the Google Home app (GHA) on Android and control them using Google Assistant , GHA, or smart displays like the 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 cet aperçu pour les développeurs : Matter, veuillez tenir compte des points suivants :

  • Le compte utilisé pour le développement ne doit comporter qu'un seul hub compatible avec Matter connecté à des tests. Plusieurs hubs compatibles avec Matter connectés en même temps ou connectés à la même structure lors des 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 faire clignoter 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 énoncées dans les procédures, si nécessaire.
  • Seule la version Android de GHA est compatible.

Définitions

Les termes suivants sont utilisés dans cette documentation:

Routeur de bordure
Un hub qui implémente un usage général Thread Border Router for Thread-enabled devices.
Hub
Un appareil compatible Google Nest device, such as the Google Nest Hub (2nd gen). A hub is required to control Matter-enabled devices through other surfaces such as Assistant, the GHA, and smart displays.
Appareil compatible avec Matter
Appareil ou carte de développement sur lesquels une version compatible avec Matter ou une application exemple a été activée
Sur un appareil mobile
Téléphone test utilisé pour l'association. Il s'agit actuellement d'un Android phone.

Prérequis

Extensions IDE recommandées pour le développement de Matter

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

  1. Un hub Google compatible avec Thread, qui sert à la fois de routeur de bordure pour les appareils compatibles avec Thread et de chemin d'accès local pour acheminer les intents de la maison connectée.
  2. 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 (la compatibilité avec iOS sera ajoutée ultérieurement)
    • Fonctionnalité BLE
  3. Un ID de fournisseur (VID) et un ID de produit (PID) pour l'appareil compatible avec Matter.
  4. Un appareil sur lequel Matter est activé. Il doit s'agir de l'un des Matter types d'appareils actuellement compatibles avec l'écosystème Google Home, qui peut être :
    • Votre propre produit avec un micrologiciel compatible avec Matter.
    • Tableau de développement d'une plate-forme de fournisseur compatible pouvant servir d'appareil compatible 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 Assistance Thread
Bouffalo Lab BL602 Démarrage rapide
BL702 Démarrage rapide
Espressif ESP32 Démarrage rapide
Tests OTA
Semiconducteur nordique nRF52840 DK Démarrage rapide
Tests OTA
NXP IOTZTB-DK006 Kit de développement Démarrage rapide
Realtek Ameba série D Démarrage rapide
Silicon Labs Kit de démarrage EFR32MG Zigbee et Thread Démarrage rapide
Kit de développement EFR32MG24 Démarrage rapide
Telink TLSR9518 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, 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 été délivrée par la CSA.

Ce VID doit être mis en œuvre dans le micrologiciel de votre appareil.

Un appareil Matter ne peut être associé à l'écosystème Google Home que dans certains cas d'identifiant de fournisseur et de type d'appareil.

  • Un VID test ne peut pas être utilisé sur un appareil grand public.
  • Pour qu'un appareil de production (consommateur) soit associé, il doit être certifié dans la CSL CSA.
  • À des fins de développement et d'essai sur le terrain, un appareil doit être enregistré dans Google Home Developer Console .
Tableau: ID de fournisseur (VID) et scénarios d'association de types d'appareils
Quels types d'utilisateurs peuvent mettre l'appareil en service dans l'écosystème Google Home ?
Type d'ID vidéo Certification VID et statut d'enregistrement Production
(utilisateurs grand public)
Développement
(développeurs, utilisateurs sur l'essai)
Test Non enregistré (non certifié) N/A N/A
Test Enregistré dans le Developer Console (non certifié) N/A
Production Non certifié, non enregistré N/A
Production Non certifié, enregistré dans Developer Console
Production Certifié dans la CSA DCL, non enregistré N/A
Production Certifié dans la DCL CSA et enregistré dans Developer Console

ID produit

Les informations sur l'appareil sont lues à l'aide de clusters Matter Descriptor, et non de l'ID produit. Vous pouvez attribuer n'importe quel ID produit lors du développement, conformément au schéma de numérotation de votre entreprise, à condition qu'il corresponde à l'ID produit de votre intégration à Matter, le cas échéant.

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 seront pas visibles par les utilisateurs finaux:

Table : Matter Clusters non exposés aux utilisateurs de l'écosystème Google Home
Type de cluster Clusters
Core
  • Liaison
  • 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 horaire
  • Mode de sélection
Application
  • Les groupes et les scènes ne sont pas directement pris en charge. Des fonctionnalités équivalentes sont disponibles via des routines.
  • Tous les clusters multimédias. Des fonctionnalités équivalentes sont disponibles via Google Cast .