---
title: AI 像素屏文生图方案 - 蓝牙像素屏调试
summary: AI 像素屏文生图方案的蓝牙像素屏调试指南，涵盖设备介绍（MCU+BLE 模组架构）、MCU 串口连接、SecureCRT 日志查看工具、串口调试步骤（新建会话、协议选择、波特率 115200、连接）、BLE 像素图数据传输调试（验证面板发送、MCU 接收、MCU 解析渲染）及调试技巧。
---

## 蓝牙像素屏调试

### 一、功能介绍

蓝牙像素屏调试模块旨在帮助开发者快速理解 **蓝牙像素屏（BLE Pixel Display）设备的工作原理、通信方式以及调试方法**。通过了解 MCU、蓝牙模组、串口通信方式与日志查看流程，开发者可以更高效地排查蓝牙透传数据问题，提升开发效率。


### 二、设备介绍

以下为典型的蓝牙像素屏设备结构示意图：

<Image
  src='/images/solution/aiTextToImage/e8.jpg'
  style={{
    borderRadius: '10px',
    boxShadow: '0 0 5px rgba(0,0,0,0.3)',
    maxWidth: '800px',
    marginTop: '20px',
  }}
/>

蓝牙像素屏主要由两部分组成：

* **MCU（主控芯片）**：负责像素屏的绘图逻辑、内部渲染、屏幕驱动、指令解析等。
* **蓝牙模组（Tuya BLE Module）**：负责手机 App 与设备之间的 BLE 通信，是 MCU 和 App 之间的数据桥梁。

设备内部通信方式：

* **MCU** &lt;--&gt; **蓝牙模组**：通过 UART 串口通信（TX/RX）
* **蓝牙模组** &lt;--&gt; **手机 App**：通过无线 BLE 协议通信

整体架构图：

<Image
  src='/images/solution/aiTextToImage/e2.png'
  style={{
    borderRadius: '10px',
    boxShadow: '0 0 5px rgba(0,0,0,0.3)',
    maxWidth: '800px',
    marginTop: '20px',
  }}
/>

### 三、设备调试方法

#### MCU 与电脑串口连接

若 MCU 支持日志输出，可通过 USB 转 TTL 工具将 MCU 的串口日志输出到电脑上，方便调试。

连接方式如下：

<Image
  src='/images/solution/aiTextToImage/e3.png'
  style={{
    borderRadius: '10px',
    boxShadow: '0 0 5px rgba(0,0,0,0.3)',
    maxWidth: '800px',
    marginTop: '20px',
  }}
/>

说明：

* **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

<Image
  src='/images/solution/aiTextToImage/e5.png'
  style={{
    borderRadius: '10px',
    boxShadow: '0 0 5px rgba(0,0,0,0.3)',
    maxWidth: '800px',
    marginTop: '20px',
  }}
/>

##### ③ 填写串口参数（推荐值）

| 参数           | 推荐值                  | 说明          |
| ------------ | -------------------- | ----------- |
| Port         | 根据系统（COM7 / ttyUSB0） | USB 转串口自动分配 |
| Baud rate    | **115200**           | MCU 调试常用波特率 |
| Data bits    | 8                    | 标准值         |
| Parity       | None                 | 无校验         |
| Stop bits    | 1                    | 标准值         |
| Flow control | None                 | 不推荐开启       |

<Image
  src='/images/solution/aiTextToImage/e6.png'
  style={{
    borderRadius: '10px',
    boxShadow: '0 0 5px rgba(0,0,0,0.3)',
    maxWidth: '800px',
    marginTop: '20px',
  }}
/>

##### ④ 点击 Connect 查看日志

连接成功后即可看到 MCU 输出日志：

<Image
  src='/images/solution/aiTextToImage/e7.png'
  style={{
    borderRadius: '10px',
    boxShadow: '0 0 5px rgba(0,0,0,0.3)',
    maxWidth: '800px',
    marginTop: '20px',
  }}
/>

### 五、蓝牙像素屏图像数据下发调试

在蓝牙像素屏开发中，面板通过 BLE 大数据透传的方式下发图像数据。调试重点在于：

#### 1. 确认面板是否正确发送了透传数据

* 观察 App 侧日志（控制台或上传日志）
* 检查分包是否符合协议格式
* 确认是否收到设备 ACK 回包

#### 2. MCU 是否收到正确的透传数据

* 观察 MCU 串口显示的透传包内容
* 校验接收到的包头、包序号、数据长度是否一致

#### 3. MCU 是否正确解析并渲染像素图

* 查看 MCU 侧是否输出渲染成功/失败日志
* 确认显示效果是否与面板预览一致

通过串口日志可快速排查以下问题：

* BLE 是否丢包
* 分包顺序是否错误
* MCU 是否正确解析图像协议
* 屏幕绘图是否出现异常


### 六、调试建议

* 若设备未响应 ACK，检查蓝牙模组是否进入接收模式
* 若 MCU 收到的数据长度不正确，需检查 App 分包逻辑
* 若 MCU 显示乱码，多为 base64 → hex → bytes 转换问题
* 若像素图显示偏色/错位，确认 MCU 的像素渲染格式（RGB / GRB / 行列顺序）


### 七、总结

蓝牙像素屏调试包含三个关键步骤：

1. **保证串口正常输出，方便查看 MCU 日志**
2. **使用 SecureCRT 分析 MCU 与蓝牙模组之间的通信情况**
3. **结合蓝牙透传模块的分包/回包机制排查数据下发流程**

通过掌握上述流程开发者能够更高效地调试 BLE 像素屏设备，这有助于面板开发过程中问题的排查, 开发同学可以通过查看输出日志快速定位并解决问题, 以提高开发效率。