配對 Matter 裝置

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

與「Matter-enabled device. To do this, you'll need a QR code for pairing. Depending on the platform of your Matter device, you may need to generate this QR code yourself.」配對

取得 QR 圖碼

Bouffalo Lab

BL602 問卷調查

QR 圖碼字串會在裝置啟動時,顯示在序列控制台中。 請查看序列控制台,您應該會看到類似以下的訊息:

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
...

在網路瀏覽器中開啟連結,即可顯示 QR 圖碼。

品牌提升 702

QR 圖碼字串會在裝置啟動時,顯示在序列控制台中。請查看序列控制台,您應該會看到類似以下的訊息:

[         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

在網路瀏覽器中開啟連結,即可顯示 QR 圖碼。

特許

K32W

QR 圖碼字串會在裝置啟動時,顯示在序列控制台中。 請查看序列控制台,您應該會看到類似以下的訊息:

[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
...

在網路瀏覽器中開啟連結,即可顯示 QR 圖碼。

Realtek

阿梅巴 D

QR 圖碼是以網址編碼,當 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

在網路瀏覽器中開啟連結,即可顯示 QR 圖碼。

Silicon Labs

EFR32MG12

啟動 Jamboard 後,你會在其小型 LCD 螢幕上找到 QR 圖碼。

TLSR9518

QR 圖碼字串會在裝置啟動時,顯示在序列控制台中。檢查序列控制台,您應該會看到在瀏覽器中開啟 QR 圖碼的網址:

*** 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. Google 的 Home Mobile 和 Thread Network SDKs for Android (which can be used in a 3rd party app)

這兩種方法使用相同的 MatterThread Network API。

Google Home 應用程式

  1. 開啟 GHA
  2. 輕觸左上角的
  3. 輕觸 [設定裝置]
  4. 輕觸 [新裝置]
  5. 選取所需住家,然後輕觸 [下一步]
  6. GHA」會掃描你的裝置。當系統提示您是否要設定裝置時,請輕觸 [設定其他裝置]。
  7. 輕觸任何類型的 Matter 裝置
  8. 將相機鏡頭對準裝置的 QR 圖碼 (或網站產生的 QR 圖碼)。
  9. GHA 流程所示,繼續進行配對程序。

在行動裝置上與 GHA 配對時遇到任何問題:

  1. 確認行動裝置已啟用開發人員選項
  2. 配對連線失敗後立即擷取錯誤報告

Android SDK

實作 Android SDK 以配對 Matter 裝置,並管理應用程式中的 Thread 網路

Android 已提供 Play services SDK,方便您在第三方應用程式中進行測試和配對。

建議從使用 Google Home Sample App for Matter 開始,該文章說明如何透過這些 SDK 在 Google Home 生態系統中委任、配對及控制 Matter 裝置。

本網站提供兩種 SDK 的參考說明文件:

配對限制

在特定供應商 ID 和裝置類型情境中,Matter 裝置只能與 Google Home 生態系統配對。

  • 無法在消費者的裝置上使用測試 VID。
  • 針對生產環境 (消費性) 裝置進行配對,該裝置必須通過 CSA DCL 認證。
  • 基於開發和現場試用的目的,裝置必須Google Home Developer Console 中註冊
表格:供應商 ID (VID) 和裝置類型配對情境
哪些類型的使用者可以將裝置送入 Google Home 生態系統?
VID 類型 VID 認證和註冊狀態 正式版
(消費者使用者)
開發
(開發人員、實測使用者)
Test 未報名 (未通過認證) 不適用 不適用
Test 已註冊 Developer Console (無法取得認證) 不適用
正式版 未經認證,尚未註冊 不適用
正式版 未經認證,已於Developer Console註冊
正式版 通過 CSA DCL 認證,未註冊 不適用
正式版 通過 CSA DCL 認證,並向 Developer Console 註冊

裝置資訊

您可以前往 GHA 查看已配對裝置的技術資訊。

  1. GHA 中選取裝置。
  2. 輕觸右上角的 圖示。
  3. 輕觸 [技術資訊]

ID,例如 ManufacturerModelHardware 版本,來自裝置上的 Matter 韌體,而非 Developer Console。例如,Matter SDK 的裝置設定中的 CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAMECHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME 值。

這些 ID 有助於驗證哪些裝置已經與測試目的配對,特別是使用測試供應商 ID 和產品 ID (可在整合中重複) 時。

排解配對問題

如果您已將裝置與測試供應商 ID (VID) 和產品 ID (PID) 配對,但在 Developer Console 中嘗試使用測試套件測試裝置時,系統並未顯示這個選項,原因可能是您在多個整合作業中使用相同的測試 VID 和 PID 組合。

如要排解問題,請將所有測試裝置從 Developer Console 中移除,然後重新配對您要測試的裝置。

如要驗證配對的裝置是否正確,您可以在裝置的韌體中,將裝置的製造商和型號資訊 (CHIP_DEVICE_CONFIG_DEVICE_* 值) 設為不重複的值。

詳情請參閱裝置資訊