用SPI点亮第一块屏：STM32驱动screen+实战手记
你有没有过这样的经历？项目做到一半，老板突然说：“加个屏幕吧，用户要能看懂。”然后你就开始翻数据手册、查引脚定义、调试时序——一连串操作下来，三天过去了，屏幕还是一片黑。
别慌。今天我就带你从零跑通STM32通过SPI驱动screen+显示模块的全流程，不讲虚的，只聊实战中踩过的坑和绕得开的弯路。我们不堆术语，而是像两个工程师坐在工位上对代码那样，一步步把这块“难搞”的屏点亮。
为什么是SPI？不是I²C也不是并口？
先解决一个根本问题：为啥非要用SPI来驱动screen+？
我之前也试过用I²C接OLED，简单是真简单，但一旦想画点动态图表或者刷新整屏内容，那延迟简直让人怀疑人生。标准模式100kHz？别说动画了，连滚动文字都卡成幻灯片。
而传统的8位并行接口虽然速度快，但占用MCU引脚太多——光数据线就要8根，再加上控制线，轻轻松松吃掉十几个GPIO。对于资源紧张的STM32G0或F1系列来说，这简直是奢侈消费。
于是，SPI成了折中的最优解：
- 引脚少（SCLK、MOSI、CS，再加一个DC就够了）
- 速率高（轻松上20MHz以上）
- 支持DMA传输，CPU几乎不用插手
- 多数主流TFT/OLED屏都原生支持
更重要的是，STM32的SPI外设做得相当成熟，配合HAL库，初始化也就几十行代码的事儿。
所以结论很明确：如果你在做一款带图形界面的嵌入式产品，又不想烧钱上GPU方案，SPI + screen+ 就是你最值得投资的技术组合。
硬件怎么连？一张图说清关键信号
先来看最常见的连接方式。假设你手上是一块基于ILI9341驱动IC的2.8英寸TFT模块，背面标着VCC、GND、SCL、SDA、RES、DC、CS这些标签——注意，这里的SCL其实就是SCLK，SDA就是MOSI。
我把常用引脚对应关系列出来：
| 模块引脚 | 功能说明 | 推荐连接（以STM32F4为例） |
|---|---|---|
| VCC | 电源输入（3.3V） | 板载LDO输出 |
| GND | 地 | 共地 |
| SCLK | 时钟线 | PA5 (SPI1_SCK) |
| MOSI | 主发从收数据线 | PA7 (SPI1_MOSI) |
| CS | 片选（低电平有效） | PA4（软件控制更灵活） |
| DC | 数据/命令选择 | PA6（任意GPIO即可） |
| RST | 复位（可选，建议接） | PA3（软件可控复位） |
其中最关键的是DC引脚—— 它决定了你传下去的是命令还是数据。比如发个0x2C表示开始写像素，这是命令；后面跟着的一长串RGB颜色值，就是数据。靠的就是DC电平切换。
至于CS，虽然硬件NSS可以自动管理，但在实际开发中我更推荐软件控制CS脚。原因很简单：很多模块对片选时序要求严格，HAL库里硬件NSS有时会多拉高半个周期，导致通信失败。自己用HAL_GPIO_WritePin()控制，反而更稳。
SPI初始化：别让配置毁了高速通道
接下来是重头戏——SPI初始化。很多人以为只要打开时钟、配好引脚就行，结果发现传输速度提不上去，甚至根本不通。问题往往出在几个细节上。
SPI_HandleTypeDef hspi1; void MX_SPI1_Init(void) { __HAL_RCC_SPI1_CLK_ENABLE(); __HAL_RCC_GPIOA_CLK_ENABLE(); GPIO_InitTypeDef gpio = {0}; // SCLK & MOSI: 复用推挽，高速 gpio.Pin = GPIO_PIN_5 | GPIO_PIN_7; gpio.Mode = GPIO_MODE_AF_PP; gpio.Alternate = GPIO_AF5_SPI1; gpio.Speed = GPIO_SPEED_FREQ_VERY_HIGH; // 必须设为最高速！ gpio.Pull = GPIO_NOPULL; HAL_GPIO_Init(GPIOA, &gpio); // CS 和 DC: 普通输出即可 gpio.Pin = GPIO_PIN_4 | GPIO_PIN_6; gpio.Mode = GPIO_OUTPUT_PP; HAL_GPIO_Init(GPIOA, &gpio); // 默认状态：不选中模块，DC默认低（准备发命令） HAL_GPIO_WritePin(CS_PORT, CS_PIN, GPIO_PIN_SET); HAL_GPIO_WritePin(DC_PORT, DC_PIN, GPIO_PIN_RESET); hspi1.Instance = SPI1; hspi1.Init.Mode = SPI_MODE_MASTER; hspi1.Init.Direction = SPI_DIRECTION_1LINE; // 单向发送，省一根线 hspi1.Init.DataSize = SPI_DATASIZE_8BIT; hspi1.Init.CLKPolarity = SPI_POLARITY_LOW; // 空闲时钟低电平 hspi1.Init.CPHA = SPI_PHASE_1EDGE; // 第一跳变沿采样 hspi1.Init.NSS = SPI_NSS_SOFT; // 软件控制CS hspi1.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_4; // APB2=84MHz → SCLK=21MHz hspi1.Init.FirstBit = SPI_FIRSTBIT_MSB; hspi1.Init.TIMode = DISABLE; hspi1.Init.CRCCalculation = DISABLE; if (HAL_SPI_Init(&hspi1) != HAL_OK) { Error_Handler(); } }有几个点必须强调：
- GPIO Speed一定要设为VERY_HIGH，否则高频下波形畸变严重。
- BaudRatePrescaler选4，这样在84MHz APB2总线下能得到21MHz的SCLK，足够驱动大多数TFT屏。
- Direction设为1LINE，因为我们只往屏幕写数据，不需要读回状态（除非你要轮询忙标志）。
- CPOL=0, CPHA=0对应SPI Mode 0，这是绝大多数screen+模块的标准配置。
初始化完成后，你可以用逻辑分析仪抓一下SCLK和MOSI，看看能不能看到清晰的数据帧。如果波形毛刺多或频率不对，回头检查RCC配置和GPIO设置。
命令与数据分离：DC引脚才是灵魂
很多初学者搞不清为什么同样的SPI传输，有时候是“设置光标”，有时候却是“刷一堆像素”。答案就在DC引脚。
举个例子：
void Screen_WriteCommand(uint8_t cmd) { HAL_GPIO_WritePin(DC_PORT, DC_PIN, GPIO_PIN_RESET); // 切到命令模式 HAL_GPIO_WritePin(CS_PORT, CS_PIN, GPIO_PIN_RESET); HAL_SPI_Transmit(&hspi1, &cmd, 1, 100); HAL_GPIO_WritePin(CS_PORT, CS_PIN, GPIO_PIN_SET); } void Screen_WriteData(uint8_t *data, size_t len) { HAL_GPIO_WritePin(DC_PORT, DC_PIN, GPIO_PIN_SET); // 切到数据模式 HAL_GPIO_WritePin(CS_PORT, CS_PIN, GPIO_PIN_RESET); HAL_SPI_Transmit(&hspi1, data, len, HAL_MAX_DELAY); HAL_GPIO_WritePin(CS_PORT, CS_PIN, GPIO_PIN_SET); }就这么简单。每次发命令前拉低DC，发数据前拉高DC。模块内部的驱动IC（如ILI9341）会根据这个电平判断后续字节的意义。
⚠️ 一个小坑：有些模块响应慢，连续操作之间需要加微秒级延时。别迷信
HAL_MAX_DELAY万能，某些场景下反而会阻塞太久。建议关键步骤后加__NOP()或精确延时。
屏幕初始化：照着手册走一遍“开机仪式”
拿到一块新屏，第一步不是画画，而是喂它一套正确的初始化序列。这部分最容易出错，因为不同厂家的模组哪怕用同一个IC，也可能有细微差异。
以下是ILI9341的典型初始化流程片段：
void Screen_Init(void) { HAL_Delay(100); // 上电稳定 Screen_Reset(); // 软件复位 HAL_Delay(150); Screen_WriteCommand(0xCF); uint8_t seq1[] = {0x00, 0x83, 0x30}; Screen_WriteData(seq1, 3); Screen_WriteCommand(0xED); uint8_t seq2[] = {0x64, 0x03, 0x12, 0x81}; Screen_WriteData(seq2, 4); // ... 中间省略若干配置 ... Screen_WriteCommand(0x3A); // 设置色彩格式 Screen_WriteData((uint8_t[]){0x55}, 1); // 16位色，RGB565 Screen_WriteCommand(0x11); // 退出睡眠 HAL_Delay(120); Screen_WriteCommand(0x29); // 开启显示 }你会发现这些命令看起来毫无规律，其实它们是在配置内部寄存器：电源参数、帧率、Gamma曲线、接口模式等等。千万别删减！曾经我为了节省Flash空间删了几条“看似无关”的指令，结果屏幕亮度忽明忽暗，折腾了一整天才发现是Gamma没校准。
建议做法：直接使用厂商提供的初始化代码，哪怕看不懂也要原样保留。等系统跑通后再逐条注释测试，确认是否必要。
如何高效刷屏？别让CPU卡在数据搬运上
到这里，屏幕是亮了，但如果你每次更新画面都用HAL_SPI_Transmit()同步发送几万字节的图像数据，那主循环基本就废了——用户按键没人响应，传感器数据积压……
怎么办？上DMA。
STM32的SPI+DMA组合堪称神器。只需一次配置，就能让SPI外设自己从内存搬数据，CPU腾出来干别的事。
开启DMA的关键修改：
// 在SPI结构体中启用TX DMA请求 hspi1.Init.NSS = SPI_NSS_SOFT; // ... 其他配置不变 ... if (HAL_SPI_Init(&hspi1) != HAL_OK) { ... } // 单独启动DMA通道 __HAL_LINKDMA(&hspi1, hdmatx, hdma_spi1_tx); // 启动传输时不阻塞 HAL_SPI_Transmit_DMA(&hspi1, pixel_buffer, 320*240*2); // RGB565每像素2字节配合双缓冲机制，你甚至可以在后台刷新当前帧的同时，前台生成下一帧内容，实现平滑动画。
当然，前提是你的RAM够大。QVGA分辨率全彩帧缓存要150KB左右，F4系列还扛得住，F1就得考虑“局部刷新”策略了。
实战技巧：那些文档里不会写的“秘籍”
最后分享几个我在真实项目中总结的经验，全是血泪教训换来的：
✅ 使用宏封装命令调用
#define SEND_CMD(c) Screen_WriteCommand(c) #define SEND_DATA(d,l) Screen_WriteData(d,l) #define SET_ADDR(x1,y1,x2,y2) \ do { \ SEND_CMD(0x2A); SEND_DATA((uint8_t[]){(x1)>>8,(x1)&0xFF,(x2)>>8,(x2)&0xFF},4); \ SEND_CMD(0x2B); SEND_DATA((uint8_t[]){(y1)>>8,(y1)&0xFF,(y2)>>8,(y2)&0xFF},4); \ SEND_CMD(0x2C); \ } while(0)写UI逻辑时清爽多了。
✅ 局部刷新优于全屏重绘
只更新变化区域，减少SPI流量。例如温度数字变了，只刷那个小方块就行。
✅ 加电容！加电容！加电容！
screen+模块瞬间电流可达100mA以上，不加去耦电容容易拉垮系统电压。建议电源入口放一个10μF钽电容 + 0.1μF陶瓷电容。
✅ OLED低温要延长延时
冬天测试时发现OLED启动失败？那是低温下响应变慢。把初始化中的HAL_Delay(150)改成200试试。
✅ 出错了先复位
SPI通信失败别死循环重试，果断给RST脚来个低脉冲，重新初始化整个模块，比纠结时序强得多。
写在最后：这不是终点，而是起点
当你第一次看到STM32把第一个彩色矩形成功推送到屏幕上时，那种成就感，不亚于点亮LED时的激动。
但这只是开始。真正的挑战在于如何构建稳定的GUI框架、处理触摸事件、优化功耗、适配多种分辨率……好消息是，现在已经有LVGL这样的开源GUI库帮你搞定大部分工作。
而你所需要掌握的核心能力，就是理解底层通信机制。只有清楚SPI是怎么传数据的，DC是怎么切模式的，GRAM是怎么被填满的，你才能在问题出现时快速定位，而不是对着库函数干瞪眼。
所以，请务必亲手写一遍SPI初始化，亲手调一次DC电平，亲手送一组命令进去。
动手，才是嵌入式工程师最好的语言。
如果你正在尝试类似的项目，欢迎在评论区留言交流——我们一起把每一块屏，都点亮得更有意义。
