3.5寸ILI9488彩色触摸屏

模块来源

采购链接：
https://item.taobao.com/item.htm?spm=a1z09.2.0.0.38d22e8dm6PlFb&id=38842179442&_u=62t4uge57f1d

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

规格参数

工作电压：3.3V
工作电流：20MA
模块尺寸：56.34(H) x 98.00(W)
像素大小：320(H) x 480(V)RGB
驱动芯片：ILI9488
通信协议：SPI
使用管脚数量：14 Pin（2.54mm间距排针）

移植过程

我们的目标是将例程移植至立创开发板GD32E230C8T6上。按照以下步骤，即可完成移植。

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

查看资料

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

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

移植至工程

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

我们打开工程，将C文件加入到工程目录。

1. LCD文件夹中的C文件

2. SPI文件夹中的C文件

3. TOUCH文件夹中的C文件

4. Hardware文件夹下的两个C文件

然后我们添加h文件的路径到工程

这样我们就将LCD文件夹路径添加到工程了。

接下来我们只需要依次将SPI文件夹和TOUCH文件夹路径添加到工程中，像上面的步骤一样。

这样几个文件夹都添加好了，

我们发现上面有一个Hardware文件夹的路径，我们并没有添加，为什么会出现呢，因为空白工程中给大家提供的工程中就添加好了。所以我们不用再添加Hardware文件夹路径到工程了。

接下来我们将各个文件中包含头文件语句换成下面的，根据注释，找到符合的直接替换掉。

// main.c文件
#include "gd32e23x.h"
#include "systick.h"
#include <stdio.h>
#include "Lcd.h"
#include "gui.h"
#include "test.h"
#include "spi.h"
#include "bsp_usart.h"
#include "touch.h"


// test.c文件
#include "lcd.h"
#include "gui.h"
#include "systick.h"
#include "test.h"
#include "touch.h"
#include "led.h"
#include "pic.h"


// lcd.c文件
#include "lcd.h"
#include "stdlib.h"
#include "systick.h"
#include "spi.h"

// SPI.c文件
#include "spi.h"


//touch.c文件
#include "touch.h"
#include "lcd.h"
#include "systick.h"
#include "stdlib.h"
#include "math.h"
#include "gui.h"


// GUI.c文件
#include "lcd.h"
#include "string.h"
#include "font.h"
#include "systick.h"
#include "gui.h"

// lcd.h文件
#include "gd32e23x.h"
#include "systick.h"
#include "stdlib.h"

// gui.h文件
#include "gd32e23x.h"
#include "systick.h"

// test.h文件
#include "gd32e23x.h"
#include "systick.h"

// touch.h文件
#include "gd32e23x.h"
#include "systick.h"

// spi.h文件
#include "gd32e23x.h"
#include "systick.h"

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

#ifndef u8
#define u8 uint8_t
#endif

#ifndef u16
#define u16 uint16_t
#endif

#ifndef u32
#define u32 uint32_t
#endif

引脚选择

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

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

//-----------------LCD端口移植----------------
//VCC - 3.3V
//SCL - PA5
//SDA - PA7
//RES - PC13(可以接入复位)
//DC  - PC14
//CS  - PA4
//BLK - PC15
#define RCU_LCD_SCL     RCU_GPIOA//SCK     #######
#define PORT_LCD_SCL    GPIOA
#define GPIO_LCD_SCL    GPIO_PIN_5

#define RCU_LCD_SDA     RCU_GPIOA//MOSI    ########
#define PORT_LCD_SDA    GPIOA
#define GPIO_LCD_SDA    GPIO_PIN_7

#define RCU_LCD_MIS     RCU_GPIOA//MIS0    #########
#define PORT_LCD_MIS    GPIOA
#define GPIO_LCD_MIS    GPIO_PIN_6

#define RCU_LCD_CS      RCU_GPIOA//NSS     ##########
#define PORT_LCD_CS     GPIOA
#define GPIO_LCD_CS     GPIO_PIN_4

#define RCU_LCD_DC      RCU_GPIOC //DC
#define PORT_LCD_DC     GPIOC
#define GPIO_LCD_DC     GPIO_PIN_14

#define RCU_LCD_RES     RCU_GPIOC//RES
#define PORT_LCD_RES    GPIOC
#define GPIO_LCD_RES    GPIO_PIN_13

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

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

#define RCU_LCD_PEN      RCU_GPIOB //PEN/T_IRQ
#define PORT_LCD_PEN     GPIOB
#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_0

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

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

#define RCU_SPI_HARDWARE RCU_SPI0
#define PORT_SPI         SPI0
#define LINE_AF_SPI      GPIO_AF_0

将 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接口的宏，这里我们将其注释，使用我们自己的方式。

我们打开touch.h文件，修改语句。
修改前：

修改后：

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

#define PEN        gpio_input_bit_get(PORT_LCD_PEN,  GPIO_LCD_PEN)              //T_PEN
#define DOUT       gpio_input_bit_get(PORT_LCD_MIS, GPIO_LCD_MIS)               //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

打开 test.c 文件，将 void Touch_Test(void) 函数改为这样：

void Touch_Test(void)
{
        u8 key;
        u16 i=0;
        u16 j=0;
        u16 colorTemp=0;
        TP_Init();
//        KEY_Init();
//        LED_Init();
        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)
        {
//                 key=KEY_Scan(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_1ms(10);
                                }

                                else TP_Draw_Big_Point(tp_dev.x,tp_dev.y,POINT_COLOR);                //画图
                        }
                }else delay_1ms(10);        //没有按键按下的时候
                if(1)        //KEY_RIGHT按下,则执行校准程序
                {

                        LCD_Clear(WHITE);//清屏
                    TP_Adjust();  //屏幕校准
//                        TP_Save_Adjdata();
                        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);
                }
                i++;
                if(i==30)
                {
                        i=0;
//                        LED0=!LED0;
                        //break;
                }
        }
}

打开touch.c文件，将u8 TP_Init(void)函数改为下面的代码：

u8 TP_Init(void)
{
    rcu_periph_clock_enable(RCU_GPIOA);
    rcu_periph_clock_enable(RCU_GPIOB);
        rcu_periph_clock_enable(RCU_GPIOC);

       /* PEN */
    gpio_mode_set(PORT_LCD_PEN,GPIO_MODE_INPUT,GPIO_PUPD_NONE,GPIO_LCD_PEN);
       /* DOUT*/
    gpio_mode_set(PORT_LCD_TD0,GPIO_MODE_INPUT,GPIO_PUPD_NONE,GPIO_LCD_TD0);
       /* 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_50MHZ,GPIO_LCD_TDIN);
    gpio_bit_write(PORT_LCD_TDIN, GPIO_LCD_TDIN, SET);

     /* 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_50MHZ,GPIO_LCD_TCLK);
    gpio_bit_write(PORT_LCD_TCLK, GPIO_LCD_TCLK, SET);

     /* TCS*/
    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_50MHZ,GPIO_LCD_CS2);
    gpio_bit_write(PORT_LCD_CS2, GPIO_LCD_CS2, SET);

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

        return 1;
}

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

移植验证

在main.c中输入代码如下

 /******************************************************************************
   * 测试硬件：立创开发板·GD32E230C8T6    使用主频72Mhz    晶振8Mhz
   * 版 本 号: V1.0
   * 修改作者: www.lckfb.com
   * 修改日期: 2023年11月02日
   * 功能介绍:
   *****************************************************************************
   * 梁山派软硬件资料与相关扩展板软硬件资料官网全部开源
   * 开发板官网：www.lckfb.com
   * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
   * 立创论坛：club.szlcsc.com
   * 其余模块移植手册：【立创·GD32E230C8T6开发板】模块移植手册
   * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
   * 不靠卖板赚钱，以培养中国工程师为己任
  ******************************************************************************/
#include "gd32e23x.h"
#include "systick.h"
#include <stdio.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;
    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();           //触摸屏手写测试
    }
}

上电效果

文件下载

📌 资料下载中心（点击跳转）

📌 在 资料下载中心->【模块移植手册资料下载】 里面的本章节压缩包中。