Mit dem Home Developer-Programm von Google können Gerätehersteller ihre Smart-Home-Geräte mit dem Google Home-System verbinden. Wir erweitern den lokalen Ablauf für Smart-Home-Aktionen, sodass Sie Matter-kompatible Geräte zur Einrichtung über die Google Home app (GHA) hinzufügen und sie über Google Assistant, GHA oder Smart Displays wie das Google Nest Hub (2nd gen) steuern können.
In dieser Dokumentation wird beschrieben, wie Sie eine von Matter unterstützte Plattform erstellen und in das Google Home-System einbinden.
Haftungsausschlüsse
Beachten Sie bei den in der Matter-Dokumentation beschriebenen Verfahren Folgendes:
- Wir empfehlen, für das für die Entwicklung verwendete Konto nur einen einzigen Matter-kompatiblen Hub für Tests zu verwenden. Wenn mehrere Matter-kompatible Hubs gleichzeitig 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 Sie ein Linux-System mit Ubuntu 20.04 verwenden, um Matter-Samples zu erstellen und zu flashen. Diese Samples wurden von Google getestet. macOS-Computer werden zwar unterstützt, wir empfehlen jedoch Linux. Mac-spezifische Anleitungen werden bei Bedarf in den Verfahren aufgeführt.
So erstellen Sie ein Projekt
Wenn Sie ein Matter-kompatibles Gerät entwickeln möchten, das in das Google Home-System eingebunden werden kann, benötigen Sie ein Matter-kompatibles Entwicklungsboard und das Matter SDK.
Am einfachsten ist es, mit unseren Codelabs zu beginnen. Wir empfehlen, mindestens eines der folgenden Codelabs zu absolvieren:
Sehen Sie dann in der Liste der unterstützten Geräte nach, ob das Gerät, das Sie einbinden möchten, von Google Home unterstützt wird. Lesen Sie dann die Entwickler-Checkliste, um den gesamten Entwicklungsablauf von der Projekterstellung bis zur Markteinfü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 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 das ein Build oder eine Beispiel-App mit aktiviertem Matter geflasht wurde.
- Mobilgerät
- Das Test-Smartphone, das bei der Kopplung verwendet wird. Derzeit ist das ein Android.
Vorbereitung
Damit ein Entwickler ein Matter-kompatibles Gerät vollständig in das Google Home-System einbinden kann, muss er Folgendes haben:
- Ein Google-Hub mit Thread-Unterstützung, der sowohl als Border-Router für Thread-kompatible Geräte als auch als lokaler Pfad für die Ausführung 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-kompatible Gerät.
- Ein Matter-kompatibles Gerät. Dieses Gerät muss zu den Matter Gerätetypen gehören, die im Google Home-System unterstützt werden. Beispiele:
- Ihr 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 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 kannst du eine der von der CSA zu Testzwecken zugewiesenen VIDs verwenden. Wählen Sie einen der folgenden Werte aus: 0xFFF1
, 0xFFF2
, 0xFFF3
oder 0xFFF4
.
Wenn Sie eine Produktions-VID verwenden möchten, damit Ihre Integration zertifiziert und eingeführt werden kann, muss sie zuerst von Google verifiziert werden, um sicherzustellen, dass sie Ihnen von der CSA ausgestellt wurde.
Diese VID sollte in der Firmware Ihres Geräts implementiert sein.
Ein Matter-Gerät kann im Google Home-System nur in bestimmten Szenarien mit Anbieter-ID und Gerätetyp gekoppelt werden.
- Eine Test-VID kann nicht auf einem Verbrauchergerät verwendet werden.
- Deine 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. Danach kannst du Integrationen für diese VID erstellen.
- Für Entwicklungs- und Feldtests 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 Nutzer des Feldtests aufgeführt sein.
- Verbraucher können Ihr Produkt erst verwenden, wenn es von der Alliance zertifiziert wurde.
VID und PID können für eine Integration nur einmal verwendet werden. Wenn du dieselbe VID oder PID in deiner Integration verwenden möchtest, musst du Folgendes tun:
- Bearbeiten Sie die Integration und ändern Sie die VID oder PID in eine andere.
- Löschen Sie die Verknüpfung mithilfe der VID oder PID.
Welche Nutzer können das Gerät in das Google Home-System einbinden? | |||
---|---|---|---|
VID-Typ | Status der VID-Zertifizierung und der Konsolenintegration | Produktion
(Privatnutzer) |
Entwicklung
(Entwickler, Nutzer des Feldtests) |
Test | Keine Integration in der Developer Console (kann nicht zertifiziert werden) | ||
Test | Die Integration ist in der Developer Console vorhanden (kann nicht zertifiziert werden) | ||
Produktion | Nicht zertifiziert, Integration ist in Developer Console nicht vorhanden | ||
Produktion | Nicht zertifiziert, Integration ist in der Developer Console vorhanden | ||
Produktion | Im Alliance-DCL zertifiziert, Integration ist in der Developer Console nicht vorhanden | ||
Produktion | Zertifiziert in der Alliance-DCL und Integration ist in der 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 sichtbar, werden aber möglicherweise vom System verwendet. In den meisten Fällen bedeutet das, dass Attribute, die über diese Cluster freigegeben werden, für Endnutzer nicht sichtbar sind:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
¹ Weitere Informationen zu Lichtschaltern