Matter 问题排查

构建

验证手机是否兼容

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

设置 Android 调试桥

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

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

验证 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 小时内未收到这些模块，可以尝试将设备恢复出厂设置，以强制下载这些模块。

验证设备的 VID/PID

如果您想开始开发与 Google 的集成，则必须在 Google Home 控制台中创建项目和集成。

蓝牙嗅探器问题排查

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

  • VID 0xFFF1 - 0xFFF4 保留用于测试。它们可用于基本调试和控制测试，但不能在以下开发阶段使用：

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

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

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

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

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

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

Google Matter Hub 与 Matter 1.0 兼容，并且已使用 稳定分支中的提交构建的版本进行过测试 v1.0-branch。请查看公开版本 说明，了解建议用于 每个新 Hub 版本的特定提交。

正在配对

验证设备的凭据

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

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

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

验证与 Matter 兼容的 Hub

您的 Matter Hub 必须是 Google 支持的 Hub 之一。它还必须使用与 Matter 兼容的 build 。

某些 Hub 也是 **Thread 边界路由器** ，因此您可以开发和测试 Thread 设备。除非您的网络中有其他边界路由器来启用 Thread 连接，否则其他 Hub 仅支持 Wi-Fi 和以太网 Matter 设备。

您可以通过以下方式验证 Hub build：从顶部边缘向下滑动手指 > 配置轮 > 设备信息 > 技术信息 > Chromecast 固件版本

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

请确保您已创建具有正确 VID/PID 组合的集成 在 Developer Console。如需了解详情，请参阅创建 Matter 集成。

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

如果您在调试 Thread设备时不断收到“无法连接到设备”错误消息，并且已用尽所有可用的调试 选项，则可能需要清除 Android 手机上存储的首选Thread 凭据，以便通过设置 > 应用 > 应用的应用 > Google Play 服务 > 存储空间和缓存 > 管理空间 > 清除所有数据进行全新设置。

测试

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

如果您已将设备与测试供应商 ID (VID) 和产品 ID (PID) 配对，但 在尝试使用 测试套件 (test suite) 在 Developer Console 中测试设备时，该设备未显示，这很可能是因为 您在多个集成中使用了相同的测试 VID 和 PID 组合。

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

如需验证您是否已配对正确的设备，您可以在测试固件中将设备的制造商和型号信息（CHIP_DEVICE_CONFIG_DEVICE_* 值）设置为唯一值。

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

如果问题仍然存在

如果您按照此处的所有问题排查步骤操作后，问题仍然没有解决，请不要担心！

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