Matter 使用入门

借助 Google 的 Home 开发者计划，设备制造商可以将自己的智能家居设备与 Google Home 生态系统连接起来。我们正在扩展 智能家居操作本地执行方式路径，使其能够添加 Matter设备，以便使用 Google Home app (GHA)进行设置，并使用 Google Assistant、 GHA或智能显示屏（例如 Google Nest Hub (2nd gen)）来控制这些设备。

本文档介绍了如何在 Google Home 生态系统中开始构建和集成 Matter的平台。

免责声明

关于 Matter 文档中介绍的程序，请注意以下事项：

  • 我们建议用于开发的账号仅连接一个 Matter 的 hub 进行测试。如果在测试期间同时连接多个 Matter启用 Matter 的 hub 或连接到同一结构，可能会导致 不可预测的行为。
  • 所有程序都假定使用运行 Ubuntu 20.04 的 Linux 机器来 构建和刷写 Matter 示例，这些示例已由 Google 测试。 虽然支持 macOS 机器，但建议使用 Linux。程序中会根据需要调用特定于 Mac 的说明。

如何构建

如需构建与 Google Home 生态系统集成的 Matter-enabled 设备，您需要使用与 Matter 兼容的开发板和 Matter SDK。

最简单的入门方法是学习我们的 Codelab。我们建议您至少学习以下 Codelab 之一：

学习完 Codelab 后，查看我们的受支持设备 列表，以确保您计划集成的设备受 Google Home 生态系统支持。 然后，阅读开发者核对清单 ，了解从创建项目到发布的整个开发流程。

受支持设备 开发者核对清单

定义

本文档中使用了以下术语：

边界路由器
一种集线器，可为支持Thread Border Router for Thread-enabled devices.
Hub
受支持的 Google Nest 设备，例如 Google Nest Hub (2nd gen)。 如需通过 其他界面（例如 Assistant、 GHA 和智能显示屏）控制启用 Matter-的设备，您需要使用 hub。
启用 Matter 的设备
已刷写启用 Matter Matter 的 build 或示例应用的设备或开发板。
移动设备
用于协助配对的测试手机。目前，这是一款 Android 手机。

前提条件

针对 Matter 开发的推荐 IDE 扩展程序

如需将启用 Matter 的设备与 Google Home 生态系统完全集成，开发者必须具备以下条件：

  1. 支持 Thread 的 Google hub ，既可充当启用 Thread 的设备的边界路由器，也可充当用于传递智能家居 intent 的本地 执行方式路径。
  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 支持 指南
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 是由联盟向您颁发的。

此 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.

¹ 如需了解这对 On/Off Light Switches 有何影响，请参阅 On/Off Light Switches。

下一页
开发者核对清单