楼宇
验证您的手机是否兼容
所有 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 小时内未收到模块,可以尝试将设备恢复出厂设置,以强制下载模块。
Fuchsia Hub 设备日志
如需启用 hub 以进行本地日志检索,请执行以下操作:
- 向您的 Google Technical Account Manager (TAM) 发送电子邮件,在其中提供您设备的序列号和型号。您可以在设备下方以小写字母找到这些符号。
- 列入许可名单后,您必须按照以下步骤启用该功能:
- 通过 Hub:
- 从屏幕顶部向下滑动。
- 点按“设置”图标
- 查找 Fuchsia 版本:在 Google Nest Hub (2nd gen) 上,依次转到 Device information > Technical information > Fuchsia Version
- 点按“紫红色版本”7 次。这将启用开发者选项
- 返回顶级菜单
- 点按“开发者选项”
- 点按“伴侣记录”
- 此功能将启用 24 小时。然后,从第 5 步开始重新启用日志记录功能。
- 通过 Hub:
- 获取 hub 的 IP 地址:
- 从 Hub 中(如果它有屏幕):
- 从屏幕顶部向下滑动。
- 点按“设置”图标
- 查找设备 IP 地址:在 Nest Hub (2nd gen) 上,依次前往设备信息 > 技术信息 > IP 地址
- 通过手机上的 Google Home app (GHA) 执行以下操作:
- 点按设备以显示设备详细信息页面
- 点按“设置”图标 即可调出设置页面
- 查找设备 IP 地址:依次前往设备信息 > 技术信息 > IP 地址
- 从 Hub 中(如果它有屏幕):
- 若要从 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 日志的隐去功能
- 为保护隐私和安全,此功能应仅用于工程测试目的。
- 请勿针对生产设备或用户使用此选项。
- 步骤:
- 将具有未隐去日志的用户的 Google 账号发送到您的 Google TAM。
- 确认您的帐号已添加到许可名单后,重新启动手机。
验证设备的 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 支持团队分享您的问题。