STM32CubeMX与HAL库驱动ILI9341 SPI屏：从零搭建到图形界面实战

1. 环境准备与硬件连接第一次接触ILI9341 SPI屏幕时我对着密密麻麻的引脚有点发懵。这块2.4英寸的TFT屏其实接线并不复杂关键是要理清SPI通信的四大金刚SCK时钟、MOSI主机输出从机输入、CS片选和DC数据/命令选择。我的STM32F103C8T6最小系统板与屏幕连接时特别注意了电源引脚要接3.3V过高电压会直接烧毁屏幕。硬件连接建议SCK → PA5 (SPI1_CLK)MOSI → PA7 (SPI1_MOSI)CS → PA4 (自定义GPIO)DC → PA3 (自定义GPIO)RESET → PA2 (自定义GPIO)VCC → 3.3VGND → 共地实际调试中发现个坑如果屏幕背光不亮检查下BLK引脚是否接了上拉电阻。有次我忘记接10K上拉电阻屏幕死活不亮还以为硬件坏了折腾半天才发现是这个细节问题。2. STM32CubeMX配置详解打开CubeMX新建工程时建议直接选择Access to MCU Selector快速定位芯片型号。我习惯先用Clock Configuration配置好时钟树确保系统时钟不超过芯片最大频率STM32F103系列通常是72MHz。这里有个关键点SPI时钟频率要匹配屏幕规格ILI9341最高支持15MHz SPI时钟但实测10MHz更稳定。具体配置步骤在Pinout界面启用SPI1模式选择Full-Duplex Master将PA4、PA3、PA2配置为GPIO_Output分别对应CS/DC/RESET在Configuration标签页设置SPI参数Prescaler选择8分频系统时钟72MHz时得到9MHz SPI时钟CPOL选择LowCPHA选择1 Edge勾选Hardware NSS Signal为Disable遇到过最头疼的问题是SPI通信不稳定后来发现是GPIO速度设置不当。建议将SPI相关引脚速度设为Medium太高会导致信号振铃太低又会影响刷新率。3. HAL库驱动移植实战官方标准库驱动不能直接用在HAL库上需要做以下适配修改硬件抽象层改写// 原标准库GPIO操作替换为HAL库版本 #define LCD_CS_LOW() HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET) #define LCD_CS_HIGH() HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET) // SPI发送函数重写 void LCD_SPI_Send(uint8_t data) { HAL_SPI_Transmit(hspi1, data, 1, 100); }初始化时序调整void LCD_Reset(void) { HAL_GPIO_WritePin(GPIOA, GPIO_PIN_2, GPIO_PIN_RESET); HAL_Delay(100); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_2, GPIO_PIN_SET); HAL_Delay(100); // 发送初始化命令序列 LCD_Write_Cmd(0xCF); uint8_t init_data[] {0x00, 0xC1, 0x30}; LCD_Write_Data(init_data, 3); // ...其他初始化命令 }调试时发现HAL_Delay在72MHz主频下需要调整建议在stm32f1xx_hal_conf.h中修改#define HSE_VALUE ((uint32_t)8000000) // 根据实际晶振修改4. 基础显示功能实现完成驱动移植后先测试基础绘图函数。我封装了几个常用功能清屏函数优化void LCD_Clear(uint16_t color) { LCD_SetWindow(0, 0, LCD_WIDTH-1, LCD_HEIGHT-1); for(uint32_t i0; iLCD_WIDTH*LCD_HEIGHT; i) { LCD_Write_Data_16Bit(color); } }显示字符串的实用技巧void LCD_ShowString(uint16_t x, uint16_t y, const char *str, uint16_t fc, uint16_t bc) { while(*str) { if(x LCD_WIDTH-16) { // 自动换行 x 0; y 16; } LCD_ShowChar(x, y, *str, fc, bc); x 8; str; } }实测发现直接调用HAL_SPI_Transmit发送每个像素效率太低我改用DMA传输提升性能void LCD_Fill_DMA(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t *color) { uint32_t size (x2-x11)*(y2-y11); LCD_SetWindow(x1, y1, x2, y2); HAL_SPI_Transmit_DMA(hspi1, (uint8_t*)color, size*2); }5. 中文字库与图片显示显示中文需要外接字库或使用点阵取模。我推荐PCtoLCD2002这款免费工具配置要点字体宋体取模方式逐行式取模走向逆向低位在前输出格式C51格式实际项目中的字库处理方案// 在font.h中添加自定义汉字点阵 const uint8_t Font16x16_CN[] { /*中*/ 0x00,0x40,0x00,0x40,0x7F,0xFE,0x40,0x00, 0x40,0x00,0x5F,0xF0,0x40,0x10,0x40,0x10, // ...其他汉字点阵 }; // 显示函数优化 void LCD_ShowCNChar(uint16_t x, uint16_t y, uint8_t *font, uint16_t fc, uint16_t bc) { uint8_t i,j; uint16_t data; LCD_SetWindow(x, y, x15, y15); for(i0;i32;i) { data font[i]; for(j0;j8;j) { if(data 0x80) LCD_Write_Data_16Bit(fc); else LCD_Write_Data_16Bit(bc); data 1; } } }图片显示采用Img2Lcd工具取模注意图片尺寸不要超过屏幕分辨率240x320颜色模式选择RGB565保存为C数组格式显示优化技巧void LCD_ShowPicture_DMA(uint16_t x, uint16_t y, uint16_t width, uint16_t height, uint16_t *pic) { LCD_SetWindow(x, y, xwidth-1, yheight-1); HAL_SPI_Transmit_DMA(hspi1, (uint8_t*)pic, width*height*2); }6. 性能优化与常见问题调试过程中遇到的典型问题及解决方案屏幕花屏检查SPI时钟极性(CPOL)和相位(CPHA)设置确认Reset引脚时序符合规格书要求降低SPI时钟频率测试显示残影// 在初始化序列中添加以下命令 LCD_Write_Cmd(0xE0); // Gamma校正 uint8_t gamma[] {0x0F,0x1F,0x1C,0x0C...}; LCD_Write_Data(gamma, sizeof(gamma));刷新率优化方案使用双缓冲机制局部刷新代替全屏刷新开启SPI的CRC校验提高稳定性我的实测数据显示全屏刷新无DMA约15fps全屏刷新DMA约28fps局部刷新40x40区域可达60fps最后分享一个实用调试技巧在SPI初始化后添加硬件检测函数bool LCD_CheckConnection(void) { LCD_Write_Cmd(0xD3); // 读ID命令 uint8_t id[4]; LCD_Read_Data(id, 4); return (id[1] 0x93) (id[2] 0x41); // ILI9341的ID固定值 }