Matter-Gerät koppeln

Kopple dein Matter-fähiges Gerät. Dazu benötigst du einen QR‑Code für die Kopplung. Je nach Plattform deines Matter Geräts musst du diesen QR‑Code selbst generieren.

QR‑Code abrufen

Bouffalo Lab

BL602

Die QR‑Code-String wird in der seriellen Konsole ausgegeben, wenn das Gerät hochgefahren wird. In der seriellen Konsole sollten Meldungen wie die folgenden angezeigt werden:

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
...

Öffne den Link in einem Webbrowser, um den QR‑Code anzuzeigen.

BL702

Die QR‑Code-String wird in der seriellen Konsole ausgegeben, wenn das Gerät hochgefahren wird. In der seriellen Konsole sollten Meldungen wie die folgenden 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

Öffne den Link in einem Webbrowser, um den QR‑Code anzuzeigen.

NXP

K32W

Die QR‑Code-String wird in der seriellen Konsole ausgegeben, wenn das Gerät hochgefahren wird. In der seriellen Konsole sollten Meldungen wie die folgenden angezeigt werden:

[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
...

Öffne den Link in einem Webbrowser, um den QR‑Code anzuzeigen.

Realtek

Ameba D

Der QR‑Code ist in einer URL codiert, die in der seriellen Konsole ausgegeben wird, wenn das Ameba D-Board hochgefahren 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

Öffne den Link in einem Webbrowser, um den QR‑Code anzuzeigen.

Silicon Labs

EFR32MG12

Nach dem Hochfahren des Boards sollte auf dem kleinen LCD ‑Display ein QR‑Code angezeigt werden.

TLSR9518

Die QR‑Code-String wird in der seriellen Konsole ausgegeben, wenn das Gerät hochgefahren wird. In der seriellen Konsole sollte eine URL angezeigt werden, die den QR‑Code anzeigt, wenn sie in einem Browser geöffnet wird: 

*** 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. Mobile SDKs und Thread Network SDKs von Google für Android (die in einer Drittanbieter-App verwendet werden können)

Bei beiden Methoden werden dieselben Matter und Thread Network APIs verwendet.

Google Home App

  1. Öffne die GHA.
  2. Tippe oben links auf das .
  3. Tippe auf Gerät einrichten.
  4. Tippe auf Neues Gerät.
  5. Wähle dein Zuhause aus und tippe auf Weiter.
  6. GHA sucht nach deinem Gerät. Wenn du gefragt wirst, ob du dein Gerät einrichten möchtest, tippe auf Anderes Gerät einrichten.
  7. Tippe für jeden Gerätetyp auf Matter Gerät.
  8. Halte die Kamera auf den QR‑Code deines Geräts (oder den auf der Website generierten QR‑Code).
  9. Setze den Kopplungsvorgang wie im GHA Ablauf beschrieben fort.

Wenn beim Koppeln mit der GHA auf deinem Mobilgerät Probleme auftreten, gehe so vor:

  1. Vergewissere dich, dass die Entwickler optionen für dein Mobilgerät aktiviert sind.
  2. Erstelle direkt nach dem fehlgeschlagenen Kopplungsversuch einen Fehler bericht.

Android SDKs

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

Android SDKs sind in Play services für Tests und die Kopplung in einer Drittanbieter-App verfügbar.

Wir empfehlen, mit der Google Home Sample App for Matter zu beginnen. Sie zeigt, wie du mit diesen SDKs ein Matter-fähiges Gerät im Google Home-Ökosystem in Betrieb nimmst, koppelst und steuerst.

Die Referenzdokumentation für beide SDKs ist auf dieser Website verfügbar:

Einschränkungen bei der Kopplung

Ein Matter Gerät kann im Google Home Ökosystem nur in bestimmten Szenarien für Anbieter-ID und Gerätetyp gekoppelt werden.

  • Eine Test-VID kann nicht in einem Verbrauchergerät verwendet werden.
  • Deine Produktions-VID muss von der Connectivity Standards Alliance (Alliance) ausgestellt werden. Google prü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 in der Developer Console ein Projekt und eine Integration mit der entsprechenden VID- und PID-Kombination erstellt werdenDeveloper Console. 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.
  • Verbrauchernutzer können dein Produkt erst verwenden, wenn es von der Alliance zertifiziert wurde.

VID und PID können nur einmal für eine Integration verwendet werden. Wenn du dieselbe VID oder PID in deiner Integration verwenden möchtest, hast du folgende Möglichkeiten:

  • Bearbeite die Integration und ändere die VID oder PID in eine andere VID oder PID.
  • Lösche die Integration mit der VID oder PID.
Tabelle: Kopplungsszenarien für Anbieter-ID (VID) und Gerätetyp
Welche Arten von Nutzern können das Gerät im Google Home-Ökosystem in Betrieb nehmen?
VID-Typ VID-Zertifizierung und Status der Konsolenintegration Produktion
(Verbrauchernutzer)		 Entwicklung
(Entwickler, Field Trial Nutzer)
Test Keine Integration in der Developer Console (kann nicht zertifiziert werden)
Test Integration in der Developer Console vorhanden (kann nicht zertifiziert werden)
Produktion Nicht zertifiziert, keine Integration in der Developer Console vorhanden
Produktion Nicht zertifiziert, Integration in der Developer Console vorhanden
Produktion In der Alliance DCL zertifiziert, keine Integration in der Developer Console vorhanden
Produktion In der Alliance DCL zertifiziert und Integration vorhanden in der Developer Console

Geräteinformationen

Technische Informationen zum gekoppelten Gerät können in der GHA aufgerufen werden.

  1. Wähle in der GHA das Gerät aus.
  2. Tippe oben rechts auf das Symbol.
  3. Tippe auf Technische Informationen.

Kennungen wie Hersteller, Modell und Hardwareversion stammen aus der Matter Firmware auf dem Gerät und nicht aus der Developer Console. Beispiel: die CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME und CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME Werte in der Gerätekonfiguration im Matter SDK.

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

Fehlerbehebung bei der Kopplung

Wenn du ein Gerät mit einer Test-Anbieter-ID (VID) und ‑Produkt-ID (PID) gekoppelt hast, es aber nicht angezeigt wird, wenn du versuchst, das Gerät mit der Test Suite in Developer Console zu testen, liegt das wahrscheinlich daran, dass dieselbe Test-VID- und ‑PID-Kombination in mehreren Integrationen verwendet wird.

Entferne zur Fehlerbehebung alle Testgeräte aus Developer Console und kopple das Gerät, das du testen möchtest, noch einmal.

Um zu prüfen, ob du das richtige Gerät gekoppelt hast, kannst du die Informationen zu Hersteller und Modell (CHIP_DEVICE_CONFIG_DEVICE_*-Werte) für das Gerät in deiner Test-Firmware auf eindeutige Werte festlegen.

Weitere Informationen findest du unter Geräteinformationen für weitere Informationen.

Zurück
Matter-Module und -Dienste bestätigen
Weiter
"Rechtsangelegenheit" steuern