【CW32模块使用】1.47寸彩屏

一、模块来源​

资料下载链接： https://pan.baidu.com/s/15OWpndYzyW8kFPqmfKNfxQ

资料提取码：8888

二、 规格参数​

工作电压：3.3V

工作电流：90MA

模块尺寸：30(H) x 37(V) MM

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

驱动芯片：ST7789V3

通信协议：SPI

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

以上信息见厂家资料文件

文件路径

尺寸参数

三、移植过程​

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

将源码导入工程；

根据编译报错处进行粗改；

修改引脚配置；

修改时序配置；

移植验证。

3.1. 查看资料​

打开厂家资料例程（例程下载见百度网盘链接下载）。具体路径见例程路径

例程路径

3.2. 移植至工程​

将厂家资料路径下的【LCD】文件夹，复制到自己的工程中。（工程可以参考入门手册工程模板）

复制示意图

我们打开工程文件，将我们刚刚复制到文件夹中的文件，导入C文件和路径。

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

TIP

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

修改lcd_init.h内容

修改lcd.h内容

将 lcd_init.c 和 lcd.c 中的 delay.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

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

3.3. 引脚选择​

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

模块为SPI通信协议的从机，SCL为SPI信号线（SCK），SDA为SPI输出线（MOSI），CS为SPI片选线（NSS）。 如果MCU的GPIO引脚不足，可以将屏幕的两个引脚接口不接入MCU的GPIO。

将RES接入MCU的复位引脚，当MCU复位时，屏幕也跟着复位；

可以将BLK接入3.3V或悬空，代价是无法控制背光亮度。

3.4. 软件SPI移植​

软件SPI接线图

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

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

void LCD_GPIO_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct;   // GPIO初始化结构体

    __RCC_GPIOA_CLK_ENABLE();           // 使能GPIOA时钟

    GPIO_InitStruct.Pins =  LCD_SCL_PIN| // GPIO引脚
                            LCD_SDA_PIN|
                            LCD_RES_PIN|
                            LCD_DC_PIN|
                            LCD_CS_PIN|
                            LCD_BLK_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;    // 推挽输出
    GPIO_InitStruct.Speed = GPIO_SPEED_HIGH;       // 输出速度高
    GPIO_Init(CW_GPIOA, &GPIO_InitStruct);         // 初始化

    LCD_SCLK_Set();
    LCD_MOSI_Set();
    LCD_RES_Set();
    LCD_DC_Set();
    LCD_CS_Set();
    LCD_BLK_Set();
}

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

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

#define LCD_GPIO_PORT        CW_GPIOA

#define LCD_SCL_PIN          GPIO_PIN_5
#define LCD_SDA_PIN          GPIO_PIN_7
#define LCD_RES_PIN          GPIO_PIN_3
#define LCD_DC_PIN           GPIO_PIN_2
#define LCD_CS_PIN           GPIO_PIN_4
#define LCD_BLK_PIN          GPIO_PIN_1

#define LCD_SCLK_Clr() GPIO_WritePin(LCD_GPIO_PORT, LCD_SCL_PIN, GPIO_Pin_RESET)//SCL=SCLK
#define LCD_SCLK_Set() GPIO_WritePin(LCD_GPIO_PORT, LCD_SCL_PIN, GPIO_Pin_SET)

#define LCD_MOSI_Clr() GPIO_WritePin(LCD_GPIO_PORT, LCD_SDA_PIN, GPIO_Pin_RESET)//SDA=MOSI
#define LCD_MOSI_Set() GPIO_WritePin(LCD_GPIO_PORT, LCD_SDA_PIN, GPIO_Pin_SET)

#define LCD_RES_Clr()  GPIO_WritePin(LCD_GPIO_PORT, LCD_RES_PIN, GPIO_Pin_RESET)//RES
#define LCD_RES_Set()  GPIO_WritePin(LCD_GPIO_PORT, LCD_RES_PIN, GPIO_Pin_SET)

#define LCD_DC_Clr()   GPIO_WritePin(LCD_GPIO_PORT, LCD_DC_PIN, GPIO_Pin_RESET)//DC
#define LCD_DC_Set()   GPIO_WritePin(LCD_GPIO_PORT, LCD_DC_PIN, GPIO_Pin_SET)

#define LCD_CS_Clr()   GPIO_WritePin(LCD_GPIO_PORT, LCD_CS_PIN, GPIO_Pin_RESET)//CS
#define LCD_CS_Set()   GPIO_WritePin(LCD_GPIO_PORT, LCD_CS_PIN, GPIO_Pin_SET)

#define LCD_BLK_Clr()  GPIO_WritePin(LCD_GPIO_PORT, LCD_BLK_PIN, GPIO_Pin_RESET)//BLK
#define LCD_BLK_Set()  GPIO_WritePin(LCD_GPIO_PORT, LCD_BLK_PIN, GPIO_Pin_SET)

源端口定义

修改后端口定义

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

3.5. 硬件SPI移植​

硬件SPI与软件SPI相比，硬件SPI是靠硬件上面的SPI控制器，所有的时钟边缘采样，时钟发生，还有时序控制，都是由硬件完成的。它降低了CPU的使用率，提高了运行速度。软件SPI就是用代码控制IO输出高低电平，模拟SPI的时序，这种方法通信速度较慢，且不可靠。

想要使用硬件SPI驱动屏幕，需要确定使用的引脚是否有SPI外设功能。可以通过数据手册进行查看。

数据手册和用户手册都在百度网盘资料，网盘地址看入门手册。

当前使用的是硬件SPI接口，而屏幕我们只需要控制它，而不需要读取屏幕的数据，故使用的是3线的SPI，只使用到了时钟线SCK、主机输出从机输入线MOSI和软件控制的片选线NSS。而NSS我们使用的是软件控制，所以除了SCL(SCK)/SDA(MOSI)引脚需要使用硬件SPI功能的引脚外，其他引脚都可以使用开发板上其他的GPIO。这里选择使用PA5/PA7的SPI复用功能。其他对应接入的屏幕引脚请按照你的需要。这里选择的引脚见表硬件SPI接线

有SPI功能的引脚

硬件SPI接线

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

引脚初始化配置见如下代码。

void LCD_GPIO_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct;   // GPIO初始化结构体

    __RCC_GPIOA_CLK_ENABLE();           // 使能GPIOA时钟
    __RCC_SPI1_CLK_ENABLE();        // 使能SPI1时钟


    // GPIO复用为SPI1
    SPI1_AF_SCK();
    SPI1_AF_MOSI();

    GPIO_InitStruct.Pins =  LCD_SCL_PIN| // GPIO引脚
                            LCD_SDA_PIN|
                            LCD_RES_PIN|
                            LCD_DC_PIN|
                            LCD_CS_PIN|
                            LCD_BLK_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;    // 推挽输出
    GPIO_InitStruct.Speed = GPIO_SPEED_HIGH;       // 输出速度高
    GPIO_Init(CW_GPIOA, &GPIO_InitStruct);         // 初始化

        // 拉高
    LCD_RES_Set();
    LCD_DC_Set();
    LCD_CS_Set();
    LCD_BLK_Set();

    SPI_InitTypeDef  SPI_InitStructure; // SPI 初始化结构体

    SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex;    // 双线全双工
    SPI_InitStructure.SPI_Mode = SPI_Mode_Master;                         // 主机模式
    SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b;                     // 帧数据长度为8bit
    SPI_InitStructure.SPI_CPOL = SPI_CPOL_High;                           // 时钟空闲电平为高
    SPI_InitStructure.SPI_CPHA = SPI_CPHA_2Edge;                          // 第二个边沿采样
    SPI_InitStructure.SPI_NSS = SPI_NSS_Soft;                             // 片选信号由SSI寄存器控制
    SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_8;    // 波特率为PCLK的8分频
    SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB;                    // 最高有效位 MSB 收发在前
    SPI_InitStructure.SPI_Speed = SPI_Speed_Low;                          // 低速SPI

    SPI_Init(BSP_SPI1, &SPI_InitStructure);   // 初始化
    SPI_Cmd(BSP_SPI1, ENABLE); // 使能SPI1
}

初始化部分完，还需要修改发送数据部分。源代码中使用的是软件SPI，时序是由厂家编写完成的。我们使用硬件SPI则需要对其进行修改。

在lcd_init.c文件中，将源代码的void LCD_Writ_Bus(u8 dat) 函数修改为下图中右图样式。

源代码格式

修改后的代码

将lcd_init.h中的LCD_Writ_Bus函数改为

/******************************************************************************
      函数说明：LCD串行数据写入函数
      入口数据：dat  要写入的串行数据
      返回值：  无
******************************************************************************/
void LCD_Writ_Bus(u8 dat)
{
    LCD_CS_Clr();

    while (SPI_GetFlagStatus(BSP_SPI1, SPI_FLAG_TXE) == RESET);

    SPI_SendData(BSP_SPI1, dat); // 发送数据

    while (SPI_GetFlagStatus(BSP_SPI1, SPI_FLAG_RXNE) == RESET);

    uint16_t temp = SPI_ReceiveData(BSP_SPI1); // 返回数据

    LCD_CS_Set();
}

将lcd_init.h中的LCD端口定义改为

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

#define BSP_SPI1        CW_SPI1

//GPIO AF
#define SPI1_AF_SCK()   PA05_AFx_SPI1SCK()
#define SPI1_AF_MOSI()  PA07_AFx_SPI1MOSI()

#define LCD_GPIO_PORT   CW_GPIOA

#define LCD_SCL_PIN     GPIO_PIN_5
#define LCD_SDA_PIN     GPIO_PIN_7
#define LCD_RES_PIN     GPIO_PIN_3
#define LCD_DC_PIN      GPIO_PIN_2
#define LCD_CS_PIN      GPIO_PIN_4
#define LCD_BLK_PIN     GPIO_PIN_1

#define LCD_RES_Clr()  GPIO_WritePin(LCD_GPIO_PORT, LCD_RES_PIN, GPIO_Pin_RESET)//RES
#define LCD_RES_Set()  GPIO_WritePin(LCD_GPIO_PORT, LCD_RES_PIN, GPIO_Pin_SET)

#define LCD_DC_Clr()   GPIO_WritePin(LCD_GPIO_PORT, LCD_DC_PIN, GPIO_Pin_RESET)//DC
#define LCD_DC_Set()   GPIO_WritePin(LCD_GPIO_PORT, LCD_DC_PIN, GPIO_Pin_SET)

#define LCD_CS_Clr()   GPIO_WritePin(LCD_GPIO_PORT, LCD_CS_PIN, GPIO_Pin_RESET)//CS
#define LCD_CS_Set()   GPIO_WritePin(LCD_GPIO_PORT, LCD_CS_PIN, GPIO_Pin_SET)

#define LCD_BLK_Clr()  GPIO_WritePin(LCD_GPIO_PORT, LCD_BLK_PIN, GPIO_Pin_RESET)//BLK
#define LCD_BLK_Set()  GPIO_WritePin(LCD_GPIO_PORT, LCD_BLK_PIN, GPIO_Pin_SET)

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

四、移植验证​

在main.c中输入代码如下

/*
 * Change Logs:
 * Date           Author       Notes
 * 2024-06-17     LCKFB-LP    first version
 */
#include "board.h"
#include "stdio.h"
#include "bsp_uart.h"
#include "lcd.h"
#include "lcd_init.h"

int32_t main(void)
{
    board_init();        // 开发板初始化

    uart1_init(115200);        // 串口1波特率115200

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

    float t = 0;

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

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

        delay_ms(1000);
    }
}

上电效果：

移植成功案例（软件和硬件SPI）：

链接：https://pan.baidu.com/s/1Gh3gjERStM73AV_MiNTV0A?pwd=LCKF 提取码：LCKF