手把手教你用STM32F103ZET6的SPI点亮2.4寸TFT屏（附ILI9341初始化代码避坑指南）

STM32F103ZET6 SPI驱动ILI9341 TFT屏实战全解析第一次拿到2.4寸TFT屏时看着五颜六色的排线我完全不知道从何下手。屏幕背面印着ILI9341的型号标识网上搜到的资料又零散不全。经过三天调试当屏幕终于显示出清晰的图像时那种成就感至今难忘。本文将分享从硬件连接到软件调试的全过程经验特别是那些容易踩坑的细节。1. 硬件连接与SPI配置1.1 引脚定义与物理连接ILI9341驱动的2.4寸TFT屏通常采用20pin排线接口关键信号线包括屏引脚STM32F103ZET6连接备注VCC3.3V电源正极GNDGND电源地CSPB11片选信号RESETPB12复位信号DC/RSPB10数据/命令选择SDAPB15(MOSI)SPI数据线SCLPB13(SCK)SPI时钟线LEDPB9背光控制常见接线错误将MOSI和MISO接反TFT屏通常不需要MISO忘记连接复位线导致屏幕无法初始化背光LED直接接3.3V导致无法关闭背光1.2 SPI外设初始化STM32F103的SPI2外设位于PB13~PB15引脚初始化配置如下void SPI2_Init(void) { SPI_InitTypeDef SPI_InitStructure; GPIO_InitTypeDef GPIO_InitStructure; // 使能时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB|RCC_APB2Periph_AFIO, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_SPI2, ENABLE); // 配置SPI引脚 GPIO_InitStructure.GPIO_Pin GPIO_Pin_13 | GPIO_Pin_15; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; // 复用推挽输出 GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOB, GPIO_InitStructure); // SPI参数配置 SPI_InitStructure.SPI_Direction SPI_Direction_1Line_Tx; // 单线发送模式 SPI_InitStructure.SPI_Mode SPI_Mode_Master; // 主机模式 SPI_InitStructure.SPI_DataSize SPI_DataSize_8b; // 8位数据 SPI_InitStructure.SPI_CPOL SPI_CPOL_Low; // 时钟极性 SPI_InitStructure.SPI_CPHA SPI_CPHA_1Edge; // 时钟相位 SPI_InitStructure.SPI_NSS SPI_NSS_Soft; // 软件控制NSS SPI_InitStructure.SPI_BaudRatePrescaler SPI_BaudRatePrescaler_4; // 18MHz SPI_InitStructure.SPI_FirstBit SPI_FirstBit_MSB;// 高位在前 SPI_Init(SPI2, SPI_InitStructure); SPI_Cmd(SPI2, ENABLE); }注意SPI时钟不宜过高初期调试建议设置为系统时钟的1/418MHz稳定后可逐步提高。2. ILI9341初始化序列详解2.1 关键寄存器配置ILI9341有数十个配置寄存器以下几个最为关键0x36 - 内存访问控制控制显示方向、颜色顺序等典型值0x48竖屏BGR顺序0x3A - 像素格式设置16位0x55或18位0x66颜色模式TFT屏通常使用16位RGB565格式0xB1 - 帧率控制设置刷新率影响显示流畅度典型值0x00, 0x1B约70Hz0xC0/C1 - 电源控制配置内部电压调节器需要严格按照数据手册顺序设置2.2 初始化代码优化原始初始化序列往往包含大量冗余设置经测试可简化为void LCD_Init(void) { LCD_Reset(); // 硬件复位 // 精简后的初始化序列 LCD_WR_REG(0xCF); LCD_WR_DATA(0x00); LCD_WR_DATA(0xC1); LCD_WR_DATA(0X30); LCD_WR_REG(0xED); LCD_WR_DATA(0x64); LCD_WR_DATA(0x03); LCD_WR_DATA(0X12); LCD_WR_DATA(0X81); LCD_WR_REG(0xE8); LCD_WR_DATA(0x85); LCD_WR_DATA(0x00); LCD_WR_DATA(0x78); LCD_WR_REG(0xCB); LCD_WR_DATA(0x39); LCD_WR_DATA(0x2C); LCD_WR_DATA(0x00); LCD_WR_DATA(0x34); LCD_WR_DATA(0x02); LCD_WR_REG(0xF7); LCD_WR_DATA(0x20); LCD_WR_REG(0xEA); LCD_WR_DATA(0x00); LCD_WR_DATA(0x00); // 电源控制 LCD_WR_REG(0xC0); LCD_WR_DATA(0x1B); // VRH LCD_WR_REG(0xC1); LCD_WR_DATA(0x12); // SAP LCD_WR_REG(0xC5); LCD_WR_DATA(0x32); // VCM控制 LCD_WR_REG(0xC7); LCD_WR_DATA(0XC0); // 对比度 // 内存访问控制 LCD_WR_REG(0x36); LCD_WR_DATA(0x48); // 竖屏模式 LCD_WR_REG(0x3A); LCD_WR_DATA(0x55); // 16位像素 // 显示控制 LCD_WR_REG(0xB1); LCD_WR_DATA(0x00); LCD_WR_DATA(0x1B); // 帧率 LCD_WR_REG(0xB6); LCD_WR_DATA(0x0A); LCD_WR_DATA(0xA2); // 显示功能 // Gamma校正 static const u8 Gamma_Sequence[] { /* 省略具体数值 */ }; LCD_WR_REG(0xE0); for(u8 i0; i15; i) LCD_WR_DATA(Gamma_Sequence[i]); LCD_WR_REG(0xE1); for(u8 i0; i15; i) LCD_WR_DATA(Gamma_Sequence[i15]); LCD_WR_REG(0x11); // 退出睡眠 delay_ms(120); LCD_WR_REG(0x29); // 开启显示 }调试技巧如果屏幕出现花屏可尝试调整0x36寄存器的值特别是MY/MX/MV这三个方向控制位。3. 显示优化技巧3.1 双缓冲机制实现直接刷屏会导致明显的闪烁采用双缓冲可大幅改善// 定义显存 u16 frame_buffer[2][320*240]; u8 current_buffer 0; // 切换显示缓冲区 void LCD_SwitchBuffer(void) { LCD_SetWindows(0, 0, 239, 319); LCD_CS_CLR; LCD_RS_SET; for(u32 i0; i320*240; i) { SPI_WriteByte(SPI2, frame_buffer[current_buffer][i]8); SPI_WriteByte(SPI2, frame_buffer[current_buffer][i]0xFF); } LCD_CS_SET; current_buffer ^ 1; // 切换缓冲区 }3.2 局部刷新优化全屏刷新耗时长针对动态区域可局部更新void LCD_UpdateRegion(u16 x1, u16 y1, u16 x2, u16 y2) { LCD_SetWindows(x1, y1, x2, y2); LCD_CS_CLR; LCD_RS_SET; u16 width x2 - x1 1; u16 height y2 - y1 1; for(u16 y0; yheight; y) { for(u16 x0; xwidth; x) { u16 color frame_buffer[current_buffer][(y1y)*320 (x1x)]; SPI_WriteByte(SPI2, color8); SPI_WriteByte(SPI2, color0xFF); } } LCD_CS_SET; }3.3 字体显示优化嵌入式系统常用点阵字体存储和渲染需特别处理// 字体结构定义 typedef struct { u8 width; // 字体宽度 u8 height; // 字体高度 u8 first_char;// 起始ASCII码 u8 char_num; // 字符数量 const u16 *data; // 字体数据 } FontType; // 显示一个字符 void LCD_ShowChar(u16 x, u16 y, u8 chr, FontType font, u16 color, u16 bgcolor) { u8 i,j; u8 temp; u16 x0 x; chr - font.first_char; const u16 *p font.data[chr * font.height]; for(i0; ifont.height; i) { temp *(pi); for(j0; jfont.width; j) { if(temp (1(font.width-1-j))) { LCD_DrawPoint(xj, yi, color); } else if(bgcolor ! color) { LCD_DrawPoint(xj, yi, bgcolor); } } } }4. 常见问题排查指南4.1 白屏问题分析当屏幕只亮背光无显示时按以下步骤排查检查电源测量VCC电压是否为3.3V确认GND连接可靠验证复位时序复位信号需保持低电平至少10ms复位后需延迟100ms再初始化SPI信号测试用逻辑分析仪抓取SPI波形确认CS、DC信号变化正常初始化序列确保发送了0x11(退出睡眠)和0x29(开启显示)检查0x36寄存器设置是否正确4.2 颜色异常处理颜色显示不正常时重点关注像素格式设置确认0x3A寄存器设置为0x55(16位接口)检查SPI数据是否为RGB565顺序内存访问控制0x36寄存器的BGR位决定颜色顺序典型设置0x48(竖屏BGR)Gamma校正不正确的Gamma值会导致颜色失真建议使用厂商提供的标准Gamma序列4.3 性能优化建议SPI时钟优化初期使用较低时钟(如18MHz)稳定后可逐步提高至36MHzDMA传输使用DMA可释放CPU资源配置示例void SPI2_DMA_Init(void) { DMA_InitTypeDef DMA_InitStructure; RCC_AHBPeriphClockCmd(RCC_AHBPeriph_DMA1, ENABLE); DMA_DeInit(DMA1_Channel5); DMA_InitStructure.DMA_PeripheralBaseAddr (u32)SPI2-DR; DMA_InitStructure.DMA_MemoryBaseAddr (u32)frame_buffer; DMA_InitStructure.DMA_DIR DMA_DIR_PeripheralDST; DMA_InitStructure.DMA_BufferSize 320*240; DMA_InitStructure.DMA_PeripheralInc DMA_PeripheralInc_Disable; DMA_InitStructure.DMA_MemoryInc DMA_MemoryInc_Enable; DMA_InitStructure.DMA_PeripheralDataSize DMA_PeripheralDataSize_HalfWord; DMA_InitStructure.DMA_MemoryDataSize DMA_MemoryDataSize_HalfWord; DMA_InitStructure.DMA_Mode DMA_Mode_Normal; DMA_InitStructure.DMA_Priority DMA_Priority_High; DMA_InitStructure.DMA_M2M DMA_M2M_Disable; DMA_Init(DMA1_Channel5, DMA_InitStructure); SPI_I2S_DMACmd(SPI2, SPI_I2S_DMAReq_Tx, ENABLE); }屏幕旋转优化修改0x36寄存器实现硬件旋转避免软件旋转带来的性能损耗调试ILI9341最耗时的部分是反复修改初始化参数。建议将初始化代码模块化通过宏定义快速切换不同配置。实际项目中我会先确保基本显示正常再逐步添加高级功能。