立创开发板技术文档中心

1.7 1.14 寸彩屏

1.7.1 模块来源

采购链接：
1.14 寸 TFT 显示屏 ips 液晶屏 1.14 寸 st7789 并口屏高清 TFT LCD135240

资料下载链接：
https://pan.baidu.com/s/1cVzawBFj3ZkGml5Dj-368A
资料提取码：8888

1.7.2 规格参数

工作电压： 3.3V

工作电流： 20MA

模块尺寸： 31.4(H) x 28(V) MM

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

驱动芯片： ST7789V

通信协议： 8 位并口

管脚数量： 16 Pin（2.54mm 间距排针）

1.7.3 移植过程

我们的目标是将例程移植至梁山派 GD32F470 上。按照以下步骤，即可完成移植。

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

1.7.3.1 查看资料

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

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

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

1.7.3.2 移植至工程

将厂家资料路径下的【LCD】文件夹，复制到自己的工程中。自己的工程至少需要有毫秒级延时函数。

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

选择导入复制过来的文件夹里面的全部.c 文件。

导入完成后，工程目录下会出现新导入的文件。（原工程目录见图 5.3.5 C 文件导入步骤）

添加.h 路径

在弹出的路径窗口，选择添加新路径

选择 LCD 文件夹的路径，我们的.h 就在里面。因为是选择导入路径，所以不会显示该文件夹下有什么文件。

添加完成

尝试编译，发现有错误。错误内容为找不到 sys.h 这个文件。

将 lcd_init.h 文件下的 sys.h 改为 gd32f4xx.h， 还要将lcd.h文件下的 sys.h 改为 gd32f4xx.h。

(在左边将 lcd.c 和 lcd_init.c 的工程目录展开，就发现有 lcd_init.h 和 lcd.h)

再编译发现还有错误，错误内容分别为标识符“u8”、“u16”、“u32”未定义和找不到 delay.h 这个文件。

分别在 lcd_init.h 与 lcd.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

在源代码中使用 delay.h 的主要作用是给屏幕初始化时提供一定的延时，确保初始化成功。主要使用的函数是 delay_ms，进行毫秒级延时。

将 lcd_init.c 与 lcd.c 文件中的头文件 delay.h 改为自己的延时函数头文件，这里我使用的是 systick.h；再将文件中使用到的延时函数 delay_ms 替换为自己的毫秒级延时，这里替换为 delay_1ms。

#include "systick.h"
#define  delay_ms  delay_1ms

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

1.7.3.3 引脚选择

该屏幕需要设置 8 个接口，具体接口说明见 表 1.7.3.1 各引脚说明。

因为使用的是软件并行口，所以除了特殊引脚外，其他引脚都可以设置。时序部分厂家已经完成，我们只需要将引脚和延时配置好即可。所以对应接入的屏幕引脚请按照你的需要。这里选择的引脚见表 1.7.3.2 8 位并行接线。

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

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

cpp

//-----------------LCD端口移植----------------
// 1-VCC    --3.3V
// 2-GND    --GND
// 3-BLK    --PF9
// 4-RES    --PF7
// 5-CS     --PF6
// 6-DC     --PC3
// 7-WR     --PF8
// 8-RD     --PA0
// 9-DB0    --PA1
//10-DB1    --PA2
//11-DB2    --PC1
//12-DB3    --PC2
//13-DB4    --PF10
//14-DB5    --PA3
//15-DB6    --PA4
//16-DB7    --PA5
#define RCU_LCD_RD     RCU_GPIOA//RD
#define PORT_LCD_RD    GPIOA
#define GPIO_LCD_RD    GPIO_PIN_0

#define RCU_LCD_WR     RCU_GPIOF//WR
#define PORT_LCD_WR    GPIOF
#define GPIO_LCD_WR    GPIO_PIN_8

#define RCU_LCD_CS      RCU_GPIOF//CS
#define PORT_LCD_CS     GPIOF
#define GPIO_LCD_CS     GPIO_PIN_6

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

#define RCU_LCD_RES     RCU_GPIOF//RES
#define PORT_LCD_RES    GPIOF
#define GPIO_LCD_RES    GPIO_PIN_7

#define RCU_LCD_BLK     RCU_GPIOF//BLK
#define PORT_LCD_BLK    GPIOF
#define GPIO_LCD_BLK    GPIO_PIN_9

#define RCU_LCD_DB0     RCU_GPIOA//DB0
#define PORT_LCD_DB0    GPIOA
#define GPIO_LCD_DB0    GPIO_PIN_1

#define RCU_LCD_DB1     RCU_GPIOA//DB1
#define PORT_LCD_DB1    GPIOA
#define GPIO_LCD_DB1    GPIO_PIN_2

#define RCU_LCD_DB2     RCU_GPIOC//DB2
#define PORT_LCD_DB2    GPIOC
#define GPIO_LCD_DB2    GPIO_PIN_1

#define RCU_LCD_DB3     RCU_GPIOC//DB3
#define PORT_LCD_DB3    GPIOC
#define GPIO_LCD_DB3    GPIO_PIN_2

#define RCU_LCD_DB4     RCU_GPIOF//DB4
#define PORT_LCD_DB4    GPIOF
#define GPIO_LCD_DB4    GPIO_PIN_10

#define RCU_LCD_DB5     RCU_GPIOA//DB5
#define PORT_LCD_DB5    GPIOA
#define GPIO_LCD_DB5    GPIO_PIN_3

#define RCU_LCD_DB6     RCU_GPIOA//DB6
#define PORT_LCD_DB6    GPIOA
#define GPIO_LCD_DB6    GPIO_PIN_4

#define RCU_LCD_DB7     RCU_GPIOA//DB7
#define PORT_LCD_DB7    GPIOA
#define GPIO_LCD_DB7    GPIO_PIN_5

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

void LCD_GPIO_Init(void)
{
          /* 使能时钟 */
        rcu_periph_clock_enable(RCU_LCD_RD);
        rcu_periph_clock_enable(RCU_LCD_WR);
        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);
        rcu_periph_clock_enable(RCU_LCD_DB0);
        rcu_periph_clock_enable(RCU_LCD_DB1);
        rcu_periph_clock_enable(RCU_LCD_DB2);
        rcu_periph_clock_enable(RCU_LCD_DB3);
        rcu_periph_clock_enable(RCU_LCD_DB4);
        rcu_periph_clock_enable(RCU_LCD_DB5);
        rcu_periph_clock_enable(RCU_LCD_DB6);
        rcu_periph_clock_enable(RCU_LCD_DB7);

                 /* 配置RD */
        gpio_mode_set(PORT_LCD_RD,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_RD);
        gpio_output_options_set(PORT_LCD_RD,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_RD);
        gpio_bit_write(PORT_LCD_RD, GPIO_LCD_RD, SET);

                 /* 配置WR */
        gpio_mode_set(PORT_LCD_WR,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_WR);
        gpio_output_options_set(PORT_LCD_WR,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_WR);
        gpio_bit_write(PORT_LCD_WR, GPIO_LCD_WR, 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);


                 /* 配置DB0 */
        gpio_mode_set(PORT_LCD_DB0, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_DB0);
        gpio_output_options_set(PORT_LCD_DB0, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_DB0);
        gpio_bit_write(PORT_LCD_DB0, GPIO_LCD_DB0, SET);

                 /* 配置DB1 */
        gpio_mode_set(PORT_LCD_DB1, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_DB1);
        gpio_output_options_set(PORT_LCD_DB1, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_DB1);
        gpio_bit_write(PORT_LCD_DB1, GPIO_LCD_DB1, SET);

                 /* 配置DB2 */
        gpio_mode_set(PORT_LCD_DB2, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_DB2);
        gpio_output_options_set(PORT_LCD_DB2, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_DB2);
        gpio_bit_write(PORT_LCD_DB2, GPIO_LCD_DB2, SET);

                 /* 配置DB3 */
        gpio_mode_set(PORT_LCD_DB3, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_DB3);
        gpio_output_options_set(PORT_LCD_DB3, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_DB3);
        gpio_bit_write(PORT_LCD_DB3, GPIO_LCD_DB3, SET);

                 /* 配置DB4 */
        gpio_mode_set(PORT_LCD_DB4, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_DB4);
        gpio_output_options_set(PORT_LCD_DB4, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_DB4);
        gpio_bit_write(PORT_LCD_DB4, GPIO_LCD_DB4, SET);

                 /* 配置DB5 */
        gpio_mode_set(PORT_LCD_DB5, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_DB5);
        gpio_output_options_set(PORT_LCD_DB5, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_DB5);
        gpio_bit_write(PORT_LCD_DB5, GPIO_LCD_DB5, SET);

                 /* 配置DB6 */
        gpio_mode_set(PORT_LCD_DB6, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_DB6);
        gpio_output_options_set(PORT_LCD_DB6, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_DB6);
        gpio_bit_write(PORT_LCD_DB6, GPIO_LCD_DB6, SET);

                 /* 配置DB7 */
        gpio_mode_set(PORT_LCD_DB7, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_DB7);
        gpio_output_options_set(PORT_LCD_DB7, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_DB7);
        gpio_bit_write(PORT_LCD_DB7, GPIO_LCD_DB7, SET);
}

将 lcd_init.h 中的LCD 端口定义 宏，修改为图 1.7.3.22 样式。

#define        LCD_RES_Set()       gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, SET)//RES
#define        LCD_CS_Set()        gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, SET)//CS
#define        LCD_DC_Set()        gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, SET)//DC
#define        LCD_WR_Set()        gpio_bit_write(PORT_LCD_WR, GPIO_LCD_WR, SET)//WR
#define        LCD_RD_Set()        gpio_bit_write(PORT_LCD_RD, GPIO_LCD_RD, SET)//RD
#define        LCD_BLK_Set()       gpio_bit_write(PORT_LCD_BLK, GPIO_LCD_BLK, SET)//BLK

#define        LCD_RES_Clr()       gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, RESET)//RES
#define        LCD_CS_Clr()        gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, RESET)//CS
#define        LCD_DC_Clr()        gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, RESET)//DC
#define        LCD_WR_Clr()        gpio_bit_write(PORT_LCD_WR, GPIO_LCD_WR, RESET)//WR
#define        LCD_RD_Clr()        gpio_bit_write(PORT_LCD_RD, GPIO_LCD_RD, RESET)//RD
#define        LCD_BLK_Clr()       gpio_bit_write(PORT_LCD_BLK, GPIO_LCD_BLK, RESET)//BLK

因为是并口屏，传输 8 位的数据，是一根线一个位，8 个位数据就是 8 根线。所以我们需要将一个 8 位的数据，装载到 8 根数据线上。在lcd_init.h 中添加以下代码，方便后续的数据传输和端口修改。

// x ? 置1 : 置0
#define PIN_HIGH_OR_LOW(port,gpio,x)  {((x) ? (GPIO_OCTL(port)|=(uint32_t)(gpio)) : (GPIO_OCTL(port)&=~(uint32_t)(gpio)));}

//                  先清除该位，空出位置                                    根据x判断是设置位还是清除位
#define BIT_DB7(x) { GPIO_OCTL(PORT_LCD_DB7) &= ((uint32_t)~(GPIO_LCD_DB7)); PIN_HIGH_OR_LOW( PORT_LCD_DB7, GPIO_LCD_DB7, x) }
#define BIT_DB6(x) { GPIO_OCTL(PORT_LCD_DB6) &= ((uint32_t)~(GPIO_LCD_DB6)); PIN_HIGH_OR_LOW( PORT_LCD_DB6, GPIO_LCD_DB6, x) }
#define BIT_DB5(x) { GPIO_OCTL(PORT_LCD_DB5) &= ((uint32_t)~(GPIO_LCD_DB5)); PIN_HIGH_OR_LOW( PORT_LCD_DB5, GPIO_LCD_DB5, x) }
#define BIT_DB4(x) { GPIO_OCTL(PORT_LCD_DB4) &= ((uint32_t)~(GPIO_LCD_DB4)); PIN_HIGH_OR_LOW( PORT_LCD_DB4, GPIO_LCD_DB4, x) }
#define BIT_DB3(x) { GPIO_OCTL(PORT_LCD_DB3) &= ((uint32_t)~(GPIO_LCD_DB3)); PIN_HIGH_OR_LOW( PORT_LCD_DB3, GPIO_LCD_DB3, x) }
#define BIT_DB2(x) { GPIO_OCTL(PORT_LCD_DB2) &= ((uint32_t)~(GPIO_LCD_DB2)); PIN_HIGH_OR_LOW( PORT_LCD_DB2, GPIO_LCD_DB2, x) }
#define BIT_DB1(x) { GPIO_OCTL(PORT_LCD_DB1) &= ((uint32_t)~(GPIO_LCD_DB1)); PIN_HIGH_OR_LOW( PORT_LCD_DB1, GPIO_LCD_DB1, x) }
#define BIT_DB0(x) { GPIO_OCTL(PORT_LCD_DB0) &= ((uint32_t)~(GPIO_LCD_DB0)); PIN_HIGH_OR_LOW( PORT_LCD_DB0, GPIO_LCD_DB0, x) }

在 lcd_init.c 文件中，找到 **void LCD_Writ_Bus(u8 dat)**函数，将其修改如下。

void LCD_Writ_Bus(u8 dat)
{
        LCD_CS_Clr();
        LCD_WR_Clr();

        BIT_DB7( (dat>>7)&0x01 );
        BIT_DB6( (dat>>6)&0x01 );
        BIT_DB5( (dat>>5)&0x01 );
        BIT_DB4( (dat>>4)&0x01 );
        BIT_DB3( (dat>>3)&0x01 );
        BIT_DB2( (dat>>2)&0x01 );
        BIT_DB1( (dat>>1)&0x01 );
        BIT_DB0( (dat>>0)&0x01 );

        LCD_WR_Set();
        LCD_CS_Set();
}

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

1.7.4 移植验证

在 main.c 中输入代码如下

#include "gd32f4xx.h"
#include "systick.h"
#include "lcd_init.h"
#include "lcd.h"
#include "pic.h"

int main(void)
{
    float t=0;
    nvic_priority_group_set(NVIC_PRIGROUP_PRE2_SUB2);  // 优先级分组
    systick_config();                //滴答定时器初始化 1ms
    LCD_Init();//LCD初始化
    LCD_Fill(0,0,LCD_W,LCD_H,WHITE);
    while(1)
    {
                LCD_ShowString(24,30,"LCD_W:",RED,WHITE,16,0);
                LCD_ShowIntNum(72,30,LCD_W,3,RED,WHITE,16);
                LCD_ShowString(24,50,"LCD_H:",RED,WHITE,16,0);
                LCD_ShowIntNum(72,50,LCD_H,3,RED,WHITE,16);
                LCD_ShowFloatNum1(20,80,t,4,RED,WHITE,16);
                t+=0.11;
                LCD_ShowPicture(65,80,40,40,gImage_1);
    }
}

上电效果

移植成功案例

入门教程资料

模块移植手册

显示类

传感器类

实战项目资料

训练营活动

电赛项目资料

1.7 1.14 寸彩屏

1.7.1 模块来源

1.7.2 规格参数

1.7.3 移植过程

1.7.3.1 查看资料

1.7.3.2 移植至工程

1.7.3.3 引脚选择

1.7.4 移植验证

显示类

传感器类

1.7 1.14 寸彩屏 ​

1.7.1 模块来源 ​

1.7.2 规格参数 ​

1.7.3 移植过程 ​

1.7.3.1 查看资料 ​

1.7.3.2 移植至工程 ​

1.7.3.3 引脚选择 ​

1.7.4 移植验证 ​

1.7 1.14 寸彩屏

1.7.1 模块来源

1.7.2 规格参数

1.7.3 移植过程

1.7.3.1 查看资料

1.7.3.2 移植至工程

1.7.3.3 引脚选择

1.7.4 移植验证