2.8寸与3.2寸ILI9341彩屏

该案例适配了3.2寸ILI9341屏。

模块来源

采购链接： https://item.taobao.com/item.htm?spm=a230r.1.14.18.3a686fa6qABOu4&id=38842179442&ns=1&abbucket=7
资料下载链接：
http://www.lcdwiki.com/zh/2.8inch_SPI_Module_ILI9341_SKU:MSP2807

规格参数

工作电压：3.3V-5V
工作电流：90mA
模块尺寸：50.0(H) x 86(V) MM
像素大小：320(H) x 240(V)RGB
驱动芯片：ILI9341
通信协议：SPI

移植过程

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

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

查看资料

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

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

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

移植至工程

将厂家资料路径下的【LCD】、【SPI】、【TOUCH】文件夹和User文件夹下的GUI.c、GUI.h、test.c和test.h、pic.h，复制到自己的工程中。自己的工程至少需要有毫秒级延时函数。（工程可以参考文件1.15.3.2 空白工程下载）

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

把TOUCH文件夹的路径也添加下：

分别在touch.h、spi.h、gui.h 和 test.h 文件中定义三个宏，s32、u16与u8。

#ifndef u8
#define u8 uint8_t
#endif

#ifndef u16
#define u16 uint16_t
#endif

#ifndef s32
#define s32 uint32_t
#endif

这里需要注意，lcd.h中使用到的是u32类型，因此，我们需要改为u32.

在 gui.h 和 test.h 中记得要加入 #include "gd32f4xx.h"

将touch.c、lcd.c、GUI.c与test.c文件中的头文件delay.h改为自己的延时函数头文件，这里我使用的是board.h；

再编译发现只剩下LCD引脚初始化的内容报错，接下来我们要进行引脚选择。

引脚选择

该屏幕需要设置14个接口，具体接口说明见厂家资料屏幕规格书。
当前厂家源码使用的是软件SPI接口，SPI时序部分厂家已经完成，我们只需要将硬件SPI引脚时序和延时配置好即可。所以对应接入的屏幕引脚请按照你的需要。这里选择的引脚见表1.15.3.2 屏幕接线。

选择好引脚后，进入工程开始编写屏幕引脚初始化代码。
为了方便后续移植，我在 lcd.h 处宏定义了每一个引脚，后续根据需要进行修改即可。

//-----------------LCD端口移植----------------
//VCC - 3.3V
//SCL - PB10         SPI1_SCK
//SDA - PB15         SPI1_MOSI
//RES - PD9          (可以接入复位)
//DC  - PD8
//CS  - PB12          SPI1_NSS
//BLK - PD10
#define RCU_LCD_SCL     RCU_GPIOB//SCK
#define PORT_LCD_SCL    GPIOB
#define GPIO_LCD_SCL    GPIO_PIN_10

#define RCU_LCD_SDA     RCU_GPIOB//MOSI
#define PORT_LCD_SDA    GPIOB
#define GPIO_LCD_SDA    GPIO_PIN_15

#define RCU_LCD_MIS     RCU_GPIOB//MIS0
#define PORT_LCD_MIS    GPIOB
#define GPIO_LCD_MIS    GPIO_PIN_14

#define RCU_LCD_CS      RCU_GPIOB//NSS
#define PORT_LCD_CS     GPIOB
#define GPIO_LCD_CS     GPIO_PIN_12

#define RCU_LCD_DC      RCU_GPIOD //DC
#define PORT_LCD_DC     GPIOD
#define GPIO_LCD_DC     GPIO_PIN_8

#define RCU_LCD_RES     RCU_GPIOD//RES
#define PORT_LCD_RES    GPIOD
#define GPIO_LCD_RES    GPIO_PIN_9

#define RCU_LCD_BLK     RCU_GPIOD//BLK/LED
#define PORT_LCD_BLK    GPIOD
#define GPIO_LCD_BLK    GPIO_PIN_10

#define RCU_LCD_CS2      RCU_GPIOA//CS2/T_CS
#define PORT_LCD_CS2     GPIOA
#define GPIO_LCD_CS2     GPIO_PIN_4

#define RCU_LCD_PEN      RCU_GPIOA //PEN/T_IRQ
#define PORT_LCD_PEN     GPIOA
#define GPIO_LCD_PEN     GPIO_PIN_0

#define RCU_LCD_TCLK      RCU_GPIOA //T_CLK
#define PORT_LCD_TCLK     GPIOA
#define GPIO_LCD_TCLK     GPIO_PIN_5

#define RCU_LCD_TDIN      RCU_GPIOA //T_DIN
#define PORT_LCD_TDIN     GPIOA
#define GPIO_LCD_TDIN     GPIO_PIN_3

#define RCU_LCD_TD0       RCU_GPIOA //T_DO
#define PORT_LCD_TD0      GPIOA
#define GPIO_LCD_TD0      GPIO_PIN_1

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

将lcd.c源代码中的void LCD_GPIOInit(void)修改为如下代码。
代码中已经做了引脚SPI的适配，如果没有修改相关引脚，则将宏定义USE_HARDWARE_SPI 宏 为1即可。

void LCD_GPIOInit(void)
{
    #if USE_HARDWARE_SPI

    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_8;//8分频
    spi_init_struct.endian               = SPI_ENDIAN_MSB;
    spi_init(PORT_SPI, &spi_init_struct);


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


#else
              /* 使能时钟 */
        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);
#endif
}

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

//液晶控制口置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)

在 SPI.c 文件中，找到void SPIv_WriteData(unsigned char Data) 函数，将其修改如下。

void  SPIv_WriteData(unsigned char Data)
{
#if USE_HARDWARE_SPI
    while(RESET == spi_i2s_flag_get(PORT_SPI, SPI_FLAG_TBE));
    spi_i2s_data_transmit(PORT_SPI, Data);
    while(RESET == spi_i2s_flag_get(PORT_SPI, SPI_FLAG_RBNE));
    spi_i2s_data_receive(PORT_SPI);
#else
    unsigned char i=0;
        for(i=8;i>0;i--)
        {
          if(Data&0x80)
          LCD_SDA_SET; //输出数据
      else LCD_SDA_CLR;

      LCD_SCL_CLR;
      LCD_SCL_SET;
      Data<<=1;
        }
#endif
}

在spi.h中，厂家定义了关于SPI接口的宏，这里我们将其注释，使用我们自己的方式。并且加上头文件：lcd.h

将lcd.c中 void LCD_Init(void) 里的【LCD_LED=1;//点亮背光】换成为我们自己的点亮背光方式。

将touch.c里的 u8 TP_Init(void) 替换为以下代码。

u8 TP_Init(void)
{
        //T_CS
        rcu_periph_clock_enable(RCU_LCD_CS2);
        gpio_mode_set(PORT_LCD_CS2, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO_LCD_CS2);
        gpio_output_options_set(PORT_LCD_CS2, GPIO_OTYPE_PP, GPIO_OSPEED_MAX, GPIO_LCD_CS2);

        //TCLK
        rcu_periph_clock_enable(RCU_LCD_TCLK);
        gpio_mode_set(PORT_LCD_TCLK, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO_LCD_TCLK);
        gpio_output_options_set(PORT_LCD_TCLK, GPIO_OTYPE_PP, GPIO_OSPEED_MAX, GPIO_LCD_TCLK);

        //T_DIN
        rcu_periph_clock_enable(RCU_LCD_TDIN);
        gpio_mode_set(PORT_LCD_TDIN, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO_LCD_TDIN);
        gpio_output_options_set(PORT_LCD_TDIN, GPIO_OTYPE_PP, GPIO_OSPEED_MAX, GPIO_LCD_TDIN);

        //T_DO
        rcu_periph_clock_enable(RCU_LCD_TD0);
        gpio_mode_set(PORT_LCD_TD0, GPIO_MODE_INPUT, GPIO_PUPD_NONE, GPIO_LCD_TD0);

        //T_IRQ
        rcu_periph_clock_enable(RCU_LCD_PEN);
        gpio_mode_set(PORT_LCD_PEN, GPIO_MODE_INPUT, GPIO_PUPD_NONE, GPIO_LCD_PEN);

          TP_Read_XY(&tp_dev.x,&tp_dev.y);//第一次读取初始化

        return 1;
}

将touch.c里 void TP_Save_Adjdata(void) 、 u8 TP_Get_Adjdata(void) 注释。

在touch.c中的void TP_Adjust(void)里，找到TP_Save_Adjdata(); 和 TP_Get_Adjdata(); 进行注释。

将test.c中的 void Touch_Test(void) 修改如下：

void Touch_Test(void)
{
        u8 key;
        u16 i=0;
        u16 j=0;
        u16 colorTemp=0;
        TP_Init();

        LCD_Clear(WHITE);//清屏
        TP_Adjust();  //屏幕校准

        DrawTestPage("测试9:Touch(按KEY0校准)      ");
        LCD_ShowString(lcddev.width-24,0,16,"RST",1);//显示清屏区域
        POINT_COLOR=RED;
        LCD_Fill(lcddev.width-52,2,lcddev.width-50+20,18,RED);
                while(1)
        {
                tp_dev.scan(0);
                if(tp_dev.sta&TP_PRES_DOWN)                        //触摸屏被按下
                {
                         if(tp_dev.x<lcddev.width&&tp_dev.y<lcddev.height)
                        {
                                if(tp_dev.x>(lcddev.width-24)&&tp_dev.y<16)
                                {
                                        DrawTestPage("测试9:Touch(按KEY0校准)      ");//清除
                                        LCD_ShowString(lcddev.width-24,0,16,"RST",1);//显示清屏区域
                                        POINT_COLOR=colorTemp;
                                        LCD_Fill(lcddev.width-52,2,lcddev.width-50+20,18,POINT_COLOR);
                                }
                                else if((tp_dev.x>(lcddev.width-60)&&tp_dev.x<(lcddev.width-50+20))&&tp_dev.y<20)
                                {
                                LCD_Fill(lcddev.width-52,2,lcddev.width-50+20,18,ColorTab[]);
                                POINT_COLOR=ColorTab[];
                                colorTemp=POINT_COLOR;
                                delay_ms(10);
                                }

                                else TP_Draw_Big_Point(tp_dev.x,tp_dev.y,POINT_COLOR);                //画图
                        }
                }
                else
                {
                        delay_ms(10);        //没有按键按下的时候
                }
        }
}

打开touch.h文件修改下列代码

//与触摸屏芯片连接引脚
//与触摸屏芯片连接引脚

#define PEN       gpio_input_bit_get(PORT_LCD_PEN, GPIO_LCD_PEN)      //T_PEN
#define DOUT      gpio_input_bit_get(PORT_LCD_TD0, GPIO_LCD_TD0)      //T_MISO
#define TDIN(x)   gpio_bit_write(PORT_LCD_TDIN, GPIO_LCD_TDIN, x?1:0) //T_MOSI
#define TCLK(x)   gpio_bit_write(PORT_LCD_TCLK, GPIO_LCD_TCLK, x?1:0) //T_SCK
#define TCS(x)    gpio_bit_write(PORT_LCD_CS2, GPIO_LCD_CS2, x?1:0)   //T_CS

打开touch.c文件将里面 关于TDIN、TCLK、TCS的代码语句改为下列

TDIN = 1  -------改为------->    TDIN(1)
TDIN = 0  -------改为------->    TDIN(0)

TCLK = 1  -------改为------->    TCLK(1)
TCLK = 0  -------改为------->    TCLK(0)

TCS = 1   -------改为------->    TCS(1)
TCS = 0   -------改为------->    TCS(0)

到这里就移植完成了，请移步到移植验证。

移植验证

在main.c中输入代码如下

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

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

    LCD_Init();           //液晶屏初始化

    while(1)
    {
                main_test();        //测试主界面
                Test_Color();              //简单刷屏填充测试
                Test_FillRec();            //GUI矩形绘图测试
                Test_Circle();             //GUI画圆测试
                Test_Triangle();    //GUI三角形绘图测试
                English_Font_test();//英文字体示例测试
                Chinese_Font_test();//中文字体示例测试
                Pic_test();         //图片显示示例测试
                Rotate_Test();           //旋转显示测试

                /* 如果不带触摸，或者不需要触摸功能，请注释掉下面触摸屏测试项 */
                Touch_Test();       //触摸屏手写测试
    }
}

移植现象：

移植成功案例：

代码下载

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