Mater-Gerät koppeln

Kopple dein Matter-fähiges Gerät. Dazu benötigen Sie einen QR-Code für die Kopplung. Je nach Plattform Ihres Matter-Gerät, Sie müssen möglicherweise diesen QR-Code generieren selbst.

QR-Code anfordern

Bouffalo-Labor

BL602

Der QR-Code-String wird beim Hochfahren des Geräts in der seriellen Konsole ausgegeben. Auf der seriellen Konsole sollten folgende Meldungen 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
...

Öffnen Sie den Link in einem Webbrowser, um den QR-Code anzuzeigen.

BL702

Der QR-Code-String wird beim Starten des Geräts in der seriellen Konsole ausgegeben. oben. In der seriellen Konsole sollten folgende Meldungen angezeigt werden: dies:

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

NXP

K32W

Der QR-Code-String wird beim Hochfahren des Geräts in der seriellen Konsole ausgegeben. Auf der seriellen Konsole sollten folgende Meldungen 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
...

Öffnen Sie den Link in einem Webbrowser, um den QR-Code anzuzeigen.

Realtek

Ameba D

Der QR-Code ist in einer URL codiert, die in der Seriennummer wenn das Ameba D-Board hochfährt:

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 den QR-Code anzuzeigen.

Silicon Labs

EFR32MG12

Sobald die Platine hochgefahren ist, sollten Sie auf dem kleinen LCD-Display einen QR-Code finden. Display.

TLSR9518

Der QR-Code-String wird beim Starten des Geräts in der seriellen Konsole gedruckt. Überprü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 Home Mobile SDKs und Thread-Netzwerk-SDKs von Google für Android (kann in einer Drittanbieter-App verwendet werden)

Beide Methoden verwenden dieselben Matter- und Thread Netzwerk-APIs.

Google Home App

  1. Öffnen Sie GHA.
  2. Tippe 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 dann nach Ihrem Gerät. Sobald Sie gefragt werden, Wenn Sie Ihr Gerät einrichten möchten, tippen Sie auf Anderes Gerät einrichten Gerät.
  7. Tippen Sie bei jedem Gerätetyp auf Matter Gerät.
  8. Richten Sie die Kamera auf den QR-Code Ihres Geräts oder auf den von der Website generierten QR-Code Code).
  9. Setzen Sie den Kopplungsprozess fort, wie in GHA angegeben. Ablauf.

Sollten bei der Kopplung mit GHA auf deinem Mobilgerät:

  1. Die Entwickleroptionen müssen auf Ihrem Mobilgerät aktiviert sein.
  2. Sofort nach dem fehlgeschlagenen Kopplungsversuch Fehler erfassen Bericht.

Android-SDKs

Android-SDKs implementieren, um Matter zu koppeln und Thread-Netzwerke in deiner App verwalten

Android SDKs wurden verfügbar in Play services zum Testen und Koppeln in einer Drittanbieter-App.

Wir empfehlen, mit der Google Home Sample App for Matter, das illustriert, wie um ein Matter-fähiges Gerät in Betrieb zu nehmen, zu koppeln und zu steuern in der Google Home-Plattform mit diesen SDKs.

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

Kopplungsbeschränkungen

Ein Matter-Gerät kann nur mit Google Home gekoppelt werden in bestimmten Szenarien mit Anbieter-ID und Gerätetyp.

  • Eine Test-VID kann nicht auf einem Nutzergerät verwendet werden.
  • Deine Produktions-VID muss von der Connectivity Standards Alliance (Alliance) ausgestellt werden. Google wird musst du bestätigen, dass du der Inhaber dieser VID bist, bevor du sie im Google Home Developer Console verwenden kannst. Danach kannst du Integrationen für diese VID erstellen.
  • Für Entwicklungs- und Field-Trial-Zwecke ist ein Projekt und die Integration in die muss die zugehörige Kombination aus VID und PID in Developer Console erstellt werden. Die Inbetriebnahme durch den Nutzer Das Gerät muss entweder ein Projektmitglied sein oder in der Liste enthalten sein von Field-Trial-Nutzenden.
  • Verbraucher können Ihr Produkt erst verwenden, nachdem es vom Alliance
Tabelle: Anbieter-ID (VID) und Gerätetyp für Kopplungsszenarien
Welche Nutzer können das Gerät in das Google Home-System einbinden?
VID-Typ VID-Zertifizierung und Status der Konsolenintegration Produktion
(Privatnutzer)		 Entwicklung
(Entwickler, Field-Trial-Nutzer)
Test Keine Integration in Developer Console (kann nicht zertifiziert werden)
Test Integration ist in Developer Console vorhanden (kann nicht zertifiziert)
Produktion Nicht zertifiziert, Integration ist in Developer Console nicht vorhanden
Produktion Nicht zertifiziert, Integration existiert in Developer Console
Produktion Nach Alliance DCL zertifiziert, Integration nicht vorhanden in Developer Console
Produktion Nach Alliance DCL zertifiziert und Integration vorhanden in Developer Console

Geräteinformationen

Technische Daten zum gekoppelten Gerät findest du auf der GHA

  1. Wählen Sie unter GHA das Gerät aus.
  2. Tippe oben auf das Symbol genau.
  3. Tippen Sie auf Technische Daten.

Kennungen wie Hersteller, Modell und Hardwareversion werden von der Matter-Firmware auf dem Gerät, nicht von der Developer Console. Beispielsweise die Werte CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME und CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME in der Gerätekonfiguration im Matter SDK.

Diese Kennungen können hilfreich sein, um zu prüfen, welches Gerät Testzwecke, insbesondere wenn Sie eine Testanbieter-ID und Produkt-ID (kann in allen Integrationen dupliziert werden).

Fehlerbehebung beim Koppeln

Wenn Sie ein Gerät mit einer Testanbieter-ID (VID) und einer Produkt-ID (PID) gekoppelt haben, erscheint er nicht, wenn Sie versuchen, das Gerät mit der Test- Suite in Developer Console, wird dies wahrscheinlich durch mit derselben Kombination aus Test-VID und PID in mehreren Integrationen.

Entferne alle Testgeräte von Developer Console und kopple sie, um das Problem zu beheben das Gerät, das Sie noch einmal testen möchten.

Um zu überprüfen, ob Sie das richtige Gerät gekoppelt haben, können Sie den Hersteller und Modellinformationen (CHIP_DEVICE_CONFIG_DEVICE_*-Werte) für das Gerät eindeutige Werte in Ihrer Testfirmware.

Weitere Informationen findest du unter Geräteinformationen. Informationen.

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