测试 Matter 集成

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

必须将集成供应商 ID 和产品 ID 对应的设备调试好,并确保这些设备在 Google Home app (GHA) 中可供与 Developer Console 搭配使用的账号使用,以便进行测试。如需了解详情,请参阅配对 Matter 设备。

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

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

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

测试计划的类型

您可以选择以下类型的测试计划:

  • 开发测试计划用于测试使用 Matter 控制设备。这些测试结果可修改,但无法提交进行 Matter 认证。

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

  • CSA Interop 测试计划允许您跳过测试阶段,直接使用 Connectivity Standards Alliance (Alliance) Interop Test Lab 结果。此测试选项适用于所有受支持的设备类型,并且是与 Aliro 兼容的门锁获得 Aliro 认证的唯一有效选项。

使用 Developer Console 中的 Test Suite 提交测试结果以进行认证。如果您想在开发期间运行 Test Suite 进行测试,请参阅 Google Home 测试套件页面,了解独立版本。

集成版本

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

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

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

也就是说,在 Developer Console 中的 Matter > Test 中:

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

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

创建测试计划

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

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

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

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

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

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

创建包含三个选项的新测试计划

前往开发者控制台

  1. 在项目列表中,点击要使用的项目旁边的打开。

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

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

  4. 选择测试类型,然后点击测试。

    • 如果您准备在 Google 生态系统中进行认证,请选择认证测试。
    • 开发测试不能用于认证。
    • 选择 CSA Interop test,即可使用 Alliance Interop Test Lab 结果跳过 Matter 集成流程中的“测试”和“现场试验”阶段。选择 CSA Interop 测试后,为配置配置文件分配一个跟踪名称,映射设备产品 ID (PID),然后点击提交,直接进入认证。

      对于与 Aliro 兼容的门锁,您必须选择 CSA Interop test 才能获得 Aliro 认证。如果您选择其他测试选项,则必须创建新的集成版本并重新提交。

  5. 如果您选择了认证测试或开发测试,请在配置测试屏幕上为测试提供一个名称,然后点击自动配对设备以选择要配对的设备。

    命名和配置测试计划

    • 对于 Android 设备:

      1. 确保您已在手机上安装 GHA。
      2. 使用 USB 线将手机连接到宿主机。
      3. 您必须在设备上启用 USB 调试 APK com.chip.interop.moblysnippet 将自动下载并安装。
      4. 手机连接后,输入配对码和设备名称,即可自动配对设备。
    • 对于 iOS 设备:

      1. 您需要手动配对设备。如需了解手动配对说明,请参阅 Google Home 应用部分。
      2. 如果你有现有设备,系统可能会要求你取消与该设备的配对,然后重新配对或与新设备配对。
  6. 点击下一步:测试计划按钮。

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

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

运行测试计划

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

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

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

测试结果 如需从测试环境页面重新测试测试计划,请在测试作业完成后点击顶部的 重新测试。

完成后:

查看并解读测试结果

在 Test Suite 的测试历史记录页面上,您可以点击测试计划部分中相应测试计划的重新测试,查看开发计划或未提交的认证测试计划的先前测试结果。您将进入测试环境页面,其中会显示该测试的结果。

测试记录

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

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

控制台状态

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

对应的节 状态 说明 要求 接下来需采取的措施
可供测试 准备就绪 此版本的 integration 已可供测试。 不适用 测试此版本的 integration。
已测试 准备就绪 此版本的 integration 已经过测试,可以提交以进行Field Trial或认证。

版本已测试并保存。

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

重新测试(如果需要)。

重新测试

认证

如果您需要重新测试以获得认证,则需要在开始重新测试后配对设备。

开发

如果您需要重新测试以进行开发,则可以使用现有设备,而无需再次配对。

问题排查

已调试的设备未显示在 Test Suite 中

如果您已将设备与测试供应商 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 列为 5A23FFFE,从服务数据字段的第四个字节开始。这表示 VID 为 5A23,PID 为 FFFE,两者均采用小端字节序格式。

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

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

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