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 möglicherweise selbst generieren.
QR-Code anzeigen lassen
Bouffalo Lab
BL602
Der QR-Code-String wird beim Starten des Geräts in der seriellen Konsole ausgegeben. 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 ...
Öffnen Sie den Link in einem Webbrowser, um den QR-Code anzuzeigen.
BL702
Der QR-Code-String wird beim Booten des Geräts in der seriellen Konsole ausgegeben. 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
- 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 anzuzeigen.
NXP
K32W
Der QR-Code-String wird beim Hochfahren des Geräts in der seriellen Konsole ausgegeben. 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 ...
Öffnen Sie den Link in einem Webbrowser, um den QR-Code anzuzeigen.
Realtek
Ameba D
Der QR-Code ist in einer URL codiert, die beim Hochfahren des Ameba D-Boards 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:
Öffnen Sie 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.
Telink
TLSR9518
Der QR-Code-String wird beim Hochfahren des Geräts in der seriellen Konsole ausgegeben. Prüfen Sie die serielle Konsole. Dort 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:
- Google Home app (GHA)
- Home Mobile SDK und Thread Network SDK von Google für Android (können in einer Drittanbieter-App verwendet werden)
Beide Methoden verwenden dieselben Matter- und Thread-Netzwerk-APIs.
Google Home App
- Öffnen Sie GHA.
- Tippen Sie links oben auf das .
- Tippe auf Gerät einrichten.
- Tippe auf Neues Gerät.
- Wähle dein Zuhause aus und tippe auf Weiter.
- GHA sucht nach deinem Gerät. Wenn du gefragt wirst, ob du dein Gerät einrichten möchtest, tippe auf Anderes Gerät einrichten.
- Tippe für einen beliebigen Gerätetyp auf Matter Gerät.
- Richte die Kamera auf den QR-Code deines Geräts (oder den von der Website generierten QR-Code).
- Setze die Kopplung wie im GHA-Ablauf beschrieben fort.
Wenn beim Koppeln mit GHA auf deinem Mobilgerät Probleme auftreten:
- Achten Sie darauf, dass die Entwickleroptionen für Ihr Mobilgerät aktiviert sind.
- Erstelle direkt nach dem fehlgeschlagenen Kopplungsversuch einen Fehlerbericht.
Android SDKs
Android SDKs wurden in Play services zum Testen und Koppeln in einer Drittanbieter-App zur Verfügung gestellt.
Wir empfehlen, mit dem Google Home Sample App for Matter zu beginnen. Darin wird gezeigt, wie du mit diesen SDKs ein Matter-kompatibles 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 für die Kopplung
Ein Matter-Gerät kann nur in bestimmten Szenarien mit Anbieter-ID und Gerätetyp im Google Home-Ökosystem gekoppelt werden.
- Eine Test-VID kann nicht auf einem Verbrauchergerät verwendet werden.
- Deine Produktions-VID muss von der Connectivity Standards Alliance (Alliance) ausgestellt sein. Google prüft, ob Sie der Inhaber dieser VID sind, bevor Sie sie in der Google Home Developer Console verwenden können. Anschließend können Sie Integrationen für diese VID erstellen.
- Für Entwicklungs- und Field Trial-Zwecke müssen ein Projekt und eine Integration mit der entsprechenden VID- und PID-Kombination in der Developer Console erstellt werden. 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.
- Privatnutzer können Ihr 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, musst du entweder:
- Ändere die VID oder PID der Integration in eine andere VID oder PID.
- Lösche die Integration mithilfe der VID oder PID.
| Welche Arten von Nutzern können das Gerät im Google Home-Ökosystem in Betrieb nehmen? | |||
|---|---|---|---|
| VID-Typ | VID-Zertifizierung und Status der Integration in die Console | Produktion
(Privatpersonen) |
Entwicklung
(Entwickler, Field Trial Nutzer) |
| Test | Keine Integration in Developer Console (kann nicht zertifiziert werden) | ||
| Test | Die Integration ist in der Developer Console vorhanden (kann nicht zertifiziert werden) | ||
| Produktion | Nicht zertifiziert, Integration ist nicht in Developer Console vorhanden | ||
| Produktion | Nicht zertifiziert, Integration ist in Developer Console vorhanden | ||
| Produktion | In der Alliance-DCL zertifiziert, Integration ist in der Developer Console nicht vorhanden | ||
| Produktion | In der Alliance-DCL zertifiziert und Integration in der Developer Console vorhanden | ||
Geräteinformationen
Technische Informationen zum gekoppelten Gerät können in der GHA aufgerufen werden.
- Wähle in der GHA das Gerät aus.
- Tippe rechts oben auf das Symbol .
- Tippe auf Technische Daten.
IDs wie Hersteller, Modell und Hardwareversion stammen von der Matter-Firmware auf dem Gerät, 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 Testzwecke gekoppelt wurde, insbesondere wenn eine Test-Anbieter-ID und eine Test-Produkt-ID verwendet werden (die in verschiedenen Integrationen dupliziert werden können).
Fehlerbehebung bei der Kopplung
Wenn du ein Gerät mit einer Test-Anbieter-ID (VID) und einer Test-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 du dieselbe Kombination aus Test-VID und Test-PID für mehrere Integrationen verwendest.
Entfernen Sie zur Fehlerbehebung alle Testgeräte aus Developer Console und koppeln Sie das Gerät, das Sie testen möchten, noch einmal.
Um zu prüfen, ob du das richtige Gerät gekoppelt hast, kannst du die Hersteller- und Modellinformationen (CHIP_DEVICE_CONFIG_DEVICE_*-Werte) für das Gerät in deiner Test-Firmware auf eindeutige Werte festlegen.
Weitere Informationen finden Sie unter Geräteinformationen.