手上这块 1.8 寸 TFT-LCD 小屏是我从一堆毕业设计剩下的模块里翻出来的型号标着 1.8 TFT SPI 128*160背面一颗 ST7735S 驱动芯片八个引脚整整齐齐排在一侧。拿它做 STM32 项目里的状态显示成本低、接线少、体积小几乎是入门级人机界面的首选方案。这次我没走硬件 SPI 那条路而是用 STM32 的普通 GPIO把软件 SPI 时序一格一格敲出来原因很实在换引脚灵活、不挑外设、移植到别的芯片上几乎零改动。对于 F103C8T6 这种 SPI 外设已经被别的模块占用或者手里只有一块最小系统板、想随便挑几个空闲引脚就开工的场景软件 SPI 驱动 TFT-LCD 反而更省心。这篇就把我从接线、写时序、灌初始化序列、调偏移、跑到第一屏、再到提速优化的完整过程摊开讲一遍。看完你应该能拿到一份可以直接照抄的软件 SPI 驱动框架能理解 ST7735S 初始化序列里每一条命令在干什么也能避开我踩过的白屏、花屏、显示偏移这几个经典大坑。适合刚开始接触 STM32 外设驱动的新手也适合做过硬件 SPI、想搞清楚底层时序到底怎么跑的老手。1. 先想清楚为什么这个项目值得用软件 SPI 来做1.1 硬件 SPI 和软件 SPI 的真实差距在哪很多人一上来就被软件 SPI 慢这句话劝退其实得看你拿这块屏干什么。硬件 SPI 靠外设自动移位配好波特率之后 CPU 只要往数据寄存器里塞字节就行72MHz 主频下跑到 18MHz 甚至 36MHz 的时钟都不稀奇刷一整屏 128×160 的 RGB565 图像也就十几毫秒。软件 SPI 是用 GPIO 一个位一个位地翻转每位至少要干拉低时钟、摆数据、拉高时钟这三步加上循环开销一个字节差不多要花掉几十个时钟周期。账算得再细一点假设一个 bit 平均消耗 8 到 12 个 CPU 周期一个字节就是 64 到 96 个周期STM32F103 在 72MHz 下大概是 0.9 到 1.1 MByte/s 的吞吐。一屏图像 128×160×2 40960 字节算下来刷满一屏在 40 毫秒上下。这个速度刷个静态界面、翻页菜单、显示几个数字肉眼完全看不出卡顿。真正吃速度的是全屏动画、视频流、大区块高刷这类场景那时候才轮到硬件 SPI 出场。所以判断标准很简单你的画面刷新频率要求低于 10fps或者每次只更新局部区域软件 SPI 完全够用。反过来如果你要做那种整屏跳动的波形图或者逐帧动画早点换硬件 SPI 或者上 DMA别跟自己较劲。1.2 什么场景下软件 SPI 反而是更优解我用软件 SPI 主要有三个现实理由。第一是引脚自由度。硬件 SPI 的 SCK、MOSI 被固定在特定引脚上比如 SPI1 基本锁死在 PA5、PA7你要是这几个脚已经被 ADC、串口或者别的模块占了改引脚就得换 SPI 外设、重配一遍。软件 SPI 随便挑两个普通 GPIO 就行我在 F103 最小系统板上经常拿 PB6/PB7 甚至 PC 口的脚来用布局布线舒服太多。第二是移植成本。软件 SPI 的核心就是几个 GPI 读写宏换到 GD32、APM32 甚至别的 Cortex-M 芯片上只要改一下寄存器名字和时钟使能逻辑一行不用动。硬件 SPI 虽然各家也兼容但时钟分频、标志位判断、DMA 请求映射这些细节每换一颗片子都得重新对一遍手册。第三是调试可见。软件 SPI 出问题时你可以拿逻辑分析仪甚至示波器直接夹在 SCK 和 MOSI 上看波形每一位长什么样一目了然是时钟太快还是数据没摆稳肉眼就能判断。硬件 SPI 时钟一跑到十几兆普通示波器基本看不清楚只能靠猜。提示软件 SPI 不是落后方案它是够用且灵活方案。项目规模不大、引脚紧张、要求快速出原型的时候它比硬件 SPI 更省事。1.3 手上的器件先确认清楚动手之前必须把屏幕型号搞明白这一步偷懒后面全是坑。1.8 寸 128×160 的 SPI 屏市面上主流就两种驱动ST7735S 和 ST7735R偶尔碰到 ST7735B。三者初始化序列有差异尤其是 Gamma 校正和电源部分。最稳的办法是看模块背面丝印或者问卖家要一份初始化代码。我手上这块背面印着 ST7735S红色 PCB业内俗称红板。顺便确认分辨率是 128×160 还是 128×128。有些 1.8 寸屏物理是 128×160但初始化成 128×128 用剩下 32 行空着。这个在设置显示窗口的时候会直接影响你算坐标后面偏移那一节会细讲。供电方面模块一般带 3.3V 稳压和电平转换逻辑侧直接接 3.3V 就行别手痒接 5VST7735S 的逻辑耐压就 3.6V 左右超了容易挂。2. 接线与引脚规划八个脚一个都不能想当然2.1 屏幕模块的引脚逐个说清楚标准 1.8 寸 SPI 模块引出八根线我按常见丝印念一遍。VCC 电源正接 3.3VGND 地必须和 STM32 共地这个别省很多花屏就是地没接好。SCL 是时钟线对应 SPI 的 SCK软件 SPI 里就是一个普通输出脚。SDA 是数据线对应 MOSI主控发数据给屏幕屏幕一般不回数据所以 MISO 这根线这个模块根本没引出来。RES 是复位脚低电平有效上电后要给一个至少 10 微秒的低脉冲让它复位。DC 是数据/命令选择脚业内也写作 A0 或 RS低电平表示接下来发的是命令高电平表示发的是数据这个脚是 TFT 屏和普通 SPI Flash 最大的区别。CS 是片选低电平选中单屏应用里可以一直拉低省事但我还是建议接上方便以后扩展和调试。背光一般有两种接法。老模块是 BLK 单独引出接高电平点亮或者接一个限流电阻到 3.3V新一点的模块把背光直接和 VCC 捆在一起上电就亮。如果你的屏上电不亮但能读到数据先确认背光引脚有没有接对别急着怀疑驱动。2.2 我实际使用的一套接线方案我以 STM32F103C8T6 最小系统板为例软件 SPI 我这么分配引脚你看一眼就知道为什么灵活。SCL 用 PA5SDA 用 PA7这俩刚好是硬件 SPI1 的位置但我当普通 GPIO 用这样以后想换硬件 SPI 都不用动线。RES 用 PA3DC 用 PA4CS 用 PA2背光我直接接 3.3V。整套接线占用 PA2 到 PA7空出 PB 口给串口和按键。屏幕引脚STM32 引脚功能说明VCC3.3V逻辑供电别接 5VGNDGND必须共地SCLPA5软件 SPI 时钟普通推挽输出SDAPA7软件 SPI 数据普通推挽输出RESPA3复位低有效DCPA40 发命令1 发数据CSPA2片选低有效BLK3.3V背光或接限流电阻接线最忌讳的是把 SCL 和 SDA 接反。接反的典型现象是屏幕亮背光但全白或者显示出一片毫无规律的噪点。因为时钟线一直在跳数据线却在错误的时机采样控制器收到的全是垃圾命令。查线的时候先拿万用表对一遍比在代码里找半天强。2.3 电源和背光这两个容易翻车的点电源这块有两个坑。一个是很多最小系统板的 3.3V 是从板载 LDO 出来的带载能力有限屏幕背光一开就是几十毫安加上 ST7735S 本身的工作电流整套加起来可能接近 100mA。如果你的板子同时还驱动着别的模块3.3V 会被拉低屏幕就开始随机花屏或者白屏现象特别像驱动 bug其实是供电不足。我遇到过一次查了两小时代码最后量了下电压只有 2.9V换了独立 3.3V 供电立刻正常。第二个坑是背光限流。有些模块背光那颗限流电阻设计得比较激进长期满亮度跑会发烫屏幕边框都能摸出温度。如果只是晚上看亮度够用就行可以串一个大一点的电阻或者用 PWM 调光。用 PWM 的时候注意频率别太低低于 200Hz 人眼能看出闪烁我一般给 1kHz 以上。注意排查白屏之前先量 VCC 对地电压是不是稳定在 3.3V 附近。电压不足导致的显示异常比代码 bug 更常见也更难往驱动方向想。3. 软件 SPI 的时序原理与底层代码3.1 先搞清楚 ST7735S 用哪种 SPI 模式SPI 有四种模式区别在时钟空闲电平和采样边沿。CPOL 决定空闲时时钟是高还是低CPHA 决定在第一个边沿还是第二个边沿采样数据。ST7735S 手册里一般标的是模式 0 或者模式 3也就是 CPOL0、CPHA0空闲低电平上升沿采样。实际写软件 SPI 的时候其实不用太纠结 CPHA 是哪个边沿因为你完全掌控时序——只要保证数据先摆稳再给时钟上升沿控制器在上升沿把它读走就行。我的做法是标准三段式先把 SCK 拉低此时数据线上的电平还不稳定不着急然后根据当前要发的 bit 把 SDA 置高或置低等数据线稳下来之后再把 SCK 拉高控制器在这个上升沿采样最后准备下一位。整个过程用最朴素的顺序写出来逻辑清晰也不会因为编译器优化出问题。这里有个细节很多人忽略数据线拉高拉低之后最好给一点延时让电平稳定尤其是总线较长或者上拉较弱的时候。72MHz 下 GPIO 翻转本身就够快通常不需要显式延时但如果你的屏接线比较长、走线不稳加一个空操作宏能明显提高稳定性。我一般先用无延时版本出问题再加。3.2 用寄存器直接操作 GPIO 把速度榨出来如果用 HAL 库的HAL_GPIO_WritePin()每次调用都要过一遍参数检查、端口判断一层层套下去一个字节的耗时能翻好几倍。软件 SPI 本来就吃 CPU这时候就得直接怼寄存器。STM32 的 GPIO 有两个神器BSRR 和 BRR。BSRR 的低 16 位写 1 则对应引脚置高高 16 位写 1 则对应引脚置低BRR 写 1 则对应引脚置低。用这两个寄存器一次写操作就能改变引脚状态比读改写 ODR 快得多也不会有读改写带来的意外。我把这几个操作包成宏代码里直接调用编译出来就是一条 STR 指令#define LCD_SCL_PIN GPIO_Pin_5 #define LCD_SDA_PIN GPIO_Pin_7 #define LCD_PORT GPIOA #define LCD_SCL_H() (LCD_PORT-BSRR LCD_SCL_PIN) #define LCD_SCL_L() (LCD_PORT-BRR LCD_SCL_PIN) #define LCD_SDA_H() (LCD_PORT-BSRR LCD_SDA_PIN) #define LCD_SDA_L() (LCD_PORT-BRR LCD_SDA_PIN)这种写法还有一个好处是可读性强。整个驱动里你看不到GPIOA-ODR | 0x20这种魔法数字全是语义清晰的宏几个月后回来改代码也不费劲。CS、DC、RES 我也用同样的方式包好统一风格。3.3 一个字节收发函数怎么写才稳核心的字节发送函数是整个驱动的地基我贴一个最朴素也最可靠的版本void LCD_Writ_Bus(uint8_t dat) { uint8_t i; for (i 0; i 8; i) { LCD_SCL_L(); if (dat 0x80) LCD_SDA_H(); else LCD_SDA_L(); LCD_SCL_H(); dat 1; } }逻辑就是典型的 MSB 优先从最高位开始发。每次循环先压低时钟摆好数据再抬升时钟让控制器采样最后把数据左移一位准备下一个 bit。ST7735S 只收不发所以不需要读数据线的过程函数返回值都不用。这里我特意用了if-else而不是位运算赋值因为有些新手会写成LCD_SDA dat 0x80在只按位操作的情况下容易出问题。用明确的判断分支编译器生成的代码也很紧凑实测下来跟位运算版本速度差不了多少但可读性高一个档次。实操心得把LCD_Writ_Bus写成内联函数或者在 .h 里用static inline能省掉函数调用开销。刷屏这种高频调用场景这一点优化能带来肉眼可见的提升。4. ST7735S 初始化与显示驱动实现4.1 命令和数据怎么分开发有了字节发送函数接下来要按 ST7735 的协议把命令和数据区分开。规则很简单DC 拉低时发的字节被当作命令DC 拉高时发的字节被当作数据。命令后面往往跟着若干个参数字节参数都是数据。CS 我在每个操作周期拉低、结束后拉高虽然单屏用不到多设备但保持这个习惯以后扩展方便。void LCD_WR_REG(uint8_t reg) { LCD_DC_L(); LCD_CS_L(); LCD_Writ_Bus(reg); LCD_CS_H(); } void LCD_WR_DATA(uint8_t dat) { LCD_DC_H(); LCD_CS_L(); LCD_Writ_Bus(dat); LCD_CS_H(); } void LCD_WR_DATA16(uint16_t dat) { LCD_WR_DATA(dat 8); LCD_WR_DATA(dat 0xFF); }LCD_WR_DATA16是给颜色数据用的RGB565 一个像素两个字节高位先发。这里注意 CS 在命令和数据之间是拉高的也就是每个字节独立片选ST7735 允许这么用。如果你想让时序更紧凑也可以把命令和它的参数放在一次片选里发完效率会高一点点但代码会复杂一些。新手先按独立片选写稳妥。4.2 初始化序列逐条解读初始化序列看起来吓人其实分几组我拆开讲。第一组是软复位和延时。发 0x01 软复位然后必须等 120ms 以上等内部电源稳定。这个延时千万别省省了后面偶尔能点亮、偶尔白屏是最坑人的偶发故障。第二组是 0x11 退出睡眠同样要等 120ms。第三组是 0x3A 设置颜色格式参数 0x05 表示 RGB565这是最常用的格式一个像素两个字节。第四组是 0xB1 到 0xB4 的帧率控制、电源控制、Gamma 校正这些参数各家模块略有不同抄卖家的初始化代码最保险。最后发 0x29 打开显示0x2C 开始写显存。我把它整理成一张流程表方便对照命令含义关键参数必须延时0x01软复位无120ms0x11退出睡眠无120ms0x3A颜色格式0x05 表示 RGB565无0xB1帧率控制0x05, 0x3C, 0x3C无0xB2~0xB4电源与 Gamma视模块而定无0x36显示方向0x00 或 0xA0 等无0x29打开显示无无0x36 这个命令单独讲讲它控制扫描方向、镜像、RGB/BGR 顺序。参数每一位含义不同改一下就能翻转显示方向。我一般用 0x00 竖屏正向或者 0xC8 竖屏旋转 180 度。如果显示出来颜色偏蓝、偏红多半是 RGB/BGR 位反了把这一位取反即可。4.3 显示窗口设置与偏移量这个老大难往屏幕写图像之前必须先划定一个矩形窗口告诉控制器我接下来要往这块区域灌数据。这靠两个命令0x2A 设置列地址范围0x2B 设置行地址范围各接四个参数字节分别是起始和结束的高低位。void LCD_Address_Set(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2) { LCD_WR_REG(0x2A); LCD_WR_DATA16(x1 colstart); LCD_WR_DATA16(x2 colstart); LCD_WR_REG(0x2B); LCD_WR_DATA16(y1 rowstart); LCD_WR_DATA16(y2 rowstart); LCD_WR_REG(0x2C); }注意那两个colstart和rowstart这就是偏移量。为什么会有偏移因为 ST7735S 内部显存其实是 132×162比 128×160 的可见区域大多出来的行列不显示。不同厂家把可见区域放在显存里的位置不一样所以需要偏移。红板常见的是 colstart0、rowstart0 或者 colstart2、rowstart1黑板可能是 0 和 32。这个没法靠猜只能试。试的方法很直接写一个横竖两条边框加四个角点的测试图案看是否刚好铺满整屏、对称。如果图像整体偏左偏上一点点说明偏移量少了如果右边或底部有彩色噪点带说明偏移量不对。我调这块屏的时候试了三四组才找到正确的写在初始化里以后就固定了。提示偏移量列在初始化注释里方便以后换屏时快速调整。不同批次同一型号的屏偏移量都有可能不一样别照抄别人的数值就完事。5. 从零跑通第一屏的完整实操5.1 工程搭建与文件组织我用的是 Keil MDK 加标准外设库工程结构保持干净。新建一个lcd文件夹里面放三个文件lcd_init.h放引脚宏和函数声明lcd_init.c放 GPIO 初始化、字节发送、命令封装和初始化序列lcd.c放画点、画线、填充、显示字符串这些上层接口。这样分开以后换屏幕或者换主控改动范围很清楚。GPIO 初始化我就用标准库直接配把 SCL、SDA、CS、DC、RES 五个脚全配成推挽输出速度拉到 50MHz。这里有个细节输出速度一定要选高的。默认 2MHz 的翻转速度一个字节要花好几微秒整屏刷下来明显卡顿改成 50MHz配合前面 BSRR 宏速度立刻上一个台阶。这个是很多新手忽略的性能点。复位在初始化最开始做先把 RES 拉低延时 10ms再拉高延时 120ms。这个上电复位流程走一遍控制器状态最干净能避免很多偶发问题。别指望上电自动复位虽然模块一般有 RC 复位电路但软件再补一次不会有坏处。5.2 主函数和第一个测试图案主函数里的调用顺序就是初始化 GPIO、执行 LCD 初始化序列、填几个色块验证。我先全屏刷红、再刷绿、再刷蓝这一步能快速判断三件事通信通不通不通就是白屏、颜色通道对不对红绿蓝顺序错说明 RGB565 位序有问题、整屏刷新速度大概多少。int main(void) { LCD_Init(); LCD_Fill(0, 0, 128, 160, RED); LCD_Fill(0, 0, 128, 160, GREEN); LCD_Fill(0, 0, 128, 160, BLUE); while (1) { LCD_ShowString(0, 0, STM32, RED, WHITE, 16); } }三个纯色块跑通之后再上文字和图形。文字需要字库我一般用取模软件生成 8×16 或者 16×16 的 ASCII 和中文字库取模方向选逐行、高位在前、阴码这些常规设置。字库取模方向错了会显示成一堆乱码或者反着的方块这个在下一节的问题排查里讲。实操心得第一次点亮不要直接跑复杂的界面程序。先纯色、再画框、再文字一层层加出问题时你就知道在哪一层排查范围一下子缩小。5.3 画点函数是所有图形的基础颜色填充、画线、显示字符底层都靠一个画点函数。它的实现就是把窗口收窄到一个像素然后写入两个字节颜色值。频繁调用画点函数会有大量重复的窗口设置命令效率不高所以实际绘制时我会用带窗口优化的版本比如填充一个矩形时一次性设好大窗口然后连续灌像素。void LCD_DrawPoint(uint16_t x, uint16_t y, uint16_t color) { LCD_Address_Set(x, y, x, y); LCD_WR_DATA16(color); }画线用 Bresenham 算法填充用逐行画点或者直接一个大窗口连续写显示字符则把字库的每一位展开成像素。这些算法都是通用套路不难关键是把窗口设置和连续写像素的节奏对上别每写一个像素就重设一次窗口。6. 刷屏提速软件 SPI 也能跑得不错6.1 先量化瓶颈在哪我实测过几个版本的刷屏耗时。最朴素的写法用HAL_GPIO_WritePin逐位翻转刷满一屏 128×160 要 200ms 以上肉眼能明显看到从上往下扫描。换成 BSRR 宏加 50MHz 输出速度降到 45ms 左右已经比较流畅。再把字节发送函数内联、循环展开能压到 35ms 附近。这个数据说明瓶颈主要在 GPIO 翻转和循环开销不在协议本身。对照硬件 SPI 的话18MHz 时钟配上 DMA整屏刷新能进 10ms差距确实明显。但回到实际使用场景我的界面大部分时候只是局部更新比如刷新一个电压数值、切换一个状态图标每次只写几十到几百个字节软件 SPI 完全感知不到延迟。6.2 局部刷新比全局刷新重要得多真正提升看起来快的关键不是把整屏刷新速度抠到极致而是只刷变化的部分。我做过一个温湿度显示的界面只刷新数值那十几个字符的位置每次大概几百个像素用软件 SPI 也就一两毫秒视觉上完全没有刷新的感觉。反过来如果你每次都LCD_Fill整屏再重画再快的驱动也会闪一下。实现局部刷新需要记录上一次显示的内容或者只更新固定区域的数值。最简单的方式是给数值单独开一块固定坐标区域每次先填个背景色再写新数值。稍微讲究一点可以做双缓冲但这在内存紧张的 F103C8T6 上不太现实我更推荐按区域手动管理。7. 常见问题排查实录7.1 白屏、花屏、偏色的排查顺序白屏是最常见的现象背光亮但整屏白或者灰。排查顺序我总结成先量电压、再查接线、再查复位、最后查初始化。电压不够是物理问题接线反了或者虚焊是连接问题复位时序不对会让控制器停在未初始化状态初始化序列漏了延时或者参数写错也会白屏。这四步基本能把白屏覆盖掉。花屏通常和时序稳定性有关比如时钟太快、走线太长、地线没接好。软件 SPI 的优势在这里体现出来——把时钟速度降一降加个稳定延时往往就好。偏色则多半是颜色格式或者 RGB/BGR 位的问题检查 0x3A 命令是不是 0x05检查 0x36 命令的 BGR 位。现象可能原因排查动作全白无内容供电不足、复位缺失量电压、补复位延时噪点花屏时序不稳、虚焊降速、加延时、补焊颜色整体偏红偏蓝RGB/BGR 位反改 0x36 参数图像偏移偏移量错调 colstart/rowstart显示上下颠倒扫描方向错改 0x36 方向位7.2 坐标偏移和镜像怎么快速定位坐标偏移的表现是图像不在正中或者屏幕边缘出现一条彩色噪点。定位方法前面提过写个四角带点的边框看四个角是否对齐。如果整体偏改偏移量如果左右或上下镜像改扫描方向那个位如果横竖颠倒说明行列扫描顺序整个反了一般是 0x36 参数的组合位没用对。这些参数都不用背看手册里 0x36 那张位表一位一位对改到对为止。7.3 一个容易被忽视的偶发故障我遇到过一种偶发故障上电偶尔正常、偶尔白屏重启几次有一次能好。代码怎么查都没问题最后发现是初始化里的 120ms 延时不够稳供电上电斜率慢的时候控制器还没准备好就被灌命令了。把延时加到 200ms问题消失。这类偶发问题最能耗时间因为它不总是复现容易让人怀疑是不是硬件坏了。经验是凡是偶发性的显示异常先把所有关键延时加足八成能解决。8. 写在最后的一些个人体会软件 SPI 驱动这块 1.8 寸屏我前后折腾了大概一周。回头看代码本身并不复杂真正费时间的是那些看不到的地方偏移量、延时、供电、接线。技术难点从来不在函数写得多优雅而在你能不能把时序和硬件状态对上。我现在的习惯是每写一个新模块的驱动先拿逻辑分析仪把第一屏的波形抓下来存好后面再出问题跟这份正常波形一对比五分钟定位。这比翻手册猜要快得多。还有个我正在验证的方向是把这套软件 SPI 封装成一个带函数指针的通用驱动层未来想换硬件 SPI 或者换 SH1106、ILI9163 这类别的屏只要换底层实现上层绘图接口不用动。手头这块 F103C8T6 空间够试试看效果怎么样跑通了再来补一篇。
手上这块 1.8 寸 TFT-LCD 小屏是我从一堆毕业设计剩下的模块里翻出来的型号标着 1.8 TFT SPI 128*160背面一颗 ST7735S 驱动芯片八个引脚整整齐齐排在一侧。拿它做 STM32 项目里的状态显示成本低、接线少、体积小几乎是入门级人机界面的首选方案。这次我没走硬件 SPI 那条路而是用 STM32 的普通 GPIO把软件 SPI 时序一格一格敲出来原因很实在换引脚灵活、不挑外设、移植到别的芯片上几乎零改动。对于 F103C8T6 这种 SPI 外设已经被别的模块占用或者手里只有一块最小系统板、想随便挑几个空闲引脚就开工的场景软件 SPI 驱动 TFT-LCD 反而更省心。这篇就把我从接线、写时序、灌初始化序列、调偏移、跑到第一屏、再到提速优化的完整过程摊开讲一遍。看完你应该能拿到一份可以直接照抄的软件 SPI 驱动框架能理解 ST7735S 初始化序列里每一条命令在干什么也能避开我踩过的白屏、花屏、显示偏移这几个经典大坑。适合刚开始接触 STM32 外设驱动的新手也适合做过硬件 SPI、想搞清楚底层时序到底怎么跑的老手。1. 先想清楚为什么这个项目值得用软件 SPI 来做1.1 硬件 SPI 和软件 SPI 的真实差距在哪很多人一上来就被软件 SPI 慢这句话劝退其实得看你拿这块屏干什么。硬件 SPI 靠外设自动移位配好波特率之后 CPU 只要往数据寄存器里塞字节就行72MHz 主频下跑到 18MHz 甚至 36MHz 的时钟都不稀奇刷一整屏 128×160 的 RGB565 图像也就十几毫秒。软件 SPI 是用 GPIO 一个位一个位地翻转每位至少要干拉低时钟、摆数据、拉高时钟这三步加上循环开销一个字节差不多要花掉几十个时钟周期。账算得再细一点假设一个 bit 平均消耗 8 到 12 个 CPU 周期一个字节就是 64 到 96 个周期STM32F103 在 72MHz 下大概是 0.9 到 1.1 MByte/s 的吞吐。一屏图像 128×160×2 40960 字节算下来刷满一屏在 40 毫秒上下。这个速度刷个静态界面、翻页菜单、显示几个数字肉眼完全看不出卡顿。真正吃速度的是全屏动画、视频流、大区块高刷这类场景那时候才轮到硬件 SPI 出场。所以判断标准很简单你的画面刷新频率要求低于 10fps或者每次只更新局部区域软件 SPI 完全够用。反过来如果你要做那种整屏跳动的波形图或者逐帧动画早点换硬件 SPI 或者上 DMA别跟自己较劲。1.2 什么场景下软件 SPI 反而是更优解我用软件 SPI 主要有三个现实理由。第一是引脚自由度。硬件 SPI 的 SCK、MOSI 被固定在特定引脚上比如 SPI1 基本锁死在 PA5、PA7你要是这几个脚已经被 ADC、串口或者别的模块占了改引脚就得换 SPI 外设、重配一遍。软件 SPI 随便挑两个普通 GPIO 就行我在 F103 最小系统板上经常拿 PB6/PB7 甚至 PC 口的脚来用布局布线舒服太多。第二是移植成本。软件 SPI 的核心就是几个 GPI 读写宏换到 GD32、APM32 甚至别的 Cortex-M 芯片上只要改一下寄存器名字和时钟使能逻辑一行不用动。硬件 SPI 虽然各家也兼容但时钟分频、标志位判断、DMA 请求映射这些细节每换一颗片子都得重新对一遍手册。第三是调试可见。软件 SPI 出问题时你可以拿逻辑分析仪甚至示波器直接夹在 SCK 和 MOSI 上看波形每一位长什么样一目了然是时钟太快还是数据没摆稳肉眼就能判断。硬件 SPI 时钟一跑到十几兆普通示波器基本看不清楚只能靠猜。提示软件 SPI 不是落后方案它是够用且灵活方案。项目规模不大、引脚紧张、要求快速出原型的时候它比硬件 SPI 更省事。1.3 手上的器件先确认清楚动手之前必须把屏幕型号搞明白这一步偷懒后面全是坑。1.8 寸 128×160 的 SPI 屏市面上主流就两种驱动ST7735S 和 ST7735R偶尔碰到 ST7735B。三者初始化序列有差异尤其是 Gamma 校正和电源部分。最稳的办法是看模块背面丝印或者问卖家要一份初始化代码。我手上这块背面印着 ST7735S红色 PCB业内俗称红板。顺便确认分辨率是 128×160 还是 128×128。有些 1.8 寸屏物理是 128×160但初始化成 128×128 用剩下 32 行空着。这个在设置显示窗口的时候会直接影响你算坐标后面偏移那一节会细讲。供电方面模块一般带 3.3V 稳压和电平转换逻辑侧直接接 3.3V 就行别手痒接 5VST7735S 的逻辑耐压就 3.6V 左右超了容易挂。2. 接线与引脚规划八个脚一个都不能想当然2.1 屏幕模块的引脚逐个说清楚标准 1.8 寸 SPI 模块引出八根线我按常见丝印念一遍。VCC 电源正接 3.3VGND 地必须和 STM32 共地这个别省很多花屏就是地没接好。SCL 是时钟线对应 SPI 的 SCK软件 SPI 里就是一个普通输出脚。SDA 是数据线对应 MOSI主控发数据给屏幕屏幕一般不回数据所以 MISO 这根线这个模块根本没引出来。RES 是复位脚低电平有效上电后要给一个至少 10 微秒的低脉冲让它复位。DC 是数据/命令选择脚业内也写作 A0 或 RS低电平表示接下来发的是命令高电平表示发的是数据这个脚是 TFT 屏和普通 SPI Flash 最大的区别。CS 是片选低电平选中单屏应用里可以一直拉低省事但我还是建议接上方便以后扩展和调试。背光一般有两种接法。老模块是 BLK 单独引出接高电平点亮或者接一个限流电阻到 3.3V新一点的模块把背光直接和 VCC 捆在一起上电就亮。如果你的屏上电不亮但能读到数据先确认背光引脚有没有接对别急着怀疑驱动。2.2 我实际使用的一套接线方案我以 STM32F103C8T6 最小系统板为例软件 SPI 我这么分配引脚你看一眼就知道为什么灵活。SCL 用 PA5SDA 用 PA7这俩刚好是硬件 SPI1 的位置但我当普通 GPIO 用这样以后想换硬件 SPI 都不用动线。RES 用 PA3DC 用 PA4CS 用 PA2背光我直接接 3.3V。整套接线占用 PA2 到 PA7空出 PB 口给串口和按键。屏幕引脚STM32 引脚功能说明VCC3.3V逻辑供电别接 5VGNDGND必须共地SCLPA5软件 SPI 时钟普通推挽输出SDAPA7软件 SPI 数据普通推挽输出RESPA3复位低有效DCPA40 发命令1 发数据CSPA2片选低有效BLK3.3V背光或接限流电阻接线最忌讳的是把 SCL 和 SDA 接反。接反的典型现象是屏幕亮背光但全白或者显示出一片毫无规律的噪点。因为时钟线一直在跳数据线却在错误的时机采样控制器收到的全是垃圾命令。查线的时候先拿万用表对一遍比在代码里找半天强。2.3 电源和背光这两个容易翻车的点电源这块有两个坑。一个是很多最小系统板的 3.3V 是从板载 LDO 出来的带载能力有限屏幕背光一开就是几十毫安加上 ST7735S 本身的工作电流整套加起来可能接近 100mA。如果你的板子同时还驱动着别的模块3.3V 会被拉低屏幕就开始随机花屏或者白屏现象特别像驱动 bug其实是供电不足。我遇到过一次查了两小时代码最后量了下电压只有 2.9V换了独立 3.3V 供电立刻正常。第二个坑是背光限流。有些模块背光那颗限流电阻设计得比较激进长期满亮度跑会发烫屏幕边框都能摸出温度。如果只是晚上看亮度够用就行可以串一个大一点的电阻或者用 PWM 调光。用 PWM 的时候注意频率别太低低于 200Hz 人眼能看出闪烁我一般给 1kHz 以上。注意排查白屏之前先量 VCC 对地电压是不是稳定在 3.3V 附近。电压不足导致的显示异常比代码 bug 更常见也更难往驱动方向想。3. 软件 SPI 的时序原理与底层代码3.1 先搞清楚 ST7735S 用哪种 SPI 模式SPI 有四种模式区别在时钟空闲电平和采样边沿。CPOL 决定空闲时时钟是高还是低CPHA 决定在第一个边沿还是第二个边沿采样数据。ST7735S 手册里一般标的是模式 0 或者模式 3也就是 CPOL0、CPHA0空闲低电平上升沿采样。实际写软件 SPI 的时候其实不用太纠结 CPHA 是哪个边沿因为你完全掌控时序——只要保证数据先摆稳再给时钟上升沿控制器在上升沿把它读走就行。我的做法是标准三段式先把 SCK 拉低此时数据线上的电平还不稳定不着急然后根据当前要发的 bit 把 SDA 置高或置低等数据线稳下来之后再把 SCK 拉高控制器在这个上升沿采样最后准备下一位。整个过程用最朴素的顺序写出来逻辑清晰也不会因为编译器优化出问题。这里有个细节很多人忽略数据线拉高拉低之后最好给一点延时让电平稳定尤其是总线较长或者上拉较弱的时候。72MHz 下 GPIO 翻转本身就够快通常不需要显式延时但如果你的屏接线比较长、走线不稳加一个空操作宏能明显提高稳定性。我一般先用无延时版本出问题再加。3.2 用寄存器直接操作 GPIO 把速度榨出来如果用 HAL 库的HAL_GPIO_WritePin()每次调用都要过一遍参数检查、端口判断一层层套下去一个字节的耗时能翻好几倍。软件 SPI 本来就吃 CPU这时候就得直接怼寄存器。STM32 的 GPIO 有两个神器BSRR 和 BRR。BSRR 的低 16 位写 1 则对应引脚置高高 16 位写 1 则对应引脚置低BRR 写 1 则对应引脚置低。用这两个寄存器一次写操作就能改变引脚状态比读改写 ODR 快得多也不会有读改写带来的意外。我把这几个操作包成宏代码里直接调用编译出来就是一条 STR 指令#define LCD_SCL_PIN GPIO_Pin_5 #define LCD_SDA_PIN GPIO_Pin_7 #define LCD_PORT GPIOA #define LCD_SCL_H() (LCD_PORT-BSRR LCD_SCL_PIN) #define LCD_SCL_L() (LCD_PORT-BRR LCD_SCL_PIN) #define LCD_SDA_H() (LCD_PORT-BSRR LCD_SDA_PIN) #define LCD_SDA_L() (LCD_PORT-BRR LCD_SDA_PIN)这种写法还有一个好处是可读性强。整个驱动里你看不到GPIOA-ODR | 0x20这种魔法数字全是语义清晰的宏几个月后回来改代码也不费劲。CS、DC、RES 我也用同样的方式包好统一风格。3.3 一个字节收发函数怎么写才稳核心的字节发送函数是整个驱动的地基我贴一个最朴素也最可靠的版本void LCD_Writ_Bus(uint8_t dat) { uint8_t i; for (i 0; i 8; i) { LCD_SCL_L(); if (dat 0x80) LCD_SDA_H(); else LCD_SDA_L(); LCD_SCL_H(); dat 1; } }逻辑就是典型的 MSB 优先从最高位开始发。每次循环先压低时钟摆好数据再抬升时钟让控制器采样最后把数据左移一位准备下一个 bit。ST7735S 只收不发所以不需要读数据线的过程函数返回值都不用。这里我特意用了if-else而不是位运算赋值因为有些新手会写成LCD_SDA dat 0x80在只按位操作的情况下容易出问题。用明确的判断分支编译器生成的代码也很紧凑实测下来跟位运算版本速度差不了多少但可读性高一个档次。实操心得把LCD_Writ_Bus写成内联函数或者在 .h 里用static inline能省掉函数调用开销。刷屏这种高频调用场景这一点优化能带来肉眼可见的提升。4. ST7735S 初始化与显示驱动实现4.1 命令和数据怎么分开发有了字节发送函数接下来要按 ST7735 的协议把命令和数据区分开。规则很简单DC 拉低时发的字节被当作命令DC 拉高时发的字节被当作数据。命令后面往往跟着若干个参数字节参数都是数据。CS 我在每个操作周期拉低、结束后拉高虽然单屏用不到多设备但保持这个习惯以后扩展方便。void LCD_WR_REG(uint8_t reg) { LCD_DC_L(); LCD_CS_L(); LCD_Writ_Bus(reg); LCD_CS_H(); } void LCD_WR_DATA(uint8_t dat) { LCD_DC_H(); LCD_CS_L(); LCD_Writ_Bus(dat); LCD_CS_H(); } void LCD_WR_DATA16(uint16_t dat) { LCD_WR_DATA(dat 8); LCD_WR_DATA(dat 0xFF); }LCD_WR_DATA16是给颜色数据用的RGB565 一个像素两个字节高位先发。这里注意 CS 在命令和数据之间是拉高的也就是每个字节独立片选ST7735 允许这么用。如果你想让时序更紧凑也可以把命令和它的参数放在一次片选里发完效率会高一点点但代码会复杂一些。新手先按独立片选写稳妥。4.2 初始化序列逐条解读初始化序列看起来吓人其实分几组我拆开讲。第一组是软复位和延时。发 0x01 软复位然后必须等 120ms 以上等内部电源稳定。这个延时千万别省省了后面偶尔能点亮、偶尔白屏是最坑人的偶发故障。第二组是 0x11 退出睡眠同样要等 120ms。第三组是 0x3A 设置颜色格式参数 0x05 表示 RGB565这是最常用的格式一个像素两个字节。第四组是 0xB1 到 0xB4 的帧率控制、电源控制、Gamma 校正这些参数各家模块略有不同抄卖家的初始化代码最保险。最后发 0x29 打开显示0x2C 开始写显存。我把它整理成一张流程表方便对照命令含义关键参数必须延时0x01软复位无120ms0x11退出睡眠无120ms0x3A颜色格式0x05 表示 RGB565无0xB1帧率控制0x05, 0x3C, 0x3C无0xB2~0xB4电源与 Gamma视模块而定无0x36显示方向0x00 或 0xA0 等无0x29打开显示无无0x36 这个命令单独讲讲它控制扫描方向、镜像、RGB/BGR 顺序。参数每一位含义不同改一下就能翻转显示方向。我一般用 0x00 竖屏正向或者 0xC8 竖屏旋转 180 度。如果显示出来颜色偏蓝、偏红多半是 RGB/BGR 位反了把这一位取反即可。4.3 显示窗口设置与偏移量这个老大难往屏幕写图像之前必须先划定一个矩形窗口告诉控制器我接下来要往这块区域灌数据。这靠两个命令0x2A 设置列地址范围0x2B 设置行地址范围各接四个参数字节分别是起始和结束的高低位。void LCD_Address_Set(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2) { LCD_WR_REG(0x2A); LCD_WR_DATA16(x1 colstart); LCD_WR_DATA16(x2 colstart); LCD_WR_REG(0x2B); LCD_WR_DATA16(y1 rowstart); LCD_WR_DATA16(y2 rowstart); LCD_WR_REG(0x2C); }注意那两个colstart和rowstart这就是偏移量。为什么会有偏移因为 ST7735S 内部显存其实是 132×162比 128×160 的可见区域大多出来的行列不显示。不同厂家把可见区域放在显存里的位置不一样所以需要偏移。红板常见的是 colstart0、rowstart0 或者 colstart2、rowstart1黑板可能是 0 和 32。这个没法靠猜只能试。试的方法很直接写一个横竖两条边框加四个角点的测试图案看是否刚好铺满整屏、对称。如果图像整体偏左偏上一点点说明偏移量少了如果右边或底部有彩色噪点带说明偏移量不对。我调这块屏的时候试了三四组才找到正确的写在初始化里以后就固定了。提示偏移量列在初始化注释里方便以后换屏时快速调整。不同批次同一型号的屏偏移量都有可能不一样别照抄别人的数值就完事。5. 从零跑通第一屏的完整实操5.1 工程搭建与文件组织我用的是 Keil MDK 加标准外设库工程结构保持干净。新建一个lcd文件夹里面放三个文件lcd_init.h放引脚宏和函数声明lcd_init.c放 GPIO 初始化、字节发送、命令封装和初始化序列lcd.c放画点、画线、填充、显示字符串这些上层接口。这样分开以后换屏幕或者换主控改动范围很清楚。GPIO 初始化我就用标准库直接配把 SCL、SDA、CS、DC、RES 五个脚全配成推挽输出速度拉到 50MHz。这里有个细节输出速度一定要选高的。默认 2MHz 的翻转速度一个字节要花好几微秒整屏刷下来明显卡顿改成 50MHz配合前面 BSRR 宏速度立刻上一个台阶。这个是很多新手忽略的性能点。复位在初始化最开始做先把 RES 拉低延时 10ms再拉高延时 120ms。这个上电复位流程走一遍控制器状态最干净能避免很多偶发问题。别指望上电自动复位虽然模块一般有 RC 复位电路但软件再补一次不会有坏处。5.2 主函数和第一个测试图案主函数里的调用顺序就是初始化 GPIO、执行 LCD 初始化序列、填几个色块验证。我先全屏刷红、再刷绿、再刷蓝这一步能快速判断三件事通信通不通不通就是白屏、颜色通道对不对红绿蓝顺序错说明 RGB565 位序有问题、整屏刷新速度大概多少。int main(void) { LCD_Init(); LCD_Fill(0, 0, 128, 160, RED); LCD_Fill(0, 0, 128, 160, GREEN); LCD_Fill(0, 0, 128, 160, BLUE); while (1) { LCD_ShowString(0, 0, STM32, RED, WHITE, 16); } }三个纯色块跑通之后再上文字和图形。文字需要字库我一般用取模软件生成 8×16 或者 16×16 的 ASCII 和中文字库取模方向选逐行、高位在前、阴码这些常规设置。字库取模方向错了会显示成一堆乱码或者反着的方块这个在下一节的问题排查里讲。实操心得第一次点亮不要直接跑复杂的界面程序。先纯色、再画框、再文字一层层加出问题时你就知道在哪一层排查范围一下子缩小。5.3 画点函数是所有图形的基础颜色填充、画线、显示字符底层都靠一个画点函数。它的实现就是把窗口收窄到一个像素然后写入两个字节颜色值。频繁调用画点函数会有大量重复的窗口设置命令效率不高所以实际绘制时我会用带窗口优化的版本比如填充一个矩形时一次性设好大窗口然后连续灌像素。void LCD_DrawPoint(uint16_t x, uint16_t y, uint16_t color) { LCD_Address_Set(x, y, x, y); LCD_WR_DATA16(color); }画线用 Bresenham 算法填充用逐行画点或者直接一个大窗口连续写显示字符则把字库的每一位展开成像素。这些算法都是通用套路不难关键是把窗口设置和连续写像素的节奏对上别每写一个像素就重设一次窗口。6. 刷屏提速软件 SPI 也能跑得不错6.1 先量化瓶颈在哪我实测过几个版本的刷屏耗时。最朴素的写法用HAL_GPIO_WritePin逐位翻转刷满一屏 128×160 要 200ms 以上肉眼能明显看到从上往下扫描。换成 BSRR 宏加 50MHz 输出速度降到 45ms 左右已经比较流畅。再把字节发送函数内联、循环展开能压到 35ms 附近。这个数据说明瓶颈主要在 GPIO 翻转和循环开销不在协议本身。对照硬件 SPI 的话18MHz 时钟配上 DMA整屏刷新能进 10ms差距确实明显。但回到实际使用场景我的界面大部分时候只是局部更新比如刷新一个电压数值、切换一个状态图标每次只写几十到几百个字节软件 SPI 完全感知不到延迟。6.2 局部刷新比全局刷新重要得多真正提升看起来快的关键不是把整屏刷新速度抠到极致而是只刷变化的部分。我做过一个温湿度显示的界面只刷新数值那十几个字符的位置每次大概几百个像素用软件 SPI 也就一两毫秒视觉上完全没有刷新的感觉。反过来如果你每次都LCD_Fill整屏再重画再快的驱动也会闪一下。实现局部刷新需要记录上一次显示的内容或者只更新固定区域的数值。最简单的方式是给数值单独开一块固定坐标区域每次先填个背景色再写新数值。稍微讲究一点可以做双缓冲但这在内存紧张的 F103C8T6 上不太现实我更推荐按区域手动管理。7. 常见问题排查实录7.1 白屏、花屏、偏色的排查顺序白屏是最常见的现象背光亮但整屏白或者灰。排查顺序我总结成先量电压、再查接线、再查复位、最后查初始化。电压不够是物理问题接线反了或者虚焊是连接问题复位时序不对会让控制器停在未初始化状态初始化序列漏了延时或者参数写错也会白屏。这四步基本能把白屏覆盖掉。花屏通常和时序稳定性有关比如时钟太快、走线太长、地线没接好。软件 SPI 的优势在这里体现出来——把时钟速度降一降加个稳定延时往往就好。偏色则多半是颜色格式或者 RGB/BGR 位的问题检查 0x3A 命令是不是 0x05检查 0x36 命令的 BGR 位。现象可能原因排查动作全白无内容供电不足、复位缺失量电压、补复位延时噪点花屏时序不稳、虚焊降速、加延时、补焊颜色整体偏红偏蓝RGB/BGR 位反改 0x36 参数图像偏移偏移量错调 colstart/rowstart显示上下颠倒扫描方向错改 0x36 方向位7.2 坐标偏移和镜像怎么快速定位坐标偏移的表现是图像不在正中或者屏幕边缘出现一条彩色噪点。定位方法前面提过写个四角带点的边框看四个角是否对齐。如果整体偏改偏移量如果左右或上下镜像改扫描方向那个位如果横竖颠倒说明行列扫描顺序整个反了一般是 0x36 参数的组合位没用对。这些参数都不用背看手册里 0x36 那张位表一位一位对改到对为止。7.3 一个容易被忽视的偶发故障我遇到过一种偶发故障上电偶尔正常、偶尔白屏重启几次有一次能好。代码怎么查都没问题最后发现是初始化里的 120ms 延时不够稳供电上电斜率慢的时候控制器还没准备好就被灌命令了。把延时加到 200ms问题消失。这类偶发问题最能耗时间因为它不总是复现容易让人怀疑是不是硬件坏了。经验是凡是偶发性的显示异常先把所有关键延时加足八成能解决。8. 写在最后的一些个人体会软件 SPI 驱动这块 1.8 寸屏我前后折腾了大概一周。回头看代码本身并不复杂真正费时间的是那些看不到的地方偏移量、延时、供电、接线。技术难点从来不在函数写得多优雅而在你能不能把时序和硬件状态对上。我现在的习惯是每写一个新模块的驱动先拿逻辑分析仪把第一屏的波形抓下来存好后面再出问题跟这份正常波形一对比五分钟定位。这比翻手册猜要快得多。还有个我正在验证的方向是把这套软件 SPI 封装成一个带函数指针的通用驱动层未来想换硬件 SPI 或者换 SH1106、ILI9163 这类别的屏只要换底层实现上层绘图接口不用动。手头这块 F103C8T6 空间够试试看效果怎么样跑通了再来补一篇。
