借助 Google 的 Home 开发者计划,设备制造商可以将其智能家居设备与 Google Home 生态系统连接。我们正在扩展智能家居 Action 本地执行路径,以便能够添加支持 Matter 的设备,从而使用 Google Home app (GHA) 进行设置,并使用 Google Assistant、GHA 或 Google Nest Hub (2nd gen) 等智能显示屏进行控制。
本文档介绍了如何开始在 Google Home 生态系统中构建和集成支持 Matter 的平台。
免责声明
关于 Matter 文档中介绍的过程,请注意以下事项:
- 我们建议用于开发的账号仅连接一个启用了 Matter 的 hub 进行测试。在测试期间,同时连接多个启用了 的 Hub 或将多个启用了 的 Hub 连接到同一结构可能会导致不可预测的行为。Matter
- 所有过程均假设使用运行 Ubuntu 20.04 的 Linux 机器来构建和刷写 Matter 示例,这些示例已经过 Google 测试。虽然支持 macOS 机器,但建议使用 Linux。如有需要,我们会在操作步骤中注明 Mac 专用说明。
如何构建
如需构建与 Google Home 生态系统集成的支持 Matter 的设备,您需要使用与 Matter 兼容的开发板和 Matter SDK。
最简单的入门方法是学习我们的 Codelab。建议至少学习以下 Codelab 之一:
学习完 Codelab 后,查看我们的受支持设备列表,以确保您计划集成的设备受 Google Home 生态系统支持。 然后,阅读开发者核对清单,了解从创建项目到发布的整个开发流程。
定义
本文档中会用到以下术语:
- 边界路由器
- 为支持 Thread 的设备实现通用 Thread 边界路由器的集线器。
- Hub
- 受支持的 Google Nest 设备,例如 Google Nest Hub (2nd gen)。 如需通过其他界面(例如 Assistant、GHA和智能显示屏)控制支持 Matter 的设备,则需要使用 hub。
- 支持 Matter 的设备
- 已刷写支持 Matter 的 build 或示例应用的设备或开发板。
- 移动设备
- 用于协助配对的测试手机。目前,这是一部 Android 手机。
前提条件
为了将支持 Matter 的设备与 Google Home 生态系统完全集成,开发者必须具备以下条件:
- 支持 Thread 的 Google hub,既可作为支持 Thread 的设备的 border router,也可作为用于传递智能家居 intent 的本地执行方式路径。
- 满足最低要求的移动设备(测试手机):
- Android O(8.1,API 级别 27 或更高级别)
- iOS(v16.5 或更高版本)
- BLE 功能
- 支持 Matter 的设备的供应商 ID (VID) 和产品 ID (PID)。
- 支持 Matter 的设备。此设备应是 MatterGoogle Home 生态系统中支持的设备类型之一,可以是:
- 您自己的产品,且固件支持 Matter。
- 以下任一 Matter 设备,用于端到端验证:
| 供应商 | 平台 | Thread 支持 | 指南 |
|---|---|---|---|
| 博流智能 | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | OTA 测试 | |
| Nordic Semiconductor | nRF52840 DK | OTA 测试 | |
| NXP | IOTZTB-DK006 开发套件 | ||
| Realtek | Ameba D 系列 | ||
| Silicon Labs | EFR32MG24 开发套件 | ||
| EFR32MG Zigbee 和 Thread 入门套件 | |||
| 泰凌微电子 | TLSR9528 | Telink Matter 开发者指南 | |
| Texas Instruments | CC2652R7 LaunchPad 开发套件 |
供应商 ID
默认情况下,您可以使用联盟分配的其中一个 VID 进行测试。选择以下选项之一:0xFFF1、0xFFF2、0xFFF3、0xFFF4。
如需使用生产 VID 来认证和发布集成,您必须先让 Google 验证该 VID,以确保该 VID 是由联盟签发给您的。
此 VID 应在设备的固件中实现。
Matter 设备只能在特定供应商 ID 和设备类型场景下在 Google Home 生态系统中配对。
- 测试 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 删除集成。
| 哪些类型的用户可以将设备调试到 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 集群尚未向用户公开,但系统可能会使用这些集群。在大多数情况下,这意味着通过这些集群公开的属性对最终用户不可见:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ 请参阅开关灯,了解这对开关灯有何影响。