Erste Schritte mit Matter

Über das Google Home Developer-Programm können Gerätehersteller ihre Smart-Home-Geräte mit der Google Home-Plattform zu verknüpfen. Wir erweitern die lokaler Pfad für die Ausführung von Smart-Home-Aktionen mit der Möglichkeit, Geräte mit aktiviertem Matter für die Einrichtung mit der Google Home app (GHA) und steuern Sie sie mit Google Assistant, GHA oder Smart Displays wie dem Google Nest Hub (2nd gen).

In dieser Dokumentation werden die ersten Schritte zum Erstellen und Integrieren eines Matter-unterstützte Plattform in der Google Home-Umgebung.

Rechtliche Hinweise

In Bezug auf die in den Matter beschriebenen Verfahren Dokumentation:

  • Wir empfehlen, dass das für die Entwicklung verwendete Konto nur ein einziges Matter-fähiger Hub zum Testen verbunden. Mehrere Matter-fähige Hubs verbunden am miteinander verbunden sind oder mit derselben Struktur verbunden sind, unvorhersehbares Verhalten.
  • Bei allen Verfahren wird ein Linux-Computer mit Ubuntu 20.04 für Matter-Beispiele erstellt und blinken, die von Google getestet wurden. macOS-Computer werden zwar unterstützt, aber Linux wird empfohlen. Mac-spezifisch Anweisungen werden bei Bedarf in den Verfahren genannt.

Anleitung

Um ein Matter-fähiges Gerät zu erstellen, das sich in das Google Home-Systems nutzen, nutzt du ein Matter-kompatibles Entwicklungsboard und das Matter SDK zu aktualisieren.

Am einfachsten ist es, mit unseren Codelabs loszulegen. Mi. empfehlen wir, mindestens eines der folgenden Codelabs zu absolvieren:

Sehen Sie sich anschließend unsere Liste der unterstützten Geräte an, um sicherzustellen, in die Google Home-Umgebung unterstützt wird. Gehen Sie dann die Entwickler-Checkliste durch, um die gesamte von der Projekterstellung bis zur Markteinführung.

Unterstützte Geräte Checkliste für Entwickler

Definitionen

Die folgenden Begriffe werden in dieser Dokumentation verwendet:

Border-Router
Ein Hub, der einen Thread-Border für allgemeine Zwecke implementiert Router für Thread-fähige Geräte.
Hub
Ein unterstütztes Google Nest-Gerät wie das Google Nest Hub (2nd gen) Ein Hub ist erforderlich, um Matter-fähige Geräte über andere Oberflächen wie Assistant, die GHA und Smart Displays.
Matter-fähiges Gerät
Ein Gerät oder ein Entwicklungsboard, das mit einem Build- oder Beispiel-App mit Matter.
Mobilgerät
Das Testtelefon, das für die Kopplung verwendet wird. Dies ist derzeit ein Android Smartphone.

Vorbereitung

<ph type="x-smartling-placeholder"></ph>
Empfohlene IDE-Erweiterungen für Matter Entwicklung

Um ein Matter-fähiges Gerät vollständig mit der Google Home-Plattform haben, muss ein Entwickler folgende Voraussetzungen erfüllen:

  1. Ein Google-Hub mit Thread-Unterstützung der sowohl als Border-Router für Thread-fähige Geräte als auch Ausführungspfad für das Routing von Smart-Home-Intents.
  2. Ein Mobilgerät (Testtelefon), das die Mindestanforderungen erfüllt: <ph type="x-smartling-placeholder">
      </ph>
    • Android O (8.1, API-Level 27 oder höher)
    • iOS (Version 16.5 oder höher)
    • BLE-Funktionalität
  3. Eine Anbieter-ID (VID) und eine Produkt-ID (PID) für die Matter-fähiges Gerät.
  4. Ein Matter-fähiges Gerät. Dieses Gerät sollte eines der folgenden sein: die Matter unterstützten Gerätetypen im Google Home-Umgebung und kann Folgendes sein: <ph type="x-smartling-placeholder">
      </ph>
    • Dein eigenes Produkt mit Matter-fähiger Firmware.
    • Eines der folgenden Matter Geräte zur Verwendung für Ende-zu-Ende-Überprüfung:
.
Tabelle: Matter Beispiele von Anbietern aus dem Siliziumdesign
Vendor Plattform Support der Stufe „Thread Leitfaden
Bouffalo-Labor BL602
BL702
Espressif ESP32 OTA-Tests
Nordische Halbleiter nRF52840 DK OTA-Tests
NXP IOTZTB-DK006-Entwicklung Set
Realtek Ameba D-Serie
Silicon Labs EFR32MG24-Entwicklerkit
EFR32MG Zigbee und Thread Starterkit
Logo: Telink TLSR9518
Texanische Instrumente CC2652R7 LaunchPad-Entwicklung Set

Anbieter-ID

Standardmäßig kannst du eine der von der CSA zugewiesenen VIDs für Tests verwenden zu verstehen. Wählen Sie eine der folgenden Möglichkeiten aus: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

Wenn du eine Produktions-VID verwenden möchtest, damit deine Integration zertifiziert und eingeführt werden kann, musst du zuerst lassen sie von Google überprüfen, um sicherzustellen, dass sie von der CSA ausgestellt wurde.

Diese VID sollte in der Firmware deines Geräts implementiert sein.

Ein Matter-Gerät kann nur mit Google Home gekoppelt werden in bestimmten Szenarien mit Anbieter-ID und Gerätetyp.

  • Eine Test-VID kann nicht auf einem Nutzergerät verwendet werden.
  • Deine Produktions-VID muss von der Connectivity Standards Alliance (Alliance) ausgestellt werden. Google macht musst du bestätigen, dass du der Inhaber dieser VID bist, bevor du sie im Google Home Developer Console verwenden kannst. Anschließend können Sie für diese VID.
  • Für Entwicklungs- und Field-Trial-Zwecke ist ein Projekt und die Integration in die muss die zugehörige Kombination aus VID und PID in Developer Console erstellt werden. Die Inbetriebnahme durch den Nutzer Das Gerät muss entweder ein Projektmitglied sein oder in der Liste enthalten sein von Field-Trial-Nutzenden.
  • Verbraucher können Ihr Produkt erst verwenden, nachdem es vom Alliance
.
Tabelle: Anbieter-ID (VID) und Gerätetyp Kopplungsszenarien
Welche Nutzer die mit der Google Home-Plattform zu verbinden?
VID-Typ VID-Zertifizierung und Status der Konsolenintegration Produktion
(Privatnutzer)
Entwicklung
(Entwickler, Field-Trial-Nutzer)
Test Keine Integration in Developer Console (kann nicht zertifiziert werden)
Test Integration ist in Developer Console vorhanden (kann nicht zertifiziert)
Produktion Nicht zertifiziert, Integration ist in Developer Console nicht vorhanden
Produktion Nicht zertifiziert, Integration existiert in Developer Console
Produktion Nach Alliance DCL zertifiziert, Integration nicht vorhanden in Developer Console
Produktion Nach Alliance DCL zertifiziert und Integration vorhanden in Developer Console

Produkt-ID

Informationen zum Gerät werden aus dem Matter: Cluster mit grundlegenden Informationen. Die in Ihrem Die Firmware des Geräts muss mit der Produkt-ID der Matter-Integration übereinstimmen in der Developer Console.

Nicht unterstützte Funktionen

Einige Matter-Cluster sind jedoch noch nicht für Nutzer zugänglich können sie vom System verwendet werden. In den meisten Fällen bedeutet dies, dass Attribute sind für Endnutzer nicht sichtbar:

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 Siehe Ein-/Aus-Lichtschalter wie sich dies auf die Ein/Aus-Lichtschalter auswirkt.