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
Damit ein Matter-fähiges Gerät vollständig in die Google Home-Umgebung integriert werden kann, muss ein Entwickler folgende Voraussetzungen erfüllen:
- 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.
- 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
- Eine Anbieter-ID (VID) und eine Produkt-ID (PID) für das Gerät, für das Matter aktiviert ist.
- 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:
| 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.
| 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:
| Clustertyp | Cluster |
|---|---|
| Kernprodukt |
|
| Anwendung |
|