ST7789屏幕刷新优化：SPI传输速率调优实践-平芜编程栈

榨干每一帧：ST7789 + SPI刷新性能极限调优实战

你有没有遇到过这样的场景？精心设计的UI动画，在代码里明明是60FPS的节奏，结果烧进板子一跑，画面却像卡顿的老式幻灯片——滑动不跟手、数字跳变延迟明显、甚至出现撕裂和闪烁？

别急着怀疑LVGL或TouchGFX框架。很多时候，问题不在上层，而藏在最底层的SPI通信链路中。

尤其是在使用ST7789这类主流TFT驱动芯片时，许多开发者默认采用“能点亮就行”的配置，殊不知这直接把本可流畅运行的显示系统，硬生生拖进了“低速通道”。我们今天要做的，就是打破这个惯性思维，从硬件协议层入手，真正释放ST7789的潜力。

为什么你的ST7789总是“慢半拍”？

先来看一组真实对比数据：

配置方式	全屏刷新耗时（240×320 RGB565）	等效帧率
轮询 + 8MHz SPI	~130ms	<8 FPS
DMA + 15MHz SPI	~22ms（含命令开销）	~45 FPS

看到没？同样是ST7789，差距接近6倍。这意味着前者连基本的页面切换都显得迟滞，而后者已经可以支撑较为流畅的图形交互。

瓶颈在哪？答案很明确：SPI带宽利用率太低。

虽然ST7789支持最高15MHz的标准SPI速率，但很多工程实现仍停留在“HAL库默认初始化+GPIO模拟控制”的初级阶段，忽略了几个关键优化点：
- SPI时钟分频未拉满
- 使用轮询而非DMA传输
- D/C切换与CS控制存在冗余延时
- 初始化序列冗长且未合并

这些问题叠加起来，足以让一块本应灵动的彩屏变得呆滞。

ST7789不是“普通外设”，它是GRAM驱动的画布

在动手调优之前，我们必须重新认识ST7789的本质。

它不是一个简单的字符屏控制器，而是一个集成了升压电路、伽马校正、显存（GRAM）、行列驱动于一体的完整TFT解决方案。它的核心优势在于：

无需外部显存：240×320×16bit = 153.6KB 内置GRAM，足以缓存整屏图像。
单电源供电：多数模块内置DC/DC，仅需3.3V输入即可驱动LCD面板。
命令/数据分离机制：通过D/C引脚切换模式，实现灵活控制。

这意味着每一次刷新，并非实时绘制像素，而是向内部GRAM“搬运”一块图像数据。换句话说，屏幕刷新的本质，是一次大容量内存写操作。

而这个“搬运工”，正是SPI总线。

所以，如果你希望动画顺滑，就必须让这位“搬运工”跑得更快、更高效。

突破瓶颈：SPI速率调优四步法

第一步：选对SPI工作模式 —— Mode 3才是正解

ST7789官方推荐的工作模式是CPOL=1, CPHA=1，即SPIMode 3。

这是有讲究的。Mode 3下，SCK空闲时为高电平，数据在第二个边沿采样。这种时序更匹配ST7789内部锁存逻辑，尤其在高速传输时能有效避免建立/保持时间不足的问题。

错误地使用Mode 0（CPOL=0, CPHA=0）可能导致：
- 高速下数据错位
- 命令误识别
- 初始化失败或花屏

hspi1.Init.CLKPolarity = SPI_POLARITY_HIGH; // CPOL = 1 hspi1.Init.CPHA = SPI_PHASE_2EDGE; // CPHA = 1 → Mode 3

✅ 实践建议：若更换模组后通信异常，优先检查是否支持Mode 3；部分低成本模块可能因上拉电阻缺失而表现不稳定，此时可尝试加装4.7kΩ上拉至VDD。

第二步：榨干PCLK，精准设置分频系数

SPI的实际速率由主控时钟源（PCLK）除以分频系数决定。以STM32为例：

MCU型号	PCLK2频率	可达SCK最大值（理论）
STM32F103	36MHz	最高约18MHz（受限于外设能力）
STM32F407	84MHz	支持21MHz SCK输出
STM32H7xx	100MHz+	更高潜力，需注意兼容性

假设PCLK2 = 72MHz，目标SCK = 15MHz，则最优分频为72 / 15 ≈ 4.8→ 实际选择4分频（18MHz）或6分频（12MHz）

但注意：不能超过ST7789物理极限！

尽管某些MCU SPI外设支持20MHz以上输出，但ST7789标准规格仅支持15MHz。部分增强版模组标称27MHz，实测往往需要极佳信号完整性才能稳定运行。

🔧 推荐策略：
- 初次调试设为6分频（12MHz）
- 功能正常后逐步提升至4分频（18MHz）
- 若出现乱码、花屏，立即回落并增加去耦电容

// 安全起见，选用6分频（72MHz/6=12MHz） hspi1.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_6;

第三步：DMA上阵，解放CPU

这才是真正的性能跃迁点。

传统轮询发送方式（如HAL_SPI_Transmit()），CPU必须全程参与每一位数据的移位过程。对于150KB的全屏数据，即使在12MHz下也需上百毫秒，期间几乎无法处理其他任务。

而启用DMA后，整个过程变为：

CPU发起传输请求
DMA控制器接管数据搬运
SPI外设自动从内存取数发往MOSI
传输完成触发中断回调

CPU仅在开始和结束时介入，中间可自由执行GUI逻辑、传感器采集或多任务调度。

启用DMA的关键代码

void ST7789_WritePixels_DMA(uint16_t *buffer, uint32_t len) { HAL_GPIO_WritePin(DC_PORT, DC_PIN, GPIO_PIN_SET); // DATA mode HAL_GPIO_WritePin(CS_PORT, CS_PIN, GPIO_PIN_RESET); HAL_SPI_Transmit_DMA(&hspi1, (uint8_t*)buffer, len * 2); // RGB565 → 字节数 }

配合回调函数管理片选与状态同步：

void HAL_SPI_TxCompleteCallback(SPI_HandleTypeDef *hspi) { if (hspi == &hspi1) { HAL_GPIO_WritePin(CS_PORT, CS_PIN, GPIO_PIN_SET); // 结束事务 st7789_dma_busy = 0; // 标记空闲，可用于双缓冲切换 } }

⚠️ 注意事项：
- 缓冲区必须位于DMA可访问内存（避免栈上分配）
- 若使用RTOS，确保传输期间缓冲区不被释放或覆盖
- 对于连续流式更新（如视频帧），可结合Half-Transfer回调实现乒乓缓冲

第四步：减少“无效开销”——命令合并与区域裁剪

你以为数据传完了就结束了？其实还有很多隐藏损耗。

每次GRAM写入前，都需要发送以下命令：
-CASET（列地址设置）
-RASET（行地址设置）
-RAMWR（启动写入）

这些命令虽短，但如果每帧都重复发送，累计延迟不容忽视。

优化技巧1：固定区域复用地址设置

如果你的应用只刷新某个固定区域（比如顶部状态栏、底部时间栏），完全可以一次性设置好地址窗口，后续仅发送RAMWR + 数据。

例如，仅更新第100~101行：

void ST7789_Update_Row100(void) { LCD_CMD(0x2A); // CASET LCD_DATA(0); LCD_DATA(0); LCD_DATA(0); LCD_DATA(239); LCD_CMD(0x2B); // RASET LCD_DATA(0); LCD_DATA(100); LCD_DATA(0); LCD_DATA(101); LCD_CMD(0x2C); // RAMWR ST7789_WritePixels_DMA(row_buffer, 240*2); }

此后只要显示区域不变，就不必再发CASET/RASET。

优化技巧2：局部刷新替代全屏重绘

不要因为一个数字变化就刷整个屏幕！利用ST7789的地址窗口机制，精确指定待更新区域。

void ST7789_Draw_DigitalClock(int x, int y, uint32_t color) { set_addr_window(x, y, x+79, y+19); // 仅更新80x20区域 fill_rect(color); }

这一招能让平均刷新数据量下降70%以上。

工程实践中那些“踩过的坑”

坑点一：DMA传输中途崩溃？

常见原因：
- 缓冲区定义在局部变量中（栈空间），函数返回后被回收
- 多任务环境下多个线程同时访问SPI总线

✅ 解决方案：
- 将图像缓冲声明为静态或全局变量
- 使用互斥锁（如FreeRTOS中的xSemaphoreTake()）保护SPI资源

坑点二：速度提上去后屏幕闪屏或乱码？

典型症状：低速正常，提速后花屏。

排查方向：
1.电源噪声过大：ST7789对VDD稳定性敏感，建议添加0.1μF陶瓷电容 + 10μF钽电容靠近电源引脚
2.PCB走线过长或跨分割平面：SPI高频信号应尽量短，避免与电源/模拟信号平行走线
3.未启用去耦：模块背面无足够电容时，可在MCU端补焊滤波网络

🔧 调试利器：逻辑分析仪抓波形
查看SCK实际频率、D/C切换时机、CS拉低宽度是否符合预期，是定位通信问题的黄金手段。

性能之外：功耗与用户体验的平衡

高性能不代表无节制耗电。尤其在电池供电设备中，我们需要智能调节刷新策略：

场景	刷新策略	节能效果
静态画面	进入睡眠模式（`SLPIN`命令）	电流从~50mA降至<1mA
动态内容	局部刷新 + 降低背光PWM占空比	减少发热与功耗
用户无操作	定时关闭背光	提升续航

此外，合理使用双缓冲技术也能显著改善体验：
- 前台缓冲用于当前显示
- 后台缓冲由CPU/DMA准备下一帧
- VSYNC或DMA完成时切换指针

虽不能完全消除撕裂（无专用控制器），但已足够应对大多数动态UI需求。