开发者预览版
Google 的 Home 开发者计划允许设备制造商将其智能家居设备与 Google Home 生态系统连接起来。我们将扩展智能家居 Action 本地执行方式路径,并能够添加 Matter-enabled devices for setup using the Google Home app (GHA) on Android and control them using Google Assistant, GHA, or smart displays like the Google Nest Hub (2nd gen).
本文档介绍了如何开始在 Google Home 生态系统中构建和集成 Matter 支持的平台。
免责声明
对于 Matter 的开发者预览版本中所述的过程,请注意以下事项:
- 用于开发的帐号应仅连接一个启用了 Matter 的 hub 以进行测试。如果同时连接多个启用了 Matter 的 hub 或在测试期间连接到同一结构,可能会导致不可预测的行为。
- 所有过程都假定使用运行 Ubuntu 20.04 的 Linux 机器进行构建和刷写 Matter 示例,这些示例已经过 Google 测试。虽然支持 MacOS 机器,但建议使用 Linux。我们会根据需要在 Mac 中列出专门针对 Mac 的说明。
- 仅支持 Android 版本的 GHA。
定义
本文档中使用了以下术语:
- 边界路由器
- 实现通用的 hubThread Border Router for Thread-enabled devices.
- Hub
- 支持的 Google Nest device, such as the Google Nest Hub (2nd gen). A hub is required to control Matter-enabled devices through other surfaces such as Assistant, the GHA, and smart displays.
- 支持Matter的设备
- 已刷入启用了 Matter 的 build 或示例应用的设备或开发板。
- 移动设备
- 用于辅助配对的测试手机。目前,这是一个 Android phone.
前提条件
若要将支持 Matter 的设备与 Google Home 生态系统完全集成,开发者必须满足以下条件:
- 一个支持线程的 Google hub,可同时用作启用线程的设备的边界路由器,以及路由智能家居 intent 的本地执行路径。
- 满足最低要求的移动设备(测试手机):
- Android O(8.1,API 级别 27)或更高版本(iOS 支持将在日后添加)
- 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 | EFR32MG Zigbee 和 Thread Starter Kit | 快速入门 | |
EFR32MG24 开发套件 | 快速入门 | ||
链接 | TLSR9518 | 快速入门 |
供应商 ID
默认情况下,您可以使用 CSA 分配的其中一个 VID 进行测试。选择以下选项之一:0xFFF1
、0xFFF2
、0xFFF3
、0xFFF4
。
如需使用生产 VID 来对您的集成进行认证和发布,您必须先由 Google 对其进行验证,以确保 CSA 向您发放该集成。
此 VID 应在设备的固件中实现。
在某些供应商 ID 和设备类型场景中,Matter 设备只能在 Google Home 生态系统中配对。
- 测试 VID 无法在消费类设备上使用。
- 若要配对生产(消费者)设备,设备必须获得 CSA DCL 认证。
- 出于开发和现场试验目的,设备必须在 Google Home Developer Console 中注册。
哪些类型的用户可以委托设备加入 Google Home 生态系统? | |||
---|---|---|---|
VID 类型 | VID 认证和注册状态 | 正式版
(消费者用户) |
开发
(开发者、现场试用用户) |
测试 | 未注册(无法获得认证) | 不适用 | 不适用 |
测试 | 已在Developer Console注册(无法获得认证) | 不适用 | |
生产 | 未认证,未注册 | 不适用 | |
生产 | 未经认证,已在Developer Console注册 | ||
生产 | 在 CSA DCL 中认证,未注册 | 不适用 | |
生产 | 在 CSA DCL 中获得认证并在Developer Console注册 |
产品 ID
使用 Matter 描述符集群(而不是产品 ID)读取设备的相关信息。您可以在开发期间根据公司编号方案分配任何产品 ID,只要与 Matter 集成的产品 ID 匹配(若指定)。
不支持的功能
某些 Matter 集群尚未提供给用户,但可供系统使用。在大多数情况下,这意味着最终用户将无法看到通过这些集群公开的属性:
集群类型 | 集群 |
---|---|
Core |
|
应用 |
|