项目名称
BLE Terminal - Web Bluetooth 串口终端
版本号
v2.6
开发者
ESP Console Project
技术栈
Web Bluetooth API + xterm.js + Nordic UART Service (NUS)
开源协议
MIT License
快速开始
- 确保设备已开启蓝牙并启动 BLE 服务
- 使用支持 Web Bluetooth 的浏览器(桌面版 Chrome 或 Edge)
- 在 HTTPS 网站或本地 file:// 协议下打开本页面
- 点击"配对 BLE"按钮,在弹窗中选择设备(名称以 BTConsole 开头)
- 连接成功后即可进行串口通信
浏览器要求
- 支持:桌面版 Chrome 56+、Edge 79+、Opera 43+
- 不支持:Firefox、Safari、移动端浏览器(iOS/Android)
- 协议要求:必须在 HTTPS 或本地 file:// 下使用
- 权限:首次连接需授予蓝牙访问权限
常见问题
- 找不到设备?确认设备蓝牙已开启,设备名称以 BTConsole 开头,距离在 10 米以内
- 连接失败?检查是否在系统蓝牙设置中已配对该设备,如是请先删除系统配对
- 连接中断?点击"重连"按钮尝试恢复连接,或重新配对
- SecurityError?确保在 HTTPS 或本地 file:// 协议下访问
- NotSupportedError?当前浏览器不支持 Web Bluetooth,请使用桌面版 Chrome/Edge
- 数据丢失?BLE 传输有 MTU 限制(默认 180 字节/包),大量数据可能需要分包
技术说明
- 使用 Nordic UART Service (NUS) 协议进行串口模拟
- TX 特征(notify):设备 → 浏览器
- RX 特征(write):浏览器 → 设备
- 数据缓冲:10ms 内的接收数据会合并处理,减少终端重绘
- 写入队列:发送数据自动分包并按序发送