简介面向嵌入式与STM32开发者的完整工程资源以W25Q128 SPI Flash存储字库、LCD显示汉字为主线适合学习外部存储器驱动与显示联动原理的入门及进阶用户。工程基于Keil MDK搭建包含SPI通信、W25Q128读写、汉字字库解析、LCD驱动等核心模块可快速理解从字库烧录到界面显示的全链路实现。压缩包共192个文件大小约4.6MB以c、h源码为主搭配uvprojx工程配置、o/axf/hex编译输出、crf/map中间文件以及keilkill.bat清理脚本和字库地址说明txt目录结构清楚便于直接编译与对照学习。平台已有1965人学习下载。资源给出了可直接运行的程序并涉及字库按0X10004096地址写入W25Q128的烧录思路以及LCD依据字库数据还原汉字图像的设计细节适合结合实物板卡反复调试也可作为课程设计或竞赛项目的代码基础。1. 项目概述与核心思路直接说结论用W25Q128这颗SPI接口的Flash芯片把常用汉字的点阵字库存进去再配合一块LCD屏幕就能让单片机在没有外部字库芯片比如GT21L16S2W的情况下照样流畅显示中文。这玩意儿在项目里最大的价值就是省钱省IO一片W25Q128几块钱16Mbit的容量存几个16×16点阵字库绰绰有余剩下的空间还能存图片、音频或者日志数据。我最早接触这个方案是因为手头一个产品需要显示简体中文菜单但主控Flash不够用RAM更是紧张到算一个16×16汉字都要抠抠搜搜。后来查了一圈资料发现很多人用“字库芯片”比如GT21L16S2W但这类芯片采购周期长、价格偏贵而且部分型号还不好买。刚好项目里已经有一片W25Q128存固件升级包于是干脆把字库也塞进去一次搞定。聊聊这个方案的适用场景。如果你用的是STM32F103这种中等容量MCU内部Flash只有512KB甚至256KB想塞一个完整的GB2312字库进去基本不现实因为光是常用汉字3755个的16×16点阵就要约128KB再来个ASCII和符号直接吃满。用W25Q128外挂存储主控只保留几KB的缓存显示时按需读取RAM占用几乎没有压力。如果你用的是ESP32或者Linux板子那直接用文件系统读字库文件更香但这套思路在裸机环境下依然很实用。我在这个项目里踩了不少坑包括SPI时钟配置太高导致读数据偶尔出错、字库偏移地址算错导致显示乱码、LCD初始化时序不对导致花屏等等。下面把完整流程拆开讲从硬件连接到底层驱动从取模工具到显示逻辑一步步说清楚确保你能直接复现。2. 硬件选型与电路设计2.1 主控和屏幕的选择这套方案对主控没有硬性要求只要是能跑SPI外设的MCU都行。我用的是STM32F103C8T6原因是便宜、资料多、SPI1时钟最高18MHz配W25Q128和LCD绰绰有余。LCD我选了常见的1.8寸TFT分辨率128×160驱动IC是ST7735S同样走SPI接口。这种屏在淘宝上十几块钱一块显示汉字完全够用唯一要注意的是买的时候确认驱动IC不同IC初始化代码不一样别买成0.96寸的OLEDSSD1306两者SPI时序和初始化序列差别很大。如果你手头是12864这种并口屏也可以参考这套思路只是把LCD驱动部分换成对应的初始化代码就行。核心的字库读取逻辑完全不变。2.2 W25Q128与LCD的接线细节W25Q128是标准SPI从设备需要接CS、CLK、MOSI、MISO四根线外加VCC和GND。LCD的ST7735S则要接CS、DC数据/命令选择、RESET、MOSI、CLK有的屏还有背光控制脚BLK。为了让主控少占用IO我把W25Q128和LCD挂在了同一个SPI总线上两个设备各分一个CS片选。信号W25Q128引脚ST7735S引脚STM32引脚备注CLKCLK(6)SCL(2)PA5共用SPI1_CLKMOSIDI(5)SDA(3)PA7共用SPI1_MOSIMISODO(2)—PA6仅Flash需要CS1CS(1)—PA4W25Q128片选CS2—CS(1)PA3LCD片选DC—DC(4)PA2数据/命令选择RES—RES(5)PA1LCD复位GNDGND(4)GND(1)GND共地需要注意的是ST7735S的SDA引脚接收的数据在SCL的上升沿被采样和W25Q128的SPI模式0CPOL0, CPHA0一致所以两个设备可以共用SPI配置不用频繁切换模式。我一开始想当然把LCD设为模式0、Flash设为模式0后来发现ST7735S其实是模式0也兼容实测没问题但某些屏的变种可能要求模式2或3遇到的话单独切换一下SPI的CPOL/CPHA即可。2.3 几个容易忽略的硬件细节第一个是Flash的WP引脚写保护W25Q128的WP#和HOLD#引脚如果悬空内部默认是允许写入的但部分国产兼容芯片可能不是这样稳妥起见把WP#和HOLD#都接上拉电阻到VCC或者直接接到3.3V。第二个是LCD的背光引脚有的模块默认背光电压是5V直接接3.3V会偏暗但不会烧注意别接反。第三个是电源滤波W25Q128在擦写Flash时电流峰值能达到几十毫安如果主控和屏幕共用同一个LDO容易导致电压跌落最好在Flash的VCC脚旁边加一个10uF和0.1uF的电容组合实测能明显降低偶发读错的问题。3. 字库的生成与烧录流程3.1 16×16点阵字库格式说明汉字显示的核心是一个汉字对应一个16×16的点阵图案即每个汉字占用32字节。排列方式通常有两种横向取模和纵向取模。横向取模是指每一行的16个点用两个字节表示从左到右对应字节的高位到低位纵向取模则是每两列一组16行用两个字节表示从上到下对应高位到低位。我的LCD是ST7735S内部显存是按行列扫描的实际测试横向取模配合逐行写入显示效果最直观。GB2312编码的区位码计算公式是区位码 汉字编码的两个字节分别减去0xA0区号在前位号在后。字库文件如果按区位码顺序存储那么某个汉字的偏移地址可以直接算出来偏移 ((区号 - 1) * 94 (位号 - 1)) * 32。这个公式需要牢牢记住因为写死到代码里后就可以随机读取任意汉字不需要遍历查找。3.2 用PCtoLCD2002生成点阵数据网上有很多取模软件我用得最顺手的是PCtoLCD2002。打开软件后在“选项”里设置取模方式为“横向取模”每行16个点字节顺序设置为“从左到右、从上到下”生成的数据格式选“C51格式”这样直接就能得到0x00, 0x00这种十六进制数组。把“汉字”两个字分别输入软件生成的数据往下翻大概有64行每行是32字节。我用Python脚本把这些数据按照GB2312的区位码顺序拼接成一个.bin文件。脚本的核心逻辑是读取一个包含全部汉字的文本文件比如“常用汉字3500字表.txt”然后逐字用encode(gb2312)得到编码再根据编码找到字库里对应汉字的点阵。如果你用的取模软件只能单个字导出也可以写个自动化批处理或者直接用Python的fontTools库读取系统字体文件如simhei.ttf来生成点阵不过这种方式需要自行处理抗锯齿和像素对齐比较折腾我建议还是用取模软件加批处理的方式。生成的文件结构定义为前两字节是字库头部标识比如0xEB, 0x90后面按GB2312区位码顺序依次存放16×16点阵数据。这样烧录到W25Q128后读取时直接按偏移计算不用搜索。3.3 把字库烧录到W25Q128烧录方式有三种我分别列出来按推荐程度排序通过单片机ISP烧录把编译好的烧录固件通过串口下载到STM32烧录固件里包含字库数组上电后将数组写入外部Flash。这种方式最简单但要确保STM32的Flash空间够大因为3500个汉字大约112KB加上程序本身STM32F103C8T6的64KB Flash肯定放不下所以我对字库做了裁剪只保留2500个常用汉字大约80KB配合分页擦写勉强塞进去。通过编程器烧录用CH341A编程器直接离线烧录W25Q128。先把字库bin文件整体烧进Flash再把Flash焊回板子。这种方式一步到位但需要拆芯片适合小批量调试。我用过一次优点是速度快缺点是搞错偏移地址就得重新焊来回折腾挺费劲。通过串口YMODEM分批传输写一个上位机小工具把字库bin文件分帧通过串口发送给单片机单片机收到后直接写入W25Q128写完校验。这种方式最灵活不占用MCU Flash还能随时更新字库推荐在产品调试阶段使用。我在项目里就是用的这种方案串口波特率115200每帧256字节加CRC校验3500个字库大约112KB传完大约十来秒完全能接受。我常用的烧录流程先用STM32CubeProgrammer通过串口烧录一个“引导加载程序”BootLoader这个BootLoader只做两件事从串口接收数据、写入外部Flash。上电后如果检测到串口收到的第一个字节是0xA5就进入下载模式否则直接跳到用户应用程序。用这种方式之后每次更新字库只需要用串口发bin文件不需要反复烧录固件。3.4 烧录后的校验烧录完千万别直接去读汉字先校验一下读回来的数据是否和源文件一致。最简单的方法是把读回来的前64字节和源文件的前64字节对比。我习惯在固件里加一个“读取偏移0x000000的32字节并发送到串口”的测试命令窗口里能直接看到字库头部数据是否和预期一致。如果看到一堆0xFF说明Flash没有被正确烧录或者CS片选逻辑有问题如果读到的是乱码但非全FF大概率是偏移地址算错了。4. 底层驱动开发SPI读写Flash与LCD显示4.1 SPI驱动配置要点不管用STM32的HAL库还是标准外设库SPI的初始化配置有三个点必须注意时钟极性CPOL和相位CPHA、数据帧格式、时钟频率。W25Q128支持SPI模式0和模式3标准外设库初始化代码我写成这样SPI_InitTypeDef SPI_InitStructure; SPI_InitStructure.SPI_Direction SPI_Direction_2Lines_FullDuplex; SPI_InitStructure.SPI_Mode SPI_Mode_Master; SPI_InitStructure.SPI_DataSize SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL SPI_CPOL_Low; SPI_InitStructure.SPI_CPHA SPI_CPHA_1Edge; SPI_InitStructure.SPI_NSS SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler SPI_BaudRatePrescaler_4; SPI_InitStructure.SPI_FirstBit SPI_FirstBit_MSB;时钟频率方面STM32F103的SPI1挂载在APB2总线上最高36MHzPCLK2默认72MHz所以分频系数选4就是18MHz。这个频率对W25Q128来说完全没问题芯片手册里最高支持104MHz。但对ST7735S屏幕来说18MHz稍微有点偏快个别屏会花屏。我的经验是如果屏幕和Flash共用时钟直接把分频设为89MHz两个设备都稳定显示速度差别几乎感觉不到。如果你用的是0.96寸OLED它的SPI最高也就10MHz更要降频。读W25Q128的标准流程是拉低CS → 发送命令0x03 → 发送24位地址 → 连续读取数据字节 → 拉高CS。这里有一个关键点W25Q128读操作没有“读长度”限制可以连续读整片Flash但地址会自动回卷到0。所以读取字库时一次性读32字节完全没有问题。void W25Q128_Read(uint32_t addr, uint8_t *buf, uint16_t len) { uint8_t cmd[4] {0x03, (addr 16) 0xFF, (addr 8) 0xFF, addr 0xFF}; GPIO_ResetBits(GPIOA, GPIO_Pin_4); // CS拉低 SPI_SendData(cmd, 4); for (uint16_t i 0; i len; i) { buf[i] SPI_ExchangeByte(0xFF); } GPIO_SetBits(GPIOA, GPIO_Pin_4); // CS拉高 }很多人踩过一个坑发送完命令和地址后读第一个字节之前必须等一小段“空时钟”有些Flash需要但W25Q128不需要它会在命令地址发送完后的第一个时钟就输出数据。如果你是按W25Q64的老手册写的代码加了延迟也问题不大但纯软件延迟很浪费性能特别是显示大量汉字时。4.2 LCD驱动与汉字显示接口ST7735S初始化序列网上有很多核心是配置屏幕的偏置电压、显示窗口和颜色格式。我用的初始化序列是从淘宝卖家的例程里抄的做了简化只保留必要的20多条命令点击清屏后能显示白底黑字就够用。显示汉字的核心函数是画点函数LCD_DrawPoint(x, y, color)然后根据点阵数据逐位判断画点。void LCD_ShowChinese(uint16_t x, uint16_t y, uint8_t index, uint16_t color, uint16_t bgColor) { // index字库中的汉字索引0~N-1按GB2312排序 uint8_t buffer[32]; uint32_t addr FONT_START_ADDR index * 32; // FONT_START_ADDR是字库起始地址 W25Q128_Read(addr, buffer, 32); for (int i 0; i 16; i) { for (int j 0; j 8; j) { if (buffer[i * 2] (0x80 j)) { LCD_DrawPoint(x j, y i, color); } else { LCD_DrawPoint(x j, y i, bgColor); } } for (int j 0; j 8; j) { if (buffer[i * 2 1] (0x80 j)) { LCD_DrawPoint(x 8 j, y i, color); } else { LCD_DrawPoint(x 8 j, y i, bgColor); } } } }这里我把背景色也画了这样刷新菜单时不用清屏直接覆盖就能重绘。但代价是多了一倍画点操作速度会慢一些。如果你追求速度可以只画前景色刷新前手动填充整块区域背景色。4.3 汉字编码转换与索引计算通常用户输入的字符串是GB2312编码比如“中”的编码是0xD6 0xD0。如果直接把这两个字节当作索引就必须知道字库里“中”排在第几个。我的处理方法是汉字编码减去0xA0得到区位码然后定位。代码如下uint16_t GetGB2312Index(uint8_t high, uint8_t low) { uint8_t qu high - 0xA0; // 区号 uint8_t wei low - 0xA0; // 位号 return (qu - 1) * 94 (wei - 1); }注意这个公式适用于GB2312编码中位于第16区到87区的汉字。如果是ASCII字符小于0x80需要单独处理。我把ASCII字库也放在了W25Q128里放在汉字库前面偏移地址从0开始每个ASCII字符8×16大小占16字节。这样读取时根据字符码直接乘16即可。如果你想支持UTF-8编码的字符串比如从文件系统读取的中文文件名那就需要先把UTF-8转成GB2312再按上面的公式计算。这个转换在PC上很简单在单片机上如果资源紧张可以只做常用汉字的映射表或者干脆不使用中文字符串直接传索引看项目需求灵活处理。5. 常见问题与排查技巧实录5.1 读Flash全是0xFF这种情况十有八九是CS引脚没控制好。我遇到过在SPI初始化时把CS配置成了复用推挽输出但W25Q128的CS在数据手册里要求必须由GPIO控制不能用SPI硬件NSS。如果你用了SPI_NSS_Hard初始化后NSS电平不稳定直接导致Flash一直处于非选中状态。解决办法是改回软件NSS把CS引脚设为GPIO输出在每次通信前后手动拉低拉高。第二个可能原因是Flash的供电问题。我用万用表量过VCC和GND发现有一批板子VCC电压只有2.8V因为LDO电流不够。W25Q128在读取时其实电流不大但如果之前频繁擦写Flash内部电荷泵会导致瞬时电流增大电压稍微掉一点就触发了欠压保护读出来就是FF。解决方法是给Flash单独加一个100uF电解电容或者换一个输出电流大一点的LDO。5.2 汉字显示位置错误或出现镜像显示位置错乱通常是LCD初始化里的列地址和行地址设置和画点函数的坐标方向不一致。ST7735S可以通过寄存器设置扫描方向我用的屏幕默认是从左上角开始扫描如果你买的屏幕是横屏坐标会旋转90度这时把画点函数里的x和y互换或者初始化时设置0x36寄存器的值即可。镜像问题则是字节序反了横向取模的数据如果从低位开始画汉字就会左右颠倒只需把画点循环里的0x80 j改成0x01 j。5.3 读字库速度慢导致菜单卡顿如果你在显示一屏汉字时逐个读取32字节每次读Flash都要拉CS、发命令、读数据、拉CS虽然数据量不大但SPI本身的通信次数很多。优化方法是把一屏所有汉字的点阵一次性读入一个临时缓冲区再统一绘制。比如一屏显示16个汉字就开一个uint8_t fontBuffer[16 * 32]的数组先循环读取所有汉字数据再集中画点实际体感能提升两倍以上。更进一步的优化是把常用汉字缓存到SRAM但STM32F103只有20KB RAM缓存多了就得不偿失建议还是按屏刷新。5.4 烧录后字库偏移地址搞错字库bin文件里如果包含了文件头比如我加了2字节的标识符那么代码里算偏移时必须加上这个偏移量否则显示出来全是后面的汉字。我踩过一次坑用ch341a编程器烧录时读出来第一个字节正常但显示“测试”两个字变成了“测诂”后来发现是烧录时把bin文件从0x000000开始写而代码里FONT_START_ADDR设置成了0x000002导致错位。解决方法是把字库bin文件的头部去掉或者修改代码里的起始地址两者保持一致就行。排查技巧是随便显示一个汉字把读出来的32字节通过串口发到上位机和源bin文件对比就知道偏移差了多少。5.5 LCD显示花屏或颜色不对花屏一般是初始化设置的颜色格式不对。ST7735S支持65K色RGB565和262K色RGB666两种模式我用的是RGB565也就是每个像素2字节。如果初始化里设置了RGB444模式画点函数的颜色值就必须对换高低字节否则红蓝互换、花屏明显。还有一个容易被忽略的是LCD的复位时序复位低电平要保持至少10us然后拉高等待5ms以上才能发初始化命令。如果复位太短屏幕可能上电就乱码。6. 性能优化与扩展方向基本功能跑通后我做了几个针对性优化效果很明显。第一是SPI的DMA传输。把Flash读取改成DMA方式CPU就能腾出来做其他计算。对STM32F103来说用SPI1的DMA接收需要两个通道配合代码量不大但能省下不少阻塞时间。第二是在LCD画点上做了区域填充优化连续绘制同一颜色的区域时直接调用LCD设置窗口函数填充矩形而不是逐点绘制刷新速度提升很多。第三是把字库按“使用频率”排序高频汉字排在前面这样读取时平均偏移更短虽然对SPI读取来说时间差异不大但对心理上是个安慰。扩展方向上这套字库存储方案可以延伸到显示多字号、多字体。W25Q128有16Mbit2MB空间16×16点阵的国标字库约250KB32×32点阵约1MB如果只显示常用汉字完全可以把两种尺寸的字库都放进去。再比如加入ASCII符号、特殊图标、甚至是整张图片的压缩数据都没有问题。我在另一个项目里就把产品Logo图片也存进了W25Q128上电后从Flash读取像素数据直接刷到LCD比从代码数组读方便多了。还有一个扩展玩法是用W25Q128存字库的同时做OTA升级缓存。先把新固件写入Flash的另一个区域校验通过后再搬运到主Flash这样一片芯片干了两个活。如果你在产品上用了外挂Flash强烈建议把字库和固件缓存分区规划好比如地址0x000000~0x0FFFFF存固件备份0x100000~0x1FFFFF存字库用宏定义区分起始地址避免互相覆盖。7. 实操总结与个人经验跑完整个项目我最大的体会是把字库存到外部Flash本质上是用“读取延迟”换“存储空间”对显示系统来说这笔交易非常划算。尤其是对STM32F103这种小容量MCU一片W25Q128解决了字库、图片、日志、OTA缓存多个需求性价比极高。整个实现过程中最值得反复检查的三个环节分别是字库取模方向是否和画点逻辑匹配、Flash的偏移地址计算是否准确、SPI总线上多设备的片选是否互斥。这三处只要有一处出错显示效果就是“看起来正常但实际乱码”的鬼样子查错很费时间。如果你自己动手做我建议先不要追求一步到位分三步走第一步用CH341A编程器把生成的bin文件直接烧进W25Q128再用简单程序读回验证第二步单独测试LCD显示单个汉字固定索引确认画点逻辑正确第三步再联调GB2312编码转换和菜单逻辑。这样每步都有一个明确的检查点出问题能快速定位。最后分享一个调试技巧在字库读取函数里临时加一个串口打印每次读取前打印命令和地址读取后打印返回数据的前几个字节。改代码、下载、看数据整个流程用串口助手就能完成不需要额外调试器。这个土办法在排查偏移错误和片选问题时特别有效你试一次就知道有多省事。本文还有配套的精品资源点击获取