与诉讼或调查设备配对

与支持 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

  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

在网络浏览器中打开链接,以显示二维码。

恩 XP (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

阿米巴·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 显示屏上看到二维码。

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

配对设备

您可以通过以下两种方式配对设备:

  1. Google Home app (GHA)
  2. 适用于 Android 的 Google Home SDK 和 Thread 网络 SDK(可在第三方应用中使用)

这两种方法使用相同的 MatterThread 网络 API。

Google Home 应用

  1. 打开 GHA
  2. 点按左上角的
  3. 点按设置设备
  4. 点按新设备
  5. 选择您的住宅,然后点按下一步
  6. GHA将扫描您的设备。当系统提示您是否要设置设备时,请点按设置其他设备
  7. 点按任意设备类型对应的 Matter 设备
  8. 将摄像头对准设备的二维码(或网站生成的二维码)。
  9. 按照 GHA 流程中的说明继续配对过程。

如果您在移动设备上与 GHA 配对时遇到任何问题,请执行以下操作:

  1. 确保为您的移动设备启用了开发者选项
  2. 配对尝试失败后,立即获取 bug 报告

Android SDK

实现我们的 Android SDK,以便与 Matter 设备配对并管理应用中的 Thread 网络

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 创建集成了。
  • 出于开发和现场试验目的,必须Developer Console 中创建项目以及与相应 VID 和 PID 组合的集成。对设备进行调试的用户必须是项目成员或包含在现场试验用户列表中。
  • 消费者用户只能在您的产品通过 Alliance 认证后使用。
表格:供应商 ID (VID) 和设备类型配对场景
哪些类型的用户可以调试设备进入 Google Home 生态系统?
VID 类型 VID 认证和 Play 管理中心集成状态 正式版
(消费者用户)
开发
(开发者、现场试验用户)
测试 Developer Console 中没有集成(无法认证)
测试 Developer Console 中存在集成(无法认证)
生产 未认证,Developer Console中没有集成
生产 未经认证,Developer Console 中存在集成
生产 已获得 Alliance DCL 认证,但 Developer Console 中没有集成
生产 已在 Alliance DCL 中认证,且集成已存在于 Developer Console

设备信息

可以在 GHA 中查看已配对设备的技术信息。

  1. GHA 中,选择设备。
  2. 点按右上角的 图标。
  3. 点按技术信息

“制造商”“型号”和“硬件版本”等标识符来自设备上的 Matter 固件,而不是 Developer Console例如,Matter SDK 中的设备配置中的 CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAMECHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME 值。

这些标识符有助于验证已配对的设备以用于测试目的,尤其是在使用测试供应商 ID 和产品 ID(可在各项集成中重复使用)时。

排查配对问题

如果您已将设备与测试供应商 ID (VID) 和产品 ID (PID) 配对,但当您尝试在 Developer Console使用测试套件来测试设备时,该 ID 未显示,这可能是由于在多个集成中使用相同的测试 VID 和 PID 组合所致。

如需排查问题,请从 Developer Console 中移除所有测试设备,然后重新配对要测试的设备。

如需验证配对是否正确,您可以在测试固件中将设备的制造商和型号信息(CHIP_DEVICE_CONFIG_DEVICE_* 值)设置为唯一值。

如需了解详情,请参阅设备信息