蓝牙像素屏调试
一、功能介绍
蓝牙像素屏调试模块旨在帮助开发者快速理解 蓝牙像素屏（BLE Pixel Display）设备的工作原理、通信方式以及调试方法。通过了解 MCU、蓝牙模组、串口通信方式与日志查看流程，开发者可以更高效地排查蓝牙透传数据问题，提升开发效率。
二、设备介绍
以下为典型的蓝牙像素屏设备结构示意图：
蓝牙像素屏主要由两部分组成：
- MCU（主控芯片）：负责像素屏的绘图逻辑、内部渲染、屏幕驱动、指令解析等。
- 蓝牙模组（Tuya BLE Module）：负责手机 App 与设备之间的 BLE 通信，是 MCU 和 App 之间的数据桥梁。
设备内部通信方式：
- MCU <--> 蓝牙模组：通过 UART 串口通信（TX/RX）
- 蓝牙模组 <--> 手机 App：通过无线 BLE 协议通信
整体架构图：
三、设备调试方法
MCU 与电脑串口连接
若 MCU 支持日志输出，可通过 USB 转 TTL 工具将 MCU 的串口日志输出到电脑上，方便调试。
连接方式如下：
说明：
- RX（接收）连接 MCU 的 TX（发送）
- TX（发送）连接 MCU 的 RX（接收）
四、日志查看工具
1. SecureCRT 简介
SecureCRT 是一款适用于多协议的终端调试软件，支持 SSH / Telnet / 串口 Serial，多用于连接嵌入式设备、路由器、MCU 调试等。
在像素屏调试中，SecureCRT 用于：
- 查看 MCU 输出日志
- 查看蓝牙透传数据解析结果
- 观察 MCU 是否正确接收到面板下发的数据
2. 串口调试步骤
① 新建 Session
File → New Session 或 File → Quick Connect
② 选择协议：Serial
③ 填写串口参数（推荐值）
④ 点击 Connect 查看日志
连接成功后即可看到 MCU 输出日志：
五、蓝牙像素屏图像数据下发调试
在蓝牙像素屏开发中，面板通过 BLE 大数据透传的方式下发图像数据。调试重点在于：
1. 确认面板是否正确发送了透传数据
- 观察 App 侧日志（控制台或上传日志）
- 检查分包是否符合协议格式
- 确认是否收到设备 ACK 回包
2. MCU 是否收到正确的透传数据
- 观察 MCU 串口显示的透传包内容
- 校验接收到的包头、包序号、数据长度是否一致
3. MCU 是否正确解析并渲染像素图
- 查看 MCU 侧是否输出渲染成功/失败日志
- 确认显示效果是否与面板预览一致
通过串口日志可快速排查以下问题：
- BLE 是否丢包
- 分包顺序是否错误
- MCU 是否正确解析图像协议
- 屏幕绘图是否出现异常
六、调试建议
- 若设备未响应 ACK，检查蓝牙模组是否进入接收模式
- 若 MCU 收到的数据长度不正确，需检查 App 分包逻辑
- 若 MCU 显示乱码，多为 base64 → hex → bytes 转换问题
- 若像素图显示偏色/错位，确认 MCU 的像素渲染格式（RGB / GRB / 行列顺序）
七、总结
蓝牙像素屏调试包含三个关键步骤：
- 保证串口正常输出，方便查看 MCU 日志
- 使用 SecureCRT 分析 MCU 与蓝牙模组之间的通信情况
- 结合蓝牙透传模块的分包/回包机制排查数据下发流程
通过掌握上述流程开发者能够更高效地调试 BLE 像素屏设备，这有助于面板开发过程中问题的排查, 开发同学可以通过查看输出日志快速定位并解决问题, 以提高开发效率。