1.8寸TFT_LCD彩屏

模块来源

采购链接：
https://item.taobao.com/item.htm?id=560176729178&ns=1&abbucket=8#detail
资料下载链接：
https://doc.openluat.com/wiki/21?wiki_page_id=2650

规格参数

工作电压：3.3V
工作电流：30mA
模块尺寸：35(H) x 56(V) MM
分辨率：128*160
通信协议：SPI

移植过程

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

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

查看资料

移植至工程

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

打开我们的工程，将C文件和h文件路径导入到工程目录中。

我们将每个文件的头文件导入语句改为：

// main.c
#include "gd32e23x.h"
#include "systick.h"
#include <stdio.h>
#include "GUI.h"
#include "Lcd_Driver.h"

// GUI.c
#include "gd32e23x.h"
#include "Lcd_Driver.h"
#include "GUI.h"
#include "font.h"

// Lcd_Driver.c
#include "gd32e23x.h"
#include "Lcd_Driver.h"

// Lcd_Driver.h
#include "gd32e23x.h"

// GUI.h
#include "gd32e23x.h"

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

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

引脚选择

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

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

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

//-----------------LCD端口移植----------------
// VCC - 3.3V
// SCL - PB3
// SDA - PB4    MOSI
// RES - PB5(可以接入复位)
// DC  - PB6
// CS  - PB7
// BLK - PB8

#define RCU_LCD_SCL     RCU_GPIOB//SCK
#define PORT_LCD_SCL    GPIOB
#define GPIO_LCD_SCL    GPIO_PIN_3

#define RCU_LCD_SDA     RCU_GPIOB//MOSI
#define PORT_LCD_SDA    GPIOB
#define GPIO_LCD_SDA    GPIO_PIN_4

#define RCU_LCD_CS      RCU_GPIOB//NSS
#define PORT_LCD_CS     GPIOB
#define GPIO_LCD_CS     GPIO_PIN_7

#define RCU_LCD_DC      RCU_GPIOB //DC
#define PORT_LCD_DC     GPIOB
#define GPIO_LCD_DC     GPIO_PIN_6

#define RCU_LCD_RES     RCU_GPIOB//RES
#define PORT_LCD_RES    GPIOB
#define GPIO_LCD_RES    GPIO_PIN_5

#define RCU_LCD_BLK     RCU_GPIOB//BLK
#define PORT_LCD_BLK    GPIOB
#define GPIO_LCD_BLK    GPIO_PIN_8

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

/**********************************************************
 * 函 数 名 称：LCD_GPIO_Init
 * 函 数 功 能：初始化LCD相连的SPIO
 * 传 入 参 数：无
 * 函 数 返 回：无
 * 作       者：www.lckfb.com
 * 备       注：
**********************************************************/
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.2.3.22 样式。

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

#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账号：【立创开发板】，掌握我们的最新动态！
   * 不靠卖板赚钱，以培养中国工程师为己任
  ******************************************************************************/
#include "gd32e23x.h"
#include "systick.h"
#include <stdio.h>
#include "lcd_init.h"
#include "lcd.h"
#include "pic.h"

int main(void)
{
        systick_config();
        LCD_Init();//LCD初始化
        LCD_Fill(0,0,LCD_W,LCD_H,BLUE);
        LCD_ShowString(18,30,"LuatOS",WHITE,BLUE,32,0);
        while(1)
        {

        }
}

成功案例：

文件下载

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

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