Matter 使用入门

Google 的 Home 开发者计划允许设备制造商将其智能家居设备与 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 的说明。

如何构建

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

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

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

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

定义

本文档中会用到以下术语：

边界路由器
一种为支持 Thread 的设备实现通用 Thread 边界路由器的 Hub。
Hub
支持的 Google Nest 设备，例如 Google Nest Hub (2nd gen)。 您需要使用 hub 才能通过其他平台（例如 Assistant、GHA 和智能显示屏）控制启用 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 Dev Kit
EFR32MG Zigbee 和 Thread 入门套件
Telink TLSR9518
Texas Instruments CC2652R7 LaunchPad 开发套件

供应商 ID

默认情况下，您可以使用 CSA 分配的 VID 之一进行测试。选择以下其中一项：0xFFF1、0xFFF2、0xFFF3、0xFFF4。

如需使用生产 VID 以便认证和发布您的集成，您必须先让 Google 验证该 VID，以确保 CSA 已将其签发给您。

此 VID 应在设备的固件中实现。

Matter 设备只能在 Google Home 生态系统中与特定供应商 ID 和设备类型配对。

  • 测试 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 删除集成。
表格：供应商 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.

¹ 如需了解这对“开启/关闭”灯具开关有何影响，请参阅“开启/关闭”灯具开关。

下一页
开发者核对清单