2.2寸ILI9225彩屏

模块来源

采购链接：
https://item.taobao.com/item.htm?spm=a21n57.1.0.0.5cb3523chlpcq5&id=38360709299&ns=1&abbucket=0
资料下载链接：
http://pan.baidu.com/s/1ntDixJz

规格参数

文件1.12.2.1 屏幕规格书工作电压：3.3V
工作电流：20MA
模块尺寸：67.20(H) x 42.46(W)
像素大小：176(H) x 220(V)RGB
驱动芯片：ILI9225
通信协议：SPI
使用管脚数量：8 Pin（2.54mm间距排针）

移植过程

我们的目标是将例程移植至天空星GD32F407上。按照以下步骤，即可完成移植。

将源码导入工程；
根据编译报错处进行粗改；
修改引脚配置；
修改时序配置；
移植验证。

查看资料

打开厂家资料例程（例程下载见模块来源）。具体路径见图1.12.3.1 例程路径

在QDTFT_demo.c文件发现对屏幕的初始化配置函数为 Lcd_Init(); ，该函数里包含了对屏幕引脚的配置、对屏幕显示方式的配置。

我们主要修改的是引脚的初始化与时序的修改。

移植至工程

将厂家资料路径下的关于LCD底层的代码，复制到自己的工程中。自己的工程至少需要有毫秒级延时函数。（工程可以参考 入门手册空白工程 ）

打开自己的工程，将我们刚刚复制过来的文件导入.c和.h文件。

将 stm32f10x.h 修改为 gd32f4xx.h
将 delay.h 修改为 board.h

分别在** Lcd_Driver.h** 与 GUI.h 文件中定义三个宏，u32、u16与u8。

#include "gd32f4xx.h"
#ifndef u8
#define u8 uint8_t
#endif

#ifndef u16
#define u16 uint16_t
#endif

#ifndef u32
#define u32 uint32_t
#endif

引脚选择

天空星的主控为GD32F407VET6，其带有3个SPI外设，可以通过简单的库函数调用，实现硬件SPI的通信。想要使用硬件SPI驱动屏幕，需要确定使用的引脚是否有SPI外设功能。可以通过数据手册【GD32F407xx_Datasheet_Rev2.7.pdf】进行查看。

在数据手册的第40页结尾，是关于GD32F407Vx系列芯片引脚的功能定义示意图。

当前使用的是硬件SPI接口，而屏幕我们只需要控制它，而不需要读取屏幕的数据，故使用的是3线的SPI，只使用到了时钟线SCK、主机输出从机输入线MOSI和软件控制的片选线NSS。而NSS我们使用的是软件控制，所以除了SCL(SCK)/SDA(MOSI)引脚需要使用硬件SPI功能的引脚外，其他引脚都可以使用开发板上其他的GPIO。 这里选择使用PB10/PC3的SPI复用功能。 其他对应接入的屏幕引脚请按照你的需要。这里选择的引脚见 表1.6.3.2 硬件SPI接线

该屏幕需要设置8个接口，具体接口说明见 表1.12.3.1 各引脚说明。

当前厂家源码使用的是软硬件SPI接口，SPI时序部分厂家已经完成，我们只需要将硬件SPI引脚时序和延时配置好即可。所以对应接入的屏幕引脚请按照你的需要。这里选择的引脚见 表1.12.3.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

#define RCU_SPI_HARDWARE RCU_SPI1
#define PORT_SPI         SPI1
#define LINE_AF_SPI      GPIO_AF_5

将 Lcd_Driver.c 源代码中的 void LCD_GPIO_Init(void) 修改为如下代码。

void LCD_GPIO_Init(void)
{
          /* 使能时钟 */
        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 */
        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 */
        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);

}

将 Lcd_Driver.h 中的 LCD端口定义 宏，修改为 图1.12.3.22样式 。

//液晶控制口置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)//SDA=MOSI
#define        LCD_SCL_CLR          gpio_bit_write(PORT_LCD_SCL, GPIO_LCD_SCL, RESET)//SCL=SCLK
#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)

在 Lcd_Driver.c 文件中，找到 u8 SPI_WriteByte(SPI_TypeDef* SPIx,u8 Byte) 函数，将其修改如下。

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;
}

这里因为我们修改了 u8 SPI_WriteByte(SPI_TypeDef* SPIx,u8 Byte) ，减少传入了一个参数SPIx，所以后面使用到该函数的地方，都减少一个参数传递。
在 Lcd_Driver.c 文件中，找到 void Lcd_WriteIndex(u8 Index) 和 void Lcd_WriteData(u8 Data) 函数，将其修改如下。

在 Lcd_Driver.c 文件中，找到 void SPI2_Init(void) 函数，将其修改为GD32的SPI初始化，将其修改如下。

void SPI2_Init(void)
{
    spi_parameter_struct spi_init_struct;
      /* 开启各引脚时钟 */
    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);
      /* 使能SPI */
    rcu_periph_clock_enable(RCU_SPI_HARDWARE);

      /* 配置 SPI的SCK GPIO */
    gpio_af_set(PORT_LCD_SCL, LINE_AF_SPI, GPIO_LCD_SCL);
    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);
    gpio_bit_set(PORT_LCD_SCL,GPIO_LCD_SCL);
      /* 配置 SPI的MOSI  GPIO */
    gpio_af_set(PORT_LCD_SDA, LINE_AF_SPI, GPIO_LCD_SDA);
    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);
    gpio_bit_set(PORT_LCD_SDA, GPIO_LCD_SDA);

       /* 配置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);
       /* 配置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);
       /* 配置CS */
    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_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;  // 软件cs
    spi_init_struct.prescale             = SPI_PSC_4;//4分频
    spi_init_struct.endian               = SPI_ENDIAN_MSB;
    spi_init(PORT_SPI, &spi_init_struct);

    /* 使能 SPI */
    spi_enable(PORT_SPI);
}

打开GUI.c文件找到void Gui_DrawFont_GBK16(u16 x, u16 y, u16 fc, u16 bc, u8 *s)；函数，将后面的一个数字改为3。

还有一步就是让Font.h文件变为utf-8编码方式的。

到这里就移植完成了，请移步到1.7.4节进行移植验证。

移植验证

在main.c中输入代码如下

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 立创论坛：club.szlcsc.com
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 * Change Logs:
 * Date           Author       Notes
 * 2023-11-02     LCKFB-yzh    first version
 */
#include "board.h"
#include "Lcd_Driver.h"
#include "GUI.h"

int main(void)
{
    board_init();
    nvic_priority_group_set(NVIC_PRIGROUP_PRE2_SUB2);  // 优先级分组

    Lcd_Init();
    LCD_LED_SET;//通过IO控制背光亮

    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); //x1,y1,x2,y2
    Gui_DrawFont_GBK16(16,70,BLUE,GRAY0,(uint8_t *)"文字显示测试");

    DisplayButtonUp(15,98,113,118); //x1,y1,x2,y2
    Gui_DrawFont_GBK16(16,100,RED,GRAY0,(uint8_t *)"图片显示测试");

    Gui_DrawFont_GBK16(16,140,RED,GRAY0, (uint8_t *)"Welcome");


    while(1)
    {

    }
}

上电的效果：

移植成功案例：

代码下载

链接在开发板介绍章节的资料下载！！

【标准库】模块移植手册

显示类

传感器类

无线通信类

控制类

显示类

传感器类

无线通信类

控制类

显示类

传感器类

无线通信类

控制类

2.2寸ILI9225彩屏

模块来源

规格参数

移植过程

查看资料

移植至工程

引脚选择

移植验证

2.2寸ILI9225彩屏 ​

模块来源 ​

规格参数 ​

移植过程 ​

查看资料 ​

移植至工程 ​

引脚选择 ​

移植验证 ​

2.2寸ILI9225彩屏

模块来源

规格参数

移植过程

查看资料

移植至工程

引脚选择

移植验证