配对支持 Matter 的设备。为此,您需要使用二维码进行配对。根据您的 Matter设备平台,您可能需要自行生成此二维码 。
获取二维码
博流智能
BL602
设备启动时,二维码字符串会打印在串行控制台中。 查看串行控制台,您应该会看到类似如下的消息:
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 ...
在网络浏览器中打开该链接以显示二维码。
BL702
设备启动时,二维码字符串会打印在串行控制台中。查看串行控制台,您应该会看到类似如下的消息:
[ 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
在网络浏览器中打开该链接以显示二维码。
NXP
K32W
设备启动时,二维码字符串会打印在串行控制台中。 查看串行控制台,您应该会看到类似如下的消息:
[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 ...
在网络浏览器中打开该链接以显示二维码。
Realtek
Ameba D
二维码编码在网址中,该网址会在 Ameba D 板启动时打印在串行控制台中:
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在网络浏览器中打开该链接以显示二维码。
Silicon Labs
EFR32MG12
板启动后,您应该会在其小型 LCD 显示屏上找到二维码。
Telink
TLSR9518
设备启动时,二维码字符串会打印在串行控制台中。查看串行控制台,您应该会看到一个网址,该网址在浏览器中打开时会显示二维码:
*** 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
配对设备
您可以通过两种方式配对设备:
- Google Home app (GHA)
- Google 的 Home Mobile 和 Thread Network SDK for Android(可在第三方应用中使用)
这两种方法都使用相同的 Matter 和 Thread Network API。
Google Home 应用
- 打开 GHA。
- 点按左上角的 。
- 点按设置设备 。
- 点按新设备 。
- 选择住宅,然后点按下一步 。
- GHA 将扫描您的设备。当系统提示您是否要设置设备时,点按设置其他设备 。
- 对于任何设备类型,点按 Matter 设备 。
- 将摄像头对准设备的二维码(或网站生成的二维码)。
- 按照 GHA 流程中的指示继续配对过程。
如果您在移动设备上使用 GHA 配对时遇到任何问题,请执行以下操作:
Android SDK
Android SDK 已在 Play services中提供,以便在第三方应用中进行测试和配对。
我们建议您先使用 Google Home Sample App for Matter,该应用说明了如何 使用这些 SDK 在 Google Home 生态系统中调试、配对和控制支持 Matter的设备 。
您可以在本网站上找到这两个 SDK 的参考文档:
配对限制
在某些供应商 ID 和设备类型场景中,Matter 设备只能在 Google Home 生态系统中配对。
- 测试 VID 不能在用户设备中使用。
- 您的正式版 VID 必须由 Connectivity Standards Alliance (Alliance) 发布。Google 会先 验证您是否是该 VID 的所有者,然后您才能在Google Home Developer Console中使用该 VID。验证通过后,您就可以为该 VID 创建集成。
- 出于开发和 Field Trial 目的,必须在 Developer Console 中创建具有相应 VID 和 PID 组合的项目和 集成 。调试设备的用户必须是项目的成员,或者包含在Field Trial用户列表中。
- 用户只有在您的产品通过 Alliance认证后才能使用。
VID 和 PID 只能用于一个集成一次。如果您想在集成中使用相同的 VID 或 PID,则需要执行以下操作之一:
- 使用 VID 或 PID 将集成修改为其他 VID 或 PID。
- 删除使用 VID 或 PID 的集成。
| 哪些类型的用户可以将设备调试到 Google Home 生态系统中? | |||
|---|---|---|---|
| VID 类型 | VID 认证和控制台集成状态 | 正式版
(用户) |
开发
(开发者、Field Trial用户) |
| 测试 | Developer Console 中没有集成(无法认证) | ||
| 测试 | Developer Console 中存在集成(无法 认证) | ||
| 正式版 | 未认证,集成不存在于 Developer Console | ||
| 正式版 | 未认证,Developer Console 中存在集成 | ||
| 正式版 | 已在 Alliance DCL 中认证,集成不 存在于 Developer Console | ||
| 正式版 | 已在 Alliance DCL 中认证, Developer Console 中存在集成Developer Console | ||
设备信息
您可以在 GHA中查看已配对的设备的技术信息。
- 在 GHA 中,选择设备。
- 点按右上角的图标。
- 点按技术信息 。
**制造商** 、**型号** 和**硬件版本** 等标识符来自设备上的 Matter 固件,而不是来自
Developer Console。例如,
CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME 和
CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME 值在 设备配置中
的 Matter SDK。
这些标识符有助于验证哪些设备已配对以进行 测试,尤其是在使用测试供应商 ID 和 产品 ID(可在集成之间重复)时。
排查配对问题
如果您已配对具有测试供应商 ID (VID) 和产品 ID (PID) 的设备,但 在尝试使用 Developer Console 中的测试 套件测试设备时,该设备未显示,这很可能是因为您在多个集成中使用了相同的测试 VID 和 PID 组合。
如需进行问题排查,请从 Developer Console 中移除所有测试设备,然后重新配对 要测试的设备。
如需验证您配对的设备是否正确,您可以在测试固件中将设备的制造商和型号信息(CHIP_DEVICE_CONFIG_DEVICE_* 值)设置为唯一值。
如需了解详情,请参阅设备信息。