Mit dem Home-Entwicklerprogramm 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-Aktionen um die Möglichkeit, Matter-kompatible Geräte für die Einrichtung mit der 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 mit der Entwicklung und Integration einer Matter-kompatiblen Plattform in das Google Home-Ökosystem beginnen.
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 einzelner Matter-fähiger Hub für Tests verbunden ist. Wenn mehrere Matter-kompatible Hubs gleichzeitig verbunden sind oder während des Tests mit derselben Struktur verbunden sind, kann dies zu unvorhersehbarem Verhalten führen.
- Bei allen Verfahren wird davon ausgegangen, dass ein Linux-Computer 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 bei Bedarf in den Verfahren aufgeführt.
Erstellen
Um ein Matter-kompatibles Gerät zu erstellen, das in das Google Home-Ökosystem integriert wird, arbeiten Sie mit einem Matter-kompatiblen Entwicklerboard und dem Matter SDK.
Der einfachste Weg, um zu beginnen, sind unsere Codelabs. Wir empfehlen, mindestens eines der folgenden Codelabs durchzuarbeiten:
Prüfen Sie anschließend in unserer Liste der unterstützten Geräte , ob das, was Sie integrieren möchten, im Google Home-Ökosystem unterstützt wird. Lesen Sie dann die Checkliste für Entwickler , um den gesamten Entwicklungsablauf von der Projekterstellung bis zur Veröffentlichung zu verstehen.
Unterstützte Geräte Checkliste für Entwickler
Definitionen
Die folgenden Begriffe werden in dieser Dokumentation 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, wie 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 Entwicklerboard, das mit einem Matter-kompatiblen Build oder einer Beispiel-App geflasht wurde.
- Mobilgerät
- Das Testtelefon, das zum Koppeln verwendet wird. Derzeit ist das ein Android Smartphone.
Vorbereitung
Damit ein Matter-kompatibles Gerät vollständig in das Google Home-Ökosystem integriert werden kann, muss ein Entwickler Folgendes haben:
- Einen Google-Hub mit Thread-Unterstützung , der sowohl als Border-Router für Thread-kompatible Geräte als auch als lokaler Ausführungspfad für das Routing von Smart-Home-Intents dient.
- Ein Mobilgerät (Testtelefon), das die Mindestanforderungen erfüllt:
- Android O (8.1, API-Level 27 oder höher)
- iOS (Version 16.5 oder höher)
- BLE-Funktion
- Eine Anbieter-ID (VID) und eine Produkt-ID (PID) für das Matter-kompatible Gerät.
- Ein Matter-kompatibles Gerät. Dieses Gerät sollte einer der
von Matter unterstützten Gerätetypen im
Google Home-Ökosystem sein. Es kann Folgendes sein:
- Ihr eigenes Produkt mit Matter-kompatibler Firmware.
- Eines der folgenden Matter Geräte zur End-to-End-Überprüfung:
| Anbieter | Plattform | Thread Unterstützung | Leitfaden |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | OTA-Tests | |
| Nordic Semiconductor | nRF52840 DK | OTA-Tests | |
| NXP | IOTZTB-DK006-Entwickler kit | ||
| Realtek | Ameba D-Serie | ||
| Silicon Labs | EFR32MG24-Entwicklerkit | ||
| EFR32MG Zigbee- und Thread Starterkit | |||
| Telink | TLSR9528 | Entwicklerleitfaden für Telink Matter | |
| Texas Instruments | CC2652R7 LaunchPad-Entwickler kit |
Anbieter-ID
Standardmäßig können Sie eine der von der Alliance 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 veröffentlicht werden kann, muss sie zuerst von Google überprüft werden, um sicherzustellen, dass sie Ihnen von der Alliance ausgestellt wurde.
Diese VID sollte in der Firmware Ihres Geräts implementiert sein.
Ein Matter Gerät kann im Google Home Ökosystem nur in bestimmten Szenarien für Anbieter-ID und Gerätetyp gekoppelt werden.
- Eine Test-VID kann nicht in einem Verbrauchergerät verwendet werden.
- Ihre Produktions-VID muss von der 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. Sobald das geschehen ist, können Sie Integrationen für diese VID erstellen.
- Für Entwicklungs- und Field Trial Zwecke müssen in der Developer Console ein Projekt und eine Integration mit der entsprechenden VID- und PID-Kombination erstellt werdenDeveloper Console. 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.
- Verbrauchernutzer können Ihr Produkt erst verwenden, nachdem 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.
| Welche Arten von Nutzern können das Gerät im Google Home-Ökosystem in Betrieb nehmen? | |||
|---|---|---|---|
| VID-Typ | Status der VID-Zertifizierung und Konsolenintegration | Produktion
(Verbrauchernutzer) |
Entwicklung
(Entwickler, Field Trial Nutzer) |
| Test | Keine Integration in der Developer Console (kann nicht zertifiziert werden) | ||
| Test | Integration in der Developer Console vorhanden (kann nicht zertifiziert werden) | ||
| Produktion | Nicht zertifiziert, Integration nicht in der Developer Console vorhanden | ||
| Produktion | Nicht zertifiziert, Integration in der Developer Console vorhanden | ||
| Produktion | In der Alliance DCL zertifiziert, Integration nicht vorhanden in der Developer Console | ||
| Produktion | In der Alliance DCL zertifiziert und Integration vorhanden in der Developer Console | ||
Produkt-ID
Informationen zum Gerät werden aus dem Matter Basic Information Cluster 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 sind für Nutzer noch nicht verfügbar, obwohl sie möglicherweise 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:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ Informationen dazu, wie sich das auf Ein/Aus-Lichtschalter auswirkt, finden Sie unter Ein/Aus-Lichtschalter.