从零打造嵌入式彩屏：STM32 + ST7789V 高效驱动实战
你有没有遇到过这样的项目需求——设备需要显示图形、图标甚至简单动画，但段码屏太单调，字符LCD又不够用？这时候一块小巧的彩色TFT屏幕就成了理想选择。而在众多TFT控制器中，ST7789V凭借其高集成度、低功耗和出色的色彩表现，正成为1.3~1.69英寸小尺寸彩屏的“隐形冠军”。
而主控方面，STM32系列MCU自然不必多说，尤其是F4、G0、L4等型号，内置高速SPI与丰富GPIO资源，堪称驱动这类屏幕的黄金搭档。
今天，我们就来手把手实现STM32通过SPI接口驱动ST7789V的完整流程。不讲空话，只聚焦于你能直接拿去用的工程实践：从硬件连接到寄存器配置，从初始化时序到刷屏优化，一文打通全链路。
为什么是 ST7789V？它到底强在哪？
在选型阶段，很多人会纠结于 ILI9341、SSD1351 还是 ST7789V。其实如果你要做的是小尺寸圆形/圆角屏、穿戴类或电池供电设备，ST7789V 往往是更优解。
我们来看几个关键点：
| 特性 | ST7789V 实际表现 |
|---|---|
| 分辨率适配性 | 原生支持 240×240、240×280，完美匹配主流迷你方形/圆形屏 |
| 供电方式 | 单电源（2.2V~3.3V），内部升压，省去额外DC-DC电路 |
| 通信接口 | 支持四线SPI（SCK/MOSI/CS/DC），仅需5个IO即可点亮 |
| 色彩深度 | RGB565，65K色，伽马可调，视觉细腻 |
| 刷新速度 | SPI最高可达15MHz，理论带宽远超I2C |
更重要的是，它的初始化序列简洁、启动快、兼容性强，非常适合资源有限的嵌入式系统。
📌 小贴士：市面上很多标称“ST7735S”的模块其实是ST7789V的变种，引脚和命令集高度相似，代码基本通用。
硬件怎么接？一张图说清楚
先搞定物理连接。假设你使用的是常见的 STM32F407 开发板，搭配一个典型的 1.3 英寸 ST7789V 屏幕模块，推荐接法如下：
| STM32 引脚 | 功能 | 屏幕端子 | 说明 |
|---|---|---|---|
| PB5 | SCK | SCL | SPI时钟 |
| PB7 | MOSI | SDA | 数据输出 |
| PB6 | CS | CS | 片选，低有效 |
| PB8 | DC | D/C 或 A0 | 区分命令/数据 |
| PB9 | RST | RST | 复位信号 |
| 3.3V | VCC | VCC | 注意不要接5V！ |
| GND | GND | GND | 共地 |
📌重点提醒：
- 所有信号线建议串联一个22Ω电阻抑制振铃（特别是走线较长时）；
- VCC 引脚旁务必加0.1μF陶瓷电容滤波；
- 若RST由MCU控制，则无需外接RC复位电路。
这种四线SPI+DC+RST的组合，总共只需6个引脚，对引脚紧张的小封装MCU非常友好。
SPI通信核心机制：命令与数据如何区分？
这是新手最容易搞混的地方：同样是SPI发送一个字节，怎么知道它是“设置颜色模式”还是“写像素数据”？
答案就在DC引脚（Data/Command Control）上。
工作逻辑很简单：
- DC = 0：接下来传输的是命令（比如
0x3A表示设置像素格式） - DC = 1：接下来传输的是数据（比如
0x05表示启用RGB565）
整个通信过程遵循以下步骤：
- 拉低 CS（选中设备）
- 设置 DC 电平（决定本次是命令还是数据）
- 通过 SPI 发送1个或多个字节
- 等待传输完成（轮询 TXE 标志或使用DMA）
- 拉高 CS（释放总线）
别看简单，这一步若出错，屏幕可能完全无反应，或者花屏、偏色。
初始化不是随便写的：顺序和延时都得讲究
很多开发者照搬网上的初始化代码却失败了，问题往往出在时序不匹配或缺少必要延时。
ST7789V 上电后处于睡眠状态，必须按特定顺序唤醒并配置。下面是经过实测验证的标准初始化流程：
void ST7789_Init(void) { // === 硬件复位 === ST7789_RST_LOW(); HAL_Delay(10); ST7789_RST_HIGH(); HAL_Delay(120); // 必须等待足够时间让内部电路稳定 // === 退出睡眠模式 === ST7789_SendCommand(0x11); HAL_Delay(120); // 关键！必须等待退出睡眠 // === 设置颜色格式为 RGB565 === ST7789_SendCommand(0x3A); ST7789_SendData(0x05); // 16-bit/pixel // === 设置显示方向（MADCTL）=== ST7789_SendCommand(0x36); ST7789_SendData(0xC0); // 示例：横屏翻转（可根据实际调整） /* * MADCTL 方向控制位说明： * bit7: MY - 行扫描方向 * bit6: MX - 列扫描方向 * bit5: MV - 行列交换 * 常见组合： * 0x00 -> 竖屏正常 * 0xC0 -> 横屏翻转（常用） */ // === 设置GRAM绘图区域（窗口）=== ST7789_SendCommand(0x2A); // Column Address Set ST7789_SendData(0x00); ST7789_SendData(0x00); // 起始列：0 ST7789_SendData(0x00); ST7789_SendData(0xEF); // 结束列：239 ST7789_SendCommand(0x2B); // Page Address Set ST7789_SendData(0x00); ST7789_SendData(0x00); // 起始页：0 ST7789_SendData(0x00); ST7789_SendData(0xEF); // 结束页：239 // === 开启显示 === ST7789_SendCommand(0x29); // === 进入正常显示模式（关闭睡眠）=== ST7789_SendCommand(0x13); }⚠️ 注意事项：
-HAL_Delay()在某些系统中不可用（如FreeRTOS），应替换为osDelay()或自定义延时函数；
- 延时值严格参考数据手册，尤其是0x11后的120ms，不能省略；
-MADCTL的值根据你的安装方向调整，否则图像会上下颠倒或左右镜像。
如何高效刷屏？别再一个字节一个字节传了！
最影响体验的就是刷屏慢。如果你用HAL_SPI_Transmit()逐个发送像素，刷一次全屏（240×240×2 = 115,200 字节）可能要几百毫秒，根本没法做动态UI。
解决办法只有一个：启用DMA传输。
推荐做法：
- 定义一个行缓冲区（例如
uint8_t line_buffer[240*2];） - 填充一行像素数据（RGB565格式）
- 使用
HAL_SPI_Transmit_DMA()一次性发送整行
这样CPU几乎不参与数据搬运，可以继续处理其他任务。
示例：清屏为红色（使用DMA）
uint16_t red_pixel = 0xF800; // RGB565: 红色 uint8_t color_data[2] = { (red_pixel >> 8), red_pixel & 0xFF }; // 设置写GRAM命令 ST7789_SendCommand(0x2C); // 使用DMA连续发送全部像素 for (int i = 0; i < 240 * 240; i++) { HAL_SPI_Transmit(&hspi1, color_data, 2, 10); // 小批量发送，避免阻塞 }更好的方案是预先构建好帧缓冲区，然后整块DMA发送。但对于Flash小的MCU（如STM32G0），可采用“分块刷新”策略，只更新变化区域。
寄存器精讲：几个关键控制字你必须懂
虽然大部分初始化可以用现成代码，但理解核心寄存器才能灵活应对各种问题。
| 寄存器命令 | 名称 | 作用 |
|---|---|---|
0x11 | Sleep Out | 退出睡眠模式，必须最先执行 |
0x13 | Normal Display Mode On | 开启正常显示，关闭睡眠 |
0x29 | Display ON | 启动显示引擎 |
0x2A | CASET (Column Address Set) | 设置列地址范围 |
0x2B | RASET (Row Address Set) | 设置行地址范围 |
0x2C | RAMWR (Memory Write) | 开始向GRAM写入像素数据 |
0x36 | MADCTL | 控制显示方向、镜像、扫描顺序 |
0x3A | COLMOD | 设置颜色格式（565/666等） |
其中MADCTL是调试中最常修改的寄存器。举个例子：
ST7789_SendCommand(0x36); ST7789_SendData(0x60); // MY=0, MX=1, MV=1 → 旋转90°且X翻转你可以通过改变这个字节快速调整屏幕朝向，而无需重新布线。
常见坑点与避坑秘籍
❌ 问题1：屏幕全白或全黑，没有反应
- ✅ 检查供电是否为3.3V（非5V）
- ✅ 检查SPI Mode是否为Mode 0（CPOL=0, CPHA=0）
- ✅ 确认DC引脚连接正确，且初始化时序中有足够延时
❌ 问题2：显示乱码、花屏
- ✅ 检查MOSI和SCK是否接反
- ✅ 增加SPI线上拉/串联电阻（22Ω）
- ✅ 确保SPI时钟不超过屏幕支持上限（一般≤15MHz）
❌ 问题3：只能显示部分区域
- ✅ 检查
CASET和RASET设置的地址范围是否正确 - ✅ 确认发送
0x2C命令后再开始传数据
❌ 问题4：刷屏卡顿严重
- ✅ 改用DMA而非轮询发送
- ✅ 提高SPI波特率（如设置为
fpclk/4） - ✅ 采用局部刷新代替全屏刷新
性能还能怎么榨干？进阶技巧分享
✅ 技巧1：提高SPI速率
在MXCube中配置SPI时，将Prescaler设为2（即 f_PCLK / 2），可达到接近主频一半的速度。例如72MHz系统下，SPI可达36MHz（实际受限于屏幕能力，建议设为10~12MHz）。
✅ 技巧2：局部刷新（Partial Update）
只更新变动区域，大幅减少数据量。例如更新一个时钟数字：
// 设置仅更新第100~105行，第50~60列 ST7789_SetWindow(50, 100, 60, 105); ST7789_WriteFrameBuffer(partial_data, 11*6*2); // 发送对应数据✅ 技巧3：结合LVGL打造GUI
一旦底层驱动稳定，就可以接入轻量级GUI库如LVGL，轻松实现按钮、滑动条、图表等复杂界面。
只需注册两个回调函数：
-flush_cb: 将LVGL缓冲区内容刷到ST7789V
-rounder_cb: 对齐DMA传输边界
后续文章我们可以专门展开LVGL移植细节。
写在最后：这套方案适合谁？
如果你正在开发以下类型的项目，那么STM32 + ST7789V + SPI绝对值得考虑：
- 智能手表、健康手环等穿戴设备
- 便携式仪表、工业HMI面板
- DIY电子玩具、创客项目
- 低成本POS机、扫码枪显示屏
- 需要图形化提示的家电控制板
它不仅节省引脚、降低BOM成本，而且开发门槛低，社区资源丰富，真正做到了“小而美”。
掌握这项技能后，你会发现：原来给MCU加上一块彩屏，并不像想象中那么难。
如果你已经成功点亮了自己的ST7789V屏幕，欢迎在评论区晒图交流！也欢迎提出你在调试中遇到的具体问题，我们一起攻克。
