Mit dem Google Home Developer-Programm können Gerätehersteller ihre Smart-Home-Geräte mit dem Google Home-System verbinden. Wir erweitern den lokalen Ausführungspfad für Smart Home Actions durch die Möglichkeit, Matter-fähige Geräte zur Einrichtung mit dem 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 werden die ersten Schritte zum Erstellen und Einbinden einer von Matter unterstützten Plattform in Google Home beschrieben.
Haftungsausschlüsse
Beachten Sie im Hinblick auf die in der Matter-Dokumentation beschriebenen Verfahren Folgendes:
- Wir empfehlen, mit dem für die Entwicklung verwendeten Konto nur einen einzigen Matter-fähigen Hub zum Testen zu verbinden. Wenn mehrere Matter-fähige Hubs gleichzeitig oder mit derselben Struktur verbunden sind, kann dies zu unerwartetem 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. Obwohl macOS-Computer unterstützt werden, wird Linux empfohlen. Mac-spezifische Anweisungen werden im Verfahren nach Bedarf angezeigt.
Anleitung zum Bauen
Wenn Sie ein Matter-fähiges Gerät erstellen möchten, das in Google Home eingebunden werden kann, verwenden Sie ein Matter-kompatibles Entwicklungsboard und das Matter SDK.
Am einfachsten gelingt der Einstieg in unseren Codelabs. Wir empfehlen, mindestens eines der folgenden Codelabs durchzuführen:
Sehen Sie sich danach unsere Liste der unterstützten Geräte an, um sicherzugehen, dass Ihre geplanten Geräte auch in Google Home unterstützt werden. Gehen Sie dann die Entwickler-Checkliste durch, um den gesamten Entwicklungsablauf von der Projekterstellung bis zum Start zu verstehen.
Unterstützte Geräte Checkliste für Entwickler
Definitionen
Die folgenden Begriffe werden in dieser Dokumentation verwendet:
- Border-Router
- Ein Hub, auf dem ein allgemeiner Thread-Border-Router für Thread-fähige Geräte implementiert ist.
- Hub
- Ein unterstütztes Google Nest-Gerät wie z. B. 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 ein Entwicklungsboard, das mit einer Matter-fähigen Build- oder Beispiel-App geflasht wurde
- Mobilgerät
- Das Test-Smartphone, das für die Kopplung verwendet wurde. Dies ist derzeit ein Android-Telefon.
Voraussetzungen
Um ein Matter-fähiges Gerät vollständig in das Google Home-System einzubinden, benötigen Entwickler Folgendes:
- Ein Google-Hub mit Thread-Unterstützung, der sowohl als Border-Router für Thread-fähige Geräte als auch als lokaler Auftragsausfü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 16.5 oder höher
- BLE-Fähigkeit
- Eine Anbieter-ID (VID) und Produkt-ID (PID) für das Matter-fähige Gerät.
- Ein Matter-fähiges Gerät. Dieses Gerät sollte eines der Matter-Gerätetypen sein, die in der Google Home-Umgebung unterstützt werden, und es kann Folgendes sein:
- Dein eigenes Produkt mit Matter-fähiger Firmware.
- Eines der folgenden Matter-Geräte für die End-to-End-Bestätigung:
Anbieter | Plattform | Support der Stufe „Thread“ | Leitfaden |
---|---|---|---|
Bouffalo-Labor | BL602 | ||
BL702 | |||
Espressif | ESP32 | OTA-Tests | |
Nordischer Halbleiter | nRF52840 DK | OTA-Tests | |
NXP | IOTZTB-DK006 Entwicklungskit | ||
Realtek | Ameba D-Serie | ||
Logo: Silicon Labs | EFR32MG24-Entwicklerkit | ||
EFR32MG Zigbee und Thread-Starterkit | |||
Telink | TLSR9518 | ||
Texas Instrumente | CC2652R7 LaunchPad-Entwicklungskit |
Anbieter-ID
Standardmäßig kannst du zu Testzwecken eine der von der CSA zugewiesenen VIDs 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 verifizieren lassen, um sicherzugehen, dass sie von der CSA für dich ausgestellt wurde.
Diese VID sollte in der Firmware deines Geräts implementiert sein.
Ein Matter-Gerät kann nur bei bestimmten Anbieter-IDs und Gerätetypen im Google Home-System gekoppelt werden.
- Eine Test-VID kann auf einem Verbrauchergerät nicht 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 in der Google Home Developer Console verwenden kannst. Danach kannst du Integrationen für diese VID erstellen.
- Für Entwicklungs- und Field Trial-Zwecke müssen ein Projekt und die Integration mit der entsprechenden Kombination aus VID und PID in der Developer Console erstellt werden. Der Nutzer, der das Gerät in Betrieb nimmt, muss entweder Mitglied des Projekts oder in der Liste der Field-Trial-Nutzer enthalten sein.
- Privatnutzer können Ihr Produkt erst verwenden, wenn es durch die Alliance zertifiziert wurde.
Welche Nutzer können das Gerät für das Google Home-System in Betrieb nehmen? | |||
---|---|---|---|
VID-Typ | VID-Zertifizierung und Integrationsstatus der Konsole | Produktion
(Privatnutzer) |
Entwicklung
(Entwickler, Field-Trial-Nutzer) |
Testen | Keine Integration in Developer Console (kann nicht zertifiziert werden) | ||
Testen | Integration ist in Developer Console vorhanden (kann nicht zertifiziert werden) | ||
Produktion | Nicht zertifiziert, die Integration ist in Developer Console nicht vorhanden | ||
Produktion | Nicht zertifiziert, Integration existiert in Developer Console | ||
Produktion | Im Alliance DCL zertifiziert, Integration ist in Developer Console nicht vorhanden | ||
Produktion | Im Alliance DCL zertifiziert und Integration ist in Developer Console vorhanden |
Produkt-ID
Informationen zum Gerät werden aus dem Matter-Cluster mit grundlegenden Informationen gelesen. 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 noch nicht für Nutzer verfügbar, werden aber möglicherweise vom System verwendet. In den meisten Fällen bedeutet dies, dass über diese Cluster freigegebene Attribute für Endnutzer nicht sichtbar sind:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
1 Weitere Informationen zu den Auswirkungen auf die Ein-/Aus-Lichtschalter finden Sie unter Ein-/Aus-Lichtschalter.