1.69寸彩屏

模块来源

采购链接：
https://item.taobao.com/item.htm?id=636002776097&_u=n1q56pn3e33f
资料下载链接：
https://pan.baidu.com/s/1Q4s3fk0uy8AP5aqNZ3fBmg
资料提取码：8888

规格参数

工作电压：3.3V
工作电流：90MA
模块尺寸：31(H) x 48(V) MM
像素大小：240(H) x 280(V)RGB
驱动芯片：ST7789V2
通信协议：SPI
管脚数量：8 Pin（2.54mm间距排针）

移植过程

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

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

查看资料

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

文件下载

文件1.4.3.1 例程下载

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

移植至工程

将上方我圈出来的那个例程中【HARDWARE】文件夹下的【LCD】文件夹，复制到自己的工程中的文件夹中的【Hardware】文件夹。自己的工程至少需要有毫秒级延时函数。（工程可以参考入门手册空白工程（工程模板）下载）

步骤和【1.9寸彩屏】一样，不知道的可以点击回顾一下。接下来我们开始添加h文件的路径到工程

然后我们添加C文件到工程

把 main.c、lcd.c、lcd_init.c、lcd.h和lcd_init.h 文件中的头文件语句换成下面的（根据注释替换不同的头文件语句）。

// main.c
#include "gd32e23x.h"
#include <stdio.h>
#include "pic.h"
#include "lcd.h"
#include "lcd_init.h"

// lcd.h
#include <stdint.h>
#include "gd32e23x.h"
#include "systick.h"

// lcd.c
#include "lcd.h"
#include "lcd_init.h"
#include "lcdfont.h"

// lcd_init.h
#include <stdint.h>
#include "gd32e23x.h"
#include "systick.h"

// lcd_init.c
#include "lcd_init.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。

#define  delay_ms  delay_1ms

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

引脚选择

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

模块为SPI通信协议的从机，SCL为SPI信号线（SCK），SDA为SPI输出线（MOSI），CS为SPI片选线（NSS）。

如果MCU的GPIO引脚不足，可以将屏幕的两个引脚接口不接入MCU的GPIO。
将RES接入MCU的复位引脚，当MCU复位时，屏幕也跟着复位；
可以将BLK接入3.3V或悬空，代价是无法控制背光亮度。下面分为软件SPI移植与硬件SPI移植进行讲解。

软件SPI移植

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

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

//-----------------LCD端口移植----------------
//VCC - 3.3V
//SCL - PA0
//SDA - PA1
//RES - PA2(可以接入复位)
//DC  - PA3
//CS  - PA4
//BLK - PA5
#define RCU_LCD_SCL     RCU_GPIOA//SCK
#define PORT_LCD_SCL    GPIOA
#define GPIO_LCD_SCL    GPIO_PIN_0

#define RCU_LCD_SDA     RCU_GPIOA//MOSI
#define PORT_LCD_SDA    GPIOA
#define GPIO_LCD_SDA    GPIO_PIN_1

#define RCU_LCD_CS      RCU_GPIOA//NSS
#define PORT_LCD_CS     GPIOA
#define GPIO_LCD_CS     GPIO_PIN_4

#define RCU_LCD_DC      RCU_GPIOA //DC
#define PORT_LCD_DC     GPIOA
#define GPIO_LCD_DC     GPIO_PIN_3

#define RCU_LCD_RES     RCU_GPIOA//RES
#define PORT_LCD_RES    GPIOA
#define GPIO_LCD_RES    GPIO_PIN_2

#define RCU_LCD_BLK     RCU_GPIOA//BLK
#define PORT_LCD_BLK    GPIOA
#define GPIO_LCD_BLK    GPIO_PIN_5

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

void LCD_GPIO_Init(void)
{
          /* 使能时钟 */
        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);

}

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

#define LCD_SCLK_Clr() gpio_bit_write(PORT_LCD_SCL, GPIO_LCD_SCL, RESET)//SCL=SCLK
#define LCD_SCLK_Set() gpio_bit_write(PORT_LCD_SCL, GPIO_LCD_SCL, SET)

#define LCD_MOSI_Clr() gpio_bit_write(PORT_LCD_SDA, GPIO_LCD_SDA, RESET)//SDA=MOSI
#define LCD_MOSI_Set() gpio_bit_write(PORT_LCD_SDA, GPIO_LCD_SDA, SET)

#define LCD_RES_Clr()  gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, RESET)//RES
#define LCD_RES_Set()  gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, SET)

#define LCD_DC_Clr()   gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, RESET)//DC
#define LCD_DC_Set()   gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, SET)

#define LCD_CS_Clr()   gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, RESET)//CS
#define LCD_CS_Set()   gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, SET)

#define LCD_BLK_Clr()  gpio_bit_write(PORT_LCD_BLK, GPIO_LCD_BLK, RESET)//BLK
#define LCD_BLK_Set()  gpio_bit_write(PORT_LCD_BLK, GPIO_LCD_BLK, SET)

移植验证

在main.c中输入代码如下

 /******************************************************************************
   * 测试硬件：立创开发板·GD32E230C8T6    使用主频72Mhz    晶振8Mhz
   * 版 本 号: V1.0
   * 修改作者: www.lckfb.com
   * 修改日期: 2023年11月02日
   * 功能介绍:
   *****************************************************************************
   * 梁山派软硬件资料与相关扩展板软硬件资料官网全部开源
   * 开发板官网：www.lckfb.com
   * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
   * 立创论坛：club.szlcsc.com
   * 其余模块移植手册：【立创·GD32E230C8T6开发板】模块移植手册
   * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
   * 不靠卖板赚钱，以培养中国工程师为己任
  ******************************************************************************/
// main.c
#include "gd32e23x.h"
#include <stdio.h>
#include "pic.h"
#include "lcd.h"
#include "lcd_init.h"

int main(void)
{
    float t = 0;
    systick_config();//滴答定时器初始化 1ms

    LCD_Init();//屏幕初始化
    LCD_Fill(0,0,LCD_W,LCD_H,BLACK);//清全屏为黑色

    while(1)
    {
        LCD_ShowString(0,16*2,"LCD_W:",WHITE,BLACK,16,0);
        LCD_ShowIntNum(48,16*2,LCD_W,3,WHITE,BLACK,16);
        LCD_ShowString(80,16*2,"LCD_H:",WHITE,BLACK,16,0);
        LCD_ShowIntNum(128,16*2,LCD_H,3,WHITE,BLACK,16);

        LCD_ShowString(0,16*3,"Nun:",WHITE,BLACK,16,0);
        LCD_ShowFloatNum1(8*4,16*3,t,4,WHITE,BLACK,16);

        LCD_ShowChinese(8*5,16*5,"中电子",BLUE,BLACK,32,0);

        t+=0.11;

        delay_1ms(1000);
    }
}

上电效果

文件下载

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

📌 在 资料下载中心->【模块移植手册资料下载】 里面的本章节压缩包中。

显示类

传感器类

无线通信类

控制类

1.69寸彩屏

模块来源

规格参数

移植过程

查看资料

移植至工程

引脚选择

软件SPI移植

移植验证

1.69寸彩屏 ​

模块来源 ​

规格参数 ​

移植过程 ​

查看资料 ​

移植至工程 ​

引脚选择 ​

软件SPI移植 ​

移植验证 ​

1.69寸彩屏

模块来源

规格参数

移植过程

查看资料

移植至工程

引脚选择

软件SPI移植

移植验证