简体中文

English

简体中文

English

外观

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间距排针）

移植过程 ​

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

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

查看资料 ​

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

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

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

移植至工程 ​

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

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

sys.h的内容主要是位带操作部分，sys.h文件内容在入门手册的位带操作章节。

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

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

c
#include "hc32_ll.h"
#ifndef u8
#define u8 uint8_t
#endif

#ifndef u16
#define u16 uint16_t
#endif

#ifndef u32
#define u32 uint32_t
#endif

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

引脚选择 ​

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

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

c
//-----------------LCD端口移植----------------
//VCC - 3.3V
//SCL - PB10
//SDA - PB15
//RES - PD12    (可以接入复位)
//DC  - PD11
//CS  - PB12
//BLK - PD10

//SCK
#define PORT_LCD_SCL    GPIO_PORT_B
#define GPIO_LCD_SCL    GPIO_PIN_10

//MOSI
#define PORT_LCD_SDA    GPIO_PORT_B
#define GPIO_LCD_SDA    GPIO_PIN_15

//MIS0
#define PORT_LCD_MIS    GPIO_PORT_B
#define GPIO_LCD_MIS    GPIO_PIN_14

//NSS
#define PORT_LCD_CS     GPIO_PORT_B
#define GPIO_LCD_CS     GPIO_PIN_12

//DC
#define PORT_LCD_DC     GPIO_PORT_D
#define GPIO_LCD_DC     GPIO_PIN_11

//RES
#define PORT_LCD_RES    GPIO_PORT_D
#define GPIO_LCD_RES    GPIO_PIN_12

//BLK/LED
#define PORT_LCD_BLK    GPIO_PORT_D
#define GPIO_LCD_BLK    GPIO_PIN_10

//CS2/T_CS
#define PORT_LCD_CS2    GPIO_PORT_B
#define GPIO_LCD_CS2    GPIO_PIN_7

 //PEN/T_IRQ
#define PORT_LCD_PEN    GPIO_PORT_B
#define GPIO_LCD_PEN    GPIO_PIN_4

//T_CLK
#define PORT_LCD_TCLK   GPIO_PORT_B
#define GPIO_LCD_TCLK   GPIO_PIN_8

//T_DIN
#define PORT_LCD_TDIN   GPIO_PORT_B
#define GPIO_LCD_TDIN   GPIO_PIN_6

//T_DO
#define PORT_LCD_TD0    GPIO_PORT_B
#define GPIO_LCD_TD0    GPIO_PIN_5

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

c
void LCD_GPIOInit(void)
{
    stc_gpio_init_t stcGpioInit; // 定义GPIO结构体

    // 关闭GPIO寄存器写保护
    LL_PERIPH_WE(LL_PERIPH_ALL);

    (void)GPIO_StructInit(&stcGpioInit);
    stcGpioInit.u16PinState = PIN_STAT_SET;
    stcGpioInit.u16PinDir = PIN_DIR_OUT; // 输出
    stcGpioInit.u16PullUp = PIN_PU_ON;   // 上拉开启

    // SCL
    (void)GPIO_Init(PORT_LCD_SCL, GPIO_LCD_SCL, &stcGpioInit);
    // SDA
    (void)GPIO_Init(PORT_LCD_SDA, GPIO_LCD_SDA, &stcGpioInit);
    // CS
    (void)GPIO_Init(PORT_LCD_CS, GPIO_LCD_CS, &stcGpioInit);
    // DC
    (void)GPIO_Init(PORT_LCD_DC, GPIO_LCD_DC, &stcGpioInit);
    // RES
    (void)GPIO_Init(PORT_LCD_RES, GPIO_LCD_RES, &stcGpioInit);
    // BLK
    (void)GPIO_Init(PORT_LCD_BLK, GPIO_LCD_BLK, &stcGpioInit);

}

将lcd.h中的 LCD端口定义 宏，修改为：

c
//液晶控制口置1操作语句宏定义
#define        LCD_CS_SET          GPIO_SetPins(PORT_LCD_CS, GPIO_LCD_CS)
#define        LCD_RS_SET          GPIO_SetPins(PORT_LCD_DC, GPIO_LCD_DC)
#define        LCD_SDA_SET         GPIO_SetPins(PORT_LCD_SDA, GPIO_LCD_SDA)
#define        LCD_SCL_SET         GPIO_SetPins(PORT_LCD_SCL, GPIO_LCD_SCL)
#define        LCD_RST_SET         GPIO_SetPins(PORT_LCD_RES, GPIO_LCD_RES)
#define        LCD_LED_SET         GPIO_SetPins(PORT_LCD_BLK, GPIO_LCD_BLK)

//液晶控制口置0操作语句宏定义
#define        LCD_CS_CLR          GPIO_ResetPins(PORT_LCD_CS, GPIO_LCD_CS)//CS
#define        LCD_RS_CLR          GPIO_ResetPins(PORT_LCD_DC, GPIO_LCD_DC)//DC
#define        LCD_SDA_CLR         GPIO_ResetPins(PORT_LCD_SDA, GPIO_LCD_SDA)//SDA=MOSI
#define        LCD_SCL_CLR         GPIO_ResetPins(PORT_LCD_SCL, GPIO_LCD_SCL)//SCL=SCLK
#define        LCD_RST_CLR         GPIO_ResetPins(PORT_LCD_RES, GPIO_LCD_RES)//RES
#define        LCD_LED_CLR         GPIO_ResetPins(PORT_LCD_BLK, GPIO_LCD_BLK)

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

c
void  SPIv_WriteData(u8 Data)
{
    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;
    }
}

在spi.h中，厂家定义了关于SPI接口的宏，这里我们将其注释，使用我们自己的方式。

打开touch.c 文件 修改以下内容：

  1. 修改u8 TP_Init(void)；函数
c
u8 TP_Init(void)
{
    stc_gpio_init_t stcGpioInit; // 定义GPIO结构体

    // 关闭GPIO寄存器写保护
    LL_PERIPH_WE(LL_PERIPH_ALL);

    (void)GPIO_StructInit(&stcGpioInit);
    stcGpioInit.u16PinState = PIN_STAT_SET;
    stcGpioInit.u16PinDir = PIN_DIR_IN;   // 输入
    stcGpioInit.u16PullUp = PIN_PU_OFF;   // 上拉关闭

    // PEN
    (void)GPIO_Init(PORT_LCD_PEN, GPIO_LCD_PEN, &stcGpioInit);
    // DOUT
    (void)GPIO_Init(PORT_LCD_TD0, GPIO_LCD_TD0, &stcGpioInit);


    stcGpioInit.u16PinDir = PIN_DIR_OUT;   // 输出

    // TDIN
    (void)GPIO_Init(PORT_LCD_TDIN, GPIO_LCD_TDIN, &stcGpioInit);
    // TCLK
    (void)GPIO_Init(PORT_LCD_TCLK, GPIO_LCD_TCLK, &stcGpioInit);
    // TCS
    (void)GPIO_Init(PORT_LCD_CS2, GPIO_LCD_CS2, &stcGpioInit);


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

    return 1;
}
  1. 注释掉 void TP_Save_Adjdata(void)；和 u8 TP_Get_Adjdata(void)；函数。
  1. 找到 void TP_Adjust(void) ;函数将函数里面的 TP_Save_Adjdata();和TP_Get_Adjdata();注释掉。

我们打开 test.c 文件进行一些修改：找到 void Touch_Test(void); 函数，将里面的一些语句注释掉，并且将282行括号内的 key==1 改为 1。

  1. 找到
    打开 lcd.c 文件 找到 void LCD_Init(void); 函数将里面的LCD_LED=1;替换成 LCD_LED_SET;

打开 touch.h 文件 将里面一部分代码改为下面的部分：

c
#define PEN   PBin(4)    //T_PEN
#define DOUT  PBin(5)    //T_MISO
#define TDIN  PBout(6)   //T_MOSI
#define TCLK  PBout(8)   //T_SCK
#define TCS   PBout(7)   //T_CS

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

移植验证 ​

在main.c中输入代码如下

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

int32_t main(void)
{
    board_init();
    uart1_init(115200U);


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

上电效果：

文件下载

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

📌 在 资料下载中心->模块移植资料下载 里面的该章节压缩包中。

本页面更新于: