在线蓝牙调试工具
扫描BLE设备、监测RSSI信号强度、探索GATT服务
设备信息
-
-
已断开
GATT服务浏览器
正在连接...
RSSI信号监测
通知日志
尚未收到通知。请订阅具有Notify属性的特征值。
使用说明
点击'扫描BLE设备'
这将打开浏览器的蓝牙设备选择对话框。浏览器会搜索附近的BLE设备并显示在列表中。
选择设备
从浏览器的选择器中选择要调试的BLE设备。设备将连接到此工具。
探索GATT服务
连接后,点击'连接GATT'以发现设备公开的所有服务和特征值。您可以读取、写入数据并订阅通知。
监测信号强度
使用RSSI监测器实时跟踪蓝牙信号强度。这有助于识别连接问题或确定设备的最佳放置位置。
功能特点
BLE设备扫描
使用Web Bluetooth API扫描附近的低功耗蓝牙设备。直接从浏览器连接任何兼容的BLE设备。
RSSI信号监测
通过可视化图表实时监测信号强度(RSSI)。跟踪信号质量变化,诊断连接问题。
GATT服务浏览器
发现并探索所有GATT服务和特征值。以树形结构查看服务UUID、特征值属性和描述符。
读写数值
以十六进制、文本或十进制格式读取特征值。向可写特征值写入数据,用于设备控制和测试。
通知订阅
订阅具有Notify或Indicate属性的特征值。查看带时间戳的所有接收通知日志。
浏览器兼容性
Web Bluetooth API的支持因浏览器和操作系统而异:
- Chrome 56+ — 在Windows、macOS、Linux、Android、ChromeOS上完全支持
- Edge 79+ — 在Windows、macOS上完全支持
- Opera 43+ — 完全支持
- Firefox — 不支持(未实现Web Bluetooth)
- Safari — 不支持(有实验性标志但功能有限)
浏览器限制
- Web Bluetooth仅在Chrome、Edge和Opera中有效。Firefox和Safari不支持。
- 需要HTTPS连接。该API在非安全(HTTP)页面上无法工作。
- 无法被动扫描所有设备。必须使用浏览器的权限对话框来选择设备。
- 出于隐私保护,真实MAC地址被隐藏。您将看到浏览器生成的设备ID。
- 某些设备可能需要在操作系统层面配对后才会出现在浏览器的设备选择器中。
常见问题
为什么我的设备没有出现在扫描结果中?
请确保您的设备已开机并处于广播模式。某些设备在与其他设备配对后会停止广播。另外请检查您的电脑是否已启用蓝牙,以及设备是否在有效范围内。
我能看到BLE设备的真实MAC地址吗?
不能,浏览器出于隐私原因故意隐藏真实MAC地址。显示的设备ID是浏览器为此网站源生成的唯一标识符。它对于同一网站上的同一设备是一致的,但在不同网站间是不同的。
为什么RSSI监测显示'不支持'?
通过watchAdvertisements()进行RSSI监测需要Chrome 85+或Edge 85+。某些操作系统(如iOS)即使在支持的浏览器中也不支持此功能。在较旧的浏览器中,RSSI仅在初始扫描时可用。
为什么我无法向特征值写入数据?
请检查该特征值是否具有'Write'或'Write Without Response'属性。某些特征值是只读的。另外请确保数值格式正确——十六进制值应该是用空格分隔的字节,如'01 02 03'。
我的数据会被发送到服务器吗?
不会。此工具完全在您的浏览器中运行,使用Web Bluetooth API。所有通信都直接在您的浏览器和BLE设备之间进行。没有任何数据会传输到我们的服务器。
为什么连接总是断开?
BLE连接可能不稳定,原因包括:1) 设备与电脑之间的距离/障碍物,2) 其他无线设备的干扰,3) 设备固件问题,4) BLE设备电量不足。请尝试靠近设备或移除障碍物。