Koppel dein Matter-fähiges Gerät. Dazu brauchst du einen QR-Code zum Koppeln. Je nach Plattform Ihres Matter-Geräts müssen Sie diesen QR-Code möglicherweise selbst generieren.
QR-Code abrufen
Bouffalo-Lab
BL602
Der QR-Code-String wird beim Starten des Geräts in der seriellen Konsole ausgegeben. Prüfen Sie in der seriellen Konsole die Nachricht wie diese:
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 aufzurufen.
Honda BL702
Der QR-Code-String wird beim Starten des Geräts in der seriellen Konsole ausgegeben. Prüfen Sie in der seriellen Konsole, dass 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
- 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 115200to connect to the device and view logs if it is attached to the host at/dev/ttyUSB0. - 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 den QR-Code aufzurufen.
Logo: NXP
K32W
Der QR-Code-String wird beim Starten des Geräts in der seriellen Konsole ausgegeben. Prüfen Sie in der seriellen Konsole die Nachricht wie diese:
[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 aufzurufen.
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:
Öffnen Sie den Link in einem Webbrowser, um den QR-Code aufzurufen.
Silicon Labs
EFR32MG12
Nachdem das Board gestartet wurde, sollte ein QR-Code auf dem kleinen LCD-Display angezeigt werden.
TeLink
TLSR9518-DE
Der QR-Code-String wird beim Starten des Geräts in der seriellen Konsole ausgegeben. Prüfen Sie die serielle Konsole. Sie sollten dann eine URL sehen, auf der der QR-Code angezeigt wird, wenn Sie ihn in einem Browser öffnen:
*** 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:
- Google Home app (GHA)
- Google Home Mobile und Thread Netzwerk-SDKs für Android, die in einer Drittanbieter-App verwendet werden können
Beide Methoden verwenden dieselben Matter und Thread Netzwerk-APIs.
Google Home App
- Öffnen Sie GHA.
- Tippen Sie links oben auf das .
- Tippen Sie auf Gerät einrichten.
- Tippen Sie auf Neues Gerät.
- Wählen Sie Ihr Zuhause aus und tippen Sie auf Weiter.
- 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.
- Tippe für einen beliebigen Gerätetyp auf Matter Gerät.
- Richten Sie Ihre Kamera auf den QR-Code oder den von der Website generierten QR-Code.
- Fahren Sie mit dem im GHA-Vorgang angegebenen Kopplungsprozess fort.
Wenn beim Koppeln mit GHA auf Ihrem Mobilgerät Probleme auftreten, treten Sie so auf:
- Prüfen Sie, ob die Entwickleroptionen für Ihr Mobilgerät aktiviert sind.
- Erstellen Sie unmittelbar nach dem fehlgeschlagenen Kopplungsversuch einen Fehlerbericht.
Android-SDKs
Android SDKs sind zum Testen und Koppeln in einer Drittanbieter-App in Play services verfügbar.
Wir empfehlen, mit Google Home Sample App for Matter zu beginnen. Damit wird erläutert, wie Sie mit diesen SDKs ein Matter-fähiges Gerät in der Google Home-Umgebung in Betrieb nehmen, koppeln und steuern.
Eine Referenzdokumentation für beide SDKs ist auf dieser Website verfügbar:
Kopplungseinschränkungen
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.
- Deine Produktions-VID muss vom CSA ausgestellt werden. Google überprüft, ob du der Inhaber dieser VID bist, bevor du sie in Google Home Developer Console verwenden kannst. Danach können Sie Integrationen für diese VID erstellen.
- Zu Entwicklungs- und Testphasen müssen ein Projekt und die Einbindung in die entsprechende Kombination aus VID und PID in der Developer Console erstellt werden. Der Nutzer, der das Gerät in Betrieb nimmt, muss entweder ein Projektmitglied sein oder in die Liste der Feldtestnutzer aufgenommen werden.
- Nutzer können Ihr Produkt erst verwenden, wenn es von der CSA zertifiziert wurde.
| Welche Nutzer können das Gerät in die Google Home-Umgebung einbinden? | |||
|---|---|---|---|
| VID-Typ | VID-Zertifizierung und Konsolenintegrationsstatus | Produktion
(Nutzer) |
Entwicklung
(Entwickler, Nutzer von Field Trial) |
| Test | Keine Integration in Developer Console (kann nicht zertifiziert werden) | ||
| Test | Die Integration ist in Developer Console enthalten (kann nicht zertifiziert werden) | ||
| Produktion | Nicht zertifiziert, Integration ist in Developer Console nicht vorhanden | ||
| Produktion | Nicht zertifiziert, Integration ist in Developer Console enthalten | ||
| Produktion | Zertifiziert nach dem CSA DCL ist die Integration im Developer Console nicht vorhanden | ||
| Produktion | Zertifiziert nach dem CSA DCL und Integration ist im Developer Console vorhanden | ||
Geräteinformationen
Technische Informationen für das gekoppelte Gerät finden Sie in der GHA.
- Wählen Sie unter GHA das Gerät aus.
- Tippen Sie rechts oben auf das Symbol .
- Tippen Sie auf Technische Daten.
Kennungen wie Manufacturer, Model und Hardware version stammen von der Matter-Firmware auf dem Gerät und nicht von der Developer Console. Beispiel: 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 für Tests gekoppelt wurde, insbesondere wenn Sie eine Anbieter-ID und eine Produkt-ID verwenden, die in den verschiedenen Integrationen dupliziert werden können.
Fehlerbehebung beim Koppeln
Wenn Sie ein Gerät mit einer Test-ID und einer Produkt-ID gekoppelt haben, diese aber beim Testen des Geräts mit der Test Suite in Developer Console nicht angezeigt wird, liegt das wahrscheinlich daran, dass Sie für mehrere Integrationen dieselbe Kombination aus Test-VID und PID verwenden.
Zur Fehlerbehebung entfernen Sie alle Testgeräte aus Developer Console und koppeln Sie das zu testende Gerät noch einmal.
Um zu prüfen, ob Sie die richtige gekoppelt haben, können Sie die Hersteller- und Modellinformationen (CHIP_DEVICE_CONFIG_DEVICE_*-Werte) für das Gerät auf eindeutige Werte in Ihrer Testfirmware festlegen.
Weitere Informationen finden Sie unter Geräteinformationen.