简介本资源是一套基于STM32F103VET6与FSMC接口驱动ILI9325兼容ILI9328液晶屏的完整嵌入式LCD底层驱动工程面向嵌入式初学者及STM32硬件开发工程师解决TFT-LCD在Cortex-M3平台上的时序配置、地址映射与图形显示等核心问题。压缩包共22个文件含13个C源文件实现FSMC初始化、ILI9325寄存器配置、画点/线/矩形/圆等绘图函数及多尺寸中英文字符串输出、8个头文件封装硬件抽象层与字体数据结构以及1个HTML格式的Release说明文档整体仅36KB轻量易集成。已有264人学习下载适合快速移植到STM32F10x系列开发板。读者可直接复用FSMC地址线分配逻辑如RS接A16的偏移计算方法、RGB24转RGB16精确转换公式、预定义常用颜色宏以及已适配多种LCD控制器ILI9320/9325/9328、ST7735、HX8347D、SPFD5408的模块化驱动框架。1. ILI9325_LCD驱动不是换个头文件就能点亮的“老古董屏”而是FSMC时序黑匣子上的精密调参实战你手头有一块标着“ILI9325”的3.2寸TFT LCD模块接在STM32F103上参考例程跑起来——屏幕要么全白、要么花屏、要么只闪半帧。查数据手册发现它和ILI9328引脚兼容、寄存器高度相似但直接套用ILI9328驱动大概率翻车。这不是驱动写错了是FSMCFlexible Static Memory Controller的时序参数在替你背锅HCLK频率、地址/数据建立/保持时间、读写脉冲宽度……差1个周期LCD就拒绝响应。这份ILI9325_LCD驱动资源本质是一套经实测验证的FSMCGPIO初始化组合包含完整寄存器配置序列、逐帧刷新控制逻辑、以及关键的Gamma校准表。它不解决“怎么点亮”而是解决“为什么点不亮、点得不稳定、颜色发灰”。适合正在啃STM32F103裸机开发、需要把老款并口屏稳稳接入工业HMI或教学实验平台的工程师——尤其当你发现示波器上FSMC_NWE信号边沿毛刺多、或LCD在高温下偶发错行时这份资源里的时序补偿值就是你的后悔药。2. 驱动架构与FSMC时序选型为什么必须绕开标准库手撕寄存器配置ILI9325作为2007年前后的主流控制器其通信协议本质是“伪SRAM”通过FSMC的NOR/PSRAM接口模拟并行总线时序将LCD当成一块外挂内存来读写。但STM32F103的标准外设库SPL对FSMC的封装过于粗粒度——它只提供FSMC_NORSRAMInit()这类函数却把最关键的FSMC_NORSRAMTimingInitTypeDef中6个时序参数AddressSetupTime、AddressHoldTime、DataSetupTime、BusTurnAroundDuration、CLKDivision、DataLatency全扔给用户硬算。而ILI9325数据手册Rev 1.2第47页明确要求DataSetupTime ≥ 14nsAddressSetupTime ≥ 20ns且HCLK72MHz时FSMC_CLK周期为13.9ns这意味着至少要预留2个时钟周期做建立。标准库默认的DataSetupTime1即1个HCLK周期≈13.9ns已踩红线。更致命的是ILI9325对BusTurnAroundDuration总线转向时间极其敏感——当FSMC从写地址切换到写数据时若该值设为0部分批次LCD会锁死。因此本驱动放弃SPL直接操作FSMC_Bank1_NORSRAM_TypeDef寄存器确保每个时序参数可精确到cycle级。2.1 FSMC Bank1映射与GPIO复用配置逻辑ILI9325采用16位数据总线D0-D15需占用FSMC_Bank1_NORSRAM区域。关键约束地址线A0-A22中仅A0用于寄存器/数据选择A00写指令A01写参数故实际只需A0控制线FSMC_NWE写使能、FSMC_NOE读使能、FSMC_NE1片选必须严格对应GPIO复用PD0-PD15接数据线PE7-PE15接地址线仅用PE7A0PG0NE1PD4NWEPD5NOE。提示切勿将FSMC_NWE接到PD1因PD1在部分F103芯片上存在复位后默认高电平问题会导致LCD误触发写操作。配置代码如下裸机环境无SPL// 1. 使能FSMC与GPIO时钟 RCC-APB2ENR | RCC_APB2ENR_IOPDENR | RCC_APB2ENR_IOPEENR | RCC_APB2ENR_IOPGENR; RCC-AHBENR | RCC_AHBENR_FSMCEN; // 2. PD0-PD15配置为AF_PP复用推挽速度50MHz GPIOD-CRL 0x44444444; // PD0-PD7 GPIOD-CRH 0x44444444; // PD8-PD15 GPIOD-ODR 0xFFFF; // 初始输出高避免上电干扰 // 3. PE7(A0)配置为AF_PPPG0(NE1)、PD4(NWE)、PD5(NOE)同理 GPIOE-CRL ~0xF0000000; GPIOE-CRL | 0x40000000; // PE7 GPIOG-CRL ~0x0000000F; GPIOG-CRL | 0x00000004; // PG0 GPIOD-CRL ~0x0000FF00; GPIOD-CRL | 0x00004400; // PD4,PD5 // 4. FSMC_Bank1_NORSRAMx寄存器直写关键 // 启用Bank1设置为NOR/PSRAM模式数据宽度16bit FSMC_Bank1-BTCR[0] 0x00001011; // FSMC_BCR1: MBKEN1, MWID10(16bit), MTYP00(NOR), MUXEN0 FSMC_Bank1-BTCR[1] 0x00000200; // FSMC_BTR1: ADDSET2(2周期), ADDHLD0, DATAST4(4周期), BUSTURN2(2周期) // 5. 时序参数详解单位HCLK周期 // ADDSET2 → 地址建立时间2×13.9ns27.8ns 20ns要求 ✅ // DATAST4 → 数据建立时间4×13.9ns55.6ns 14ns要求 ✅ // BUSTURN2 → 总线转向时间2周期规避ILI9325锁死风险 ✅ // 注意DATAST不能设为341.7ns实测某批次LCD在此值下出现参数写入丢失这段代码的核心价值在于它把数据手册的ns级要求精准翻译成FSMC寄存器的整数周期值。DATAST4不是拍脑袋定的——我们用逻辑分析仪抓过FSMC_NWE和D0-D15波形当DATAST3时D线数据有效窗口边缘与NWE下降沿重叠导致ILI9325采样失败DATAST4则留出13.9ns余量稳定通过所有温区测试。2.2 ILI9325初始化序列寄存器配置顺序比值更重要ILI9325的初始化不是简单写一堆寄存器而是一套强依赖顺序的“握手协议”。例如必须先写0x0001Driver Output Control启用扫描再写0x0002LCD Driving AC Control配置偏压否则后续0x0003Entry Mode的RGB/BGR设置无效。本驱动采用分阶段初始化阶段关键寄存器作用必须前置条件基础使能0x0001,0x0002开启驱动、设定VCOM电压无时序校准0x0003,0x0008,0x0009设定扫描方向、帧频、门驱动周期基础使能完成Gamma校准0x0030~0x003F16组Gamma曲线参数决定灰阶过渡时序校准完成显示使能0x0022开启主显示此寄存器写入后屏幕才亮Gamma校准完成驱动中ILI9325_Init()函数严格按此顺序执行且在每组Gamma参数写入后插入Delay_us(10)——这是血泪经验ILI9325内部状态机处理Gamma表需微秒级等待跳过则屏幕显示发绿实测现象。2.3 写指令/写参数的底层函数指针解引用陷阱ILI9325通过A0引脚区分指令/数据但FSMC映射后地址空间被拆分为0x60000000A00 → 指令端口写入寄存器地址0x60000002A01 → 数据端口写入寄存器值常见错误是直接用*(uint16_t*)0x60000000 reg_addr这在GCC编译下可能触发未定义行为因编译器优化导致写操作乱序。本驱动采用volatile指针强制内存访问#define LCD_CMD_PORT ((volatile uint16_t*)0x60000000) #define LCD_DATA_PORT ((volatile uint16_t*)0x60000002) void ILI9325_WriteCmd(uint16_t cmd) { *LCD_CMD_PORT cmd; // A00写指令地址 } void ILI9325_WriteData(uint16_t data) { *LCD_DATA_PORT data; // A01写参数值 } // 批量写数据如填充GRAM void ILI9325_WriteDataBuffer(uint16_t* buf, uint32_t len) { *LCD_CMD_PORT 0x0022; // 先发写GRAM指令 for(uint32_t i0; ilen; i) { *LCD_DATA_PORT buf[i]; // 每次写都走A01端口 } }volatile关键字确保每次*LCD_DATA_PORT都是真实内存写入杜绝编译器优化掉重复写操作——这点在调试花屏时至关重要曾有项目因未加volatile导致WriteDataBuffer循环被优化成单次写整个屏幕只显示一个像素。3. ILI9325与ILI9328的兼容性边界哪些能抄哪些必须重写虽然ILI9325和ILI9328常被当作“兄弟型号”但它们的寄存器映射和时序容忍度存在实质性差异。本驱动明确划清了兼容红线避免盲目套用导致系统性故障。3.1 寄存器级差异看似相同实则致命寄存器地址ILI9325功能ILI9328功能兼容性风险说明0x0003Entry Mode扫描方向/RGB顺序同功能✅参数位定义一致可直接复用0x0008Display Control帧频/门驱动同功能⚠️ILI9328支持更高帧频若用ILI9325的0x0008值设为60HzILI9325会显示撕裂实测0x0030~0x003FGamma校准表16组Gamma校准表16组❌数值完全不通用ILI9325的Gamma曲线更陡峭直接套用ILI9328参数会导致暗部细节丢失、白色泛黄注意本驱动提供的Gamma表gamma_table.h是实测采集的——用色彩分析仪测量ILI9325在25°C/60%湿度下的sRGB色域覆盖反向拟合出16组参数。非网上流传的“通用表”。3.2 时序容忍度ILI9325更“娇气”使用同一套FSMC时序参数ADDSET2, DATAST4, BUSTURN2测试ILI9325在-10°C~60°C全温区稳定运行ILI9328在70°C时出现偶发错行因ILI9328内部时序裕量更小。这说明ILI9325虽是老型号但对时序精度要求反而更高。驱动中FSMC_BTR1的DATAST4是专为ILI9325设定的保守值若强行降到3以提升刷屏速度ILI9325在低温下会概率性丢帧现象屏幕顶部1/3区域静止下半部正常滚动。3.3 初始化流程差异少一步就黑屏ILI9328要求在写完0x0001后立即写0x0002而ILI9325必须在两者之间插入Delay_ms(5)。原因在于ILI9325内部LDO启动较慢未等稳压完成就配置AC控制会导致VCOM电压漂移。本驱动ILI9325_Init()中明确包含ILI9325_WriteCmd(0x0001); ILI9325_WriteData(0x0100); // Driver Output Control Delay_ms(5); // ILI9325专属等待 ILI9325_WriteCmd(0x0002); ILI9325_WriteData(0x0200); // LCD Driving AC Control曾有开发者将ILI9328的初始化代码直接移植删掉这个Delay_ms(5)结果屏幕在冷启动时全黑热机后恢复正常——这就是硬件特性差异埋下的定时炸弹。4. 常见问题排查5条血泪经验每条都来自真实翻车现场4.1 现象屏幕全白但背光正常示波器测FSMC_NWE有规律脉冲原因FSMC_BTR1中DATAST数据建立时间设为0或1导致ILI9325无法在NWE下降沿前稳定采样数据线。ILI9325数据手册Table 12明确要求DATAST ≥ 14ns而DATAST1对应13.9nsHCLK72MHz实际不满足。解决将FSMC_BTR1的DATAST字段改为4即55.6ns重新编译烧录。实测DATAST341.7ns在部分批次屏上仍偶发白屏DATAST4为安全下限。4.2 现象屏幕显示正常但触摸坐标严重偏移如点击右下角返回左上角原因ILI9325的GRAM起始地址与ILI9328不同。ILI9325默认GRAM从(0,0)开始但某些厂商模组在出厂时已将GRAM偏移至(10,10)以规避边缘坏点。驱动中ILI9325_SetCursor()函数若未适配此偏移触摸校准就会失效。解决检查模组规格书中的GRAM Offset参数在ILI9325_SetCursor(x,y)中加入偏移修正void ILI9325_SetCursor(uint16_t x, uint16_t y) { uint16_t offset_x 10; // 根据模组实测调整 uint16_t offset_y 10; ILI9325_WriteCmd(0x0020); ILI9325_WriteData(x offset_x); ILI9325_WriteCmd(0x0021); ILI9325_WriteData(y offset_y); }4.3 现象屏幕间歇性花屏尤其在CPU高负载时如USB传输中原因FSMC总线被其他外设抢占。STM32F103的FSMC与DMA2通道共享AHB总线当USB CDC虚拟串口大量收发数据时DMA2占用总线带宽导致FSMC读写延迟超标ILI9325内部状态机紊乱。解决在USB中断服务程序中临时禁用FSMC非关闭而是置FSMC_BCR1的MBKEN0USB传输完成后再恢复。实测此法可100%消除花屏且对USB吞吐量影响2%。4.4 现象颜色发灰对比度低但亮度调节正常原因Gamma校准表未生效。ILI9325的Gamma寄存器0x0030~0x003F需在0x0022主显示使能之前写入且写入后必须等待Delay_us(10)。若在0x0022之后写Gamma或省略延时ILI9325会忽略新参数。解决检查初始化顺序确保Gamma写入位于ILI9325_WriteCmd(0x0022)之前并在每组WriteData后加Delay_us(10)。驱动中已封装为ILI9325_LoadGamma()函数严禁手动拆解调用。4.5 现象上电后屏幕闪一下白光然后黑屏但FSMC波形正常原因FSMC_BCR1中MWID数据宽度配置错误。ILI9325必须设为16位模式MWID10b若误设为8位MWID00bFSMC会将16位数据拆成两次8位写入ILI9325收到乱序指令而进入保护态。解决确认FSMC_BCR1寄存器第9-10位为10bFSMC_Bank1-BTCR[0] (FSMC_Bank1-BTCR[0] ~0x00001C00) | 0x00000800; // 强制MWID105. 进阶技巧用FSMC突发写加速GRAM填充把刷屏速度提3倍ILI9325的GRAM显存大小为240×320×2153.6KB传统单字写WriteData方式刷一帧需153600次FSMC写操作耗时约320msHCLK72MHz。但FSMC支持突发Burst模式——连续写入时地址自动递增省去重复发送地址的开销。本驱动通过FSMC_BTR1的ACCMod访问模式位启用此特性将刷屏时间压缩至110ms以内。5.1 突发写使能配置FSMC突发写需满足两个前提FSMC_BCR1中BURSTEN1允许突发FSMC_BTR1中ACCMod11b复用地址/数据总线突发模式。配置代码// 修改FSMC_BCR1启用突发使能 FSMC_Bank1-BTCR[0] | 0x00000008; // BURSTEN1 // 修改FSMC_BTR1设置访问模式为突发 FSMC_Bank1-BTCR[1] (FSMC_Bank1-BTCR[1] ~0x000000C0) | 0x000000C0; // ACCMod11b // 启用突发写后GRAM填充函数可大幅简化 void ILI9325_FillGRAM(uint16_t color) { ILI9325_WriteCmd(0x0022); // 发送写GRAM指令此后所有写入均为GRAM数据 // 直接向FSMC地址0x60000002写入FSMC自动递增地址 volatile uint16_t* gram_ptr (volatile uint16_t*)0x60000002; for(uint32_t i0; i240*320; i) { *gram_ptr color; // 编译器生成STRH指令FSMC自动处理突发 } }5.2 突发写性能实测对比在相同硬件STM32F103ZET6 ILI9325 3.2寸屏下测试写入方式单帧耗时CPU占用率备注传统单字写320ms100%每次写需重发地址数据FSMC突发写108ms42%地址自动递增减少总线事务DMAFSMC突发85ms15%需额外配置DMA2_Channel7驱动中未集成提示突发写对DATAST参数更敏感。实测DATAST4时突发写100%成功但DATAST3下突发写第12000个像素后开始丢数据——这是因为突发模式下FSMC内部状态机对时序余量要求更高。5.3 安全边界突发写下的Gamma校准保护启用突发写后0x0030~0x003F的Gamma寄存器不可用突发方式写入原因Gamma寄存器是离散配置项非连续地址空间突发写会导致地址越界误写其他寄存器。驱动中ILI9325_LoadGamma()函数强制使用单字写并在每次写入后插入Delay_us(10)确保ILI9325内部Gamma RAM稳定更新。从那以后我每次做FSMC外设驱动第一件事就是用逻辑分析仪抓NWE和D0-D15波形对照数据手册的时序图逐周期比对——不是信文档是信示波器。因为ILI9325这种老屏它的脾气全写在上升沿和下降沿的毫厘之间。希望帮到你。本文还有配套的精品资源点击获取
