Matter 问题排查

建筑物

验证您的手机是否兼容

所有 Android O（8.1，API 级别 27）及更高版本的设备 与 Matter 兼容。请按照以下步骤检查 手机具有必要的模块。

设置 Android 调试桥

在排查问题之前，应设置 Android 调试桥 (adb)。 如需进行设置，请执行以下操作：

  1. 安装“adb”在您的 计算机。
  2. 开启开发者选项和 USB 调试 在Android手机上。

验证您的 Google Play 服务 (GPS) Matter 模块

检查您是否拥有 Google Play services Matter 模块，请执行以下操作：

  1. 设置 Android 调试桥。
  2. 使用 USB 线将 Android 手机连接到您的 计算机。
  3. 在终端中运行此命令， 已安装 Matter 模块： 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
    如果您看到类似如下所示的输出， 已安装 Matter 个模块： 
    com.google.android.gms.home [v222110900]
    请注意，以上版本号可能与您的设备不同。
  4. 在终端中运行此命令， 已安装 Thread 模块： 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
    如果您看到与以下示例类似的输出， 已安装 Thread 个模块： 
    com.google.android.gms.threadnetwork [v222106301]
    请注意，您设备上的版本号可能会有所不同。

如果模块未列出，则意味着：

  1. 您的 Android 版本已过时。请确保 Android O (8.1) 或更高版本。
  2. Matter 个模块尚未下载。等待 至少 24 小时后可供下载确保您的设备已开机且 确保下载不会延迟。如果您还没有 24 小时内收到模块，您可以尝试将 强制下载模块。

Fuchsia hub 设备日志

如需启用 hub 以进行本地日志检索，请执行以下操作：

  1. 向 Google Technical Account Manager (TAM) 发送电子邮件，提供您设备的序列号和型号。您可以在设备下方以小字体找到它们。
  2. 列入许可名单后，您必须按照以下步骤启用该功能： <ph type="x-smartling-placeholder">
      </ph>
    • 通过 hub： <ph type="x-smartling-placeholder">
        </ph>
      1. 从屏幕顶部向下滑动。
      2. 点按“设置”图标
      3. 查找 Fuchsia 版本：在 Google Nest Hub (2nd gen) 上，转到 设备信息 >技术信息 >Fuchsia 版本
      4. 点按“紫红色版本”7 次。此操作将启用开发者选项
      5. 返回顶级菜单
      6. 点按“开发者选项”
      7. 点按“合作伙伴日志记录”
    • 该功能将启用 24 小时。此后，从第 5 步开始重新启用日志记录功能。
  3. 获取 hub 的 IP 地址： <ph type="x-smartling-placeholder">
      </ph>
    • 如果 hub 有屏幕，请执行以下操作： <ph type="x-smartling-placeholder">
        </ph>
      1. 从屏幕顶部向下滑动。
      2. 点按“设置”图标
      3. 查找设备的 IP 地址：在 Nest Hub (2nd gen) 上，前往 设备信息 >技术信息 >IP 地址
    • 从手机上的 Google Home app (GHA) 中： <ph type="x-smartling-placeholder">
        </ph>
      1. 点按设备即可打开设备详细信息页面
      2. 点按“设置”图标 打开“设置”页面
      3. 找到设备的 IP 地址：前往设备 信息 >技术信息 >IP 地址
  4. 若要从 hub 中检索日志，您需要通过同一 Wi-Fi 网络中的计算机向 hub 发出 GET HTTP 请求。
    • 记下端点的端口和路径： 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • 连接只能保持打开状态一分钟，但从缓冲区检索到的数据通常包含 20-30 分钟的过往事件。
      • 理想情况下，系统会在完成测试程序后立即使用此方法提取日志，以确保缓冲区包含与测试相关的内容（类似于 Android bug 报告）。

停用 Android 日志的隐去功能

  • 隐私保护和安全，该功能仅应用于工程测试目的。
  • 请勿对正式版设备或用户使用此选项。
  • 步骤： <ph type="x-smartling-placeholder">
      </ph>
    1. 将尚未隐去日志的用户的 Google 账号发送到您的 Google TAM。
    2. 确认您的账号已添加到许可名单后，重启手机。

验证设备的 VID/PID

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

蓝牙嗅探器故障排除

设备信标的 VID/PID 值应与 VID/PID 值一致 已输入到您的 Google Home Developer Console 项目中。

  • VID 0xFFF1 - 0xFFF4 已预留用于测试。它们可能会用于 基本的调试和控制测试，但在测试期间 以下开发阶段： <ph type="x-smartling-placeholder">

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

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

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

验证您在 Action 中输入的值和格式是否正确 基于蓝牙嗅探器所显示内容的控制台项目。

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

验证你的设备是使用兼容的 Matter SDK 分支构建的

Google Matter Hub 兼容 Matter 1.0，已经过测试，使用了 稳定分支 v1.0-branch 中的提交内容。选中公开发布 有关推荐用于特定提交的说明 每次发布新的 hub 时。

正在配对

验证您的设备凭据

当您使用自己由 Alliance 分配的 VID 时，请务必 在设备上拥有正确的凭据：

  • 认证声明 (CD)。
  • 设备认证证书 (DAC) 及其证书链。

如需了解详情，请参阅创建 Matter 设备测试 证书。

验证与 Matter 兼容的 hub

您的 Matter hub 必须是支持的 hub 之一 Google。还必须位于 build 与 Matter 兼容。

一些集线器也是线程边界路由器 使您能够开发和测试 Thread 设备。其他 hub 仅支持 Wi-Fi 和以太网Matter设备，除非您 在您的网络中使用其他边界路由器以启用 Thread 连接。

中心版本可能会通过以下方式通过验证：从上边缘向下滑动手指 > 配置轮盘 >设备信息 >技术信息 > Chromecast 固件版本

调试失败并显示“无法联系 Google”错误消息

确保您已使用正确的 VID/PID 组合创建集成 在 Developer Console 中。请参阅创建诉讼或调查 集成。

调试失败并显示“无法连接到设备”错误消息错误消息

如果您不断收到“无法连接到设备”消息错误消息 Thread 台设备，并已用尽所有可用的调试功能 选项，您可能需要清除存储的首选Thread 在 Android 手机上，通过设置 >应用 > 应用&gt;Google Play 服务 >存储与缓存 >管理聊天室 > 清除所有数据。

测试

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

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

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

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

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

如果问题仍未解决

如果按照此处的所有问题排查步骤操作后，您的问题仍未解决 已经解决了，没关系！

在问题排查步骤中，您已收集到有关设备的重要数据， 控制台项目和环境掌握这些数据后，查看 支持页面，了解如何最好地与 社区和 Google Home 支持团队。