测试 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 中的 Test Suite 提交测试结果以进行认证。如果您想在开发期间出于测试目的运行 Test Suite,请参阅Google Home 测试套件页面,了解独立版本。

集成版本

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

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

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

换句话说,在 Developer Console 中依次选择 Matter > 测试

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

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

创建测试计划

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

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

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

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

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

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

前往 Play 管理中心

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

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

  3. 针对您要测试的集成版本 N/A 点击测试。此操作会创建新的集成版本

  4. 选择开发测试认证测试创建新测试计划

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

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

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

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

创建测试计划 如果您想退出 Test Suite,请点击 返回开发者中心

运行测试计划

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

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

Logs 窗格会显示各个测试执行的状态。

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

完成后:

查看和解读测试结果

Test Suite测试历史记录页面上,您可以查看开发计划或未提交的认证测试计划的之前测试结果,只需在测试计划部分中点击所需测试计划的重新测试即可。这会将您转到测试环境页面,该页面会显示该测试的结果。

测试历史记录

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

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

控制台状态

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

对应的节 状态 说明 要求 可采取的措施
可供测试 准备就绪 此版本的 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 0xFFF10xFFF4 预留用于测试。它们可用于基本调试和控制测试,但不能在以下开发阶段使用:

使用蓝牙工程应用(例如 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