该案例适配了 3.2 寸 ILI9341 屏。

模块来源

采购链接：

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

资料下载链接：

http://www.lcdwiki.com/zh/2.8inch_SPI_Module_ILI9341_SKU:MSP2807

规格参数

以下信息见厂家资料屏幕规格书

工作电压： 3.3V-5V

工作电流： 90mA

模块尺寸： 50.0(H) x 86(V) MM

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

驱动芯片： ILI9341

通信协议： SPI

移植过程

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

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

查看资料

打开厂家资料例程

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

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

移植至工程

将厂家资料路径下的【LCD】、【SPI】、【TOUCH】文件夹和 User 文件夹下的 GUI.c、GUI.h、test.c 和 test.h、pic.h，复制到自己的工程中。自己的工程至少需要有毫秒级延时函数。（工程可以参考入门手册空白工程下载）

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

把 TOUCH 文件夹的路径也添加下：

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

#ifndef u8
#define u8 uint8_t
#endif

#ifndef u16
#define u16 uint16_t
#endif

#ifndef s32
#define s32 uint32_t
#endif

这里需要注意，lcd.h 和 GUI.h 中使用到的是 u32 类型，因此，我们需要改为 u32.

在 gui.h 和 test.h 中记得要加入 #include "stm32f4xx.h"

gui.h

test.h

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

将 sys.h 改为 stm32f4xx.h

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

引脚选择

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

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

屏幕接线

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

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

//-----------------LCD端口移植----------------
//VCC - 3.3V
//SCL - PB10         SPI_SCK
//SDA - PB15         SPI_MOSI
//RES - PD9          (可以接入复位)
//DC  - PD8
//CS  - PB12          SPI_NSS
//BLK - PD10

#define RCC_LCD1   RCC_AHB1Periph_GPIOA
#define RCC_LCD2   RCC_AHB1Periph_GPIOB
#define RCC_LCD3   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_8

//RES
#define PORT_LCD_RES    GPIOD
#define GPIO_LCD_RES    GPIO_Pin_9

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

//CS2/T_CS
#define PORT_LCD_CS2     GPIOA
#define GPIO_LCD_CS2     GPIO_Pin_4

//PEN/T_IRQ
#define PORT_LCD_PEN     GPIOA
#define GPIO_LCD_PEN     GPIO_Pin_0

//T_CLK
#define PORT_LCD_TCLK     GPIOA
#define GPIO_LCD_TCLK     GPIO_Pin_5

//T_DIN
#define PORT_LCD_TDIN     GPIOA
#define GPIO_LCD_TDIN     GPIO_Pin_3

//T_DO
#define PORT_LCD_TD0      GPIOA
#define GPIO_LCD_TD0      GPIO_Pin_1

将 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_8;//8分频
    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操作语句宏定义
#define        LCD_CS_SET          GPIO_WriteBit(PORT_LCD_CS, GPIO_LCD_CS, Bit_SET)
#define        LCD_RS_SET          GPIO_WriteBit(PORT_LCD_DC, GPIO_LCD_DC, Bit_SET)
#define        LCD_SDA_SET         GPIO_WriteBit(PORT_LCD_SDA, GPIO_LCD_SDA, Bit_SET)
#define        LCD_SCL_SET         GPIO_WriteBit(PORT_LCD_SCL, GPIO_LCD_SCL, Bit_SET)
#define        LCD_RST_SET         GPIO_WriteBit(PORT_LCD_RES, GPIO_LCD_RES, Bit_SET)
#define        LCD_LED_SET         GPIO_WriteBit(PORT_LCD_BLK, GPIO_LCD_BLK, Bit_SET)

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

在 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 接口的宏，这里我们将其注释，使用我们自己的方式。并且加上头文件：lcd.h

修改厂家源码

将 lcd.c 中 **void LCD_Init(void)**里的【LCD_LED=1;//点亮背光】换成为我们自己的点亮背光方式。

将 touch.c 里的u8 TP_Init(void) 替换为以下代码。

u8 TP_Init(void)
{
    //注意,时钟使能之后,对GPIO的操作才有效
    //所以上拉之前,必须使能时钟.才能实现真正的上拉输出
    GPIO_InitTypeDef GPIO_InitStructure;        //GPIO
    RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA|RCC_AHB1Periph_GPIOB|RCC_AHB1Periph_GPIOD, ENABLE);//使能GPIO时钟

    //GPIO初始化设置
    GPIO_InitStructure.GPIO_Pin = GPIO_LCD_TD0 | GPIO_LCD_PEN;//上拉输入
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN;//输入模式
    GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;//推挽输出
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;//100MHz
    GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;//上拉
    GPIO_Init(GPIOA, &GPIO_InitStructure);//初始化

    GPIO_InitStructure.GPIO_Pin = GPIO_LCD_CS2|GPIO_LCD_TCLK|GPIO_LCD_TDIN;//推挽输出
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;//输出模式
    GPIO_Init(GPIOA, &GPIO_InitStructure);//初始化

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

    return 1;
}

将 touch.c 里 void TP_Save_Adjdata(void) 、 u8 TP_Get_Adjdata(void) 注释。

在 touch.c 中的 void TP_Adjust(void)里，找到 TP_Save_Adjdata(); 和 TP_Get_Adjdata(); 进行注释。

将 test.c 中的 void Touch_Test(void) 修改如下：

void Touch_Test(void)
{
        u8 key;
        u16 i=0;
        u16 j=0;
        u16 colorTemp=0;
        TP_Init();

        LCD_Clear(WHITE);//清屏
        TP_Adjust();  //屏幕校准

        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)
        {
                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[j%5]);
                                POINT_COLOR=ColorTab[(j++)%5];
                                colorTemp=POINT_COLOR;
                                delay_ms(10);
                                }

                                else TP_Draw_Big_Point(tp_dev.x,tp_dev.y,POINT_COLOR);   //画图
                        }
                }
                else
                {
                        delay_ms(10);        //没有按键按下的时候
                }
        }
}

打开 touch.h 文件修改下列代码

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

#define PEN       GPIO_ReadInputDataBit(PORT_LCD_PEN, GPIO_LCD_PEN)      //T_PEN
#define DOUT      GPIO_ReadInputDataBit(PORT_LCD_TD0, GPIO_LCD_TD0)      //T_MISO
#define TDIN(x)   GPIO_WriteBit(PORT_LCD_TDIN, GPIO_LCD_TDIN, x?1:0)     //T_MOSI
#define TCLK(x)   GPIO_WriteBit(PORT_LCD_TCLK, GPIO_LCD_TCLK, x?1:0)     //T_SCK
#define TCS(x)    GPIO_WriteBit(PORT_LCD_CS2, GPIO_LCD_CS2, x?1:0)       //T_CS

打开 touch.c 文件将里面 关于 TDIN、TCLK、TCS 的代码语句改为下列

TDIN = 1  -------改为------->    TDIN(1)
TDIN = 0  -------改为------->    TDIN(0)

TCLK = 1  -------改为------->    TCLK(1)
TCLK = 0  -------改为------->    TCLK(0)

TCS = 1   -------改为------->    TCS(1)
TCS = 0   -------改为------->    TCS(0)

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

移植验证

在 main.c 中输入代码如下

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

int main(void)
{
    board_init();
    nvic_priority_group_set(NVIC_PRIGROUP_PRE2_SUB2);  // 优先级分组

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

移植现象：

代码下载

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