Google Home Developer 計畫可讓裝置製造商將智慧住宅裝置連結至 Google Home 生態系統。我們正在擴充智慧住宅動作本機執行路徑,新增支援 Matter 的裝置,以便使用 Google Home app (GHA) 進行設定,並使用 Google Assistant、GHA 或智慧螢幕 (例如 Google Nest Hub (2nd gen)) 進行控制。
本文件說明如何在 Google Home 生態系統中,開始建構及整合支援 Matter 的平台。
免責事項
關於Matter說明文件中所述的程序,請注意下列事項:
- 建議開發用帳戶只連結一個已啟用 Matter 的中樞,以便進行測試。測試期間,如果同時連結多個支援 Matter 的中樞,或連結至同一個結構體,可能會導致無法預測的行為。
- 所有程序都假設使用執行 Ubuntu 20.04 的 Linux 機器建構及刷新 Matter 範例,這些範例已由 Google 測試。雖然支援 macOS 機器,但建議使用 Linux。如有需要,程序中會特別說明 Mac 專用操作說明。
如何建構
如要建構支援 Matter 的裝置,並與 Google Home 生態系統整合,您需要使用與 Matter 相容的開發板和 Matter SDK。
如要開始使用,最簡單的方法是完成程式碼實驗室。建議您至少完成下列其中一個程式碼研究室:
接著,請查看支援的裝置清單,確認要整合的裝置是否支援 Google Home 生態系統。接著,請詳閱開發人員檢查清單,瞭解從建立專案到發布的完整開發流程。
定義
本說明文件會使用下列詞彙:
- 邊界路由器
- 為支援 Thread 的裝置,提供通用 Thread 邊界路由器的中樞。
- 中樞
- 支援 Google Nest 的裝置,例如 Google Nest Hub (2nd gen)。如要透過其他介面 (例如 Assistant、GHA和智慧螢幕) 控制支援 Matter 的裝置,必須使用中樞裝置。
- 支援Matter的裝置
- 已刷入啟用Matter建構或範例應用程式的裝置或開發板。
- 行動裝置
- 用於協助配對的測試手機。目前這是 Android 手機。
必要條件
如要將支援 Matter 的裝置與 Google Home 生態系統完全整合,開發人員必須具備:
- 支援 Thread 的 Google 中樞,可做為支援 Thread 裝置的border router,以及轉送智慧住宅意圖的本機執行要求路徑。
- 符合最低需求的行動裝置 (測試手機):
- Android O (8.1,API 級別 27 以上)
- iOS (16.5 以上版本)
- BLE 功能
- 支援 Matter 的裝置供應商 ID (VID) 和產品 ID (PID)。
- 支援 Matter 的裝置。這部裝置應屬於 Google Home 生態系統支援的 Matter 種裝置類型之一,例如:
- 自家產品,搭載支援 Matter 的韌體。
- 下列其中一種 Matter 裝置,用於端對端驗證:
| 供應商 | 平台 | Thread 支援服務 | 指南 |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | OTA 測試 | |
| Nordic Semiconductor | nRF52840 DK | OTA 測試 | |
| NXP | IOTZTB-DK006 開發套件 | ||
| Realtek | Ameba D 系列 | ||
| Silicon Labs | EFR32MG24 開發套件 | ||
| EFR32MG Zigbee 和 Thread 入門套件 | |||
| Telink | TLSR9528 | Telink Matter 開發人員指南 | |
| Texas Instruments | CC2652R7 LaunchPad 開發套件 |
供應商 ID
根據預設,您可以使用聯盟分配的其中一個 VID 進行測試。選取下列其中一項:0xFFF1、0xFFF2、0xFFF3、0xFFF4。
如要使用正式版 VID,以便認證及推出整合功能,您必須先由 Google 驗證,確保聯盟已向您核發該 VID。
這個 VID 應在裝置韌體中實作。
Matter 裝置只能在特定供應商 ID 和裝置類型情境下,與 Google Home 生態系統配對。
- 測試 VID 無法用於消費者裝置。
- 正式版 VID 必須由Connectivity Standards Alliance (Alliance)核發。Google 會先驗證您是該 VID 的擁有者,然後您才能在 Google Home Developer Console 中使用該 VID。完成後,您就能為該 VID 建立整合。
- 基於開發和Field Trial目的,必須在Developer Console中建立專案,並與對應的 VID 和 PID 組合整合。委託裝置的使用者必須是專案成員,或列在 Field Trial 使用者清單中。
- 消費者使用者必須等到產品通過Alliance認證後,才能使用產品。
VID 和 PID 只能用於一項整合。如要在整合中使用相同的 VID 或 PID,請採取下列任一做法:
- 使用 VID 或 PID 編輯整合功能,改用其他 VID 或 PID。
- 使用 VID 或 PID 刪除整合。
| 哪些類型的使用者可以將裝置委託給 Google Home 生態系統? | |||
|---|---|---|---|
| VID 類型 | VID 認證和控制台整合狀態 | 正式版
(一般使用者) |
開發
(開發人員、Field Trial 位使用者) |
| 測試 | Developer Console 中沒有整合項目 (無法認證) | ||
| 測試 | 整合項目存在於 Developer Console (無法認證) | ||
| 正式環境 | 未通過認證,Developer Console中沒有整合項目 | ||
| 正式環境 | 未通過認證,整合項目位於Developer Console | ||
| 正式環境 | 已在 Alliance DCL 中認證,但 Developer Console 中沒有整合 | ||
| 正式環境 | 已通過 Alliance DCL 認證,且Developer Console中已有整合 | ||
產品 ID
系統會從 Matter 基本資訊叢集讀取裝置資訊。裝置韌體中編碼的產品 ID 必須與開發人員控制台中 Matter 整合的產品 ID 相符。
不支援的功能
部分 Matter 叢集尚未向使用者公開,但系統可能會使用這些叢集。在大多數情況下,這表示使用者看不到透過這些叢集公開的屬性:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ 請參閱「開關燈具」,瞭解這對開關燈具的影響。