Matter 使用入门

Google 的 Home 开发者计划允许设备制造商将其智能家居设备与 Google Home 生态系统相关联。我们正在扩展智能家居 Action 本地执行方式路径，使其能够添加支持 Matter 的设备以使用 Google Home app (GHA) 进行设置，并使用 Google Assistant、GHA 或 Google Nest Hub (2nd gen) 等智能显示屏控制这些设备。

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

免责声明

关于 Matter 文档中所述的过程，请注意以下几点：

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

如何构建

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

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

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

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

定义

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

边界路由器
一个 hub，用于为已启用 Thread 的设备实现通用 Thread 边界路由器。
Hub
受支持的 Google Nest 设备，例如 Google Nest Hub (2nd gen)。需要使用 hub 才能通过其他 surface（例如 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 支持 指南
布法罗实验室 BL602
BL702
埃斯普利夫 ESP32 OTA 测试
北欧半导体 nRF52840 DK OTA 测试
恩 XP (NXP) IOTZTB-DK006 开发套件
Realtek Ameba D 系列
Silicon Labs EFR32MG24 开发套件
EFR32MG Zigbee 和 Thread 入门套件
特林克 TLSR9518
德州乐器 CC2652R7 LaunchPad 开发套件

供应商 ID

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

如需使用正式版 VID，以便您的集成可以获得认证和发布，您必须先让 Google 验证该 VID，以确保该 VID 是由 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 认证和 Play 管理中心集成状态 正式版
（消费者用户）		 开发
（开发者、现场试验用户）
测试 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 请参阅开/关灯开关，了解这对开/关灯开关有何影响。

下一页
开发者核对清单