開始使用 Matter

透過 Google 的居家開發人員計畫,裝置製造商可將智慧住宅裝置連結至 Google Home 生態系統。我們將擴充智慧型住家動作的本機執行路徑,讓您使用 Google Home app (GHA) 新增 Matter 裝置並進行設定,然後使用 Google AssistantGHA 或智慧螢幕 (例如 Google Nest Hub (2nd gen)) 控制這些裝置。

這份文件說明如何開始建構及整合 Google Home 生態系統中支援 Matter 的平台。

免責事項

請注意,說明文件Matter中描述的程序有以下事項:

  • 建議您用於開發的帳戶只連線一個已啟用Matter的中樞裝置,以進行測試。測試期間,如果同時連線多個支援 Matter 的中樞,或連線至相同結構,可能會導致無法預測的行為。
  • 所有程序都假設使用執行 Ubuntu 20.04 的 Linux 電腦,建構及刷寫 Matter 範例,這些範例已由 Google 測試。雖然支援 macOS 電腦,但建議使用 Linux。程序中會視需要標示 Mac 專屬的操作說明。

如何建構

如要建構與 Google Home 生態系統整合的 Matter 裝置,您需要使用與 Matter 相容的開發板和 Matter SDK

如要輕鬆入門,建議先完成我們的程式碼研究室。建議您至少完成下列其中一個程式碼研究室:

接著,請查看支援的裝置清單,確認您打算整合的裝置是否支援 Google Home 生態系統。接著詳閱開發人員檢查清單,瞭解從專案建立到發布的完整開發流程。

支援的裝置 開發人員檢查清單

定義

本說明文件會使用下列字詞:

邊界路由器
中樞裝置,可為支援 Thread 的裝置實作一般用途的Thread邊界路由器。
中樞
支援的 Google Nest 裝置,例如 Google Nest Hub (2nd gen)。 如要透過其他介面 (例如 AssistantGHA 和智慧螢幕) 控制支援 Matter 的裝置,必須使用中樞裝置。
Matter 裝置
已刷入啟用Matter功能的版本或範例應用程式的裝置或開發板。
行動裝置
用於輔助配對的測試手機。目前這是 Android 手機。

必要條件

Matter 開發適用的建議 IDE 擴充功能

如要將支援 Matter 的裝置完整整合至 Google Home 生態系統,開發人員必須具備下列條件:

  1. 支援 Thread 的 Google 中樞裝置,可做為支援 Thread 裝置的邊界路由器,以及轉送智慧型住宅意圖的本機執行要求路徑。
  2. 符合最低需求的行動裝置 (測試手機):
    • Android O (8.1,API 級別 27 以上版本)
    • iOS (16.5 以上版本)
    • BLE 功能
  3. 支援 Matter的裝置的供應商 ID (VID)產品 ID (PID)
  4. 支援 Matter 的裝置。這部裝置應屬於 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 TLSR9518
德州儀器 CC2652R7 LaunchPad 開發套件

供應商 ID

根據預設,您可以使用 CSA 分配的其中一個 VID 進行測試。選取下列其中一個選項:0xFFF10xFFF20xFFF30xFFF4

如要使用正式版 VID,以便認證及發布整合服務,您必須先請 Google 驗證該 VID,確保是由 CSA 核發給您。

這個 VID 應實作於裝置的韌體中。

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

VID 和 PID 只能用於單一整合服務,且只能使用一次。如要在整合中沿用 VID 或 PID,請採取下列任一做法:

  • 使用 VID 或 PID 將整合功能編輯為其他 VID 或 PID。
  • 使用 VID 或 PID 刪除整合。
表格:供應商 ID (VID) 和裝置類型配對情境
哪些類型使用者可將裝置委派至 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叢集尚未向使用者公開,但系統可能會使用這些叢集。在大多數情況下,這表示透過這些叢集公開的屬性不會向使用者顯示:

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines.
  • All Media clusters. Equivalent functionality is available via Google Cast.

¹ 請參閱「開啟/關閉燈具開關」,瞭解這項異動對開啟/關閉燈具開關的影響。