楼宇
验证您的手机是否兼容
所有 Android O(8.1,API 级别 27)及更高版本的设备都与 Matter 兼容。请按照以下步骤检查您的手机是否具备必要的模块。
设置 Android 调试桥
在排查问题之前,应设置 Android 调试桥 (adb
)。如需设置,请执行以下操作:
- 在计算机上安装“adb”。
- 在 Android 手机上开启“开发者选项”和“USB 调试”。
验证您的 Google Play 服务 (GPS) Matter 模块
如需检查您是否有 Google Play services Matter 模块,请执行以下操作:
- 设置 Android 调试桥。
- 使用 USB 线将 Android 手机连接到计算机。
- 在终端中运行以下命令,以验证是否已安装必要的 Matter 模块:
adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
com.google.android.gms.home [v222110900]
请注意,上面的版本号可能与您设备上的版本号不同。 - 在终端运行以下命令,验证是否已安装必要的 Thread 模块:
adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
com.google.android.gms.threadnetwork [v222106301]
请注意,您设备上的版本号可能有所不同。
如果列表中未列出这些模块,则表示:
- 您的 Android 版本已过时。确保设备是 Android O (8.1) 或更高版本。
- Matter 模块尚未下载。请等待至少 24 小时以便其下载。在此期间,请确保您的设备处于开机状态且正在充电,以免下载延迟。如果您在 24 小时内未收到模块,可以尝试将设备恢复出厂设置,以强制下载模块。
验证设备的 VID/PID
如果您想开始开发与 Google 的集成,则必须在 Google Home 控制台上创建项目和集成。
您的设备将用于信标的 VID/PID 值应与在 Google Home Developer Console 项目中输入的 VID/PID 一致。
使用蓝牙工程应用(例如 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 分别为 235A
和 FEFF
。
验证设备是否使用兼容的 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 支持团队分享您的问题。