开发者预览版
借助 Google 的 Home 开发者计划,设备制造商可以将他们的智能家居设备与 Google Home 生态系统连接起来。我们将扩展智能家居 Action 本地执行方式路径,使其能够使用 Google Home app (GHA) 添加支持 Matter 的设备进行设置,并使用 Google Assistant、GHA 或 Google Nest Hub (2nd gen) 等智能显示屏控制这些设备。
本文档介绍了如何开始在 Google Home 生态系统中构建和集成支持 Matter 的平台。
免责声明
关于此开发者预览版 Matter 中描述的过程,请注意以下事项:
- 用于开发的帐号应仅连接一个支持 Matter 的 hub 以进行测试。如果有多个支持 Matter 的 hub 在同一时间连接或连接到同一结构,可能会导致不可预测的行为。
- 所有过程都假定使用运行 Ubuntu 20.04 的 Linux 机器来构建和刷写经过 Google 测试的 Matter 示例。虽然系统支持 MacOS 计算机,但建议使用 Linux。您可以根据需要在程序中列出特定于 Mac 的说明。
定义
本文档中会用到以下术语:
- 边界路由器
- 为支持 Thread 的设备实现通用 Thread 边界路由器的 hub。
- Hub
- 受支持的 Google Nest 设备,例如 Google Nest Hub (2nd gen)。 需要有一个 hub 才能通过其他 surface(例如 Assistant、GHA 和智能显示屏)控制支持 Matter 的设备。
- 支持Matter的设备
- 一个设备或开发板,刷入了启用了 Matter 的 build 或示例应用。
- 移动设备
- 用于辅助配对的测试手机。目前是“Android”座机。
前提条件
若要将支持 Matter 的设备与 Google Home 生态系统完全集成,开发者必须:
- 具有 Thread 支持的 Google Hub,可用作支持 Thread 的设备的边界路由器,以及充当智能家居 intent 路由的本地执行方式路径。
- 满足最低要求的移动设备(测试手机):
- Android O(8.1,API 级别 27 或更高版本)
- iOS(v16.5 或更高版本)
- BLE 功能
- 已启用 Matter 的设备的供应商 ID (VID) 和产品 ID (PID)。
- 一台支持 Matter 的设备。此设备应为 Google Home 生态系统目前支持的 Matter 设备类型之一,可以是:
- 您自己的产品(具有支持 Matter 的固件)。
- 受支持的供应商平台的开发板,可用作支持 Matter 的设备进行端到端验证。支持以下平台:
供应商 | 平台 | 指南 | Thread 支持 |
---|---|---|---|
布法罗实验室 | BL602 | 快速入门 | |
BL702 | 快速入门 | ||
埃斯普利夫 | ESP32 | 快速入门
OTA 测试 |
|
北欧半导体 | nRF52840 丹麦克朗 | 快速入门
OTA 测试 |
|
荷兰盾 | IOTZTB-DK006 开发套件 | 快速入门 | |
Realtek | Ameba D 系列 | 快速入门 | |
Silicon Labs | EFR32MG24 开发套件 | 快速入门 | |
EFR32MG Zigbee 和 Thread Starter Kit | 快速入门 | ||
特林克 | TLSR9518 | 快速入门 | |
德克萨斯乐器 | CC2652R7 LaunchPad 开发套件 | 快速入门 |
供应商 ID
默认情况下,您可以使用 CSA 分配的其中一个 VID 进行测试。选择以下其中一项:0xFFF1
、0xFFF2
、0xFFF3
、0xFFF4
。
若要使用正式版 VID,您的集成可以获得认证并发布,您必须先经过 Google 验证,以确保 CSA 向您签发该 VID。
此 VID 应在设备的固件中实现。
只有在特定供应商 ID 和设备类型场景中,Matter 设备才能在 Google Home 生态系统中配对。
- 测试 VID 无法在消费类设备上使用。
- 您的正式版 VID 必须由 CSA 签发。Google 会先验证您是该 VID 的所有者,然后您才能在 Google Home Developer Console 中使用此 VID。完成后,您将能够为该 VID 创建集成。
- 出于开发和现场试验的目的,必须在 Developer Console 中创建项目并将其与相应的 VID 和 PID 组合集成。调试设备的用户必须是项目的成员,或者属于现场试验用户列表。
- 消费者产品只有在 CSA 认证后才能使用。
哪些类型的用户可以委托设备加入 Google Home 生态系统? | |||
---|---|---|---|
VID 类型 | VID 认证和控制台集成状态 | 正式版
(消费者用户) |
开发
(开发者、现场试验用户) |
测试 | “Developer Console”中无集成(无法认证) | ||
测试 | 集成存在于 Developer Console 中(无法认证) | ||
正式版 | 未经认证,Developer Console 中不存在集成 | ||
正式版 | 未经认证,集成存在于 Developer Console 中 | ||
正式版 | 已通过 CSA DCL 认证,Developer Console 中不存在集成 | ||
正式版 | 已通过 CSA DCL 认证,Developer Console 中存在集成 |
产品 ID
系统会从 Matter 基本信息集群读取设备的相关信息。设备固件中编码的产品 ID 必须与开发者控制台中 Matter 集成的产品 ID 一致。
不支持的功能
某些 Matter 集群尚未向用户公开,但可供系统使用。在大多数情况下,这意味着最终用户不会看到通过这些集群公开的属性:
集群类型 | 集群 |
---|---|
Core |
|
应用 |
|
1 请参阅开启/关闭灯开关,了解这对开启/关闭灯开关有何影响。