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 的屏幕截图中,您会看到从 Service Data 字段的第四个字节开始,VID/PID 被列为 5A23FFFE。这表示 VID 为 5A23,PID 为 FFFE,两者均采用小端格式

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

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

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

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

Google Matter Hub 与 Matter 1.0 兼容,并且已使用来自稳定分支 v1.0-branch 的提交的 build 进行了测试。如需了解建议与每个新 Hub 版本一起使用的具体提交内容,请参阅公开版本说明

配对

验证设备的凭据

如果您使用自己的Alliance 分配的 VID,请确保您设备上的凭据正确无误

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

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

验证与 Matter 兼容的中心

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

有些 hub 也是 Thread 边界路由器,因此您可以开发和测试 Thread 设备。其他集线器仅支持 Wi-Fi 和以太网 Matter 设备,除非您的网络中另有一个边界路由器来启用 Thread 连接。

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

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

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

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

如果您在调试 Thread 设备时不断收到“无法连接到设备”错误消息,并且已用尽所有可用的调试选项,则可能需要清除 Android 手机上存储的首选 Thread 凭据,以进行干净的设置,方法是依次选择设置 > 应用 > 应用应用 > Google Play 服务 > 存储和缓存 > 清除所有数据

测试

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

如果您已将设备与测试供应商 ID (VID) 和产品 ID (PID) 配对,但当您尝试在 Developer Console使用测试套件测试设备时,该测试并未显示,这可能是由于在多个集成中使用相同的测试 VID 和 PID 组合而导致的。

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

如需验证配对是否正确无误,您可以将设备的制造商和型号信息(CHIP_DEVICE_CONFIG_DEVICE_* 值)设为测试固件中的唯一值。

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

如果仍然出现问题

如果按照本文中的所有问题排查步骤操作后,您的问题仍未得到解决,也没关系!

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