開始使用 Matter

Google 的 Home 開發人員計畫可讓裝置製造商將智慧住宅裝置與 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 專屬操作說明。

建構方式

如要建構支援 Matter 的裝置並整合 Google Home 生態系統,請使用與 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 的裝置。這部裝置應為 Google Home 生態系統支援的 Matter 裝置類型,可能包括:
    • 你的產品 (採用已啟用 Matter 的韌體)。
    • 用於端對端驗證的 Matter 裝置之一:
表格:Matter 晶片供應商的例子
供應商 平台 Thread 支援服務 指南
水牛實驗室 BL602
BL702
深褐色塗層 ESP32 OTA 測試
北歐半導體業 nRF52840 DK OTA 測試
NXP IOTZTB-DK006 開發套件
Realtek Ameba D 系列
矽膠研究室 EFR32MG24 開發人員套件
EFR32MG Zigbee 和 Thread 入門套件
同步連結 TLSR9518
德州樂器 CC2652R7 LaunchPad 開發套件

供應商 ID

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

如要使用實際工作環境 VID,以便通過整合認證及推出整合作業,您必須先通過 Google 驗證,確保整合者是由 CSA 核發給您。

這個 VID 應導入裝置韌體。

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

產品 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.

1 如要瞭解這項操作對開啟/關閉燈具開關的影響,請參閱開啟/關閉燈具開關