Erste Schritte mit „Rechtsangelegenheit“

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Entwicklervorschau-Release

Mit dem Google Home-Entwicklerprogramm können Gerätehersteller ihre Smart-Home-Geräte mit der Google Home-Umgebung verbinden. Wir erweitern den lokalen Pfad für die Auftragsausführung von Smart Home Actions um die Möglichkeit, Matter-fähige Geräte zur Einrichtung mit Google Home app (GHA) auf Android-Geräten hinzuzufügen und mit Google Assistant, GHA oder Smart Displays wie Google Nest Hub (2nd gen) zu steuern.

In dieser Dokumentation werden die ersten Schritte zum Erstellen und Integrieren einer von Matter unterstützten Plattform in der Google Home-Umgebung beschrieben.

Angaben zum Haftungsausschluss

Beachten Sie in Bezug auf die in dieser Entwicklervorschau von Matter beschriebenen Verfahren Folgendes:

  • Das für die Entwicklung verwendete Konto sollte nur einen einzigen Matter-fähigen Hub zum Testen haben. Mehrere Matter-fähige Hubs, die gleichzeitig oder während der Tests mit derselben Struktur verbunden sind, können zu unvorhersehbarem Verhalten führen.
  • Bei allen Verfahren wird eine Linux-Maschine verwendet, auf der Ubuntu 20.04 ausgeführt wird, um Matter-Beispiele zu erstellen und zu blinken, die von Google getestet wurden. MacOS-Maschinen werden zwar unterstützt, Linux wird aber empfohlen. Mac-spezifische Anleitungen werden bei Bedarf in den Verfahren beschrieben.
  • Nur die Android-Version von GHA wird unterstützt.

Definitionen

Die folgenden Begriffe werden in dieser Dokumentation verwendet:

Border-Router
Ein Hub, der einen universellen Allround-Thread-Border-Router für Geräte mit aktiviertem Thread 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 geladen wurde.
Mobilgerät
Das für die Kopplung verwendete Testtelefon. Dies ist derzeit ein Smartphone von Android.

Voraussetzungen

Empfohlene IDE-Erweiterungen für die Matter-Entwicklung

Damit ein Matter-fähiges Gerät vollständig in die Google Home-Umgebung integriert werden kann, muss ein Entwickler folgende Voraussetzungen erfüllen:

  1. 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.
  2. Ein Mobilgerät (Testtelefon), das die Mindestanforderungen erfüllt:
    • Android O (8.1, API-Level 27) oder höher (iOS-Unterstützung wird später hinzugefügt)
    • BLE-Funktion
  3. Eine Anbieter-ID (VID) und eine Produkt-ID (PID) für das Matter-fähige Gerät.
  4. Ein Matter-fähiges Gerät. Dieses Gerät sollte einem der Matter-Gerätetypen entsprechen, die derzeit in der Google Home-Umgebung unterstützt werden. Das könnte folgende Eigenschaften haben:
    • Ihr eigenes Produkt mit Matter-fähiger Firmware
    • Ein Entwicklungsboard einer unterstützten Anbieterplattform, das als Matter-fähiges Gerät für die End-to-End-Überprüfung dienen kann. Folgende Plattformen werden unterstützt:
Tabelle: Matter Beispiele von Anbietern von Silikonen
Vendor Plattform Leitfäden Support der Stufe „Thread
Bouffalo-Labor BL602 Kurzanleitung
BL702 Kurzanleitung
Espressif ESP 32 Kurzanleitung
OTA-Tests
Nordischer Halbleiter nRF52840 DK Kurzanleitung
OTA-Tests
Logo: NXP IOTZTB-DK006 Entwicklungskit Kurzanleitung
Realtek Ameba D-Serie Kurzanleitung
Silicon Labs Start-Kit Zigbee und Thread mit EFR32MG Kurzanleitung
EFR32MG24-Entwicklungskit Kurzanleitung
TeLink TLSR9518 Kurzanleitung

Anbieter-ID

Standardmäßig können Sie eine der vom CSA zugewiesenen VIDs zu Testzwecken 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 gestartet werden kann, müssen Sie sie zuerst von Google überprüfen lassen, damit sie von der CSA 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-System gekoppelt werden.

Tabelle: Anbieter-ID (VID) und Kopplungstypen für Gerätetypen
Welche Nutzer können das Gerät in das Google Home-System einbinden?
VID-Typ VID-Zertifizierung und Registrierungsstatus Produktion
(Nutzer)
Entwicklung
(Entwickler, Nutzer von Field Trials)
Test Nicht registriert (kann nicht zertifiziert werden)
Test Registriert in Developer Console (kann nicht zertifiziert werden)
Produktion Nicht zertifiziert, nicht registriert
Produktion Nicht zertifiziert, registriert im Developer Console
Produktion Im CSD-DCL zertifiziert, nicht registriert
Produktion Im CSA-DCL zertifiziert und im Developer Console registriert

Produkt-ID

Informationen zum Gerät werden über die Matter-Deskriptorcluster und nicht über die Produkt-ID gelesen. Sie können während der Entwicklung eine Produkt-ID gemäß dem Nummerierungsschema Ihres Unternehmens zuweisen, sofern sie mit der Produkt-ID Ihrer Matter-Integration übereinstimmt, sofern angegeben.

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 Attribute, die über diese Cluster verfügbar gemacht werden, für Endnutzer nicht sichtbar sind:

Tabelle: Matter Cluster, die Nutzern im Google Home-Netzwerk nicht zugänglich sind
Clustertyp Cluster
Kernprodukt
  • Bindung
  • Label
  • Festes Label
  • Nutzerlabel
  • Aktionen
  • Gruppenschlüssel
  • Lokalisierungskonfiguration
  • Lokalisierung des Zeitformats
  • Lokalisierung von Einheiten
  • Energiequellenkonfiguration
  • Stromquelle
  • Diagnosecluster (Diagnose-Logs, allgemeine Diagnosen, Softwarediagnosen, Thread-Netzwerkdiagnosen, WLAN-Netzwerkdiagnosen, Ethernet-Netzwerkdiagnose)
  • Zeitsynchronisierung
  • Modusauswahl
Anwendung
  • Gruppen und Szenen werden nicht direkt unterstützt. Entsprechende Funktionen sind über Abläufe verfügbar.
  • Alle Mediacluster. Entsprechende Funktionen sind über Google Cast verfügbar.