蓝牙工具箱 BleDebug:把 BLE 调试装进口袋

· 约 3 分钟阅读

调试 BLE 设备时,最容易卡住的往往不是协议本身,而是缺一把顺手的工具:想确认外设是否在广播、RSSI 是否稳定、某个服务和特征到底暴露了什么,或者直接向特征写一段数据,都不该先为了验证一个猜想去接完整的 IoT App。

蓝牙工具箱 BleDebug 就是为这个场景做的 Android 工具。它把 BLE 调试常用的扫描、连接、GATT 浏览、读写、广播监听和日志放在同一处,让手机可以直接成为随手可用的调试终端。[1]

从发现设备开始#

BleDebug 可以实时列出附近的 BLE 设备,并显示名称、MAC 地址、RSSI 信号强度和可连接状态。设备多时,可以按名称或 MAC 搜索,也能按 RSSI 阈值、广播服务、名称和可连接状态筛选;不需要的未命名设备可以一键隐藏。[1]

这适合先排除最基本的问题:设备是否真的在发广播、距离变化是否影响信号、目标服务有没有出现在广播数据中。比起猜测手机为什么“找不到设备”,先看原始广播结果通常更快。

连接后直接看 GATT#

选中设备并连接后,应用会展示完整的 GATT 树,包括服务和特征。对需要调试的特征值,可以使用 HEX 或 ASCII 格式读取与写入,并选择需要响应的 Write 或不等待响应的 Write No Response。[1]

这对固件联调尤其方便。比如刚加了一个控制特征,不必等待 App 页面完成;先用 BleDebug 写入预期字节,再观察设备状态和返回值。每一次发送都会保留历史记录,遇到偶发问题时可以回看上一次具体写了什么。

不连接也能监听#

有些问题发生在连接之前:设备广播包里的厂商数据是否变化、某个状态位有没有按预期出现,或者附近是否有同名设备造成干扰。BleDebug 支持不连接设备、直接被动监听 BLE 广播包,并显示厂商自定义数据;监听可以随时暂停和继续。[1]

操作日志也可以搜索、过滤,并显示毫秒级时间戳。调试时不必靠截图和记忆拼时间线,扫描、连接、收发与错误信息都能在同一份记录中追溯。

隐私与使用方式#

BleDebug 不申请网络权限,不要求登录,没有广告和追踪。设备记录与日志保存在本地数据库,不会离开设备。[1] 对测试中的硬件、现场设备名称或临时协议数据来说,这种本地优先的做法更省心。

它还提供深色与浅色主题、中英双语界面,以及扫描时长、断线自动重连、日志保留数量和默认数据格式等设置。[1]

如果你在做 BLE 外设、排查一次异常的特征写入,或者只是想看看附近究竟有什么设备在广播,可以从下面的链接安装后直接开始扫描:

Sources#

[1] https://play.google.com/store/apps/details?id=club.knifelf.ble