立创开发板技术文档中心

1.13 3.5 寸 ILI9488 彩色触摸屏

1.13.1 模块来源

采购链接：
2.2 寸/2.4/2.8/3.2/3.5/4.0 寸 TFT 触摸彩色 SPI 串口液晶屏显示模块

资料下载链接：
http://www.lcdwiki.com/zh/3.5inch_SPI_Module_ILI9488_SKU:MSP3520

1.13.2 规格参数

工作电压： 3.3V

工作电流： 20MA

模块尺寸： 56.34(H) x 98.00(W)

像素大小： 320(H) x 480(V)RGB

驱动芯片： ILI9488

通信协议： SPI

使用管脚数量：14 Pin（2.54mm 间距排针）

1.13.3 移植过程

我们的目标是将例程移植至梁山派 GD32F470 上。按照以下步骤，即可完成移植。

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

1.13.3.1 查看资料

打开厂家资料例程。具体路径见 图 1.12.3.1 例程路径

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

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

1.13.3.2 移植至工程

将厂家资料路径下的关于 LCD 底层的代码，复制到自己的工程中。一共有两次复制。并且自己的工程至少需要有微秒级延时函数。

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

选择导入复制过来的文件夹里面的全部.c 文件。

导入完成后，工程目录下会出现新导入的文件。（原工程目录见图 1.12.3.5 C 文件导入步骤）

添加.h 路径

在弹出的路径窗口，选择添加新路径

选择 Hardware 的路径，我们的.h 就在里面。因为是选择导入路径，所以不会显示该文件夹下有什么文件。

添加完成

尝试编译，发现有错误。错误内容为找不到 sys.h 这个文件。

sys.h 的内容主要是位带操作部分，这里提供给 GD32F450/GD32F470 的位带操作文件给大家。

将 sys.h 文件复制到工程的 User 目录下。

修改后编译发现更多的错误，错误内容分别为标识符“u8”、“u16”、“u32”未定义和找不到 delay.h 这个文件。

分别在 lcd.h、touch.h 和 spi.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

在源代码中使用 delay.h 的主要作用是给屏幕初始化时提供一定的延时，确保初始化成功。主要使用的函数是 delay_ms，进行毫秒级延时。

将 test.c、lcd.c、touch.c 和 GUI.c 文件中的头文件 delay.h 改为自己的延时函数头文件，这里我使用的是 systick.h；再将文件中使用到的延时函数 delay_ms 替换为自己的毫秒级延时，这里替换为 delay_1ms。

#include "systick.h"
#define  delay_ms  delay_1ms

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

1.13.3.3 引脚选择

该屏幕需要设置 14 个接口，具体接口说明见厂家资料屏幕规格书。

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

表 1.13.3.2 屏幕接线

选择好引脚后，进入工程开始编写屏幕引脚初始化代码。

为了方便后续移植，我在 lcd.h 处宏定义了每一个引脚，后续根据需要进行修改即可。

cpp

//-----------------LCD端口移植----------------
//VCC - 3.3V
//SCL - PB13 SPI1_SCK
//SDA - PB15 SPI1_MOSI
//RES - PD0(可以接入复位)
//DC  - PC6
//CS  - PB12        SPI1_NSS
//BLK - PC7- TIMER7_CH0
#define RCU_LCD_SCL     RCU_GPIOB//SCK
#define PORT_LCD_SCL    GPIOB
#define GPIO_LCD_SCL    GPIO_PIN_13

#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_GPIOC //DC
#define PORT_LCD_DC     GPIOC
#define GPIO_LCD_DC     GPIO_PIN_6

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

#define RCU_LCD_BLK     RCU_GPIOC//BLK/LED
#define PORT_LCD_BLK    GPIOC
#define GPIO_LCD_BLK    GPIO_PIN_7

#define RCU_LCD_CS2      RCU_GPIOG//CS2/T_CS
#define PORT_LCD_CS2     GPIOG
#define GPIO_LCD_CS2     GPIO_PIN_6

#define RCU_LCD_PEN      RCU_GPIOG //PEN/T_IRQ
#define PORT_LCD_PEN     GPIOG
#define GPIO_LCD_PEN     GPIO_PIN_7

#define RCU_LCD_TCLK      RCU_GPIOD //T_CLK
#define PORT_LCD_TCLK     GPIOD
#define GPIO_LCD_TCLK     GPIO_PIN_1

#define RCU_LCD_TDIN      RCU_GPIOD //T_DIN
#define PORT_LCD_TDIN     GPIOD
#define GPIO_LCD_TDIN     GPIO_PIN_5

#define RCU_LCD_TD0       RCU_GPIOD //T_DO
#define PORT_LCD_TD0      GPIOD
#define GPIO_LCD_TD0      GPIO_PIN_4

#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_2;//2分频
    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.13.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 接口的宏，这里我们将其注释，使用我们自己的方式。

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

1.13.4 移植验证

在 main.c 中输入代码如下

/********************************************************************************
  * 文 件 名: main.c
  * 版 本 号: 初版
  * 修改作者: LC
  * 修改日期: 2022年06月7日
  * 功能介绍:
  ******************************************************************************
  * 开发板官网：www.lckfb.com
*********************************************************************************/

#include "gd32f4xx.h"
#include "systick.h"
#include "Lcd.h"
#include "gui.h"
#include "test.h"
#include "spi.h"
#include "bsp_usart.h"
#include "touch.h"

int main(void)
{
    float t = 0;
        nvic_priority_group_set(NVIC_PRIGROUP_PRE2_SUB2);  // 优先级分组
        systick_config();//滴答定时器初始化 1ms


    usart_gpio_config(115200);

    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();                //触摸屏手写测试
    }
}

上电效果

移植成功案例

入门教程资料

模块移植手册

显示类

传感器类

实战项目资料

训练营活动

电赛项目资料

1.13 3.5 寸 ILI9488 彩色触摸屏

1.13.1 模块来源

1.13.2 规格参数

1.13.3 移植过程

1.13.3.1 查看资料

1.13.3.2 移植至工程

1.13.3.3 引脚选择

1.13.4 移植验证

显示类

传感器类

1.13 3.5 寸 ILI9488 彩色触摸屏 ​

1.13.1 模块来源 ​

1.13.2 规格参数 ​

1.13.3 移植过程 ​

1.13.3.1 查看资料 ​

1.13.3.2 移植至工程 ​

1.13.3.3 引脚选择 ​

1.13.4 移植验证 ​

1.13 3.5 寸 ILI9488 彩色触摸屏

1.13.1 模块来源

1.13.2 规格参数

1.13.3 移植过程

1.13.3.1 查看资料

1.13.3.2 移植至工程

1.13.3.3 引脚选择

1.13.4 移植验证