如何让STM32驱动ST7789？一张图讲清硬件连接与实战要点
你有没有遇到过这样的情况：买了一块漂亮的1.3英寸彩屏，型号是ST7789，兴冲冲接到STM32上，结果屏幕要么不亮，要么花屏、偏色、闪屏……调试半天无从下手？
别急。这几乎是每个嵌入式工程师在接入TFT彩屏时都会踩的坑。
今天我们就来彻底讲明白——ST7789和STM32之间到底该怎么连？为什么这么连？哪些细节决定成败？
我们不堆术语，不照搬手册，而是从实际开发视角出发，用“人话”+“真经验”，带你打通从芯片到PCB再到代码的最后一公里。
一、先看核心：ST7789到底是块什么屏？
市面上很多小尺寸彩色TFT模块（比如常见的1.3”、1.69”圆角屏）都用的是ST7789这颗驱动IC。它不是一块“屏幕”，而是一个集成控制器的显示驱动芯片，直接贴在LCD面板背面。
它的厉害之处在于：
- 支持最高240×320 分辨率
- 内建153.6Kbit 显存（GRAM），不用外挂显存也能存一整屏图像
- 接口灵活：支持SPI、8080并行、I²C调试
- 自带电荷泵，能生成LCD所需的高压偏置，省掉一堆外围电路
- 支持软件设置旋转方向（0°/90°/180°/270°），适配不同安装方式
这意味着你可以用一个成本极低的MCU，比如 STM32F103C8T6（蓝 pill 板），就能驱动出流畅的图形界面。
二、为什么选STM32？因为它不只是“能跑”
虽然像Arduino或ESP8266也能点亮ST7789，但如果你要做点真正实用的东西——比如带菜单的仪表、动画UI、实时波形图——那必须上STM32。
原因很简单：
| 功能 | 普通MCU（如AVR） | STM32 |
|---|---|---|
| 主频 | ~16MHz | 72MHz~480MHz |
| RAM | <2KB | 可达数百KB |
| SPI速度 | 最高几MHz | 可达30MHz+ |
| 是否支持DMA | 否 | 是！ |
尤其是DMA + SPI 组合，可以让CPU在后台自动刷图，自己去干别的事，这才是工业级设计的做法。
三、最常用的连接方式：SPI四线制，只需6根线
来看这张经典又实用的连接示意图：
STM32 ST7789模块 ----------------------------------------------- PA5 (SPI1_SCK) ──────────→ SCL / SCK PA7 (SPI1_MOSI) ──────────→ SDA / DIN PB0 ──────────→ CS (片选) PB1 ──────────→ DC (数据/命令选择) PB2 ──────────→ RST (复位) VCC (3.3V) ──────────→ VCC GND ──────────→ GND LED+ ←──[100Ω]← PWM控制MOSFET → 背光调光✅ 实际项目中建议使用硬件SPI接口，并启用DMA传输以提升性能。
关键引脚说明（必看！）
| 引脚 | 作用 | 注意事项 |
|---|---|---|
| SCK & MOSI | SPI时钟和数据线 | 必须接对，否则通信失败；尽量走短距离差分感弱的路径 |
| CS | 片选信号（低有效） | 可固定拉低节省GPIO，但多设备时需片选切换 |
| DC (D/CX) | 区分发送的是命令还是数据 | 极其关键！接错会导致初始化失败或乱码 |
| RST | 硬件复位 | 建议由MCU控制，确保每次启动时序一致 |
| VCC/GND | 供电 | 加0.1μF陶瓷电容就近滤波，避免电源抖动 |
| BLK/LEDA | 背光阳极 | 不要直接接3.3V！应通过MOSFET做PWM调光 |
⚠️ 很多人忽略背光电流问题：这类屏幕背光通常需要80~120mA电流，直接由STM32 IO驱动会烧毁端口！
正确做法：
用一个N-MOS管（如2N7002或AO3400）控制背光通断，栅极接STM32的PWM输出，实现亮度调节。
四、那些让你崩溃的问题，其实都有解法
❌ 问题1：背光亮了，但屏幕黑屏 or 白屏
常见原因：
- 初始化序列没发完
- DC引脚接反了
- SPI时钟太快导致采样错误
✅解决方法：
1. 用示波器或逻辑分析仪抓一下SPI波形，确认第一条命令是否成功发出；
2. 检查LCD_WriteCommand()函数是否真的把DC拉低了；
3. 把SPI速率降到5~10MHz再试。
小技巧：可以在初始化前加一段延时
Delay_ms(150);，等电源完全稳定后再操作。
❌ 问题2：画面花屏、字符错位、颜色发紫
典型症状：像素错行、红蓝颠倒、绿色特别强。
根源分析：
- RGB565字节顺序搞错了
- MADCTL寄存器配置不当（扫描方向/颜色格式）
- 数据未按大端发送
✅解决方案：
检查你在初始化中写的这个寄存器：
// 设置内存访问控制：RGB模式，横屏左上为原点 LCD_WriteCommand(0x36); LCD_WriteData(0x00); // 具体值根据屏幕方向调整常用配置如下：
| 方向 | MADCTL值（0x36） | 效果 |
|---|---|---|
| 0° | 0x00 | 默认竖屏 |
| 90° | 0x60 | 左转横屏 |
| 180° | 0xC0 | 倒置 |
| 270° | 0xA0 | 右转横屏 |
同时确认颜色格式是否设为RGB565而非 BGR：
LCD_WriteCommand(0x3A); LCD_WriteData(0x55); // 16-bit/pixel, RGB565❌ 问题3：刷新慢、动画卡顿
你以为是算法慢？其实是传输瓶颈！
普通GPIO模拟SPI写一个像素可能要几十微秒，刷满240×320=76,800个像素就得好几百毫秒。
✅ 正确姿势：启用DMA + 硬件SPI
流程如下：
- 准备一块缓冲区存放图像数据（可存在SRAM或Flash）
- 配置SPI为DMA发送模式
- 设置好GRAM窗口后，触发DMA传输
- CPU腾出手来做其他任务，DMA完成时发中断通知
示例代码框架：
void LCD_FillArea_DMA(uint16_t x, uint16_t y, uint16_t w, uint16_t h, uint16_t *color_array) { LCD_SetAddressWindow(x, y, x+w-1, y+h-1); LCD_WriteCommand(ST7789_RAMWR); HAL_SPI_Transmit_DMA(&hspi1, (uint8_t*)color_array, w * h * 2); // 2 bytes per pixel }配合HAL库或LL库，轻松实现CPU零参与刷图。
五、电源与PCB设计：稳定性来自细节
很多开发者只关注代码，却忽略了硬件基础，结果系统总出奇奇怪怪的问题。
以下是几个关键设计建议：
✅ 电源处理
- 使用LDO提供稳定3.3V给VCC；
- 在靠近ST7789的VCC引脚处放置0.1μF陶瓷电容 + 10μF钽电容；
- 若系统有模拟部分（如ADC采样），注意数字地与模拟地分离，单点接地。
✅ PCB布局
- SPI走线尽量短且平行，避免与其他高速信号交叉；
- 屏幕模块下方不要布敏感模拟线路；
- 背光走线加粗，防止压降过大导致亮度不均；
- 所有信号线尽可能走在内层，顶层铺地屏蔽干扰。
✅ 上拉电阻要不要加？
一般情况下不需要。因为STM32的SPI推挽输出能力强，板内短距离连接足够可靠。
但如果走线超过5cm或环境噪声大，可在SCK和MOSI线上加4.7kΩ上拉电阻到3.3V。
六、推荐开发实践：写出可移植的驱动代码
别再写一堆裸写寄存器的“一次性代码”了。好的驱动应该具备以下特征：
✔ 封装基础操作
void LCD_WriteCommand(uint8_t cmd); void LCD_WriteData(uint8_t data); void LCD_WriteBuffer(uint8_t *buffer, size_t len);✔ 提供坐标抽象接口
void LCD_DrawPixel(int16_t x, int16_t y, uint16_t color); void LCD_FillRect(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color); void LCD_DrawImage(int16_t x, int16_t y, const uint16_t *image, int16_t w, int16_t h);✔ 支持LVGL、GUI Guider等主流框架
将底层驱动封装成标准接口，即可无缝接入LVGL：
void my_flush_cb(lv_disp_drv_t *disp, const lv_area_t *area, lv_color_t *color_p) { int32_t w = (area->x2 - area->x1 + 1); int32_t h = (area->y2 - area->y1 + 1); LCD_SetAddressWindow(area->x1, area->y1, area->x2, area->y2); LCD_WriteBuffer((uint8_t *)color_p, w * h * 2); lv_disp_flush_ready(disp); }这样你就可以用可视化工具设计UI，一键生成代码，效率翻倍。
七、这些场景，正适合用这套方案
别以为这只是“玩玩具”。这套组合已经在不少真实产品中落地：
📊 数据采集终端
- 实时绘制传感器曲线（温湿度、压力）
- 支持本地参数设置菜单
- 断网也能查看历史记录
🔋 智能手环原型
- 使用FreeRTOS调度界面刷新与蓝牙通信
- 配合触摸IC实现滑动手势
- 低功耗模式下关闭背光，仅保留RTC运行
🧪 便携式检测仪
- 显示波形图、柱状图、报警状态
- 中文字库预加载，支持多语言切换
- 可扩展SD卡存储截图
最后一点忠告：别忽视初始化序列
ST7789的初始化不是随便发几条命令就行。官方提供了一套“黄金序列”，包含了退出睡眠、设置伽马曲线、开启显示等关键步骤。
务必参考数据手册中的推荐流程，或者直接使用成熟开源库（如 Adafruit_ST7789 ）里的初始化代码。
否则你会发现：同样的硬件，别人能点亮，你就是不行。
如果你想快速上手，这里有一份精简清单供你对照检查：
✅ 已使用硬件SPI
✅ DC、CS、RST均已正确连接并初始化
✅ 电源加了去耦电容
✅ 初始化序列完整且顺序正确
✅ MADCTL和COLMOD设置匹配预期显示效果
✅ 背光通过MOSFET控制，非直连IO
✅ 图像刷新尝试启用DMA加速
只要这七项都打钩，你的ST7789基本就能稳稳点亮。
如果你正在做一个需要本地显示的小型嵌入式项目，不妨试试STM32 + ST7789这个组合。成本不高，资料丰富，生态成熟，最重要的是——你能真正掌控整个系统。
欢迎在评论区分享你的调试经历：你是怎么解决第一次花屏问题的？用了哪种调光方式？有没有加入触摸功能？
一起交流，少走弯路。
