测试 Matter 集成

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

用于集成的供应商 ID 和产品 ID 的设备必须在与 Developer Console 一起使用的帐号的 Google Home app (GHA) 中调试并提供,这样才能进行测试。如需了解详情,请参阅配对 Matter 设备

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

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

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

测试计划类型

测试计划分为两种:

  • 开发测试计划用于使用 Matter 对设备进行测试。它们可修改,但无法提交以进行 Matter 认证。

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

集成版本

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

绝不会通过其他编号版本创建新版本。例如,您为集成创建的第一个测试计划将为该集成创建版本 v.1。创建其他测试计划将为该集成创建版本 v.2,但此版本并不是以 v.1 为基础。相反,此版本基于不带版本号的集成实例,与 v.1 相同。

集成的“不适用”版本表示集成的未版本化实例,在开发标签页上进行管理。

换言之,在 Developer Console 中的 Matter > Test 上:

  • 如果您针对集成的版本“N/A”点击测试,系统将创建一个新版本。版本号将比任何现有的编号版本高 1。
    • 如果不存在编号版本,则会创建版本 v.1
    • 如果存在版本 v.1,则会创建版本 v.2。如果存在版本 v.2,则会创建版本 v.3,以此类推。
  • 如果您针对集成的编号版本(例如 v.1)点击测试,则系统不会创建新版本。v.1而是再次测试版本 v.1

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

创建测试计划

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

在制定认证测试计划之前,请确保您已完成以下事项

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

如果您尚未针对集成完成所有这些操作,则无法对为认证测试创建的集成版本进行认证您必须创建一个新版本,这意味着要重新执行测试、现场试验和认证步骤。

如果您想在集成版本认证之前更新品牌信息,则还必须创建一个新版本并重新开始。

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

前往 Play 管理中心

  1. 从项目列表中,点击要处理的项目旁边的打开

  2. 在页面左侧的导航菜单中,依次点击 Matter > 测试

  3. 点击测试,找到要测试的集成的版本“不适用”。此操作会创建新的集成版本

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

    • 如果您正在为 Google 生态系统中的认证做准备,请选择 Certification test(认证测试)。
    • 开发测试不能用于认证。
  5. 点击测试。如果您收到 No device found 错误屏幕,则表示此集成的设备尚未委托到生态系统中。如需了解详情,请参阅排查配对问题

  6. Configure your test 屏幕上,为测试提供名称,然后从设备列表中选择要测试的设备。

  7. 点击 Next: Test plan 按钮。

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

创建测试计划

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

运行测试方案

Test Suite创建测试计划页面中,点击运行测试。此时将显示测试环境页面,其中包含所有测试的状态和日志。

测试完成后,系统会显示测试结果。每个测试套件执行作业的状态旁边会显示相应的状态(“已通过”“失败”)。

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

测试结果

如需从测试环境页面重新测试测试计划,请在测试执行完成后点击顶部的 重新测试

完成后:

查看和解读测试结果

Test SuiteTest history 页面上,您可以查看开发方案或未提交的认证测试计划的过往测试结果,方法是点击 Test plan 部分中所需测试计划对应的 Retest,系统随即会转到测试环境页面,该页面会显示该测试结果。

测试历史记录

对于已提交的认证方案,点击已保存供认证部分中的结果以查看测试结果报告。

您还可以通过 Developer Console 中的 Test 标签页访问集成版本的测试结果。点击该页面上列出任何集成版本的测试历史记录查看,即可转到 Test Suite 中的测试历史记录页面。

控制台状态

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

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

测试并保存版本。

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

如果需要,请重新测试

问题排查

测试套件中未显示调试的设备

如果您已将设备与测试供应商 ID (VID) 和产品 ID (PID) 配对,但当您尝试在 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 从 Service Data 字段的第四个字节开始列为 5A23FFFE。这表示 VID 为 5A23,PID 为 FFFE,两者均采用小端字节格式

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

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

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