Mit dem Google Home Developer Program 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-fähige Geräte für die 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 wird beschrieben, wie du mit dem Erstellen und Integrieren einer von Matter unterstützten Plattform in das Google Home-Ökosystem beginnst.
Haftungsausschlüsse
Beachten Sie in Bezug auf die in der Matter-Dokumentation beschriebenen Verfahren Folgendes:
- Wir empfehlen, dass das für die Entwicklung verwendete Konto nur einen einzigen Matter-fähigen Hub hat, der zu Testzwecken verbunden ist. Wenn mehrere Matter-fähige Hubs gleichzeitig verbunden sind oder während des Tests mit demselben Gebäude verbunden sind, kann dies zu unvorhersehbarem Verhalten führen.
- Bei allen Verfahren wird davon ausgegangen, dass ein Linux-Computer mit Ubuntu 20.04 verwendet wird, um Matter-Beispiele zu erstellen und zu flashen, die von Google getestet wurden. macOS-Computer werden zwar unterstützt, Linux wird jedoch empfohlen. Mac-spezifische Anweisungen werden in den Verfahren nach Bedarf hervorgehoben.
Erstellen
Wenn du ein Matter-fähiges Gerät entwickeln möchtest, das in das Google Home-Ökosystem integriert ist, benötigst du ein Matter-kompatibles Entwicklungsboard und das Matter SDK.
Am einfachsten ist es, wenn Sie unsere Codelabs durchgehen. Wir empfehlen, mindestens eines der folgenden Codelabs durchzuarbeiten:
Prüfe anschließend in unserer Liste der unterstützten Geräte, ob die Geräte, die du integrieren möchtest, im Google Home-Ökosystem unterstützt werden. Lies dann die Checkliste für Entwickler, um den gesamten Entwicklungsablauf von der Projekterstellung bis zur Einführung 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 Thread-Border-Router für allgemeine Zwecke 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 das ein Matter-fähiger Build oder eine Beispiel-App geflasht wurde.
- Mobilgerät
- Das Test-Smartphone, das für die Kopplung verwendet wurde. Derzeit ist dies 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 (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
- 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-Ökosystem unterstützt werden, und 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:
| 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 kannst du eine der von der Alliance zugewiesenen VIDs zu Testzwecken verwenden. Wählen Sie eine der folgenden Optionen aus: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Damit du eine Produktions-VID verwenden kannst, um deine Integration zertifizieren und einführen zu lassen, muss sie zuerst von Google verifiziert werden, um sicherzustellen, dass sie dir von der Alliance ausgestellt wurde.
Diese VID sollte in der Firmware deines Geräts implementiert sein.
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.
- Deine Produktions-VID muss von der Connectivity Standards Alliance (Alliance) ausgestellt sein. Google prüft, ob Sie der Inhaber dieser VID sind, bevor Sie sie in der Google Home Developer Console verwenden können. Anschließend können Sie Integrationen für diese VID erstellen.
- Für Entwicklungs- und Field Trial-Zwecke müssen 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.
- Privatnutzer 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 du dieselbe VID oder PID in deiner Integration verwenden möchtest, musst du entweder:
- Ändere die VID oder PID der Integration in eine andere VID oder PID.
- Lösche die Integration mithilfe der VID oder PID.
| Welche Arten von Nutzern können das Gerät im Google Home-Ökosystem in Betrieb nehmen? | |||
|---|---|---|---|
| VID-Typ | VID-Zertifizierung und Status der Integration in die Console | Produktion
(Privatpersonen) |
Entwicklung
(Entwickler, Field Trial Nutzer) |
| Test | Keine Integration in Developer Console (kann nicht zertifiziert werden) | ||
| Test | Die Integration ist in der 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 | In der Alliance-DCL zertifiziert, Integration ist in der Developer Console nicht vorhanden | ||
| Produktion | In der Alliance-DCL zertifiziert und Integration in der Developer Console vorhanden | ||
Produkt-ID
Informationen zum Gerät werden aus dem Matter-Cluster für grundlegende 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 für Nutzer noch nicht sichtbar, können aber vom System verwendet werden. In den meisten Fällen bedeutet dies, 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 dies auf Lichtschalter auswirkt, findest du unter Lichtschalter.