與支援 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 115200
to 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.
![](https://developers.home.google.com/static/matter/images/internal-getti--mvmbhyybxvh.jpg?authuser=7&hl=zh-tw)
ESP32 WROVER Kit
The device shows the QR code immediately after booting.
![](https://developers.home.google.com/static/matter/images/internal-getti--3h3zuw91jod.jpg?authuser=7&hl=zh-tw)
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:
https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234
在網路瀏覽器中開啟連結即可顯示 QR code。
Silicon Labs
EFR32MG12
主機板啟動後,你應該在小型 LCD 螢幕上看到 QR code。
![](https://developers.home.google.com/static/matter/images/internal-getti--11k7upbf13dc.png?authuser=7&hl=zh-tw)
網頁連結
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_*
值) 設為測試韌體中的不重複值。
詳情請參閱「裝置資訊」一文。