Erste Schritte mit Matter

Das Google Home Developer-Programm ermöglicht es Geräteherstellern, ihre Smart-Home-Geräte mit dem Google Home-Ökosystem zu verbinden. Wir erweitern den lokalen Abwicklungspfad von Smart Home Actions um die Möglichkeit, Matter-fähige Geräte zur Einrichtung mit dem Google Home app (GHA) hinzuzufügen und sie mit dem Google Assistant, dem GHA oder intelligenten Displays wie dem Google Nest Hub (2nd gen) zu steuern.

Diese Dokumentation beschreibt, wie Sie mit dem Aufbau und der Integration einer Matter-unterstützten Plattform in das Google Home-Ökosystem beginnen.

Rechtliche Hinweise

Beachten Sie bei den in der Matter-Dokumentation beschriebenen Verfahren Folgendes:

• Wir empfehlen, dass auf dem für die Entwicklung verwendeten Konto nur ein einziger Matter-fähiger Hub für Testzwecke angeschlossen ist. Wenn mehrere Matter-fähige Hubs gleichzeitig oder während des Tests mit derselben Struktur verbunden sind, kann dies zu unvorhersehbarem Verhalten führen.
• Bei allen Verfahren wird davon ausgegangen, dass eine Linux-Maschine mit Ubuntu 20.04 zum Erstellen und Flashen von Matter-Beispielen verwendet wird, die von Google getestet wurden. macOS-Computer werden zwar unterstützt, Linux wird jedoch empfohlen. Mac-spezifische Anleitungen werden in den Verfahren bei Bedarf angegeben.

Wie man baut

Um ein Matter-fähiges Gerät zu entwickeln, das sich in das Google Home-Ökosystem integriert, arbeiten Sie mit einem Matter-kompatiblen Entwicklungsboard und dem Matter SDK.

Am einfachsten gelingt der Einstieg mit unseren Codelabs. Wir empfehlen, mindestens eines der folgenden Codelabs zu absolvieren:

Prüfen Sie anschließend unsere Liste der unterstützten Geräte, um sicherzustellen, dass das, was Sie integrieren möchten, im Google Home-Ökosystem unterstützt wird. Lesen Sie dann die Entwickler-Checkliste, um den gesamten Entwicklungsablauf von der Projekterstellung bis zum Start zu verstehen.

Unterstützte Geräte Checkliste für Entwickler

Definitionen

In dieser Dokumentation werden die folgenden Begriffe verwendet:

Grenzrouter

Ein Hub, der einen universellen Thread-Border-Router für Thread-kompatible Geräte implementiert.

Hub

Ein unterstütztes Google Nest-Gerät, z. B. das Google Nest Hub (2nd gen). Ein Hub ist erforderlich, um Matter-kompatible Geräte über andere Oberflächen wie Assistant, die GHA und Smart Displays zu steuern.

Matter-kompatibles Gerät

Ein Gerät oder Entwicklungsboard, auf dem ein mit Matteraktivierter Build oder eine Beispiel-App geflasht wurde.

Mobilgerät

Das Test-Smartphone, das zum Koppeln verwendet wurde. Derzeit ist dies ein Android-Smartphone.

Vorbereitung

Damit ein Matter-kompatibles Gerät vollständig in das Google Home-Ökosystem eingebunden werden kann, muss ein Entwickler Folgendes haben:

1. Ein Google-Hub mit Thread-Unterstützung, der sowohl als Border-Router für Thread-kompatible Geräte als auch als Pfad für die lokale Ausführung zum Weiterleiten von Smart Home-Intents dient.
2. Ein Mobilgerät (Test-Smartphone), das die Mindestanforderungen erfüllt:
   • Android O (8.1, API‑Level 27 oder höher)
   • iOS (Version 16.5 oder höher)
   • BLE-Funktion
3. Eine Anbieter-ID (VID) und eine Produkt-ID (PID) für das Matter-fähige Gerät.
4. Ein Gerät, das Matter unterstützt. Dieses Gerät muss einer der Matter-Gerätetypen sein, die im Google Home-Ökosystem unterstützt werden, und kann Folgendes sein:
   • Ihr eigenes Produkt mit Matter-fähiger Firmware.
   • Eines der folgenden Matter-Geräte für die End-to-End-Überprüfung:

Tabelle: Matter Beispiele von Chipherstellern

Vendor	Plattform	Support der Stufe „Thread“	Leitfaden
Bouffalo Lab	BL602
	BL702
Espressif	ESP32		OTA-Tests
Nordic Semiconductor	nRF52840 DK		OTA-Tests
NXP	IOTZTB-DK006-Entwicklungskit
Realtek	Ameba D-Serie
Silicon Labs	EFR32MG24 Dev Kit
	EFR32MG Zigbee and Thread Starter Kit
Telink	TLSR9528		Telink Matter Developer Guide
Texas Instruments	CC2652R7 LaunchPad-Entwicklungskit

Anbieter-ID

Standardmäßig können Sie eine der von der CSA zugewiesenen VIDs für Testzwecke verwenden. Wählen Sie eine der folgenden Optionen aus: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

Wenn Sie eine Produktions-VID verwenden möchten, damit Ihre Integration zertifiziert und eingeführt werden kann, müssen Sie sie zuerst von Google verifizieren lassen, um sicherzustellen, dass sie von der CSA ausgestellt wurde.

Diese VID muss in der Firmware Ihres Geräts implementiert werden.

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

• Eine Test-VID kann nicht auf einem Verbrauchergerät verwendet werden.
• Ihre Produktions-VID muss von Connectivity Standards Alliance (Alliance) ausgestellt werden. Google prüft, ob Sie der Inhaber dieser VID sind, bevor Sie sie in der Google Home Developer Console verwenden können. Danach können Sie Integrationen für diese VID erstellen.
• Für Entwicklungs- und Field Trial-Zwecke muss ein Projekt und eine Integration mit der entsprechenden VID- und PID-Kombination in der Developer Console erstellt werden. Der Nutzer, der das Gerät in Betrieb nimmt, muss entweder Mitglied des Projekts sein oder in der Liste der Field Trial-Nutzer enthalten sein.
• Endnutzer können Ihr Produkt erst verwenden, wenn es von der Alliance zertifiziert wurde.

VID und PID können nur einmal für eine Integration verwendet werden. Wenn Sie dieselbe VID oder PID in Ihrer Integration verwenden möchten, haben Sie folgende Möglichkeiten:

• Bearbeiten Sie die Integration und ändern Sie die VID oder PID.
• Löschen Sie die Integration mit der VID oder PID.

Tabelle: Szenarien für die Kopplung von Anbieter-ID (VID) und Gerätetyp

		Welche Arten von Nutzern können das Gerät in das Google Home-Ökosystem einbinden?
VID-Typ	VID-Zertifizierung und Konsolenintegrationsstatus	Produktion (Privatnutzer)	Entwicklung (Entwickler, Field Trial-Nutzer)
Test	Keine Integration in Developer Console (kann nicht zertifiziert werden)
Test	Die Integration ist in Developer Console vorhanden (kann nicht zertifiziert werden)
Produktion	Nicht zertifiziert, Integration ist nicht in Developer Console vorhanden
Produktion	Nicht zertifiziert, Integration ist in Developer Console vorhanden
Produktion	Die Integration ist in der Alliance-DCL zertifiziert, aber nicht in Developer Console vorhanden.
Produktion	Zertifiziert für die Alliance-DCL und Integration in Developer Console vorhanden

Produkt-ID

Informationen zum Gerät werden aus dem Matter-Cluster „Basic Information“ (Grundlegende Informationen) gelesen. Die in der Firmware Ihres Geräts codierte Produkt-ID muss mit der Produkt-ID der Matter-Integration in der Developer Console übereinstimmen.

Nicht unterstützte Funktionen

Einige Matter-Cluster werden Nutzern noch nicht angezeigt, können aber vom System verwendet werden. In den meisten Fällen bedeutet dies, dass die über diese Cluster bereitgestellten Attribute für Endbenutzer nicht sichtbar sind:

¹ Informationen dazu, wie sich das auf Ein/Aus-Lichtschalter auswirkt, finden Sie hier.