Kopple dein 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. 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 Hochfahren des Geräts in der seriellen Konsole ausgegeben. In Ihrer seriellen Konsole sollten Sie folgende Meldungen sehen:
[ 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 115200
to 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. 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 beim Hochfahren der Ameba D-Platine in der seriellen Konsole angezeigt 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 den QR-Code anzuzeigen.
Silicon Labs
EFR32MG12
Sobald die Platine hochgefahren ist, sollte auf dem kleinen LCD-Display ein QR-Code angezeigt werden.
Logo: Telink
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:
- Google Home app (GHA)
- Das Home Mobile SDK und das Thread-Netzwerk-SDK von Google für Android, das in einer Drittanbieter-App verwendet werden kann
Beide Methoden verwenden dieselben Netzwerk-APIs Matter und Thread.
Google Home App
- Öffnen Sie GHA.
- Tippe oben links 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 dann nach Ihrem 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 die Kamera auf den QR-Code Ihres Geräts (oder den von der Website generierten QR-Code).
- Setzen Sie den Kopplungsprozess fort, wie im GHA-Ablauf angegeben.
Wenn beim Koppeln mit GHA auf deinem Mobilgerät Probleme auftreten:
- Achte darauf, dass die Entwickleroptionen für dein Mobilgerät aktiviert sind.
- Erstellen Sie 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. Es zeigt, 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:
Kopplungsbeschränkungen
Ein Matter-Gerät kann in der Google Home-Umgebung nur in bestimmten Szenarien mit Anbieter-ID und Gerätetyp gekoppelt werden.
- Eine Test-VID kann nicht auf einem Nutzergerät 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 im Google Home Developer Console verwenden kannst. Danach kannst du Integrationen für diese VID erstellen.
- Zu Entwicklungs- und Feldtests müssen ein Projekt und eine Integration mit der entsprechenden Kombination aus VID und PID in Developer Console erstellt werden. Der Nutzer, der das Gerät in Betrieb nimmt, muss entweder Mitglied des Projekts sein oder in der Liste der Feldtestnutzer aufgeführt sein.
- Privatnutzer können dein Produkt erst verwenden, nachdem es von der Alliance zertifiziert wurde.
Welche Nutzer können das Gerät für das Google Home-System in Betrieb nehmen? | |||
---|---|---|---|
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 werden) | ||
Produktion | Nicht zertifiziert, Integration ist in Developer Console nicht vorhanden | ||
Produktion | Nicht zertifiziert, Integration existiert in Developer Console | ||
Produktion | Nach Alliance DCL zertifiziert, Integration existiert nicht in Developer Console | ||
Produktion | Nach Alliance DCL zertifiziert und Integration in Developer Console vorhanden |
Geräteinformationen
Technische Daten zum gekoppelten Gerät findest du in den GHA.
- Wählen Sie unter GHA das Gerät aus.
- Tippen Sie rechts oben auf das Symbol .
- Tippen Sie auf Technische Daten.
IDs wie Hersteller, Modell und Hardwareversion 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 Kennzeichnungen können hilfreich sein, um zu überprüfen, welches Gerät zu Testzwecken gekoppelt wurde, insbesondere wenn eine Testanbieter-ID und eine Testprodukt-ID (die in allen Integrationen dupliziert werden können) verwendet werden.
Fehlerbehebung beim Koppeln
Wenn du ein Gerät mit einer Testanbieter-ID (VID) und einer Testprodukt-ID (PID) gekoppelt hast, diese aber nicht angezeigt wird, wenn du versuchst, das Gerät mit der Test Suite in Developer Console zu testen, wird dies wahrscheinlich durch die Verwendung derselben Test-VID und -PID-Kombination für mehrere Integrationen verursacht.
Entfernen Sie zur Fehlerbehebung alle Testgeräte aus Developer Console und koppeln Sie das zu testende Gerät noch einmal.
Um zu prüfen, ob Sie die richtige Kopplung durchgeführt haben, können Sie die Hersteller- und Modellinformationen (CHIP_DEVICE_CONFIG_DEVICE_*
-Werte) für das Gerät in Ihrer Testfirmware auf eindeutige Werte setzen.
Weitere Informationen finden Sie unter Geräteinformationen.