一、模块来源


资料下载链接:
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间距排针)

尺寸参数

三、移植过程

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

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

3.1 查看资料

打开厂家资料例程(例程下载见例程下载)。具体路径见下图。

3.2 移植至工程

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

复制文件夹1

复制文件夹2

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

动图封面

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

#include "board.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 注释掉

3.3 引脚选择

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

屏幕 开发板
GND GND
VCC 3.3V
SCK PA6
SDI PA7
RST PB1
RS PB0
CS PB10
LED PA5
SDO 不接
T_CLK PA4
T_CS PA3
T_DIN PA2
T_DO PA1
T_IRQ PA0

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

3.4. 端口修改

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

//-----------------LCD端口移植----------------

#define RCC_LCD1_ENABLE() __RCC_GPIOA_CLK_ENABLE()
#define RCC_LCD2_ENABLE() __RCC_GPIOB_CLK_ENABLE()

//SCK
#define PORT_LCD_SCL CW_GPIOA
#define GPIO_LCD_SCL GPIO_PIN_6

//MOSI
#define PORT_LCD_SDA CW_GPIOA
#define GPIO_LCD_SDA GPIO_PIN_7

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

//NSS
#define PORT_LCD_CS CW_GPIOB
#define GPIO_LCD_CS GPIO_PIN_10

//DC
#define PORT_LCD_DC CW_GPIOB
#define GPIO_LCD_DC GPIO_PIN_0

//RES
#define PORT_LCD_RES CW_GPIOB
#define GPIO_LCD_RES GPIO_PIN_1

//BLK/LED
#define PORT_LCD_BLK CW_GPIOA
#define GPIO_LCD_BLK GPIO_PIN_5

//CS2/T_CS
#define PORT_LCD_CS2 CW_GPIOA
#define GPIO_LCD_CS2 GPIO_PIN_3

//PEN/T_IRQ
#define PORT_LCD_PEN CW_GPIOA
#define GPIO_LCD_PEN GPIO_PIN_0

//T_CLK
#define PORT_LCD_TCLK CW_GPIOA
#define GPIO_LCD_TCLK GPIO_PIN_4

//T_DIN
#define PORT_LCD_TDIN CW_GPIOA
#define GPIO_LCD_TDIN GPIO_PIN_2

//T_DO
#define PORT_LCD_TD0 CW_GPIOA
#define GPIO_LCD_TD0 GPIO_PIN_1

软件SPI引脚宏

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

代码中已经做了引脚SPI的适配,如果没有修改相关引脚,则将宏定义USE_HARDWARE_SPI 宏 为1即可。

void LCD_GPIOInit(void)
{
    GPIO_InitTypeDef        GPIO_InitStruct; // GPIO初始化结构体

    RCC_LCD1_ENABLE();        // 使能GPIO时钟
    RCC_LCD2_ENABLE();        // 使能GPIO时钟

    GPIO_InitStruct.Pins = GPIO_LCD_SCL|              // GPIO引脚
                           GPIO_LCD_SDA|
                           GPIO_LCD_BLK;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;       // 推挽输出
    GPIO_InitStruct.Speed = GPIO_SPEED_HIGH;          // 输出速度高
    GPIO_Init(PORT_LCD_SCL, &GPIO_InitStruct);        // 初始化

    GPIO_InitStruct.Pins = GPIO_LCD_DC|
                           GPIO_LCD_RES|
                           GPIO_LCD_CS;
    GPIO_Init(PORT_LCD_CS, &GPIO_InitStruct);        // 初始化
}

lcd.h中的LCD端口定义宏,修改为:

////////////////////////////////////////////////////////////////////
//-----------------LCD端口定义----------------

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

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

3.5. 驱动修改

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

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); 函数
u8 TP_Init(void)
{
    GPIO_InitTypeDef  GPIO_InitStructure;

    /* PEN */
    GPIO_InitStructure.Pins  = GPIO_LCD_PEN;
    GPIO_InitStructure.Mode  = GPIO_MODE_INPUT_PULLUP; // 上拉输入
    GPIO_InitStructure.Speed = GPIO_SPEED_HIGH;
    GPIO_Init(PORT_LCD_PEN, &GPIO_InitStructure);

    /* DOUT*/
    GPIO_InitStructure.Pins  = GPIO_LCD_TD0;
    GPIO_InitStructure.Mode  = GPIO_MODE_INPUT_PULLUP; // 上拉输入
    GPIO_InitStructure.Speed = GPIO_SPEED_HIGH;
    GPIO_Init(PORT_LCD_TD0, &GPIO_InitStructure);

    /* TDIN*/
    GPIO_InitStructure.Pins  = GPIO_LCD_TDIN;
    GPIO_InitStructure.Mode  = GPIO_MODE_OUTPUT_PP;//推挽输出模式
    GPIO_InitStructure.Speed = GPIO_SPEED_HIGH;
    GPIO_Init(PORT_LCD_TDIN, &GPIO_InitStructure);

    /* TCLK*/
    GPIO_InitStructure.Pins  = GPIO_LCD_TCLK;
    GPIO_InitStructure.Mode  = GPIO_MODE_OUTPUT_PP;//推挽输出模式
    GPIO_InitStructure.Speed = GPIO_SPEED_HIGH;
    GPIO_Init(PORT_LCD_TCLK, &GPIO_InitStructure);

    /* TCS*/
    GPIO_InitStructure.Pins  = GPIO_LCD_CS2;
    GPIO_InitStructure.Mode  = GPIO_MODE_OUTPUT_PP;//推挽输出模式
    GPIO_InitStructure.Speed = GPIO_SPEED_HIGH;
    GPIO_Init(PORT_LCD_CS2, &GPIO_InitStructure);

    TP_Read_XY(&tp_dev.x,&tp_dev.y);//第一次读取初始化
    return 1;
}
  1. 注释掉 void TP_Save_Adjdata(void); 和 u8 TP_Get_Adjdata(void); 函数.

3.找到 void TP_Adjust(void); 函数将函数里面的 TP_Save_Adjdata(); 和 TP_Get_Adjdata(); 注释掉。

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

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

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

#define PEN     GPIO_ReadPin(PORT_LCD_PEN,GPIO_LCD_PEN)    //INT
#define DOUT    GPIO_ReadPin(PORT_LCD_TD0,GPIO_LCD_TD0)    //MISO
#define TDIN(x) GPIO_WritePin(PORT_LCD_TDIN,GPIO_LCD_TDIN,x?GPIO_Pin_SET:GPIO_Pin_RESET)    //MOSI
#define TCLK(x) GPIO_WritePin(PORT_LCD_TCLK,GPIO_LCD_TCLK,x?GPIO_Pin_SET:GPIO_Pin_RESET)    //SCLK
#define TCS(x)  GPIO_WritePin(PORT_LCD_CS2, GPIO_LCD_CS2,  x?GPIO_Pin_SET:GPIO_Pin_RESET)   //CS

然后我们打开 touch.c 文件 将文件中的下列形式的语句换成后面的语句:

TCLK = 1; -----换成-------> TCLK(1);
TCLK = 0; -----换成-------> TCLK(0);

TDIN = 1; -----换成-------> TDIN(1);
TDIN = 0; -----换成-------> TDIN(0);

TCS = 1; -----换成-------> TCS(1);
TCS = 0; -----换成-------> TCS(0);

例如:

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

四、移植验证

在main.c中输入代码如下

/*
 * Change Logs:
 * Date           Author       Notes
 * 2024-06-18     LCKFB-LP    first version
 */
#include "board.h"
#include "stdio.h"
#include "bsp_uart.h"
#include "Lcd.h"
#include "gui.h"
#include "test.h"
#include "spi.h"
#include "touch.h"

int32_t main(void)
{
    board_init();        // 开发板初始化

    uart1_init(115200);        // 串口1波特率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();           //触摸屏手写测试
    }
}

上电效果:

模块移植成功案例(软件SPI):

链接:https://pan.baidu.com/s/1fVFssmnIdNbN4F0ZdxpwlQ?pwd=LCKF 提取码:LCKF

Logo

智能硬件社区聚焦AI智能硬件技术生态,汇聚嵌入式AI、物联网硬件开发者,打造交流分享平台,同步全国赛事资讯、开展 OPC 核心人才招募,助力技术落地与开发者成长。

更多推荐