榨干每一帧：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需求。
写在最后：别小看SPI，它是系统的咽喉
很多人觉得SPI只是个“配角”，随便配配就能用。但在嵌入式GUI系统中，它其实是决定体验上限的“咽喉通道”。
一次成功的ST7789优化，不只是改几行参数那么简单。它要求你理解：
- 硬件时序的边界在哪里
- DMA如何与外设协同工作
- 如何权衡性能、稳定性与功耗
当你能把240×320的屏幕做到40FPS以上的稳定刷新，同时CPU占用低于10%，你会意识到：原来那块小小的彩屏，也可以如此灵动。
而这，正是嵌入式开发的魅力所在——在资源受限的世界里，把每一分性能都榨出来。
如果你正在做智能手表、工业仪表、便携医疗设备，或者只是想让你的DIY项目看起来更专业一点，不妨回头看看你的SPI配置。也许，只需一次小小的调整，就能带来翻天覆地的变化。
你在项目中是如何优化ST7789刷新性能的？有没有遇到特别棘手的通信问题？欢迎在评论区分享你的经验！
