Mater-Gerät koppeln

Koppeln Sie Ihr Matter-fähiges Gerät. Dazu benötigen Sie einen QR-Code zum Koppeln. Je nach Plattform Ihres Matter-Geräts müssen Sie diesen QR-Code möglicherweise selbst generieren.

QR-Code anfordern

Bouffalo-Labor

BL602

Der QR-Code-String wird beim Hochfahren des Geräts in der seriellen Konsole ausgegeben. Überprüfen Sie Ihre serielle Konsole. Sie sollten folgende Meldungen sehen:

Booting BL602 Chip...
██████╗ ██╗      ██████╗  ██████╗ ██████╗
██╔══██╗██║     ██╔════╝ ██╔═████╗╚════██╗
██████╔╝██║     ███████╗ ██║██╔██║ █████╔╝
██╔══██╗██║     ██╔═══██╗████╔╝██║██╔═══╝
██████╔╝███████╗╚██████╔╝╚██████╔╝███████╗
╚═════╝ ╚══════╝ ╚═════╝  ╚═════╝ ╚══════╝
...
[INFO] ==================================================
[INFO] chip-bl602-lighting-example starting
[INFO] ==================================================
...
[INFO] [SVR] SetupQRCode: [MT:NOTAREALQRCODE01234]
[INFO] [SVR] Copy/paste the below URL in a browser to see the QR Code:
[INFO] [SVR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%NOTAREALQRCODE01234
...

Öffnen Sie den Link in einem Webbrowser, um sich den QR-Code anzeigen zu lassen.

BL702

Der QR-Code-String wird beim Hochfahren des Geräts in der seriellen Konsole ausgegeben. Überprüfen Sie Ihre serielle Konsole. Dort sollten Nachrichten wie diese angezeigt werden:

[         0][-][PROGR] ==================================================
[         0][-][PROGR] bouffalolab chip-lighting-example, built at Dec 14 2022 02:05:19
[         0][-][PROGR] ==================================================
...
[      1636][-][PROGR] Starting OpenThread task
[      1655][DL][PROGR] Device Configuration:
[      1703][DL][PROGR]   Serial Number: TEST_SN
[      1703][DL][PROGR]   Vendor Id: 65521 (0xFFF1)
[      1703][DL][PROGR]   Product Id: 32773 (0x8005)
[      1752][DL][PROGR]   Hardware Version: 0
[      1799][DL][PROGR]   Setup Pin Code (0 for UNKNOWN/ERROR): 20202021
[      1846][DL][PROGR]   Setup Discriminator (0xFFFF for UNKNOWN/ERROR): 3840 (0xF00)
[      1893][DL][PROGR]   Manufacturing Date: (not set)
[      1893][DL][PROGR]   Device Type: 65535 (0xFFFF)
[      1987][SVR][PROGR] SetupQRCode: [MT:NOTAREALQRCODE01234]
[      1987][SVR][PROGR] Copy/paste the below URL in a browser to see the QR Code:
[      1988][SVR][PROGR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%NOTAREALQRCODE01234

      

Espressif

Getting the QR code differs for each type of ESP32-based kit:

ESP32 DevkitC

  1. Connect the device to a host machine and use a serial terminal to connect to it and display its logs. For example, on a Linux host machine, you might use screen /dev/ttyUSB0 115200 to connect to the device and view logs if it is attached to the host at /dev/ttyUSB0.
  2. A URL is displayed in the logs when the device is first booted. Open the link in a web browser to display the QR code.

M5Stack ESP32

When first booted, the device will display a QR code menu option. Select it to see the QR code in the device's display.

ESP32 WROVER Kit

The device shows the QR code immediately after booting.

Nordic Semiconductor

nRF52840

Since the nRF52840 board doesn't have a display, the QR code string is printed in the serial console when it boots up. For example:

I: 1317 [SVR]SetupQRCode:  [MT:I347HHY00 0C9SS0]
I: 1321 [SVR]Copy/paste the below URL in a browser to see the QR Code:
I: 1327 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI347HHY00%200C9SS0

Öffnen Sie den Link in einem Webbrowser, um sich den QR-Code anzeigen zu lassen.

NXP

K32W

Der QR-Code-String wird beim Hochfahren des Geräts in der seriellen Konsole ausgegeben. Überprüfen Sie Ihre serielle Konsole. Sie sollten folgende Meldungen sehen:

[Info]Welcome to NXP Lighting Demo App
[Info]OpenThread started: OK
...
[Info]Server Listening...
[Info]SetupQRCode:  [MT:I34DVDY00 0C9SS0]
[Info]Copy/paste the below URL in a browser to see the QR Code:
[Info]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI34DVDY00%200C9SS0
...

Öffnen Sie den Link in einem Webbrowser, um sich den QR-Code anzeigen zu lassen.

Realtek

Ameba D

Der QR-Code ist in einer URL codiert, die beim Start der Ameba D-Karte in der seriellen Konsole ausgegeben wird:

Setup PIN code: 20202021 (0x1344225)
Short Manual(decimal) setup code: 34970112332
Long Manual(decimal) setup code:  749701123309050652796
QR CODE Text: 'MT:NOTAREALQRCODE01234'
Copy/paste the below URL in a browser to see the QR CODE:

https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234

Öffnen Sie den Link in einem Webbrowser, um sich den QR-Code anzeigen zu lassen.

Logo: Silicon Labs

EFR32MG12

Nach dem Start des Boards sollten Sie auf dem kleinen LCD-Display einen QR-Code finden.

TLSR9518

Der QR-Code-String wird beim Hochfahren des Geräts in der seriellen Konsole ausgegeben. Prüfen Sie die serielle Konsole. Sie sollten eine URL sehen, die beim Öffnen in einem Browser den QR-Code anzeigt:

*** Booting Zephyr OS build v3.1.0-rc1-3593-gdac17979d626  ***
I: Init CHIP stack
I: Starting CHIP task
…
I: 812 [DL]BLEManagerImpl::ConfigureAdvertisingData
I: 823 [DL]Setting device name to : "TelinkMatter"
…
I: 1093 [SVR]SetupQRCode: [MT:NOTAREALQRCODE01234]
I: 1099 [SVR]Copy/paste the below URL in a browser to see the QR Code:
I: 1107 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234

Gerät koppeln

Es gibt zwei Möglichkeiten, das Gerät zu koppeln:

  1. Google Home app (GHA)
  2. Die SDKs für Google Home Mobile und das Thread-Werbenetzwerk für Android (die in einer Drittanbieter-App verwendet werden können)

Bei beiden Methoden werden dieselben Netzwerk-APIs Matter und Thread verwendet.

Google Home App

  1. Öffnen Sie GHA.
  2. Tippen Sie oben links auf das .
  3. Tippen Sie auf Gerät einrichten.
  4. Tippen Sie auf Neues Gerät.
  5. Wählen Sie Ihr Zuhause aus und tippen Sie auf Weiter.
  6. GHA sucht nach deinem Gerät. Wenn Sie gefragt werden, ob Sie Ihr Gerät einrichten möchten, tippen Sie auf Anderes Gerät einrichten.
  7. Tippen Sie für einen beliebigen Gerätetyp auf das Matter-Gerät.
  8. Richten Sie Ihre Kamera auf den QR-Code Ihres Geräts (oder auf den von der Website generierten QR-Code).
  9. Fahren Sie mit dem Kopplungsprozess fort, wie im GHA-Ablauf beschrieben.

Wenn beim Koppeln mit GHA auf deinem Mobilgerät Probleme auftreten:

  1. Auf Ihrem Mobilgerät müssen die Entwickleroptionen aktiviert sein.
  2. Erstellen Sie unmittelbar nach dem fehlgeschlagenen Kopplungsversuch einen Fehlerbericht.

Android-SDKs

Implementiere unsere Android SDKs, um Matter-Geräte zu koppeln und Thread-Netzwerke in deiner App zu verwalten.

In Play services wurden Android SDKs zum Testen und Koppeln in einer Drittanbieter-App zur Verfügung gestellt.

Wir empfehlen dir, mit Google Home Sample App for Matter zu beginnen. Dort siehst du, wie ein Matter-fähiges Gerät im Google Home-System mit diesen SDKs in Betrieb genommen, gekoppelt und gesteuert wird.

Die Referenzdokumentation für beide SDKs finden Sie auf dieser Website:

Kopplungseinschränkungen

Ein Matter-Gerät kann nur bei bestimmten Anbieter-IDs und Gerätetypen im Google Home-System gekoppelt werden.

  • Eine Test-VID kann auf einem Verbrauchergerät nicht verwendet werden.
  • Deine Produktions-VID muss von der Connectivity Standards Alliance (Alliance) ausgestellt werden. Google überprüft, ob du der Inhaber dieser VID bist, bevor du sie in der Google Home Developer Console verwenden kannst. Danach kannst du Integrationen für diese VID erstellen.
  • Für Entwicklungs- und Field Trial-Zwecke müssen ein Projekt und die Integration mit der entsprechenden Kombination aus VID und PID in der Developer Console erstellt werden. Der Nutzer, der das Gerät in Betrieb nimmt, muss entweder Mitglied des Projekts oder in der Liste der Field-Trial-Nutzer enthalten sein.
  • Privatnutzer können Ihr Produkt erst verwenden, wenn es durch die Alliance zertifiziert wurde.
Tabelle: Szenarien für die Kopplung von Anbieter-ID (VID) und Gerätetyp
Welche Nutzer können das Gerät für das Google Home-System in Betrieb nehmen?
VID-Typ VID-Zertifizierung und Integrationsstatus der Konsole Produktion
(Privatnutzer)
Entwicklung
(Entwickler, Field-Trial-Nutzer)
Testen Keine Integration in Developer Console (kann nicht zertifiziert werden)
Testen Integration ist in Developer Console vorhanden (kann nicht zertifiziert werden)
Produktion Nicht zertifiziert, die Integration ist in Developer Console nicht vorhanden
Produktion Nicht zertifiziert, Integration existiert in Developer Console
Produktion Im Alliance DCL zertifiziert, Integration ist in Developer Console nicht vorhanden
Produktion Im Alliance DCL zertifiziert und Integration ist in Developer Console vorhanden

Geräteinformationen

Technische Informationen zum gekoppelten Gerät findest du in der GHA.

  1. Wählen Sie in der GHA das Gerät aus.
  2. Tippen Sie rechts oben auf das Symbol .
  3. Tippen Sie auf Technische Daten.

Kennungen wie Hersteller, Modell und Hardwareversion stammen aus der Matter-Firmware des Geräts, nicht von der Developer Console. Beispiel: die Werte für CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME und CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME in der Gerätekonfiguration im Matter SDK.

Diese Kennzeichnungen können hilfreich sein, um zu prüfen, welches Gerät für Testzwecke gekoppelt wurde, insbesondere wenn eine Testanbieter-ID und eine Produkt-ID (die in verschiedenen Integrationen dupliziert werden können) verwendet werden.

Fehlerbehebung beim Koppeln

Wenn du ein Gerät mit einer Testanbieter-ID (VID) und einer Produkt-ID (PID) gekoppelt hast, diese aber nicht erscheint, wenn du versuchst, das Gerät mit der Test-Suite in Developer Console zu testen, wird dies wahrscheinlich durch die Verwendung derselben Kombination aus Test-VID und PID für mehrere Integrationen verursacht.

Entfernen Sie zur Fehlerbehebung alle Testgeräte aus Developer Console und koppeln Sie das Gerät, das Sie noch einmal testen möchten.

Du kannst prüfen, ob du das richtige Pairing gekoppelt hast, indem du die Hersteller- und Modellinformationen (CHIP_DEVICE_CONFIG_DEVICE_*-Werte) für das Gerät in deiner Testfirmware auf eindeutige Werte setzt.

Weitere Informationen finden Sie unter Geräteinformationen.