简体中文

English

简体中文

English

外观

​

模块来源 ​

采购链接：

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

规格参数 ​

工作电压： 3.3V

工作电流： 20MA

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

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

驱动芯片： ILI9488

通信协议： SPI

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

移植过程 ​

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

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

查看资料 ​

打开厂家资料例程

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

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

移植至工程 ​

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

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

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

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

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

c
#include "stm32f4xx.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 处宏定义了每一个引脚，后续根据需要进行修改即可。

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


#define RCC_LCD1    RCC_AHB1Periph_GPIOB
#define RCC_LCD2    RCC_AHB1Periph_GPIOD

//SCK
#define PORT_LCD_SCL    GPIOB
#define GPIO_LCD_SCL    GPIO_Pin_10

//MOSI
#define PORT_LCD_SDA    GPIOB
#define GPIO_LCD_SDA    GPIO_Pin_15

//MIS0
#define PORT_LCD_MIS    GPIOB
#define GPIO_LCD_MIS    GPIO_Pin_14

//NSS
#define PORT_LCD_CS     GPIOB
#define GPIO_LCD_CS     GPIO_Pin_12

//DC
#define PORT_LCD_DC     GPIOD
#define GPIO_LCD_DC     GPIO_Pin_11

//RES
#define PORT_LCD_RES    GPIOD
#define GPIO_LCD_RES    GPIO_Pin_12

//BLK/LED
#define PORT_LCD_BLK    GPIOD
#define GPIO_LCD_BLK    GPIO_Pin_10

//CS2/T_CS
#define PORT_LCD_CS2     GPIOB
#define GPIO_LCD_CS2     GPIO_Pin_7

 //PEN/T_IRQ
#define PORT_LCD_PEN     GPIOB
#define GPIO_LCD_PEN     GPIO_Pin_4

//T_CLK
#define PORT_LCD_TCLK     GPIOB
#define GPIO_LCD_TCLK     GPIO_Pin_8

//T_DIN
#define PORT_LCD_TDIN     GPIOB
#define GPIO_LCD_TDIN     GPIO_Pin_6

//T_DO
#define PORT_LCD_TD0      GPIOB
#define GPIO_LCD_TD0      GPIO_Pin_5

#define RCU_SPI_HARDWARE     RCC_APB1Periph_SPI2
#define PORT_SPI             SPI2
#define LINE_AF_SPI          GPIO_AF_SPI2

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

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

c
void LCD_GPIOInit(void)
{
    GPIO_InitTypeDef  GPIO_InitStructure;

    RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOB|RCC_AHB1Periph_GPIOD ,ENABLE);

    GPIO_InitStructure.GPIO_Pin =   GPIO_LCD_SCL|
                                    GPIO_LCD_SDA|
                                    GPIO_LCD_CS;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;//普通输出模式
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;
    GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;   //推挽输出
    GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;//上拉
    GPIO_Init(GPIOB, &GPIO_InitStructure);

    GPIO_InitStructure.GPIO_Pin = GPIO_LCD_DC|GPIO_LCD_RES|GPIO_LCD_BLK;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;
    GPIO_Init(GPIOD, &GPIO_InitStructure);
}

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

c
//液晶控制口置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)**函数，将其修改如下。

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)
{
      rcu_periph_clock_enable(RCU_LCD_PEN);
      rcu_periph_clock_enable(RCU_LCD_TCLK);
      rcu_periph_clock_enable(RCU_LCD_TDIN);
      rcu_periph_clock_enable(RCU_LCD_TD0);
      rcu_periph_clock_enable(RCU_LCD_CS2);


      /* 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. 注释掉 **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

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

移植验证 ​

在 main.c 中输入代码如下

c
/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 立创论坛：https://oshwhub.com/forum
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 *

 Change Logs:
 * Date           Author       Notes
 * 2024-03-14     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"

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


}

上电效果：

代码下载

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

本页面更新于: