Im Rahmen des Google Home Developer-Programms können Gerätehersteller ihre Smart-Home-Geräte mit dem Google Home-System verbinden. Wir erweitern den Pfad für die lokale Ausführung von Smart Home Actions um die Möglichkeit, Matter-fähige Geräte zur Einrichtung über die Google Home app (GHA) hinzuzufügen und über Google Assistant, GHA oder Smart Displays wie Google Nest Hub (2nd gen) zu steuern.
In dieser Dokumentation werden die ersten Schritte zum Erstellen und Einbinden einer von Matter unterstützten Plattform in der Google Home-Umgebung beschrieben.
Rechtliche Hinweise
In Bezug auf die in der Matter-Dokumentation beschriebenen Verfahren solltest du Folgendes beachten:
- Wir empfehlen, dass mit dem für die Entwicklung verwendeten Konto nur ein einziger Matter-aktivierter Hub zum Testen verbunden 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 zum Erstellen und Flashen von Matter-Beispielen, die von Google getestet wurden, ein Linux-Computer mit Ubuntu 20.04 verwendet. macOS-Computer werden zwar unterstützt, aber Linux wird empfohlen. Mac-spezifische Anweisungen werden in den Verfahren nach Bedarf aufgerufen.
Anleitung
Wenn Sie ein Matter-fähiges Gerät erstellen möchten, das sich in die Google Home-Umgebung einbinden lässt, benötigen Sie ein mit Matter kompatibles Entwicklungsboard und das Matter SDK.
Am einfachsten ist es, mit unseren Codelabs loszulegen. Wir empfehlen, mindestens eines der folgenden Codelabs zu absolvieren:
Sieh dir anschließend unsere Liste der unterstützten Geräte an, um zu prüfen, ob deine Integration in Google Home unterstützt wird. Gehen Sie dann die Entwickler-Checkliste durch, um den gesamten Entwicklungsablauf von der Projekterstellung bis zum Start zu verstehen.
Unterstützte Geräte Entwickler-Checkliste
Definitionen
Die folgenden Begriffe werden in dieser Dokumentation verwendet:
- Border-Router
- Ein Hub, der einen Thread-Border-Router für allgemeine Zwecke für Thread-fähige Geräte implementiert
- Hub
- Ein unterstütztes Google Nest-Gerät wie Google Nest Hub (2nd gen). Ein Hub ist erforderlich, um Matter-fähige Geräte über andere Oberflächen wie Assistant, GHA und Smart Displays zu steuern.
- Matter-fähiges Gerät
- Ein Gerät oder Entwicklungsboard, das mit einer Matter-fähigen Build- oder Beispiel-App geflasht wurde.
- Mobilgerät
- Das Testtelefon, das für die Kopplung verwendet wird. Dies ist derzeit ein Android-Smartphone.
Voraussetzungen
Damit ein Matter-fähiges Gerät vollständig in Google Home eingebunden werden kann, muss ein Entwickler folgende Voraussetzungen erfüllen:
- Ein Google-Hub mit Thread-Unterstützung, der sowohl als Border Router für Thread-fähige 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-Funktionalität
- Eine Anbieter-ID (VID) und eine Produkt-ID (PID) für das Matter-fähige Gerät.
- Ein Matter-fähiges Gerät. Dieses Gerät sollte einer der Matter-Gerätetypen sein, die im Google Home-System unterstützt werden. Es kann sich um Folgendes handeln:
- Dein eigenes Produkt mit Matter-fähiger Firmware.
- Eines der folgenden Matter-Geräte für die Ende-zu-Ende-Überprüfung:
| Vendor | Plattform | Support der Stufe „Thread“ | Leitfaden |
|---|---|---|---|
| Bouffalo-Labor | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | OTA-Tests | |
| Nordische Halbleiter | nRF52840 DK | OTA-Tests | |
| NXP | IOTZTB-DK006 Entwicklungskit | ||
| Realtek | Ameba D-Serie | ||
| Silicon Labs | EFR32MG24-Entwicklerkit | ||
| EFR32MG Zigbee- und Thread-Starterkit | |||
| Logo: Telink | TLSR9518 | ||
| Texanische Instrumente | CC2652R7 LaunchPad-Entwicklungskit |
Anbieter-ID
Standardmäßig kannst du eine der von der CSA zugewiesenen VIDs zu Testzwecken verwenden. Wählen Sie eine der folgenden Optionen aus: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Wenn du eine Produktions-VID verwenden möchtest, damit deine Integration zertifiziert und eingeführt werden kann, musst du sie zuerst von Google überprüfen lassen, 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 in der Google Home-Umgebung nur in bestimmten Szenarien mit Anbieter-ID und Gerätetyp gekoppelt werden.
- Eine Test-VID kann nicht auf einem Nutzergerät verwendet werden.
- Deine Produktions-VID muss von der Connectivity Standards Alliance (Alliance) ausgestellt werden. Google überprüft, ob du der Inhaber dieser VID bist, bevor du sie im Google Home Developer Console verwenden kannst. Danach kannst du Integrationen für diese VID erstellen.
- Zu Entwicklungs- und Feldtests müssen ein Projekt und eine Integration mit der entsprechenden Kombination aus VID und PID in Developer Console erstellt werden. Der Nutzer, der das Gerät in Betrieb nimmt, muss entweder Mitglied des Projekts sein oder in der Liste der Feldtestnutzer aufgeführt sein.
- Privatnutzer können dein Produkt erst verwenden, nachdem es von der Alliance zertifiziert wurde.
| Welche Nutzer können das Gerät für das Google Home-System in Betrieb nehmen? | |||
|---|---|---|---|
| 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 werden) | ||
| Produktion | Nicht zertifiziert, Integration ist in Developer Console nicht vorhanden | ||
| Produktion | Nicht zertifiziert, Integration existiert in Developer Console | ||
| Produktion | Nach Alliance DCL zertifiziert, Integration existiert nicht in Developer Console | ||
| Produktion | Nach Alliance DCL zertifiziert und Integration in Developer Console vorhanden | ||
Produkt-ID
Informationen zum Gerät werden aus dem Matter-Cluster für allgemeine Informationen ausgelesen. Die in der Firmware deines 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 dies, dass Attribute, die über diese Cluster bereitgestellt werden, für Endnutzer nicht sichtbar sind:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
1 Weitere Informationen dazu, wie sich dies auf die Ein-/Aus-Lichtschalter auswirkt, finden Sie unter Ein-/Aus-Lichtschalter.