Erste Schritte mit Matter

Mit dem Home Developer-Programm von Google können Gerätehersteller ihre Smart-Home-Geräte mit dem Google Home-Ökosystem verbinden. Wir erweitern den lokalen Ausführungspfad für Smart Home Actions um die Möglichkeit, Matter-fähige Geräte für die Einrichtung mit Google Home app (GHA) hinzuzufügen und sie mit Google Assistant, GHA oder Smart Displays wie dem Google Nest Hub (2nd gen) zu steuern.

In dieser Dokumentation wird beschrieben, wie Sie eine Matter-kompatible Plattform im Google Home-Ökosystem erstellen und einbinden.

Haftungsausschlüsse

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

• Wir empfehlen, dass mit dem für die Entwicklung verwendeten Konto nur ein einziger Matter-fähiger Hub für Tests verbunden ist. Mehrere Matter-fähige Hubs, die gleichzeitig oder während des Tests mit derselben Struktur verbunden sind, können 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.

Entwicklung

Wenn Sie ein Matter-fähiges Gerät entwickeln möchten, das in das Google Home-Ökosystem eingebunden wird, benötigen Sie ein Matter-kompatibles Entwicklungsboard und das Matter SDK.

Am einfachsten ist es, wenn Sie sich unsere Codelabs ansehen. Wir empfehlen, mindestens eines der folgenden Codelabs zu absolvieren:

Sehen Sie sich dann unsere Liste der unterstützten Geräte an, um zu prüfen, ob die Geräte, die Sie integrieren möchten, im Google Home-Ökosystem unterstützt werden. 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:

Border-Router

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	TLSR9518
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 in eine andere 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 nicht in Developer Console vorhanden
Produktion	Nicht zertifiziert, Integration ist in Developer Console vorhanden
Produktion	Zertifiziert in der Alliance-DCL, Integration ist nicht in der 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 das, dass Attribute, die über diese Cluster verfügbar gemacht werden, für Endnutzer nicht sichtbar sind:

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