配對 Matter 裝置

配對支援 Matter 的裝置。這時需要 QR code 才能配對視 Matter 裝置的平台而定,您可能需要自行產生這個 QR code。

取得 QR code

水牛實驗室

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 code。

BL702

裝置開機時,QR code 字串會顯示在序列控制台中。接著查看序列控制台,您應該會看到類似下方的訊息:

[         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 code。

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 code。

Realtek

阿梅巴 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 code。

矽膠研究室

EFR32MG12

主面板啟動後,你應該會在其小型 LCD 螢幕上看到 QR code。

TLSR9518

裝置啟動時,序列控制台中會顯示 QR code 字串。查看序列控制台,在瀏覽器中開啟時顯示 QR code 的網址如下:

*** 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 行動裝置和 Thread 網路 SDK (可用於第三方應用程式)

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

Google Home 應用程式

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

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

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

Android SDK

請導入 Android SDK 來配對 Matter 裝置,以及在應用程式中管理 Thread 網路

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

建議您先從 Google Home Sample App for Matter 開始著手,該文章將說明如何使用這些 SDK,在 Google Home 生態系統中調試、配對及控制支援 Matter 的裝置。

這個網站提供這兩個 SDK 的參考說明文件:

配對限制

Matter 裝置只有在特定供應商 ID 和裝置類型的情況下,才能在 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 認證和主控台整合狀態 正式版
(消費者使用者)
開發
(開發人員、實測使用者)
測試 Developer Console 中沒有任何整合 (無法認證)
測試 Developer Console 中有整合功能 (無法認證)
正式版 未通過認證,Developer Console中不存在整合功能
正式版 未通過認證,Developer Console 中已有整合功能
正式版 Alliance DCL 認證,Developer Console沒有整合功能
正式版 Alliance DCL 認證和整合服務已在Developer Console

裝置資訊

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

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

製造商型號硬體版本等 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_* 值) 設為測試韌體中不重複的值。

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