開始使用 Matter

透過 Google 的 Google Home 開發人員計畫，裝置製造商可將其智慧住宅裝置連結至 Google Home 生態系統。我們也將擴充智慧住宅動作的本機執行要求路徑，現在能夠使用 Google Home app (GHA) 新增支援 Matter 的裝置來進行設定，並使用 Google Assistant、GHA 或智慧螢幕 (例如 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)。必須有中樞裝置，才能透過其他介面 (例如 Assistant、GHA 和智慧螢幕) 控制支援 Matter 的裝置。
支援 Matter 的裝置
使用已啟用 Matter 的建構或範例應用程式刷新的裝置或開發板。
行動裝置
用於協助配對的測試手機。目前這是 Android 電話。

必要條件

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

如要將支援 Matter 的裝置與 Google Home 生態系統完全整合，開發人員必須符合以下條件：

  1. 支援 Thread 的 Google 中樞，可做為支援 Thread 的裝置的邊界路由器，以及轉送智慧型住宅意圖的本機執行要求路徑。
  2. 符合基本規格的行動裝置 (測試手機)：
    • Android O (8.1，API 級別 27 或以上)
    • iOS (v16.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 系列 快速入門
Silicon Labs EFR32MG24 開發人員套件 快速入門
EFR32MG Zigbee 和 Thread 入門套件 快速入門
網路連結 TLSR9518 快速入門
德州樂器 CC2652R7 LaunchPad 開發套件 快速入門

供應商 ID

根據預設，您可以使用 CSA 分配的其中一個 VID 進行測試。選取下列其中一個選項：0xFFF1、0xFFF2、0xFFF3、0xFFF4。

如要使用正式版 VID，以便 Google 驗證您的整合功能並啟動整合程序，您必須先通過 Google 驗證，確認該整合是由 CSA 核發給您。

請將這個 VID 導入裝置的韌體中。

只有在特定供應商 ID 和裝置類型情境下，Matter 裝置才能在 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 中並沒有整合功能
實際工作環境 Developer Console 中已有 Alliance DCL 認證與整合功能

產品 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 請參閱「開啟/關閉燈具開關」，瞭解這對於開啟/關閉燈具開關的影響。

下一頁
開發人員檢查清單