测试 Matter 集成

Google Home Developer Console 提供了一个 Test 页面,您可以在其中 针对您的 Matter 配置和运行测试 Google Home Test Suite 进行集成。通过 Test Suite 是一个内置于 用于处理所有集成测试的 Developer Console

集成的供应商 ID 和产品 ID 所对应的设备必须处于调试状态 并在 Google Home app (GHA) 中针对与 Developer Console 才能进行测试。请参阅配对诉讼或调查 设备

Test Suite 可以在属于 特定的 Matter 项目配置。请务必对集成运行 Test Suite,以确保一切正常运行。

测试页面上,已完成且可以测试的 Matter 集成会列在可以测试中。

已测试的 Matter 集成会列在已测试部分。

测试计划的类型

测试计划有两种:

  • 开发测试计划用于测试使用以下各项控制设备: Matter。它们可以修改,但无法提交 获得 Matter 认证。

  • 认证测试计划专门用于 Matter 认证,无法修改。选择此选项会创建 Matter 集成的新版本。

集成版本

当您为认证创建测试计划时,系统会创建集成的新版本。此编号为 版本在Developer Console的所有集成列表中列出 从“测试”标签页开始

系统绝不会根据其他编号版本创建新版本。例如,您为集成创建的第一个测试计划将为该集成创建版本 v.1。创建另一个测试计划将为其创建版本 v.2 但此版本不会以 v.1 为基础。此版本 基于无版本控制的集成实例,与 v.1 相同。

集成的 N/A 版本表示集成的无版本实例,该实例在开发标签页中进行管理。

换句话说,在 Matter >测试Developer Console:

  • 如果您针对集成的“不适用”版本点击测试,则会生成新的版本 创建。版本号将比任何现有编号高一 版本。
    • 如果不存在编号版本,系统会创建版本 v.1
    • 如果存在版本 v.1,系统会创建版本 v.2。如果版本为 v.2 创建版本 v.3,依此类推。
  • 如果您点击测试获取编号版本的集成( (例如 v.1),则不会创建新版本。相反,版本v.1是 重新测试。

如需了解详情,请参阅集成版本控制

创建测试计划

集成版本是未版本化集成的快照。这意味着 因此,当您创建认证测试计划时 版本,所有与该集成相关的元数据都必须是 希望用于已发布的集成

在创建用于认证的测试计划之前,请确保您已完成以下操作:

  1. 创建公司资料
  2. 输入了正式版供应商 ID (VID)
  3. 配置的设置和品牌信息

如果您还没有为集成完成所有这些操作, 为认证测试而创建的版本无法获得认证您将拥有 以创建新版本,即重新进行测试、现场试验和认证 步骤。

此外,如果您想 请在集成版本认证之前更新您的品牌信息。

如需创建测试计划,请执行以下操作:

转到 Developer Console

  1. 在项目列表中,点击要关联的项目旁边的打开

  2. 在页面左侧的导航菜单中,前往 Matter >测试

  3. 针对要测试的集成,点击测试对应的版本“不适用”。这个 操作创建新的集成版本

  4. 选择开发测试认证测试作为测试类型。 创建新的测试计划

    • 如果您准备在下列国家/地区进行认证,请选择认证测试 Google 生态系统。
    • 开发测试不能用于认证。
  5. 点击测试。如果您收到未找到设备错误屏幕,则表示用于此集成的设备尚未委托到该生态系统中。如需了解详情,请参阅配对问题排查

  6. Configure your test 屏幕上,为测试命名并 从设备列表中选择要测试的设备。

  7. 点击下一步:测试计划按钮。

  8. 创建测试计划页面的测试套件部分中,选择要运行的测试套件。

创建测试计划

如果您想退出Test Suite,请点击 返回开发者 中心

运行测试方案

Test SuiteCreate a test plan 页面中, 点击 Run Test。系统会显示测试环境页面,其中包含状态和 所有测试的日志。

测试结果会在测试完成后显示。每个测试套件的状态 执行会显示在其旁边(通过、失败)。

日志窗格显示每个测试作业的状态。

测试结果

要从测试环境页面重新测试某个测试计划,请点击 重新测试(位于顶部) 。

完成后:

查看和解读测试结果

Test Suite 中的 Test history 页面上,您可以查看 开发计划或未提交的认证的过往测试结果 测试计划,方法是在测试计划中点击所需的测试计划对应的重新测试 部分。您将转到测试环境页面,该页面会显示 该测试的结果。

测试历史记录

对于已提交的认证计划,请点击保存对象中的结果 证书部分,以查看测试结果报告。

也可以从 Test 中访问集成版本的测试结果 “Developer Console”中的标签页。点击查看以查看测试历史记录 该页面上列出的任何集成版本,以转到测试历史记录 页面(位于 Test Suite 中)。

控制台状态

在测试阶段,控制台会遇到以下状态:

Section 状态 说明 要求 可采取的措施
可供测试 准备就绪 此版本的 integration 已可供测试。 不适用 测试此版本的 integration。
已验证 准备就绪 此版本的 integration 已经过测试,可以 提交以进行现场试验或认证。

版本已经过测试并保存。

所有失败的测试用例都包含需要 Google 审核的理由。

如果需要,请重新测试

问题排查

已委托的设备未显示在测试套件中

如果您已将某个设备与测试供应商 ID (VID) 和产品 ID (PID) 配对,但 但当您尝试使用 Test 测试设备时, 套件位于Developer Console,这可能是由于以下原因造成的: 在多个集成中使用相同的测试 VID 和 PID 组合。

如需排查问题,请从 Developer Console 中移除所有测试设备,然后进行配对 要再次测试的设备

要验证配对的制造商是否正确,您可以设置制造商和 设备的型号信息(CHIP_DEVICE_CONFIG_DEVICE_* 值) 唯一值。

如需了解详情,请参阅设备信息 信息。

验证设备的 VID/PID

如果您想开始开发与 Google 的集成,则必须创建一个 项目以及 Google Home 控制台上的集成。

排查蓝牙嗅探器问题

设备发送的 VID/PID 值应与您输入到 Developer Console 项目中的 VID/PID 相匹配。

  • VID 0xFFF1 - 0xFFF4 已预留用于测试。它们可能会用于 基本的调试和控制测试,但在测试期间 以下开发阶段:

使用蓝牙工程应用,例如 nRF Connect for Mobile、 您可以在服务数据字段中看到信标设备的 VID/PID。

在这张来自 Android 版 nRF Connect 的屏幕截图中, 您会看到 VID/PID 列为 5A23FFFE(从第 4 个字节开始) Service Data(服务数据)字段。这表示 VID 为 5A23,PID 为 FFFE - 均采用小端格式

BLE 应用以小字节序显示值,但 VID/PID 值 您输入 Developer Console 项目的是大端序。

根据蓝牙嗅探器显示的内容,验证您是否已在 Actions 控制台项目中输入正确的值和格式。

对于示例屏幕截图中的值, Developer Console 分别为 235AFEFF