STM32驱动ST7735实战：从零点亮一块1.8寸彩屏
你有没有遇到过这样的情况？手头有一块1.8寸的TFT彩屏，标着“ST7735”，买回来插上STM32却死活点不亮——要么全白、要么花屏、要么干脆黑屏。别急，这几乎是每个嵌入式开发者都会踩的坑。
今天我们就来彻底解决这个问题。不是简单贴代码，而是带你一步步搞懂原理、配对时序、写出稳定驱动，最终用STM32CubeMX+HAL库，把这块小屏幕真正“驯服”。
为什么是ST7735？
在众多TFT控制器中，ST7735是个特别的存在。它不像ILI9341那样功能复杂，也不像SSD1351主打OLED，它的定位非常清晰：为1.8英寸及以下的小尺寸彩屏提供低成本、低功耗、易集成的显示方案。
这类屏幕常见于：
- 智能手表原型
- WiFi天气站
- 手持测试仪
- 学生机/教学套件
分辨率通常是128×160像素，支持RGB565格式（65K色），通过SPI接口与主控通信。最关键的是——它便宜！很多模块十几块钱就能买到。
但便宜不代表简单。如果你只是照搬网上的驱动代码，大概率会翻车。因为不同厂商的模块，初始化序列、引脚定义、甚至颜色顺序都可能不一样。
那怎么办？答案就是：掌握底层逻辑 + 使用STM32CubeMX精准配置。
硬件连接：别小看这几根线
我们先来看最基础的硬件连接。假设你用的是STM32F103C8T6（蓝 pill 板），搭配一个典型的ST7735模块，接线如下：
| STM32 | ST7735模块 | 功能说明 |
|---|---|---|
| PA5 (SCK) | SCL / SCK | SPI时钟 |
| PA7 (MOSI) | SDA / MOSI | 数据输出 |
| PA4 | DC | 数据/命令选择 |
| PA6 | CS | 片选（低有效） |
| PB1 | RST | 复位（低有效） |
| 3.3V | VCC, LED | 电源和背光 |
| GND | GND | 共地 |
⚠️ 注意：有些模块标注的是“SDA”而不是“MOSI”，其实是一回事；还有些模块需要额外供电给LED背光，记得检查。
这里的关键是DC引脚——它是命令和数据的“开关”。当DC=0时，传输的是控制命令（比如清屏、旋转屏幕）；当DC=1时，传的就是像素数据了。
STM32CubeMX怎么配？这才是重点
很多人失败的第一步，就出在SPI配置上。我们打开STM32CubeMX，新建工程，选择你的MCU型号（如STM32F103C8），然后开始配置。
✅ 正确配置SPI1（或其他SPI）
进入Pinout & Configuration页面，启用SPI1，设置为主机模式（Master），关键参数如下：
| 参数 | 推荐值 | 说明 |
|---|---|---|
| Mode | Full Duplex Master | 单向传输也够用，但默认即可 |
| Hardware NSS Signal | Disabled | 我们自己用GPIO控制CS |
| Baud Rate Prescaler | fpclk / 16 | 初始建议不要太快，避免时序问题 |
| Clock Polarity | Low | 空闲时SCK为低电平 |
| Clock Phase | 1 Edge | 第一个上升沿采样 → 实际是SPI Mode 0 |
| Frame Format | Motorola | 标准SPI格式 |
| Data Size | 8 bits | 每次发一个字节 |
📌划重点：虽然HAL库里写的是CPHA = SPI_PHASE_1EDGE，但这对应的是Mode 0（CPOL=0, CPHA=0），也就是大多数ST7735模块要求的SPI模式！
如果你不确定模块支持哪种模式，优先尝试 Mode 0。
✅ 配置控制引脚（GPIO）
除了SPI，你还得手动分配几个GPIO用于控制：
TFT_DC→ PA4 → 输出推挽TFT_CS→ PA6 → 输出推挽（初始高）TFT_RST→ PB1 → 输出推挽（初始高）
这些都可以在Pinout图上直接点击设置，并命名Label方便后续生成宏定义。
最后别忘了配置RCC时钟源（通常使用外部晶振8MHz，PLL倍频到72MHz），然后生成代码。
底层驱动函数：一切从这里开始
CubeMX只帮你做了初始化，真正的通信还得靠你自己封装函数。以下是三个最核心的接口：
1. 写命令
void tft_write_command(uint8_t cmd) { HAL_GPIO_WritePin(TFT_DC_GPIO_Port, TFT_DC_Pin, GPIO_PIN_RESET); // 命令模式 HAL_GPIO_WritePin(TFT_CS_GPIO_Port, TFT_CS_Pin, GPIO_PIN_RESET); // 选中设备 HAL_SPI_Transmit(&hspi1, &cmd, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(TFT_CS_GPIO_Port, TFT_CS_Pin, GPIO_PIN_SET); // 取消选中 }2. 写数据
void tft_write_data(uint8_t data) { HAL_GPIO_WritePin(TFT_DC_GPIO_Port, TFT_DC_Pin, GPIO_PIN_SET); // 数据模式 HAL_GPIO_WritePin(TFT_CS_GPIO_Port, TFT_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(&hspi1, &data, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(TFT_CS_GPIO_Port, TFT_CS_Pin, GPIO_PIN_SET); }3. 批量写数据（提升效率）
单字节发送太慢，画图卡成PPT。我们可以加个批量函数：
void tft_write_buffer(uint8_t *buffer, size_t len) { HAL_GPIO_WritePin(TFT_DC_GPIO_Port, TFT_DC_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(TFT_CS_GPIO_Port, TFT_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(&hspi1, buffer, len, HAL_MAX_DELAY); HAL_GPIO_WritePin(TFT_CS_GPIO_Port, TFT_CS_Pin, GPIO_PIN_SET); }这三个函数构成了整个驱动的地基。所有高级操作（清屏、画点、写字）都将基于它们实现。
初始化序列：能不能亮屏，全看它了
这是最容易出错的部分。网上很多代码直接复制某家模块的初始化流程，结果换一块屏就不行了。
正确的做法是：参考官方Datasheet，结合具体模块调整参数。
下面是适用于大多数绿色PCB版ST7735（俗称“绿屏”）的初始化流程：
void st7735_init(void) { // 硬件复位 HAL_GPIO_WritePin(TFT_RST_GPIO_Port, TFT_RST_Pin, GPIO_PIN_RESET); HAL_Delay(10); HAL_GPIO_WritePin(TFT_RST_GPIO_Port, TFT_RST_Pin, GPIO_PIN_SET); HAL_Delay(120); tft_write_command(0x11); // Sleep Out HAL_Delay(120); tft_write_command(0x3A); // COLMOD: 设置颜色格式 tft_write_data(0x05); // 16位色 (RGB565) tft_write_command(0x36); // MADCTL: 显存访问控制 tft_write_data(0xC0); // BGR顺序 + Y轴镜像（适配常见方向） tft_write_command(0x2C); // RAMWR: 准备写GRAM tft_write_command(0x29); // Display ON }📌 解释几个关键命令：
-0x11: 退出睡眠模式，必须等待至少120ms
-0x3A: 设置颜色深度，0x05 表示16位色
-0x36: 控制显示方向和颜色排列，如果你发现颜色发紫或倒置，多半是这里错了
-0x29: 开启显示，否则屏幕不会亮
💡 提示：有些模块是“BGR”排列而非“RGB”，如果你发现红色变蓝、蓝色变红，就把MADCTL中的颜色标志位改一下，或者找找有没有
RGB/BGR切换命令。
如何验证成功？来个快速测试
写完初始化后，别急着上GUI，先做个简单的测试：整屏填充单一颜色。
void tft_fill_screen(uint16_t color) { uint8_t hi = color >> 8; uint8_t lo = color; tft_write_command(0x2A); // CASET: 列地址设置 tft_write_data(0x00); tft_write_data(0x00); tft_write_data(0x00); tft_write_data(0x7F); // 0~127 tft_write_command(0x2B); // RASET: 行地址设置 tft_write_data(0x00); tft_write_data(0x00); tft_write_data(0x00); tft_write_data(0x9F); // 0~159 tft_write_command(0x2C); // RAMWR: 开始写数据 uint8_t color_buf[128 * 2]; // 每次发一行（128像素 × 2字节） for (int i = 0; i < 128; i++) { color_buf[2*i] = hi; color_buf[2*i+1] = lo; } for (int row = 0; row < 160; row++) { tft_write_buffer(color_buf, sizeof(color_buf)); } }在main()里调用：
int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_SPI1_Init(); st7735_init(); tft_fill_screen(0xF800); // 红色填充（RGB565格式） while (1) {} }如果一切顺利，你应该看到屏幕变成纯红色！
常见问题与避坑指南
❌ 屏幕全白或闪动
- 可能原因：SPI速度太快
- 解决方案：降低波特率预分频器至
/32或/64测试
❌ 屏幕全黑无反应
- 检查RST是否拉高
- 确认DC、CS电平正确
- 查看电源是否稳定（尤其是LED引脚是否接了限流电阻）
❌ 颜色异常（偏紫、偏黄）
- 很可能是BGR/RGB顺序搞反了
- 修改MADCTL参数试试
0xA0,0xC0,0xE0等组合
❌ 显示倒置或左右翻转
- 调整MADCTL中的MY/MX/MV标志位
- 常见组合：
0xC0: 正常竖屏（Y镜像）0xA0: 横屏（旋转90°）
❌ 刷新太慢
- 当前是CPU轮询发送，占用资源大
- 进阶方案：启用DMA传输，或使用FSMC/QSPI接口替代SPI
后续扩展思路
一旦你能成功点亮并填充颜色，接下来就可以逐步添加更多功能：
- 封装
draw_pixel(x, y, color)函数 - 实现直线、矩形、圆等基本图形
- 添加字体渲染（ASCII或中文）
- 接入轻量级GUI库如LVGL（需外扩RAM或启用DMA双缓冲）
- 结合传感器做动态数据显示（温湿度、电压等）
而且这套代码结构清晰，移植性强。换个STM32系列？只要重新用CubeMX生成SPI和GPIO配置，驱动层几乎不用改。
写在最后
别再盲目复制GitHub上的例程了。真正掌握一个外设，不是“让它跑起来”，而是理解每一行代码背后的硬件逻辑。
通过这次实践，你应该已经明白：
- STM32CubeMX不只是个代码生成器，更是帮你理清外设配置逻辑的好工具；
- ST7735虽小，但也有自己的脾气，初始化顺序、时序匹配一点都不能错；
- 驱动开发的本质，是对协议的理解 + 对细节的把控。
下次当你拿到一块新屏幕，不再慌张，而是冷静分析手册、合理配置SPI、一步一步调试——恭喜你，已经是一名合格的嵌入式工程师了。
如果你在实现过程中遇到了其他挑战，欢迎在评论区分享讨论。
)
