快速开始

1. 确保设备已开启蓝牙并启动 BLE 服务
2. 使用支持 Web Bluetooth 的浏览器（桌面版 Chrome 或 Edge）
3. 在 HTTPS 网站或本地 file:// 协议下打开本页面
4. 点击"配对 BLE"按钮，在弹窗中选择设备（名称以 BTConsole 开头）
5. 连接成功后即可进行串口通信

浏览器要求

• 支持：桌面版 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 内的接收数据会合并处理，减少终端重绘
• 写入队列：发送数据自动分包并按序发送