目录

如何抓取蓝牙HCI日志

简介

蓝牙/全场景开发者,可以通过开发者模式,一键采集蓝牙连接HCI日志,高效完成APP连接性能调试。该功能具有以下特点:

蓝牙HCI日志抓取功能面向开发者提供便捷高效的蓝牙HCI日志抓取能力。

开发者抓取蓝牙HCI日志功能从API版本26.0.0开始支持,目前支持Phone、Tablet。

Release版本出于数据安全与隐私保护,会屏蔽HCI日志中蓝牙报文的payload数据,仅保留Header信息,因此若HCI日志报文数据解析不完整属正常现象。

操作步骤

[h2]步骤一:开启开发者模式

在调测手机上进入开发者模式,开启方法请参考 开启开发者选项。

[h2]步骤二:连接蓝牙设备进行调试

开启手机蓝牙,连接需要调试的蓝牙外设,进行设备连接调试或问题复现操作。

[h2]步骤三:一键采集HCI日志

连接调试操作完毕后,下拉通知栏,点击开发者模式卡片,卡片下方会显示收集按钮,点击即可一键采集HCI日志。

点击"收集"后,系统开始采集HCI日志,采集过程约30秒,请耐心等待。

下拉通知栏的开发者模式卡片可以被移除,移除后将无法抓取HCI日志。若卡片已被移除,需在保证开发者模式开启的情况下,重启手机,卡片才可重新生效。请勿随意移除开发者模式卡片。

[h2]步骤四:查看与导出HCI日志

采集完成后,进入手机文件管理,选择我的手机,点击Documents目录,即可找到日志压缩包

通过华为分享、三方应用等方式,将日志压缩包分享到PC侧。

抓取的HCI日志仅保存在手机本地,不自动上传,日志文件完全由手机用户管理。

[h2]步骤五:在PC侧分析HCI日志

将日志压缩包从手机导出至PC后,使用蓝牙HCI日志分析工具(如Ellisys Bluetooth Analyzer、Wireshark等)打开日志文件进行分析。