简体中文

English

简体中文

English

外观

1.3寸彩屏 ​

模块来源 ​

采购链接：
https://item.taobao.com/item.htm?spm=a1z10.3-c-s.w4002-23991449512.34.a884703bPrf8rV&id=568022083426
资料下载链接：
https://pan.baidu.com/s/18tt2PzcnTvqTRubdRy2yoQ
资料提取码：8888

规格参数 ​

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

文件下载

文件1.16.2.1 屏幕规格书
工作电压：2.4V-3.3V
工作电流：40MA
模块尺寸：27.78(H) x 39.22(V) MM
像素大小：240(H) x 240(V)RGB
驱动芯片：ST7789V2
通信协议：SPI

移植过程 ​

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

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

查看资料 ​

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

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

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

移植至工程 ​

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

打开自己的工程，将C文件导入工程。

继续添加h文件路径到工程中

接下来我们将lcd.c、lcd_init.c、zk.c、lcd.h和lcd_init.h的包含头文件语句更改为下方的代码：

文件下载

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

c
#ifndef u8
#define u8 uint8_t
#endif

#ifndef u16
#define u16 uint16_t
#endif

#ifndef u32
#define u32 uint32_t
#endif

引脚选择 ​

该屏幕需要设置10个接口。
模块为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.16.3.2 软件SPI接线

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

c
//-----------------LCD端口移植----------------
//VCC - 3.3V

#define RCU_LCD_SCL     RCU_GPIOA//SCL
#define PORT_LCD_SCL    GPIOA
#define GPIO_LCD_SCL    GPIO_PIN_5

#define RCU_LCD_SDA     RCU_GPIOA//SDA
#define PORT_LCD_SDA    GPIOA
#define GPIO_LCD_SDA    GPIO_PIN_7

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

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

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

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

#define RCU_LCD_FSO     RCU_GPIOC//FSO
#define PORT_LCD_FSO    GPIOC
#define GPIO_LCD_FSO    GPIO_PIN_15

#define RCU_LCD_CS2     RCU_GPIOA//CS2
#define PORT_LCD_CS2    GPIOA
#define GPIO_LCD_CS2    GPIO_PIN_1


#define RCU_SPI_HARDWARE RCU_SPI0
#define PORT_SPI         SPI0
#define LINE_AF_SPI      GPIO_AF_0

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

c
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);
        rcu_periph_clock_enable(RCU_LCD_FSO);
        rcu_periph_clock_enable(RCU_LCD_CS2);


                 /* 配置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);

                 /* 配置FSO */
        gpio_mode_set(PORT_LCD_FSO,GPIO_MODE_INPUT,GPIO_PUPD_PULLUP,GPIO_LCD_RES);

                 /* 配置CS2 */
        gpio_mode_set(PORT_LCD_CS2, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, 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);

}

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

c
//-----------------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)

//读取字库数据引脚
#define ZK_MISO        gpio_input_bit_get(PORT_LCD_FSO,GPIO_LCD_FSO)//MISO

#define ZK_CS_Clr()    gpio_bit_write(PORT_LCD_CS2,GPIO_LCD_CS2,RESET)//CS2 字库片选
#define ZK_CS_Set()    gpio_bit_write(PORT_LCD_CS2,GPIO_LCD_CS2,SET)

到这里软件SPI就移植完成了，请移步到1.16.4节进行移植验证。

移植验证 ​

在main.c中输入代码如下

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

int main(void)
{
    u8 i,j;
        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(0,40,"LCD_W:",RED,WHITE,16,0);
                LCD_ShowIntNum(48,40,LCD_W,3,RED,WHITE,16);
                LCD_ShowString(80,40,"LCD_H:",RED,WHITE,16,0);
                LCD_ShowIntNum(128,40,LCD_H,3,RED,WHITE,16);
                LCD_ShowString(80,40,"LCD_H:",RED,WHITE,16,0);
                LCD_ShowString(0,70,"Increaseing Nun:",RED,WHITE,16,0);
                LCD_ShowFloatNum1(128,70,t,4,RED,WHITE,16);
                t+=0.11;
                for(j=0;j<3;j++)
                {
                        for(i=0;i<6;i++)
                        {
                                LCD_ShowPicture(40*i,120+j*40,40,40,gImage_1);
                        }
                }
                delay_1ms(1000);
                LCD_Fill(0,0,LCD_W,LCD_H,WHITE);
                Display_Asc_String(0,15,7, "ASCII_5x7",RED,WHITE);      //ASC 5X7点阵
                Display_Asc_String(0,25,8, "ASCII_7x8",RED,WHITE);      //ASC 7X8点阵
                Display_Asc_String(0,35,12, "ASCII_6x12",RED,WHITE);          //ASC 6X12点阵
                Display_Asc_String(0,50,16, "ASCII_8x16",RED,WHITE);          //ASC 8X16点阵
                Display_Asc_String(0,70,24, "ASCII_12x24",RED,WHITE);   //ASC 12X24点阵
                Display_Asc_String(0,100,32, "ASCII_16x32",RED,WHITE);        //ASC 16X32点阵
                Display_GB2312_String(0,145,12, "屏幕１２ｘ１２",RED,WHITE); //12x12汉字
                Display_GB2312_String(0,160,16, "屏幕１６ｘ１６",RED,WHITE); //15x16汉字
                Display_GB2312_String(0,179,24, "屏幕２４ｘ２４",RED,WHITE); //24x24汉字
                Display_GB2312_String(0,204,32, "屏幕３２ｘ３",RED,WHITE);   //32x32汉字
                delay_1ms(1000);
                LCD_Fill(0,0,LCD_W,LCD_H,WHITE);

                Display_TimesNewRoman_String(0,15,12, "ASCII_8x12",RED,WHITE);   //ASC 8x12点阵(TimesNewRoman类型)
                Display_TimesNewRoman_String(0,30,16, "ASCII_12x16",RED,WHITE);  //ASC 12x16点阵(TimesNewRoman类型)
                Display_TimesNewRoman_String(0,50,24, "ASCII_16x24",RED,WHITE);        //ASC 16x24点阵(TimesNewRoman类型)
                Display_TimesNewRoman_String(0,80,32, "ASCII_24x",RED,WHITE);          //ASC 24x32点阵(TimesNewRoman类型)
                Display_Arial_String(0,120,12, "ASCII_8x12",RED,WHITE);    //ASC 8x12点阵(Arial类型)
                Display_Arial_String(0,140,16, "ASCII_12x16",RED,WHITE);   //ASC 12x16点阵(Arial类型)
                Display_Arial_String(0,160,24, "ASCII_16x24",RED,WHITE);         //ASC 16x24点阵(Arial类型)
                Display_Arial_String(0,190,32, "ASCII_24x",RED,WHITE);           //ASC 24x32点阵(Arial类型)
                delay_1ms(1000);
                LCD_Fill(0,0,LCD_W,LCD_H,WHITE);
    }
}

上电效果

文件下载

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

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

本页面更新于: