企业官网建设流程全解析

STM32硬件SPI驱动ST7789屏幕实战：从CubeMX配置到性能优化

最近在做一个嵌入式项目时，遇到了屏幕刷新率不足的问题。原本使用的软件SPI驱动ST7789屏幕，虽然能正常工作，但在需要快速更新画面时明显力不从心。经过一番折腾，最终通过硬件SPI解决了这个问题，屏幕刷新率提升了近10倍。下面就把这个实战经验分享给大家。

1. 硬件SPI与软件SPI的核心差异

在嵌入式开发中，SPI通信有两种实现方式：硬件SPI和软件SPI（又称位敲打SPI）。理解它们的本质区别对后续优化至关重要。

硬件SPI是微控制器内置的专用外设，具有以下优势：

• 通信速率高：STM32H7系列的SPI时钟最高可达150MHz（理论值）
• CPU占用低：数据传输由DMA控制器或SPI外设自动完成
• 时序精确：信号边沿整齐，减少通信错误

相比之下，软件SPI是通过GPIO模拟实现的：

• 灵活性强：不依赖特定硬件引脚
• 速率受限：受CPU处理速度制约
• 资源消耗大：需要CPU持续参与数据传输

实测数据对比（STM32H750 @480MHz）：

注意：硬件SPI的实际性能还与PCB布线质量、屏幕控制器特性有关。中景园1.47寸屏的ST7789控制器最高支持80MHz时钟，但实际测试发现30MHz是最稳定的工作频率。

2. CubeMX硬件SPI配置详解

2.1 基础外设配置

使用STM32CubeMX进行硬件SPI配置时，关键步骤如下：

1. 在"Pinout & Configuration"标签页启用SPI外设
2. 配置SPI模式为"Full-Duplex Master"
3. 设置时钟分频系数（Prescaler）为2，得到30MHz时钟
4. 配置数据宽度为8位，CPOL=Low，CPHA=1Edge
5. 启用DMA传输（可选，后续性能优化章节会详述）

关键参数计算公式：

SPI时钟 = APB总线时钟 / Prescaler

以STM32H750为例，APB时钟通常为240MHz：

240MHz / 8 = 30MHz

2.2 屏幕控制引脚配置

除了SPI通信引脚外，ST7789还需要几个控制信号：

// 引脚定义示例（根据实际电路调整） #define LCD_RES_Pin GPIO_PIN_4 #define LCD_RES_GPIO_Port GPIOC #define LCD_DC_Pin GPIO_PIN_5 #define LCD_DC_GPIO_Port GPIOC #define LCD_CS_Pin GPIO_PIN_0 #define LCD_CS_GPIO_Port GPIOB #define LCD_BLK_Pin GPIO_PIN_1 #define LCD_BLK_GPIO_Port GPIOB

在CubeMX中需要将这些引脚配置为：

• RESET：GPIO输出
• DC（数据/命令选择）：GPIO输出
• CS（片选）：GPIO输出（也可用硬件NSS）
• BLK（背光控制）：GPIO输出（PWM调光更佳）

3. HAL库驱动实现关键代码

3.1 初始化序列发送

ST7789需要特定的初始化命令序列才能正常工作。以下是使用硬件SPI发送命令的典型实现：

void LCD_WriteCommand(uint8_t cmd) { HAL_GPIO_WritePin(LCD_DC_GPIO_Port, LCD_DC_Pin, GPIO_PIN_RESET); // DC=0:命令 HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_RESET); // CS=0:选中 HAL_SPI_Transmit(&hspi1, &cmd, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_SET); // CS=1:取消选中 } void LCD_WriteData(uint8_t data) { HAL_GPIO_WritePin(LCD_DC_GPIO_Port, LCD_DC_Pin, GPIO_PIN_SET); // DC=1:数据 HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(&hspi1, &data, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_SET); }

3.2 屏幕初始化优化

中景园1.47寸屏的初始化序列需要特别注意以下几点：

• 复位信号必须保持低电平至少10ms
• 部分命令之间需要添加延时
• 初始化完成后建议延时120ms再开始绘图

优化后的初始化代码结构：

void LCD_Init(void) { // 硬件复位 HAL_GPIO_WritePin(LCD_RES_GPIO_Port, LCD_RES_Pin, GPIO_PIN_RESET); HAL_Delay(20); HAL_GPIO_WritePin(LCD_RES_GPIO_Port, LCD_RES_Pin, GPIO_PIN_SET); HAL_Delay(120); // 发送初始化命令序列 LCD_WriteCommand(0x11); // Sleep out HAL_Delay(120); LCD_WriteCommand(0x3A); // 颜色模式设置 LCD_WriteData(0x55); // 16位RGB565 // ...其他初始化命令 LCD_WriteCommand(0x29); // 开启显示 }

4. 性能优化进阶技巧

4.1 DMA传输实现

使用DMA可以进一步降低CPU占用率，特别适合全屏刷新场景：

// DMA配置（CubeMX中启用SPI TX DMA） void LCD_TransmitDMA(uint8_t *data, uint16_t length) { HAL_GPIO_WritePin(LCD_DC_GPIO_Port, LCD_DC_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit_DMA(&hspi1, data, length); // 注意：需要在SPI传输完成回调中拉高CS }

4.2 双缓冲机制

对于动画显示场景，可以采用双缓冲技术：

1. 在后台缓冲区准备下一帧图像
2. 使用DMA传输当前帧
3. 交换缓冲区指针

uint16_t frameBuffer[2][LCD_WIDTH * LCD_HEIGHT]; uint8_t activeBuffer = 0; void LCD_UpdateFrame(void) { LCD_SetWindow(0, 0, LCD_WIDTH-1, LCD_HEIGHT-1); LCD_TransmitDMA((uint8_t*)frameBuffer[activeBuffer], LCD_WIDTH*LCD_HEIGHT*2); activeBuffer ^= 1; // 切换缓冲区 }

4.3 时钟频率调优

虽然ST7789理论上支持80MHz时钟，但实际应用中需要考虑：

• PCB走线长度和阻抗匹配
• 电源噪声影响
• 屏幕模组本身的质量

建议测试流程：

1. 从10MHz开始逐步提高时钟频率
2. 每个频率下测试以下场景：
   • 全屏纯色显示
   • 快速切换对比色
   • 显示精细图案
3. 选择最高无错误工作的频率

5. 常见问题排查指南

5.1 屏幕无显示

检查步骤：

1. 确认背光是否开启（测量BLK引脚电压）
2. 检查复位时序是否符合要求
3. 用逻辑分析仪抓取SPI信号
4. 验证初始化命令序列是否正确

5.2 显示花屏或错位

可能原因：

• 颜色模式设置不匹配（RGB565 vs RGB888）
• 显存大小与屏幕分辨率不匹配
• 横竖屏设置错误

// 正确的显存定义示例（172x320 RGB565） uint16_t buffer[172 * 320]; // 每个像素占2字节

5.3 通信不稳定

解决方案：

1. 降低SPI时钟频率
2. 检查PCB走线，确保SCLK和MOSI等长
3. 在SPI线上添加适当端接电阻
4. 确保电源稳定，必要时增加滤波电容

硬件SPI驱动ST7789屏幕虽然初期配置稍复杂，但带来的性能提升非常显著。在最近的一个工业HMI项目中，改用硬件SPI后，界面流畅度从原来的15fps提升到了60fps，同时CPU占用率从80%降到了不足10%。这种优化对于需要复杂图形界面的嵌入式系统来说，效果立竿见影。