嵌入式 RGB565 LCD 颜色反转、字节错序与花屏排查指南

在嵌入式 SPI 彩屏（如 ST7789 240×320）的联调过程中，屏幕颜色异常是高频出现的典型问题。排查时必须清晰区分光学显示反相（INVON/INVOFF）、RGB/BGR 通道互换、RGB565 高低字节错序、缓冲区数据竞争与 SPI 总线时序问题，避免盲目猜测修改。驱动协议与条带渲染细节可配合阅读 ST7789 命令时序、窗口配置与像素 DMA 传输参考 与 N32G455 LCD 条带渲染与异步刷新实现分析。

真实案例：红蓝绿纯色显示为青黄紫

故障现象

上电执行 RGB565 纯色测试，依次发送红、蓝、绿三种纯色，但屏幕实际稳定显示为青、黄、紫：

根本原因分析

初版驱动在 LCD 初始化序列中发送了 INVOFF (0x20)（关闭显示反相），但实测该常黑型（Normally Black）IPS 液晶面板模组需要发送 INVON (0x21)。

当面板反相配置相反时，送入 GRAM 的 RGB565 数值在光学显示上等价于 16 位按位取反（~color）后的互补色：

该映射与实机现象 100% 吻合，从而直接排除 RGB/BGR 通道互换（绿色不会变紫）与高低字节错序（0x07E0 交换字节后为 0xE007，不会呈现纯正紫品红）。

修复方式

在屏幕驱动初始化序列中，将反相控制命令由 INVOFF (0x20) 改为 INVON (0x21)：

-#define LCD_CMD_INVOFF (0x20U)
+#define LCD_CMD_INVON  (0x21U)

-LcdSt7789_WriteCommand(LCD_CMD_INVOFF);
+LcdSt7789_WriteCommand(LCD_CMD_INVON);

重新编译烧录后，实机上电三色测试依次正常显示红、蓝、绿。

交互式在线排障实验室：RGB565 颜色反相、通道对调与字节错序仿真

遇到屏幕颜色异样时，常常难以直接断定是初始化命令发反、寄存器位域对调，还是字节序错误。下方提供了一个可交互的纯前端 RGB565 硬件色彩排障实验室。你可以选择不同的基准测试颜色，自由勾选开启或关闭各项硬件故障开关，实时对照理论预期颜色、SPI 总线实际传输的两个字节与屏幕 GRAM 最终呈现的成像视觉，并查看自动输出的诊断分析：

按现象快速定位根因

遇到 LCD 颜色或画面异常时，先对照下表区分是初始化寄存器问题、字节/通道序问题，还是 DMA 与时序并发问题：

标准分步排查流程

第一步：恢复最小八色与棋盘格测试

仅靠红、绿、蓝三色有时难以一眼区分反色与字节错位，建议在 Iwdg_Init() 之前运行八色纯色测试：

若八色纯色正常而复杂界面异常，可进一步绘制 1 像素黑白棋盘格与四象限色块，用于暴露漏时钟、窗口右边界计算错误（width - 1 写成 width）或 DMA 计数减半问题。

在排查阶段，可通过以下纯 C 函数做软件辅助诊断，快速验证到底是通道颠倒还是字节序颠倒：

/* 1. 软件字节序翻转（验证是否因大小端或 DMA 位宽导致高低字节错序） */
static inline uint16_t SwapBytes16(uint16_t color)
{
    return (uint16_t)((color << 8) | (color >> 8));
}

/* 2. RGB565 与 BGR565 软件通道对调（验证 MADCTL 寄存器 Bit 3 效果） */
static inline uint16_t SwapRgbBgr565(uint16_t color)
{
    uint16_t r = (color >> 11) & 0x1FU;
    uint16_t g = (color >> 5) & 0x3FU;
    uint16_t b = color & 0x1FU;
    return (uint16_t)((b << 11) | (g << 5) | r);
}

第二步：用逻辑分析仪核对初始化序列与字节序

将逻辑分析仪连接到 PA5 (SCK)、PA7 (MOSI)、PC5 (CS)、PC4 (RS/DC)，采样率需显著高于 32 MHz（建议 ≥ 100 MS/s）：

1. 核对初始化命令阶段（8-bit，Mode 0，MSB first）：

   RS=0: 0x3A  →  RS=1: 0x55   (COLMOD = RGB565)
   RS=0: 0x36  →  RS=1: 0x00   (MADCTL = 正向 RGB)
   RS=0: 0x21                  (INVON)
   RS=0: 0x13                  (NORON)
   RS=0: 0x29                  (DISPON)
   

2. 核对 RAMWR (0x2C) 后的像素字节流（16-bit HalfWord，MSB first）：

   红：F8 00 F8 00 F8 00 ...
   绿：07 E0 07 E0 07 E0 ...
   蓝：00 1F 00 1F 00 1F ...
   

   若线上抓到红色为 00 F8，说明高低字节顺序颠倒，此时应检查 SPI1 是否切到了 16 bit、DMA 外设与内存宽度是否同为 HalfWord，切勿在未抓波确认前盲目对颜色常量做软件 bswap16。

第三步：SPI 降频对照实验

当前配置 SPI_BR_PRESCALER_2 对应 SCK = 64 MHz / 2 = 32 MHz。怀疑随机噪点、花屏与时序裕量有关时，可临时改为 4 分频（16 MHz）或 8 分频（8 MHz）做对照：

/* 临时将 32 MHz 降至 16 MHz 对照信号完整性 */
spiInit.BaudRatePres = SPI_BR_PRESCALER_4;

第四步：检查异步 DMA 缓冲区生命周期与互斥

LcdSt7789_DrawPixelsAsync() 启动 DMA 后立即返回，并不复制像素内存。必须确保：

1. 繁忙期间严禁改写缓冲：在 LcdSt7789_IsBusy() 返回 false 前，调用方不能向同一个 pixels[240 * 8] 写入下一条带数据；
2. 严禁传递栈上局部数组：传给异步接口的像素缓冲区必须是静态或全局生命周期；
3. 同步与异步接口严禁并发：当异步条带正在传输时，不得穿插调用阻塞式 LcdSt7789_FillRect()、直接写命令或改写 MADCTL，否则会同时破坏 SPI 8/16 位状态、CS/RS 电平与 DMA 通道计数；
4. 核对 DMA BufSize 单位：在 16-bit HalfWord 模式下，DMA 的 BufSize 是像素个数（1,920）而非字节数（3,840）。

板级验收清单

修改 LCD 驱动或升级 SPI 频率后，检查以下项目：

• Keil Rebuild 零错误、零新增警告，确认烧录 HEX 为当前最新产物。
• 多次冷启动、复位与热重启后，黑、白、红、绿、蓝、黄、青、紫八色显示一致且无首帧闪屏。
• 1 像素黑白棋盘格与四边 1 像素边框无漏点、无行列偏移。
• 逻辑分析仪确认 COLMOD=0x55、INVON=0x21、像素期 CS 在 SPI BUSY = 0 后才拉高。
• 开启高优先级后台采集任务并快速切换 UI 页面、滚动历史记录，无 DMA timeout 报错，页面无条带撕裂或错色。