简介ST7567a是一款常见的液晶驱动IC用于驱动132×65点阵屏通过SPI接口与主控通信。这份驱动压缩包面向嵌入式开发者与电子爱好者提供可直接参考或移植的C语言驱动代码覆盖SPI总线初始化、命令与数据收发、显示窗口设置、清屏和基本绘图操作并梳理段码位码映射思路帮助理解逻辑地址与物理像素的对应关系面对不同LCD模块时能更快适配。资源共3个文件包括2个头文件和1个C源文件压缩包仅5KB代码精简、结构清晰便于快速阅读和集成到现有项目中。已有2130人浏览学习适合正在调试ST7567a驱动或需要点阵LCD控制实例的开发者可作为从入门到上手的实用参考。1. 拿到 ST7567A 驱动包之后先别急着烧进板子做仪表、温控器、小家电面板的人八成都在某个液屏料号上见过 ST7567A 这个驱动 IC。它和经典的 ST7565 指令集几乎通用一颗芯片就能带起 12864、128128 这些常见的单色点阵屏ST7567A 驱动程序.rar 里装的就是这种屏的上电初始化序列、底层读写函数和画点/清屏接口。很多人以为把 .rar 解压、调一下引脚、编译下载就能点亮结果第一块屏要么白屏要么花屏要么显示极淡最后全卡在初始化参数和显存寻址上。说实话这类驱动包解决的核心问题只有一个让你的 MCU 用最短时间把 ST7567A 的偏压、电源、扫描方向和显存映射配到和硬件匹配的状态。我在一次小批量仪表开发里光为了一条 SPI 时序就把点亮时间拖了两天后来发现是驱动包里的延迟函数按 8 位并口板子写的。这篇就把驱动包怎么拆、怎么移植、参数怎么调、坑在哪讲透新手能照步骤点亮熟手可以拿参数表和排查思路省掉半天调试时间。2. ST7567A 驱动包的解剖初始化序列与硬件接口的对应关系2.1 驱动包里的文件结构与最小可读顺序解压 ST7567A 驱动程序.rar 之后不管里面的工程是 Keil、IAR 还是 GCC 组织方式第一件事不要急着打开主函数先按这套顺序读代码能省不少绕圈时间。一般会看到这样几类文件头文件里面定义命令宏、引脚宏、初始化文件屏幕初始化函数、底层驱动文件写命令/写数据/设置坐标、上层显示文件清屏、画点、画字符。少数包里还会带上字库数组。建议按这个顺序去读先读lcd.h或ST7567A.h看命令宏定义和引脚连接宏。再读lcd_init.c里LCD_Init()函数看初始化序列和每条命令的参数。然后读写时序函数确认是 SPI 还是 8080 并口。最后才看绘图函数页地址、列地址、显存映射的换算方式。这样做的原因是ST7567A 驱动程序包的核心价值在初始化序列。显示代码写得再花如果偏压比、分压比、扫描方向配错出来的效果完全不可用而这三项只在初始化序列里体现。读初始化函数时注意里面出现频率最高的几条命令0xAF显示开、0xA2偏压 1/9、0xA0/0xA1列方向、0xC0/0xC8扫描方向、0x2F电源控制、0x81加对比度值。这些是每一套 ST7567A 驱动都绕不开的主干命令。2.2 初始化序列逐条拆解偏压、电源、对比度这样配ST7567A 初始化一般分四个阶段开电源、定偏压、设方向、开显示。以最常见的 12864 黑白屏、3.3V 供电为例我常用的初始化序列长这样void LCD_Init(void) { LCD_RESET_CLR; // 复位引脚拉低 Delay_ms(10); // 硬件复位脉宽至少 1ms留裕量 LCD_RESET_SET; // 复位引脚拉高 Delay_ms(10); // 等待内部振荡器稳定 LCD_WriteCmd(0xE2); // 软件复位兼容部分老批次芯片 Delay_ms(10); LCD_WriteCmd(0x2F); // 打开电源升压电路、稳压器、跟随器全开 LCD_WriteCmd(0xA2); // 偏压比 1/9多数 12864 屏推荐 1/9 LCD_WriteCmd(0xA0); // 列地址方向SEG 输出正常 LCD_WriteCmd(0xC8); // 扫描方向COM0 - COM63适应大多数模块走线 LCD_WriteCmd(0x26); // 分压比内部电阻取值 0x24~0x27 LCD_WriteCmd(0x81); // 对比度寄存器入口 LCD_WriteCmd(0x20); // 对比度初始值后面按屏调 LCD_WriteCmd(0xA4); // 正常显示不用测试模式全亮 LCD_WriteCmd(0x40); // 起始行指向第 0 行 LCD_WriteCmd(0xAF); // 打开显示 }这里有几个参数值得注意。0xA2和分压比0x26决定了屏的亮度基线很多人只调对比度寄存器0x81后面的那个数发现怎么调都不理想其实问题在偏压比。分压比取0x24到0x27范围越小对比度越高但太高容易出现底影。对比度值0x20只是一个稳妥起点实际不同批次玻璃、不同温度最终值会落在0x15到0x30之间。0xA0和0xC8这两条如果和模块原理图的实际接线方向不匹配屏幕会左右镜像或上下翻转这在后文的排查章节会反复出现。驱动包里给的默认值往往是作者自己板子的走线方向换到你的板子上不一定对。2.3 写命令与写数据接口方式不同底层函数长这样ST7567A 支持两种主流接口4 线 SPI 和 8080 并口。驱动包里写命令、写数据两个函数决定了整套代码跑在哪种接口上。SPI 方式引脚少、适合小控制板8080 方式速度快、适合需要频繁刷图的场合。4 线 SPI 的底层实现常见做法是这样void LCD_WriteCmd(uint8_t cmd) { LCD_CS_CLR; // 片选拉低开始通信 LCD_A0_CLR; // A0 0当前字节是命令也称 D/C 位 for (uint8_t i 0; i 8; i) { LCD_SCL_CLR; if (cmd 0x80) // 高位先出 LCD_SDA_SET; else LCD_SDA_CLR; LCD_SCL_SET; // 上升沿锁存数据 cmd 1; } LCD_CS_SET; // 片选拉高结束通信 } void LCD_WriteData(uint8_t dat) { LCD_CS_CLR; LCD_A0_SET; // A0 1当前字节是显示数据 for (uint8_t i 0; i 8; i) { LCD_SCL_CLR; if (dat 0x80) LCD_SDA_SET; else LCD_SDA_CLR; LCD_SCL_SET; dat 1; } LCD_CS_SET; }这段代码的关键是 A0 线。命令和数据走同一条 SPI 数据线靠 A0 电平区分。驱动包移植时最容易出错的就是 A0 引脚接反把所有命令当数据写进去初始化序列执行得七零八落屏幕表现就是白屏或满屏随机点。注意这块的延时问题。ST7567A 的 SPI 时钟频率一般不要超过 2MHz很多驱动包里的软 SPI 没做任何延时跑在低速 MCU 上没问题换到主频 72MHz 的 Cortex-M 系列上就翻车因为 GPIO 翻转快过芯片能承受的速率。如果屏幕上出现内容错乱但时序逻辑看起来又没错优先怀疑这个。2.4 关键寄存器参数表调试时对照这一张就够了下表是调试时最常用的 ST7567A 寄存器参数建议直接抄在调试笔记本上比临时翻手册快命令码功能参数范围备注0xA2 / 0xA3偏压比1/9A2/ 1/7A38 行 COM 屏用 1/716 行以上用 1/90x20~0x27内部分压比0x20 最淡0x27 最深和 0x81 对比度配合使用0x81 后再写 0x00~0x3F电子对比度数值越大越深分压比不动时微调这个0x2F / 0x28~0x2F电源控制逐位打开升压/稳压/跟随0x2F 全开0x28 全关0xA0 / 0xA1列扫描方向左到右 / 右到左接错会出现镜像0xC0 / 0xC8行扫描方向正扫 / 反扫和模块 COM 引脚走线匹配0x40~0x7F起始行0x40 从第 0 行开始滚屏效果靠它实现0xB0~0xB7页地址共 8 页对应 64 行每页 8 行像素0x10~0x1F 0x00~0x0F列地址高 4 位 低 4 位两次写入范围 0~131这张表是从大量驱动包里抽出来的公共部分和 ST7565 的寄存器也高度重合。如果你手里的驱动包用的是别的命令写法本质功能是一样的只是命令码封装方式不同。调屏的时候先对着这张表过一遍大部分显示效果问题都能定位到具体是哪条命令配错了。3. 把驱动移植到自己的板子SPI/8080 接口适配与最小改动3.1 移植前先做的一件事确认模块接口类型并口还是 SPI很多开发者拿到驱动包就开始改引脚宏改完编译发现点不亮回头才意识到自己的屏是并口模块驱动包却是 SPI 版的。这个低级错误非常常见所以移植前先做减法看屏模块的 FPC 或者 PCB 丝印上有没有标注接口模式。常见做法是看屏的排线引脚数。8 根以上数据线加 WR、RD、CS、RS、RESET 的基本是 8080 接口通常会有跳线或电阻选位来切换 8 位/16 位模式只有 CS、SCL、SDA、A0、RESET 五根信号线的是 SPI 接口。有的屏模块会直接焊死接口没有跳线这种情况想换接口只能换屏。确认完接口类型再去看 ST7567A 驱动程序.rar 里的底层读写函数是 SPI 还是并口实现方向不对就直接换包别浪费时间在改接口底层上。并行改串行不是改几个宏就能搞定的事牵涉到读函数、写函数、时序三处全部重写还不如重新找对应接口的驱动包来得省事。3.2 最小改动移植法四个位置改完就能跑起来把接口对上之后移植就简单了改四个地方其他尽量不动引脚宏、延迟函数、初始化函数里的方向位、SPI 速率。以把一套原本跑在某开发板上 SPI 驱动移植到自己的 STM32 工程为例最常见的最小改动是这样// 第一步按自己的原理图改引脚宏 #define LCD_SCL_PORT GPIOB #define LCD_SCL_PIN GPIO_PIN_13 #define LCD_SDA_PORT GPIOB #define LCD_SDA_PIN GPIO_PIN_15 #define LCD_A0_PORT GPIOB #define LCD_A0_PIN GPIO_PIN_12 #define LCD_CS_PORT GPIOB #define LCD_CS_PIN GPIO_PIN_14 #define LCD_RESET_PORT GPIOB #define LCD_RESET_PIN GPIO_PIN_11// 第二步确认延迟函数可用单位是毫秒 // 很多驱动包自带的 Delay_ms 依赖定时器或空循环 // 移植到新平台后最容易出问题直接换成标准库的延时// 第三步确认初始化序列里的方向和镜像位 LCD_WriteCmd(0xA0); // 如果你屏的 SEG 走线反了改成 0xA1 LCD_WriteCmd(0xC8); // 如果上下反了改成 0xC0第四步是 SPI 速率。如果是软件 SPI去掉或调大循环里的延时如果是硬件 SPI把分频系数调到 2MHz 以下。代码块没法覆盖所有平台的 SPI 配置但判断标准统一像素不花、内容不乱速率就算安全。移植时有个原则值得记住初始化序列里的命令参数优先相信驱动包原作者的除非你能证明你的屏参数和它不同。我见过太多人移植时顺手把偏压比、分压比改成自认为“更对”的值结果屏幕显示很怪。也见过某公司的一个内部项目工程师把0xA0改成了0xA1想修正镜像屏正常了但结果显示位置整体偏移折腾半天才发现镜像和偏移是两回事。3.3 SPI 时序参数细调上升沿、时钟极性和速率软件 SPI 的实现方式五花八门有的上升沿出数据有的下降沿出数据有的先翻转 SCL 再设置 SDA有的反过来。ST7567A 手册给的标准是数据在 SCL 上升沿被锁存所以正确做法是先在 SCL 低电平时把 SDA 设置好再拉高 SCL。上一节代码块里的写法就是按这个标准来的。时钟极性上面ST7567A 通常工作在 SPOL0、CPHA0 或者 CPOL0、CPHA1 都见到过取决于模块板和驱动代码的配合。如果你用的是硬件 SPI 外设建议直接把驱动包里的底层读写函数改成寄存器操作而不是复用软件 SPI因为硬件外设的极性和相位配置起来更麻烦还要对着示波器调。常见的找坑方法是用逻辑分析仪或者示波器抓 SCL 和 SDA 两条线对照初始化序列里第一个命令 0xE2软件复位的十六进制看字节是否移位。如果抓出来的是 0x71、0x59 这类错位值就是 SCL 空闲电平和采样沿配错了把 CPOL/CPHA 翻转一下再试。3.4 最小验证法怎么确认屏被点亮而不是“碰巧亮”移植完成的验证分三步。第一步不做任何显示操作只执行初始化序列观察屏幕背景色正常是极淡的灰白或浅绿有黑点说明初始化没执行成功。第二步写全屏 0x55看是否能显示稳定的竖条纹竖条纹说明数据通路 OK。第三步写全屏 0x00 清屏如果有残影检查偏压比和对比度。void LCD_Fill(uint8_t dat) { for (uint8_t page 0; page 8; page) { LCD_WriteCmd(0xB0 page); // 切到第 page 页 LCD_WriteCmd(0x10); // 列地址高 4 位清零 LCD_WriteCmd(0x00); // 列地址低 4 位清零 for (uint8_t col 0; col 128; col) { LCD_WriteData(dat); // 连续写入 128 个字节数据 } } }这段代码里有个细节每次切页之后必须重新设置列地址。因为 ST7567A 的列地址在写完一页的最后一个字节之后不会自动回到页首它会停在下一页当前列上。如果切页后不重置列地址画面会出现整列偏移那是最让人费解的“有规则花屏”。验证时的判断标准全屏0x00后屏幕应该均匀到几乎看不出底色全屏0xFF后应该是均匀的深色块不能有位置相关的浓淡差异。出现一端深一端浅一般是分压比太高或者偏压比太浅调低0x20~0x27那一档就好。出现随机亮线优先抓 SPI 时序是不是有毛刺。4. 显存与绘图基础画点、反显、滚屏的参数设置4.1 64 行分成 8 页ST7567A 显存寻址方式先搞明白ST7567A 内部显存是 65×132 位常见 12864 屏只使用其中 64 行×128 列。显存按“页”组织每一页 8 行像素高位在上、低位在下一共 8 页页地址 0xB0~0xB7。这个结构和常规思路很不一样很多人第一次用都栽在这里屏幕是逐行扫描的但 MCU 视角下的显存是按页一列一列排放的。画点之前必须先算清楚坐标到页地址和列地址的映射。假设屏幕坐标是 x0~127水平方向、y0~63垂直方向那么页地址 page y / 8页内偏移 bit y % 8列地址 col x访问时先发页地址命令再发列地址命令高 4 位低 4 位分两次然后在这个位置写入一个字节。这一个字节不仅影响你画的点还影响同列上下 7 个像素的当前值。所以画一个点不能直接写位运算后的数据必须先把原来那页那列的一个字节读出来改掉对应位再写回去。基于这个结构做一个驱动包时会看到清屏函数是一页一页顺序写而不是一行一行横向写原因就在这里。理解了这个映射关系后很多“显示半个字”“刷新撕裂”“字符倒立”的问题都能直接通过坐标换算推出来。4.2 画点函数与局部刷新的正确写法驱动包里最常见的画点函数是带读改写逻辑的直接给你一套能跑的最小实现uint8_t lcd_buffer[8][128]; // 软件显存8 页 x 128 列 void LCD_DrawPoint(uint8_t x, uint8_t y, uint8_t color) { if (x 127 || y 63) return; // 坐标越界直接丢弃 uint8_t page y / 8; uint8_t bit y % 8; if (color) lcd_buffer[page][x] | (1 bit); // 点亮该像素 else lcd_buffer[page][x] ~(1 bit); // 熄灭该像素 // 把这个字节写回屏幕对应位置 LCD_WriteCmd(0xB0 page); // 切页 LCD_WriteCmd(0x10 | (x 4)); // 列地址高 4 位 LCD_WriteCmd(0x00 | (x 0x0F)); // 列地址低 4 位 LCD_WriteData(lcd_buffer[page][x]); }注意这里引入了一个软件显存缓冲区lcd_buffer。绝大多数成熟的 ST7567A 驱动包都不会直接操作硬件显存而是先改软件缓冲区再把改动的那一个字节刷到屏幕上。这样可以避免每次画点都执行“读出→改写→写回”的麻烦也方便做更多图形处理。坐标换算时有一个常见的错位元凶1 bit的 bit 是从第 0 位开始还是第 1 位开始。ST7567A 的显存位 0 对应 COM0也就是屏幕最上面的一行。如果驱动包里的画点函数是用1 (7 - bit)来写的说明这个包用的是倒序位映射你要么全部沿用要么全部改成顺序位中途混用会出现字符上下分裂的怪象。4.3 反显、滚屏与局部刷新的取舍ST7567A 支持硬件反显功能一条命令就能把所有像素状态取反不需要去遍历显存翻转每个位。硬件反显的写法是LCD_WriteCmd(0xA6)是正常显示LCD_WriteCmd(0xA7)是反白显示。菜单选中态、断电提示这类强调效果直接在这两条命令之间切换就行响应速度快到不用刷新屏幕。想要局域反显就只能靠绘图层做软件异或复杂度会上升通常用在表格选中行这种场景。滚屏效果是 ST7567A 的一个亮点。起始行命令0x40~0x7F改变的是显示窗口在显存中的起始位置类似向上平移画面。连续改变起始行可以实现平滑滚动完全不改显存数据对 MCU 几乎没有负担void LCD_ScrollUp(uint8_t lines) { LCD_WriteCmd(0x40 | (lines 0x3F)); // 从第 lines 行开始显示 }当lines从 0 变到 63 再回到 0画面会循环滚动一屏。注意滚动粒度是行不是页一次加 1 是 1 行加 8 正好是一页调整变化速度就是滚动动画的速度。如果要实现文本从底部卷上来的效果配合局部刷新就行不要让整个文本区域反复重绘不然低主频单片机会卡顿明显。4.4 写入策略一次刷新一整页比逐点刷新高效得多画点函数一次只写一个字节效率其实不高。如果字符串、图形这种大面积内容也走逐点每画一个字都要发几百次命令SPI 速率不高的情况下能明显看到绘制过程。成熟驱动包的处理方式是在软件显存上把所有内容画完然后按页批量刷新。批量刷新就是第二节里的LCD_Fill那种结构只是把固定数据换成显存内容void LCD_Refresh(void) { for (uint8_t page 0; page 8; page) { LCD_WriteCmd(0xB0 page); LCD_WriteCmd(0x10); LCD_WriteCmd(0x00); for (uint8_t col 0; col 128; col) LCD_WriteData(lcd_buffer[page][col]); } }整屏刷新 8×128 个字节在 2MHz SPI 下大约需要 4~5ms肉眼无感。局部刷新就只写变化的页和列区间页面数据结构不变只更新需要变化的区域。这里有一个调试时的参考如果屏幕闪烁优先怀疑刷新频率太低或者刷新区域太大如果局部刷新出现残影通常不是刷新太慢而是没把旧内容清掉。用这套软件显存加批量刷新的架构所有画线、画圆、字符绘制都可以先在内存里算好再一次性送显后续扩展交互菜单也不会因为显示部分性能捉襟见肘。5. 常见问题与排查花屏、乱码、对比度异常的五类翻车现场5.1 上电白屏或黑屏复位时序根本没保障现象执行完初始化后屏幕完全白屏或者全黑MCU 程序运行正常但屏幕没有任何反应。原因最常见的是复位引脚没有做完整时序。有些驱动包兼容设计省略了硬件复位直接用软件复位命令但软件复位在电源上电不稳时可能执行无效。其次是复位引脚悬空或接到 GPIO 后没配置成推挽输出。解决复位引脚接一个 10kΩ 上拉到 VCC然后 GPIO 配置为推挽输出。初始化里先拉低 10ms、再拉高 10ms 再往下走。并且把软件复位命令 0xE2 放在初始化序列最前面双保险。如果还白屏用万用表量芯片供电脚电压低于 2.7V 时 ST7567A 工作不稳定。5.2 显示内容错乱但有规律显存地址映射错了现象屏幕能亮但显示的内容是“乱的”字符被拆成上下两段、内容左右镜像、同一帧数据重复出现在固定位置。原因要么是页地址/列地址没有正确复位要么是0xA0/0xA1、0xC0/0xC8方向和模块实际走线不符。还有一种很隐蔽初始化里设置了起始行0x40之后某些库函数又调用了滚动显示把起始行改了画面整体偏移且内容错位。解决先做全屏填充 0x55 和 0xAA 的交替测试观察条纹方向是否一致。条纹连续稳定说明数据通路没问题问题就在扫描方向或者列地址。把0xA0改成0xA1试试是否镜像把0xC8改成0xC0试试是否上下颠倒。改了之后仍错位就在每次绘图前重新设置页地址和列地址别信任硬件自动递增。5.3 能显示但亮度极淡对比度三件套没配好现象显示内容能看清轮廓但对比度很低白色背景上的深色文字变成了浅灰色尤其在光线亮的环境下几乎看不清。原因对比度三件套——偏压比、分压比、电子对比度——三个参数配合不合适。最常见的是只调了0x81后面的数值没有动0x20~0x27分压比而分压比偏低了 1~2 档再调电子对比度也拉不上去。解决先确认偏压比是 1/90xA2ST7567A 用在 64 行屏上必须 1/91/7 会导致电压不足。然后把分压比从0x27开始往下试每降一档观察一次找到不出现底影的最深值。最后用0x81的电子对比度做 ±0x05 的微调。三件套全部到位后正常视角下深色区域应该接近黑色而不是灰色。5.4 画面抖动、有横纹残影电压建立跟不上现象屏幕显示稳定内容时一切正常刷新内容后残影要一两秒才消失或者刷新瞬间出现横向明暗纹。原因ST7567A 内部的升压电路和液晶电容需要建立时间。刷新频率过高、分压比过大、或者电源控制命令0x2F里升压部分开得太晚都会导致液晶驱动波形不稳定。低温环境下尤其明显很多仪表夏天正常冬天发虚就是这个原因。解决把0x2F全开放在初始化序列靠前的位置给升压电容留足预充时间。刷新频率超过 20Hz 时改成局部刷新避免整屏频繁重写。如果是低温场景后文第六章会专门讲温度补偿的做法。5.5 字符显示一半缺一半位序高低端颠倒了现象英文和数字显示还能辨认但汉字乱掉或者字符上下半部分错位看起来像“叠影”。原因字库取模方式和显存位序不一致。字库是按“行扫描、从低位到高位”取模的但 ST7567A 显存是“高位在上、低位在下”两者正好相反时字符就会上下分裂。这类问题在驱动包集成了现成字库的情况下很少见但自己准备字库时特别容易踩。解决检查字模头文件里每个字符的取模说明。逆向取模在画字操作时做一次位反转把dat的 bit0 和 bit7 对调、bit1 和 bit6 对调。或者在字库生成工具里把取模方式设为“逐行式从高位开始”。改完只影响字符绘制不会牵连底层写屏逻辑。6. 进阶用法省电、低温补偿与滚动显示的三个调优技巧6.1 待机省电关显示不关电源用0xAE/0xAF做休眠切换很多设备要求屏幕常亮但功耗要低。ST7567A 休眠的正确做法是只关显示、不关升压0xAE关显示后数据还在显存里再次0xAF开显示时画面完全不变不需要重新初始化。配合降低对比度和关闭 LED 背光整机待机电流能明显下降。这个技巧对电池供电的仪表特别有用切换时间在毫秒级对用户无感。6.2 低温环境的对比度补偿温度降、电压升低温下液晶响应变慢同样电压下看起来颜色变浅。成熟的方案是在温度传感器读取到环境温度后按温度区间调整分压比低于 0℃ 用0x25~0x27加深常温回落0x20~0x22。这个补偿逻辑不要做得太激进分压比跨度控制在一档到两档不然会在温度临界点出现跳变。如果产品需要过零下 20℃ 测试这是必做项。6.3 滚动显示替代频繁刷新起始行命令自己做动画用0x40~0x7F起始行做垂直滚动不占 CPU 资源。配合定时器每 50ms 改变一次起始行值就能实现信息条平滑上滚。需要注意滚动方向和0xC0/0xC8的扫描方向要一起考虑扫描反了滚动方向也会反过来。这个技巧用在界面固定、信息内容交替变化的场景里比反复重绘省电且不闪烁。这三招做完一套 ST7567A 的驱动工程才算真正调完。我自己的习惯是每次点亮新屏后把偏压比、分压比、对比度、扫描方向这四个参数记录在工程注释里防止换批次屏后参数漂移时无从查起。驱动包的初始化序列不是不可变的标准答案它是你的起点。希望这些排查方向和参数设置方法能帮你少走几次用示波器抓 SPI 时序到深夜的路。本文还有配套的精品资源点击获取