2.2寸ILI9225彩屏驱动移植实战：基于天空星GD32F407VET6的SPI接口配置详解

2.2寸ILI9225彩屏驱动移植实战基于天空星GD32F407VET6的SPI接口配置详解最近在做一个项目需要用到一块2.2寸的彩色液晶屏型号是ILI9225驱动的。网上找到了通用的例程但那是基于STM32的而我手头正好有一块天空星的GD32F407VET6开发板。相信很多朋友也遇到过类似情况——拿到一个外设模块但例程和你的主控芯片不匹配。今天我就把整个移植过程详细拆解一遍手把手教你如何把ILI9225的SPI彩屏驱动从通用例程移植到GD32F407平台上。这篇文章适合已经有一定嵌入式基础想学习具体外设驱动移植的朋友。跟着做下来你不仅能点亮这块屏幕更能掌握一套通用的驱动移植方法。1. 准备工作了解屏幕与开发板在动手写代码之前咱们得先搞清楚手头的“家伙事儿”是什么。这块2.2寸的屏幕核心是ILI9225驱动芯片通过SPI接口通信。它的基本参数如下参数规格工作电压3.3V工作电流约20mA屏幕尺寸42.46mm (宽) x 67.20mm (高)分辨率176 (水平) x 220 (垂直) RGB像素接口类型SPI (3线或4线)物理接口8 Pin 2.54mm间距排针我用的主控是天空星GD32F407VET6开发板它基于ARM Cortex-M4内核性能足够驱动这块小屏。GD32的库函数和STM32的HAL库风格类似但底层寄存器还是有些区别这也是移植时需要特别注意的地方。屏幕的厂家资料和例程可以在提供的链接里找到原始文章中有淘宝和网盘链接。例程是基于STM32F1系列写的我们的任务就是把它“翻译”成GD32F4能听懂的语言。2. 移植思路与步骤总览移植不是乱改得有章法。我的整体思路是这样的文件准备把厂家驱动文件拿到自己的GD32工程里。基础适配解决最明显的编译错误比如头文件、数据类型定义。硬件对接根据天空星开发板的实际引脚重新配置屏幕的GPIO和SPI。时序调通修改SPI通信的底层函数确保数据能正确发出去。功能验证写个简单的测试程序看看屏幕能不能正常显示。下面咱们就一步步来操作。3. 工程搭建与基础修改首先在你的GD32工程目录下比如Drivers或User文件夹新建一个LCD文件夹把厂家资料里的这些核心驱动文件复制进去Lcd_Driver.c/Lcd_Driver.h(最底层的屏幕读写驱动)GUI.c/GUI.h(上层图形绘制函数如画点、线、字符)Font.h(字库文件)接着把这些文件添加到你的MDK或IAR工程中。第一步修改头文件和类型定义厂家代码用的是STM32的库我们得换成GD32的。打开Lcd_Driver.h和GUI.h文件进行如下修改将#include stm32f10x.h替换为#include gd32f4xx.h。通常厂家例程会依赖一个delay.h我们需要替换为自己工程里的延时头文件比如board.h。在Lcd_Driver.h和GUI.h中确保有u8、u16、u32这些简洁的类型定义。如果没有就加上#include gd32f4xx.h #ifndef u8 #define u8 uint8_t #endif #ifndef u16 #define u16 uint16_t #endif #ifndef u32 #define u32 uint32_t #endif做完这几步先编译一下。可能会报很多错别慌这很正常主要是引脚和SPI函数还没适配。4. 硬件引脚配置让MCU“认识”屏幕这是移植的核心环节决定了你的屏幕接线是否正确。ILI9225屏幕有8个引脚但SPI通信主要用到其中几个。4.1 引脚功能与接线选择我们先搞清楚每个脚是干嘛的屏幕引脚名称功能说明VCC电源接3.3VGND地接地SCL时钟线SPI时钟信号接MCU的SCKSDA数据线SPI数据信号接MCU的MOSI (主机输出)RES复位屏幕硬件复位低电平有效DC数据/命令选择高电平传输的是数据低电平传输的是命令CS片选低电平选中屏幕开始通信BLK背光控制控制背光开关高电平点亮我们使用硬件SPI但采用3线模式因为只向屏幕写数据不读取。所以必须用MCU上具有SPI复用功能的引脚来接SCL和SDA。其他引脚RES, DC, CS, BLK用普通GPIO模拟控制就行。查看GD32F407VET6的数据手册我选择了SPI1的复用引脚SCL (SPI1_SCK)-PB10SDA (SPI1_MOSI)-PC3其他控制引脚我分配如下你可以根据开发板布局和方便程度调整RES-PB13DC-PB12CS-PB15BLK-PC7你的实际接线一定要和代码里的定义保持一致4.2 代码中的引脚宏定义为了方便管理和修改我在Lcd_Driver.h文件里用宏定义来管理所有引脚。这是移植时非常好的习惯。//-----------------LCD端口移植---------------- //VCC - 3.3V //SCL - PB10 SPI1_SCK //SDA - PC3 SPI1_MOSI //RES - PB13(可以接入复位) //DC - PB12 //CS - PB15 //BLK - PC7 #define RCU_LCD_SCL RCU_GPIOB//SCK #define PORT_LCD_SCL GPIOB #define GPIO_LCD_SCL GPIO_PIN_10 #define RCU_LCD_SDA RCU_GPIOC//MOSI #define PORT_LCD_SDA GPIOC #define GPIO_LCD_SDA GPIO_PIN_3 #define RCU_LCD_CS RCU_GPIOB//NSS #define PORT_LCD_CS GPIOB #define GPIO_LCD_CS GPIO_PIN_15 #define RCU_LCD_DC RCU_GPIOB //DC #define PORT_LCD_DC GPIOB #define GPIO_LCD_DC GPIO_PIN_12 #define RCU_LCD_RES RCU_GPIOB//RES #define PORT_LCD_RES GPIOB #define GPIO_LCD_RES GPIO_PIN_13 #define RCU_LCD_BLK RCU_GPIOC//BLK #define PORT_LCD_BLK GPIOC #define GPIO_LCD_BLK GPIO_PIN_7 // SPI硬件相关定义 #define RCU_SPI_HARDWARE RCU_SPI1 #define PORT_SPI SPI1 #define LINE_AF_SPI GPIO_AF_54.3 GPIO初始化函数修改找到Lcd_Driver.c文件里的void LCD_GPIO_Init(void)函数。原函数可能是针对STM32的我们需要重写为GD32的库函数风格。GD32的GPIO配置分两步先设置模式再设置输出选项。对于SCL和SDA我们稍后会在SPI初始化里配置为复用功能这里先按普通输出初始化也没问题。但更清晰的做法是这个函数只初始化用GPIO模拟控制的引脚RES, DC, CS, BLK。不过原例程可能把所有引脚初始化都放在这里了我们根据找到的代码进行修改。根据原始内容修改后的函数如下。它使能了所有引脚的时钟并将它们都初始化为推挽输出模式。注意SCL和SDA的复用功能配置是在接下来的SPI初始化函数里完成的。void LCD_GPIO_Init(void) { /* 使能所有GPIO时钟 */ rcu_periph_clock_enable(RCU_LCD_SCL); rcu_periph_clock_enable(RCU_LCD_SDA); rcu_periph_clock_enable(RCU_LCD_CS); rcu_periph_clock_enable(RCU_LCD_DC); rcu_periph_clock_enable(RCU_LCD_RES); rcu_periph_clock_enable(RCU_LCD_BLK); /* 配置SCL (先作为普通输出SPI初始化时会覆盖) */ gpio_mode_set(PORT_LCD_SCL, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_SCL); gpio_output_options_set(PORT_LCD_SCL, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_SCL); gpio_bit_write(PORT_LCD_SCL, GPIO_LCD_SCL, SET); /* 配置SDA (先作为普通输出SPI初始化时会覆盖) */ gpio_mode_set(PORT_LCD_SDA, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_SDA); gpio_output_options_set(PORT_LCD_SDA, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_SDA); gpio_bit_write(PORT_LCD_SDA, GPIO_LCD_SDA, SET); /* 配置DC */ gpio_mode_set(PORT_LCD_DC, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_DC); gpio_output_options_set(PORT_LCD_DC, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_DC); gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, SET); /* 配置CS */ gpio_mode_set(PORT_LCD_CS, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_CS); gpio_output_options_set(PORT_LCD_CS, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_CS); gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, SET); /* 配置RES */ gpio_mode_set(PORT_LCD_RES, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_RES); gpio_output_options_set(PORT_LCD_RES, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_RES); gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, SET); /* 配置BLK */ gpio_mode_set(PORT_LCD_BLK, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_BLK); gpio_output_options_set(PORT_LCD_BLK, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_BLK); gpio_bit_write(PORT_LCD_BLK, GPIO_LCD_BLK, SET); }4.4 控制引脚宏定义修改在Lcd_Driver.h中通常会有一些宏来快速控制引脚高低电平比如拉高/拉低CS片选信号。我们需要把这些宏改成GD32的写法。//液晶控制口置1操作语句宏定义 #define LCD_CS_SET gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, SET) #define LCD_RS_SET gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, SET) #define LCD_SDA_SET gpio_bit_write(PORT_LCD_SDA, GPIO_LCD_SDA, SET) #define LCD_SCL_SET gpio_bit_write(PORT_LCD_SCL, GPIO_LCD_SCL, SET) #define LCD_RST_SET gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, SET) #define LCD_LED_SET gpio_bit_write(PORT_LCD_BLK, GPIO_LCD_BLK, SET) //液晶控制口置0操作语句宏定义 #define LCD_CS_CLR gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, RESET)//CS #define LCD_RS_CLR gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, RESET)//DC #define LCD_SDA_CLR gpio_bit_write(PORT_LCD_SDA, GPIO_LCD_SDA, RESET)//SDAMOSI #define LCD_SCL_CLR gpio_bit_write(PORT_LCD_SCL, GPIO_LCD_SCL, RESET)//SCLSCLK #define LCD_RST_CLR gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, RESET)//RES #define LCD_LED_CLR gpio_bit_write(PORT_LCD_BLK, GPIO_LCD_BLK, RESET)注意这里的RS就是前面说的DC引脚只是命名不同功能一样。5. SPI驱动层修改打通数据通道引脚配置好了接下来就是重头戏修改SPI通信的底层函数。这是屏幕能否正常工作的关键。5.1 SPI字节发送函数找到Lcd_Driver.c中的u8 SPI_WriteByte(SPI_TypeDef* SPIx, u8 Byte)函数。这个函数负责通过SPI发送一个字节数据。在GD32中我们使用固定的SPI1所以可以简化参数。同时要改用GD32的SPI库函数。u8 SPI_WriteByte(u8 Byte) { // 等待发送缓冲区为空 while(RESET spi_i2s_flag_get(PORT_SPI, SPI_FLAG_TBE)); // 写入要发送的数据 spi_i2s_data_transmit(PORT_SPI, Byte); // 等待接收缓冲区非空发送完成 while(RESET spi_i2s_flag_get(PORT_SPI, SPI_FLAG_RBNE)); // 读取接收到的数据全双工通信即使我们不关心接收的数据 u8 data spi_i2s_data_receive(PORT_SPI); return data; }因为修改了函数参数去掉了SPIx所以要在整个工程里搜索SPI_WriteByte的调用把传入的SPI参数去掉只保留一个字节数据参数。5.2 SPI外设初始化这是最关键的一步配置SPI1的工作模式。找到Lcd_Driver.c中的void SPI2_Init(void)函数可能原函数名是SPI2但我们现在用SPI1。我们需要将其完全重写为GD32的初始化流程。void SPI2_Init(void) // 函数名可以保留但实际初始化的是SPI1 { spi_parameter_struct spi_init_struct; /* 开启所有相关GPIO时钟 */ rcu_periph_clock_enable(RCU_LCD_SCL); rcu_periph_clock_enable(RCU_LCD_SDA); rcu_periph_clock_enable(RCU_LCD_CS); rcu_periph_clock_enable(RCU_LCD_DC); rcu_periph_clock_enable(RCU_LCD_RES); rcu_periph_clock_enable(RCU_LCD_BLK); /* 使能SPI1时钟 */ rcu_periph_clock_enable(RCU_SPI_HARDWARE); // 即RCU_SPI1 /* 配置 SPI的SCK (PB10) 为复用功能 */ gpio_af_set(PORT_LCD_SCL, LINE_AF_SPI, GPIO_LCD_SCL); // 选择AF5 gpio_mode_set(PORT_LCD_SCL, GPIO_MODE_AF, GPIO_PUPD_NONE, GPIO_LCD_SCL); gpio_output_options_set(PORT_LCD_SCL, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_SCL); /* 配置 SPI的MOSI (PC3) 为复用功能 */ gpio_af_set(PORT_LCD_SDA, LINE_AF_SPI, GPIO_LCD_SDA); // 选择AF5 gpio_mode_set(PORT_LCD_SDA, GPIO_MODE_AF, GPIO_PUPD_NONE, GPIO_LCD_SDA); gpio_output_options_set(PORT_LCD_SDA, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_SDA); /* 配置DC、RES、BLK、CS为普通输出 (这部分和LCD_GPIO_Init重复可酌情删减) */ gpio_mode_set(PORT_LCD_DC, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_DC); gpio_output_options_set(PORT_LCD_DC, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_DC); gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, SET); gpio_mode_set(PORT_LCD_RES, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_RES); gpio_output_options_set(PORT_LCD_RES, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_RES); gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, SET); gpio_mode_set(PORT_LCD_BLK, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_BLK); gpio_output_options_set(PORT_LCD_BLK, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_BLK); gpio_bit_write(PORT_LCD_BLK, GPIO_LCD_BLK, SET); gpio_mode_set(PORT_LCD_CS, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO_LCD_CS); gpio_output_options_set(PORT_LCD_CS, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_CS); gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, SET); /* 配置 SPI 参数 */ spi_struct_para_init(spi_init_struct); // 初始化结构体 spi_init_struct.trans_mode SPI_TRANSMODE_FULLDUPLEX; // 全双工模式 spi_init_struct.device_mode SPI_MASTER; // 主机模式 spi_init_struct.frame_size SPI_FRAMESIZE_8BIT; // 8位数据帧 spi_init_struct.clock_polarity_phase SPI_CK_PL_HIGH_PH_2EDGE; // 时钟极性相位需根据屏幕手册调整 spi_init_struct.nss SPI_NSS_SOFT; // 软件控制NSS(CS) spi_init_struct.prescale SPI_PSC_4; // 4分频决定SPI速度 spi_init_struct.endian SPI_ENDIAN_MSB; // 高位先发送 spi_init(PORT_SPI, spi_init_struct); /* 使能 SPI */ spi_enable(PORT_SPI); }关键点解释clock_polarity_phase这是SPI的时钟模式CPOL和CPHA。SPI_CK_PL_HIGH_PH_2EDGE对应模式3时钟空闲时为高电平在第二个边沿采样。这个参数必须根据ILI9225数据手册的要求来设置如果屏幕没反应可以尝试修改这个值如SPI_CK_PL_LOW_PH_1EDGE模式0。prescale预分频决定SPI速度。SPI_PSC_4表示APB时钟4分频。如果屏幕通信不稳定有雪花点或错位可以尝试降低速度增大分频数如SPI_PSC_8。nss设置为软件控制因为我们用普通GPIOPB15来控制CS片选。5.3 上层函数的小修改根据原始文章提示还需要修改两个地方在GUI.c文件中找到void Gui_DrawFont_GBK16(u16 x, u16 y, u16 fc, u16 bc, u8 *s)函数将其内部一个数字参数改为3这通常与字体取模方式或显示方向有关具体需参考原注释。确保Font.h文件的编码格式为UTF-8否则中文字符可能显示乱码。用记事本或VS Code等编辑器另存为时选择UTF-8编码即可。6. 移植验证点亮屏幕所有代码修改完成后就可以写个主程序来测试了。在main.c中包含必要的头文件然后初始化屏幕并显示一些内容。#include board.h #include Lcd_Driver.h #include GUI.h int main(void) { // 系统初始化时钟、延时等 board_init(); // 设置中断优先级分组根据你的工程配置 nvic_priority_group_set(NVIC_PRIGROUP_PRE2_SUB2); // 初始化LCD Lcd_Init(); // 打开背光 LCD_LED_SET; // 清屏为灰色 Lcd_Clear(GRAY0); // 显示文字 Gui_DrawFont_GBK16(16, 10, GREEN, GRAY0, (uint8_t *)液晶测试程序); // 画一个按钮框并显示文字 DisplayButtonUp(15, 38, 113, 58); //x1,y1,x2,y2 Gui_DrawFont_GBK16(16, 40, YELLOW, GRAY0, (uint8_t *)颜色填充测试); DisplayButtonUp(15, 68, 113, 88); Gui_DrawFont_GBK16(16, 70, BLUE, GRAY0, (uint8_t *)文字显示测试); DisplayButtonUp(15, 98, 113, 118); Gui_DrawFont_GBK16(16, 100, RED, GRAY0, (uint8_t *)图片显示测试); Gui_DrawFont_GBK16(16, 140, RED, GRAY0, (uint8_t *)Welcome); while(1) { // 主循环 } }编译、下载程序到天空星开发板。如果一切顺利上电后你应该能看到屏幕上显示彩色的文字和方框。如果屏幕没反应别着急按这个顺序排查硬件检查确保屏幕的VCC接3.3VGND接地以及SCL、SDA、DC、CS、RES、BLK这6根线是否与代码定义严格对应且接触良好。背光确认BLK引脚是否设置为高电平LCD_LED_SET。复位时序检查Lcd_Init()函数中是否有正确的复位序列拉低RES延时再拉高。SPI模式与速度尝试修改spi_init_struct.clock_polarity_phase和spi_init_struct.prescale。这是最容易出问题的地方。逻辑分析仪如果有条件用逻辑分析仪抓一下SCL、SDA、DC、CS的波形看SPI数据是否正常发出时序是否符合ILI9225的要求。移植成功的那一刻看到屏幕亮起显示出自定义的界面那种成就感是非常棒的。这个过程虽然繁琐但几乎适用于任何SPI接口外设的驱动移植希望这篇详细的实战记录能帮你少走弯路。