與支援 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
- 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
在網路瀏覽器中開啟連結即可顯示 QR code。
NXP
32W
裝置啟動時，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:
在網路瀏覽器中開啟連結即可顯示 QR code。
Silicon Labs
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
配對裝置
配對裝置的方式有兩種：
- Google Home app (GHA)
- Android 專用的 Google Home Mobile 和 Thread 網路 SDK (可在第三方應用程式中使用)
這兩種方法會使用相同的 Matter 和 Thread 網路 API。
Google Home 應用程式
- 開啟 GHA。
- 輕觸左上角的 。
- 輕觸「設定裝置」。
- 輕觸「新裝置」。
- 選取住家，然後輕觸「下一步」。
- 「GHA」會掃描你的裝置。當系統詢問是否要設定裝置時，請輕觸「設定其他裝置」。
- 針對任何裝置類型，輕觸「Matter 裝置」。
- 將相機鏡頭對準裝置的 QR code，或是網站產生的 QR code。
- 按照 GHA 流程的說明繼續進行配對程序。
如果在行動裝置與 GHA 配對時遇到任何問題：
Android SDK
Android 中的 SDK 已在 Play services 中提供，以便在第三方應用程式中進行測試及配對。
建議您先從 Google Home Sample App for Matter 開始著手，該文章會說明如何在 Google Home 生態系統中，運用這些 SDK 對支援 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 認證，才能使用您的產品。
| 哪些類型的使用者可以將裝置佣金到 Google Home 生態系統？ | |||
|---|---|---|---|
| VID 類型 | VID 認證和控制台整合狀態 | 正式版
(一般使用者) |
開發
(開發人員、實際測試使用者) |
| 測試 | 「Developer Console」中未整合 (無法認證) | ||
| 測試 | Developer Console 中有整合項目 (無法認證) | ||
| 正式環境 | 未通過認證，Developer Console 中沒有整合功能 | ||
| 正式環境 | 未通過認證，有整合於 Developer Console | ||
| 正式環境 | 已透過 Alliance DCL 認證，Developer Console 中沒有整合功能 | ||
| 正式環境 | 已透過 Alliance 資料存取要求 (DCL) 取得認證，Developer Console中已有整合作業 | ||
裝置資訊
如要查看配對裝置的技術資訊，請前往 GHA。
- 在 GHA 中選取裝置。
- 輕觸右上方的 圖示。
- 輕觸「技術資訊」。
製造商、型號和硬體版本等 ID 來自裝置上的 Matter 韌體，而非 Developer Console。例如 Matter SDK 裝置設定中的 CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME 和 CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME 值。
這些 ID 有助於驗證哪個裝置已配對完成測試，特別是使用測試供應商 ID 和產品 ID (可在整合作業中複製) 時。
排解配對問題
如果您已將某部裝置與測試供應商 ID (VID) 和產品 ID (PID) 配對，但在 Developer Console 中嘗試透過測試套件測試裝置時卻未顯示，這可能是因為在多項整合項目中使用相同的測試 VID 和 PID 組合。
如要排解問題，請從 Developer Console 移除所有測試裝置，然後重新配對要測試的裝置。
如要驗證是否已配對正確，您可以將裝置的製造商和型號資訊 (CHIP_DEVICE_CONFIG_DEVICE_* 值) 設為測試韌體中的不重複值。
詳情請參閱「裝置資訊」一文。