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 程序中会根据需要列出说明。

如何构建

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

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

之后，请查看我们的支持的设备列表，确保您所使用的设备 Google Home 生态系统支持此功能。 然后通读开发者核对清单，全面了解 从创建项目到发布的整个开发流程。

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

定义

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

边界路由器
实现通用 Thread 边框的 hub 适用于已启用 Thread 的设备的路由器。
Hub
一台受支持的 Google Nest 设备，例如 Google Nest Hub (2nd gen)。 必须使用 hub 才能通过以下设备控制支持Matter的设备： 例如 Assistant、 GHA和智能显示屏。
支持 Matter 的设备
已刷写了 启用了 Matter 的 build 或示例应用。
移动设备
用于协助配对的测试手机。目前，这是一个 Android 部手机。

前提条件

<ph type="x-smartling-placeholder"></ph>
适用于 Matter 的推荐 IDE 扩展程序 开发

为了将支持 Matter 的设备与 Google Home 生态系统，开发者必须具备以下条件：

  1. 一个提供 Thread 支持的 Google Hub 既可用作支持 Thread 的设备的边界路由器，也可用作本地路由器 用于路由智能家居 intent 的执行方式路径。
  2. 满足最低要求的移动设备（测试手机）： <ph type="x-smartling-placeholder">
      </ph>
    • Android O（8.1，API 级别 27 或更高版本）
    • iOS（v16.5 或更高版本）
    • BLE 功能
  3. 供应商 ID (VID) 和产品 ID (PID) 启用了 Matter 的设备。
  4. 一部启用了 Matter 的设备。此设备应为以下类型之一： 以下国家/地区中支持的 Matter 种设备类型 Google Home 生态系统，可以是：
    • 您自己的商品，其中含有已启用 Matter 的固件。
    • 以下 Matter 设备之一用于 端到端验证：
表格：Matter 芯片供应商的示例
供应商 平台 Thread 支持 指南
布法罗实验室 BL602
BL702
埃斯普利夫 ESP32 OTA 测试
北欧半导体 nRF52840 丹麦 OTA 测试
NXP IOTZTB-DK006 开发 套件
Realtek Ameba D 系列
Silicon Labs EFR32MG24 开发套件
EFR32MG Zigbee 和 Thread 新手套装
特林克 TLSR9518
德州乐器 CC2652R7 LaunchPad 开发 套件

供应商 ID

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

要使用正式版 VID，以便您的集成可以获得认证和发布，您必须先 由 Google 进行验证，以确保 CSA 已将其发放给您。

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

只能在 Google Home 中配对 Matter 设备 生态系统。

  • 测试 VID 不能用于消费类设备。
  • 您的正式版 VID 必须由Connectivity Standards Alliance (Alliance)签发。Google 会 验证您是该 VID 的所有者，然后才能在 Google Home Developer Console 中使用该 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基本信息集群。在您的 设备的固件必须与 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 请参阅开/关灯开关 了解这对开/关灯开关有何影响。

下一页
开发者核对清单