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 Auftragsausführungspfad für Smart Home Actions um die Möglichkeit Matter -enabled devices for setup using the Google Home app (GHA) on Android and control them using Google Assistant , GHA, or smart displays like the Google Nest Hub (2nd gen) .

In dieser Dokumentation werden die ersten Schritte zum Erstellen und Einbinden einer von Matter unterstützten Plattform in das Google Home-System 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 des Tests mit derselben Struktur verbunden sind, können zu unerwartetem Verhalten führen.
  • Bei allen Verfahren wird davon ausgegangen, dass Sie eine Linux-Maschine verwenden, auf der Ubuntu 20.04 zum Erstellen und Blinken von Matter-Beispielen ausgeführt wird, 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.
  • Es wird nur die Android-Version von GHA unterstützt.

Definition

Die folgenden Begriffe werden in dieser Dokumentation verwendet:

Border-Router
Ein Hub, der einen Universalzweck implementiert Thread Border Router for Thread-enabled devices.
Hub
Google Nest device, such as the Google Nest Hub (2nd gen). A hub is required to control Matter-enabled devices through other surfaces such as Assistant, the GHA, and smart displays. unterstützt
Matter-fähiges Gerät
Ein Gerät oder Entwicklungsboard, das mit einer Matter-fähigen Build- oder Beispiel-App geflasht wurde.
Mobilgerät
Das für die Kopplung verwendete Testtelefon. Das ist derzeit eine Android phone..

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 Gerät, für das Matter aktiviert ist.
  4. Ein Matter-fähiges Gerät. Dieses Gerät sollte zu den Matter-Gerätetypen gehören, die derzeit in der Google Home-Umgebung unterstützt werden, und:
    • 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 Silikonanbietern
Vendor Plattform Leitfäden Support der Stufe „Thread
Bouffalo-Labor BL602 Kurzanleitung
BL702 Kurzanleitung
Espressif ESP32 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.

  • Eine Test-VID kann in einem Nutzergerät nicht verwendet werden.
  • Damit ein Produktionsgerät (Verbrauchergerät) gekoppelt werden kann, muss es im benutzerdefinierten DCL zertifiziert sein.
  • Für Entwicklungs- und Testzwecke muss ein Gerät im Google Home Developer Console registriert sein.
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 im Developer Console (kann nicht zertifiziert werden)
Produktion Nicht zertifiziert, nicht registriert
Produktion Nicht zertifiziert, registriert in 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 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.