配對 Matter 裝置

配對支援 Matter 的裝置。如要這麼做,你必須使用 QR code 進行配對視 Matter 裝置的平台而定,您可能需要自行產生這個 QR 圖碼。

取得 QR 圖碼

水牛實驗室

BL602

QR code 字串會於裝置啟動時依照序列控制台列印。 查看序列控制台,您應該會看到類似下列的訊息:

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 圖碼。

BL702

裝置開機後,系統會在序列主控台列印 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 圖碼。

NXP

K32W

QR code 字串會於裝置啟動時依照序列控制台列印。 查看序列控制台,您應該會看到類似下列的訊息:

[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

Ameba D

QR code 會在網址中進行編碼,當 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 圖碼。

晶片研究室

EFR32MG12

主機啟動後,請務必在小型 LCD 螢幕上找到 QR 圖碼。

TLSR9518

QR code 字串會列印在裝置控制台啟動時,查看序列控制台,您應該會看到網址,而且在瀏覽器中開啟 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 的 Android 行動版和 Thread Network SDK (可用於第三方應用程式)

這兩種方法都使用相同的 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 網路

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

建議您先從 Google Home Sample App for Matter 開始,說明如何在 Google Home 生態系統中使用這些 SDK 進行佣金、配對及控制支援 Matter 的裝置。

請參閱以下兩個 SDK 的參考說明文件:

配對限制

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

  • 測試 VID 無法在消費者裝置上使用。
  • 製作影片 VID 必須由 Connectivity Standards Alliance (Alliance) 核發。Google 會驗證您是 VID 的擁有者,才能在 Google Home Developer Console 中使用。驗證完成後,您就可以為該 VID 建立整合作業。
  • 基於開發作業和現場測試的目的,需要在 Developer Console 中建立專案以及與對應 VID 和 PID 組合的整合。委託裝置的使用者必須是專案成員,或已列入現場試用使用者清單。
  • 一般使用者必須先通過 Alliance 認證,才能使用這些產品。
表格:供應商 ID (VID) 和裝置類型配對情境
哪些類型的使用者可以將裝置加入 Google Home 生態系統?
VID 類型 VID 認證與控制台整合狀態 正式版
(消費者)
開發
(開發人員、現場試用使用者)
測試 Developer Console 未整合 (無法認證)
測試 Developer Console 中已有整合功能 (無法取得認證)
實際工作環境 未經認證,Developer Console中沒有整合作業
實際工作環境 未經認證,整合作業位於 Developer Console
實際工作環境 已通過 Alliance DCL 認證,Developer Console 中沒有整合
實際工作環境 已取得 Alliance DCL 認證,並整合了 Developer Console

裝置資訊

配對裝置的技術資訊可在 GHA 中查看。

  1. GHA 中選取裝置。
  2. 輕觸右上方的 圖示。
  3. 輕觸「技術資訊」

ManufacturerModelHardware version 等 ID 來自裝置上的 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_* 值) 設為不重複的值。

詳情請參閱「裝置資訊」。