Mit dem Home Developer-Programm 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 Actions um die Möglichkeit, Matter-fähige Geräte für die Einrichtung mit 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 das für die Entwicklung verwendete Konto nur einen einzigen Matter-fähigen Hub für Tests verbunden hat. 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 davon ausgegangen, dass eine Linux-Maschine 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 in den Verfahren nach Bedarf angegeben.
Erstellung
Wenn Sie ein Matter-fähiges Gerät entwickeln möchten, das in das Google Home-Ökosystem eingebunden wird, benötigen Sie ein Matter-kompatibles Entwicklungsboard und das Matter-SDK.
Am einfachsten ist es, wenn Sie sich unsere Codelabs ansehen. Wir empfehlen, mindestens eines der folgenden Codelabs zu absolvieren:
Sehen Sie sich dann unsere Liste der unterstützten Geräte an, um zu prüfen, ob die Geräte, die Sie integrieren möchten, im Google Home-Ökosystem unterstützt werden. Lesen Sie sich anschließend die Checkliste für Entwickler durch, um den gesamten Entwicklungsablauf von der Projekterstellung bis zum Start 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 Entwicklerboard, auf dem ein mit Matter aktivierter Build oder eine Beispiel-App geflasht wurde.
- Mobilgerät
- Das Test-Smartphone, das zum Koppeln verwendet wurde. Derzeit ist dies ein Android-Smartphone.
Vorbereitung
Damit ein Matter-kompatibles Gerät vollständig in das Google Home-Ökosystem eingebunden werden kann, muss ein Entwickler Folgendes haben:
- Ein Google-Hub mit Thread-Unterstützung, der sowohl als Border-Router für Thread-kompatible Geräte als auch als Pfad für die lokale Ausführung zum Weiterleiten von Smart Home-Intents dient.
- Ein Mobilgerät (Testsmartphone), 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-kompatibles Gerät. Dieses Gerät sollte einer der Matter-Gerätetypen sein, die im Google Home-Ökosystem unterstützt werden. Es kann sich um Folgendes handeln:
- Ihr eigenes Produkt mit Matter-fähiger Firmware.
- Eines der folgenden Matter-Geräte für die End-to-End-Ü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 | TLSR9528 | Telink Matter Developer Guide | |
| Texas Instruments | CC2652R7 LaunchPad-Entwicklungskit |
Anbieter-ID
Standardmäßig können Sie eine der von der Alliance zu Testzwecken zugewiesenen VIDs 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 eingeführt werden kann, müssen Sie sie zuerst von Google verifizieren lassen, um sicherzustellen, dass sie von der Alliance ausgestellt wurde.
Diese VID muss in der Firmware Ihres Geräts implementiert werden.
Ein Matter-Gerät kann im Google Home-Ökosystem nur in bestimmten Szenarien mit Anbieter-ID und Gerätetyp gekoppelt werden.
- Eine Test-VID kann nicht auf einem Verbrauchergerät verwendet werden.
- Ihre Produktions-VID muss von 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 können Sie Integrationen für diese VID erstellen.
- Für Entwicklungs- und Field Trial-Zwecke muss ein Projekt und eine Integration mit der entsprechenden VID- und PID-Kombination 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 Field Trial-Nutzer enthalten sein.
- Endnutzer können Ihr Produkt erst verwenden, wenn es von 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 in das Google Home-Ökosystem einbinden? | |||
|---|---|---|---|
| VID-Typ | VID-Zertifizierung und Konsolenintegrationsstatus | Produktion
(Privatnutzer) |
Entwicklung
(Entwickler, Field Trial Nutzer) |
| Test | Keine Integration in Developer Console (kann nicht zertifiziert werden) | ||
| Test | Die Integration ist in 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 | Die Integration ist in der Alliance-Gerätekonfigurationssprache zertifiziert, aber nicht in Developer Console vorhanden. | ||
| Produktion | Zertifiziert für die Alliance-DCL und Integration in Developer Console vorhanden | ||
Produkt-ID
Informationen zum Gerät werden aus dem Matter-Cluster „Basic Information“ (Grundlegende Informationen) 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 werden Nutzern noch nicht angezeigt, können aber 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 hier.