1.8寸彩色触摸屏 | 立创开发板技术文档中心

1. 模块来源

采购链接： 1.8寸液晶屏 1.8寸TFT LCD SPI串口模块TFT彩屏触摸屏st7735

资料下载链接： https://pan.baidu.com/s/1n_vp38V7ij88PUGpbJPd7Q

资料提取码：8888

2. 规格参数

工作电压：3.3V

工作电流：30MA

模块尺寸：35(H) x 56(V) MM

像素大小：128(H) x 160(V)RGB

驱动芯片：ST7735S

通信协议：SPI

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

带电阻触摸芯片：XPT2046

以上信息见厂家资料文件

3. 移植过程

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

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

3.1. 查看资料

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

3.2. 移植至工程

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

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

分别在lcd_init.h、lcd.h 和 touch.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_init.h、lcd.h 和 touch.h 文件中将 sys.h 改为 board.h

分别在lcd_init.c、lcd.c 和 touch.c 文件中将 delay.h 注释掉。

3.3. 引脚选择

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

3.4. 软件SPI移植

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

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

在lcd_init.h中添加LCD端口移植定义

//-----------------LCD端口移植----------------

#define RCC_LCD1_ENABLE()     __RCC_GPIOA_CLK_ENABLE()
#define RCC_LCD2_ENABLE()     __RCC_GPIOB_CLK_ENABLE()

#define LCD_SCLK_PORT         CW_GPIOA
#define LCD_SCLK_PIN          GPIO_PIN_5

#define LCD_MOSI_PORT         CW_GPIOA
#define LCD_MOSI_PIN          GPIO_PIN_7

#define LCD_RES_PORT          CW_GPIOB
#define LCD_RES_PIN           GPIO_PIN_0

#define LCD_DC_PORT           CW_GPIOB
#define LCD_DC_PIN            GPIO_PIN_1

#define LCD_BLK_PORT          CW_GPIOA
#define LCD_BLK_PIN           GPIO_PIN_2

#define LCD_MISO_PORT         CW_GPIOA
#define LCD_MISO_PIN          GPIO_PIN_6

#define LCD_CS1_PORT          CW_GPIOA
#define LCD_CS1_PIN           GPIO_PIN_4

#define LCD_CS2_PORT          CW_GPIOB
#define LCD_CS2_PIN           GPIO_PIN_9

#define LCD_PEN_PORT          CW_GPIOB
#define LCD_PEN_PIN           GPIO_PIN_12

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

void LCD_GPIO_Init(void)
{

    GPIO_InitTypeDef GPIO_InitStruct;   // GPIO初始化结构体

    RCC_LCD1_ENABLE();       // 使能GPIO时钟1
    RCC_LCD2_ENABLE();       // 使能GPIO时钟2

    GPIO_InitStruct.Pins =  LCD_SCLK_PIN| // GPIO引脚
                            LCD_MOSI_PIN|
                            LCD_BLK_PIN|
                            LCD_CS1_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;    // 推挽输出
    GPIO_InitStruct.Speed = GPIO_SPEED_HIGH;       // 输出速度高
    GPIO_Init(LCD_SCLK_PORT, &GPIO_InitStruct);    // 初始化

    GPIO_InitStruct.Pins =  LCD_RES_PIN|
                            LCD_DC_PIN|
                            LCD_CS2_PIN;
    GPIO_Init(LCD_RES_PORT, &GPIO_InitStruct);     // 初始化


    GPIO_InitStruct.Pins =  LCD_MISO_PIN;          // GPIO引脚
    GPIO_InitStruct.Mode = GPIO_MODE_INPUT_PULLUP; // 上拉输入
    GPIO_Init(LCD_MISO_PORT, &GPIO_InitStruct);    // 初始化

    GPIO_InitStruct.Pins =  LCD_PEN_PIN;           // GPIO引脚
    GPIO_InitStruct.Mode = GPIO_MODE_INPUT_PULLUP; // 上拉输入
    GPIO_Init(LCD_PEN_PORT, &GPIO_InitStruct);     // 初始化

}

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

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

#define LCD_SCLK_Clr()         GPIO_WritePin(LCD_SCLK_PORT, LCD_SCLK_PIN, GPIO_Pin_RESET)//SCL=SCLK
#define LCD_SCLK_Set()         GPIO_WritePin(LCD_SCLK_PORT, LCD_SCLK_PIN, GPIO_Pin_SET)

#define LCD_MOSI_Clr()         GPIO_WritePin(LCD_MOSI_PORT, LCD_MOSI_PIN, GPIO_Pin_RESET)//SDA=MOSI
#define LCD_MOSI_Set()         GPIO_WritePin(LCD_MOSI_PORT, LCD_MOSI_PIN, GPIO_Pin_SET)

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

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

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

#define LCD_CS_Clr()           GPIO_WritePin(LCD_CS1_PORT, LCD_CS1_PIN, GPIO_Pin_RESET)//CS1
#define LCD_CS_Set()           GPIO_WritePin(LCD_CS1_PORT, LCD_CS1_PIN, GPIO_Pin_SET)

将lcd_init.h 处的触摸功能引脚位带操作宏进行修改

//电阻屏芯片连接引脚
#define TCLK(x)     GPIO_WritePin(LCD_SCLK_PORT, LCD_SCLK_PIN, x?GPIO_Pin_SET:GPIO_Pin_RESET)   // SCLK
#define TDIN(x)     GPIO_WritePin(LCD_MOSI_PORT, LCD_MOSI_PIN, x?GPIO_Pin_SET:GPIO_Pin_RESET)   // MOSI
#define DOUT        GPIO_ReadPin(LCD_MISO_PORT, LCD_MISO_PIN)                                   // MISO
#define TCS(x)      GPIO_WritePin(LCD_CS2_PORT, LCD_CS2_PIN, x?GPIO_Pin_SET:GPIO_Pin_RESET)     // CS2
#define PEN         GPIO_ReadPin(LCD_PEN_PORT, LCD_PEN_PIN)                                     // PEN

然后我们打开 touch.c 文件将文件中的下列形式的语句换成后面的语句：

到这里软件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/PA6/PA7的SPI复用功能。其他对应接入的屏幕引脚请按照你的需要。这里选择的引脚见表硬件SPI接线

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

在lcd_init.h中添加LCD端口移植定义

//-----------------LCD端口移植----------------

#define RCC_LCD1_ENABLE()     __RCC_GPIOA_CLK_ENABLE()
#define RCC_LCD2_ENABLE()     __RCC_GPIOB_CLK_ENABLE()
#define RCC_SPI1_ENABLE()     __RCC_SPI1_CLK_ENABLE();

#define BSP_SPI1              CW_SPI1

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

#define LCD_SCLK_PORT         CW_GPIOA
#define LCD_SCLK_PIN          GPIO_PIN_5

#define LCD_MOSI_PORT         CW_GPIOA
#define LCD_MOSI_PIN          GPIO_PIN_7

#define LCD_RES_PORT          CW_GPIOB
#define LCD_RES_PIN           GPIO_PIN_0

#define LCD_DC_PORT           CW_GPIOB
#define LCD_DC_PIN            GPIO_PIN_1

#define LCD_BLK_PORT          CW_GPIOA
#define LCD_BLK_PIN           GPIO_PIN_2

#define LCD_MISO_PORT         CW_GPIOA
#define LCD_MISO_PIN          GPIO_PIN_6

#define LCD_CS1_PORT          CW_GPIOA
#define LCD_CS1_PIN           GPIO_PIN_4

#define LCD_CS2_PORT          CW_GPIOB
#define LCD_CS2_PIN           GPIO_PIN_9

#define LCD_PEN_PORT          CW_GPIOB
#define LCD_PEN_PIN           GPIO_PIN_12

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

void LCD_GPIO_Init(void)
{

    GPIO_InitTypeDef GPIO_InitStruct;   // GPIO初始化结构体

    RCC_LCD1_ENABLE();       // 使能GPIO时钟1
    RCC_LCD2_ENABLE();       // 使能GPIO时钟2
    RCC_SPI1_ENABLE();       // 使能SPI1时钟

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

    GPIO_InitStruct.Pins =  LCD_SCLK_PIN| // GPIO引脚
                            LCD_MOSI_PIN|
                            LCD_BLK_PIN|
                            LCD_CS1_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;    // 推挽输出
    GPIO_InitStruct.Speed = GPIO_SPEED_HIGH;       // 输出速度高
    GPIO_Init(LCD_SCLK_PORT, &GPIO_InitStruct);    // 初始化

    GPIO_InitStruct.Pins =  LCD_RES_PIN|
                            LCD_DC_PIN|
                            LCD_CS2_PIN;
    GPIO_Init(LCD_RES_PORT, &GPIO_InitStruct);     // 初始化


    GPIO_InitStruct.Pins =  LCD_MISO_PIN;      // GPIO引脚
    GPIO_InitStruct.Mode = GPIO_MODE_INPUT_PULLUP; // 上拉输入
    GPIO_Init(LCD_MISO_PORT, &GPIO_InitStruct);    // 初始化

    GPIO_InitStruct.Pins =  LCD_PEN_PIN;       // GPIO引脚
    GPIO_InitStruct.Mode = GPIO_MODE_INPUT_PULLUP; // 上拉输入
    GPIO_Init(LCD_PEN_PORT, &GPIO_InitStruct);     // 初始化


    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

}

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

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

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

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

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

#define LCD_CS_Clr()           GPIO_WritePin(LCD_CS1_PORT, LCD_CS1_PIN, GPIO_Pin_RESET)//CS1
#define LCD_CS_Set()           GPIO_WritePin(LCD_CS1_PORT, LCD_CS1_PIN, GPIO_Pin_SET)

将lcd_init.h 处的触摸功能引脚位带操作宏进行修改

//电阻屏芯片连接引脚
#define TCLK(x)     GPIO_WritePin(LCD_SCLK_PORT, LCD_SCLK_PIN, x?GPIO_Pin_SET:GPIO_Pin_RESET)   // SCLK
#define TDIN(x)     GPIO_WritePin(LCD_MOSI_PORT, LCD_MOSI_PIN, x?GPIO_Pin_SET:GPIO_Pin_RESET)   // MOSI
#define DOUT        GPIO_ReadPin(LCD_MISO_PORT, LCD_MISO_PIN)                                   // MISO
#define TCS(x)      GPIO_WritePin(LCD_CS2_PORT, LCD_CS2_PIN, x?GPIO_Pin_SET:GPIO_Pin_RESET)     // CS2
#define PEN         GPIO_ReadPin(LCD_PEN_PORT, LCD_PEN_PIN)                                     // PEN

然后我们打开 touch.c 文件将文件中的下列形式的语句换成后面的语句：

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

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

/******************************************************************************
      函数说明：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();
}

将touch.c文件中的 void TP_Write_Byte(u8 num) 函数修改为右图样式。

u16 TP_Write_Byte(u8 num)
{
    while (SPI_GetFlagStatus(BSP_SPI1, SPI_FLAG_TXE) == RESET);

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

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

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

    return temp;
}

这里因为 TP_Write_Byte(u8 num) 函数增加了返回类型为u16的返回值，故touch.h处关于TP_Write_Byte(u8 num) 的定义也要改为返回u16类型的返回值。

再将touch.c文件中的 u16 TP_Read_AD(u8 CMD) 函数修改为右图样式。

u16 TP_Read_AD(u8 CMD)
{
        u8 count = 0;
        u16 Num=0;
        TCS(0);                 //选中触摸屏IC
        TP_Write_Byte(CMD);//发送命令字
        Num=TP_Write_Byte(0xff)<<8;
        Num |= TP_Write_Byte(0xff);
        Num=Num>>4;
        TCS(1);                //释放片选
        return(Num);
}

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

4. 移植验证

验证之前，我们要给屏幕进行校准，出厂自带的参数不建议使用。

打开 touch.h 文件，找到 Adujust 的宏定义将后面的 1 修改为 0 ；

在main.c中输入代码如下

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 立创论坛：https://oshwhub.com/forum
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 * Change Logs:
 * Date           Author       Notes
 * 2024-06-18     LCKFB-LP    first version
 */
#include "board.h"
#include "stdio.h"
#include "bsp_uart.h"
#include "lcd.h"
#include "lcd_init.h"
#include "touch.h"
#include "pic.h"

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

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

    float t=0;
    u16 lastpos[2];//最后一次的数据

    LCD_Init();//LCD初始化
    LCD_Fill(0,0,LCD_W,LCD_H,WHITE);
    lastpos[0]=0XFFFF;

    LCD_ShowString(24,30,(uint8_t *)"LCD_W:",RED,WHITE,16,0);
    LCD_ShowIntNum(72,30,LCD_W,3,RED,WHITE,16);
    LCD_ShowString(24,50,(uint8_t *)"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);
    delay_1ms(1000);
    LCD_Fill(0,0,LCD_W,LCD_H,WHITE);

    TP_Init();
    LCD_ShowString(10,LCD_H-40,(uint8_t *)"X:",RED,WHITE,16,0);
    LCD_ShowIntNum(26,LCD_H-40,0,3,RED,WHITE,16);
    LCD_ShowString(10,LCD_H-20,(uint8_t *)"Y:",RED,WHITE,16,0);
    LCD_ShowIntNum(26,LCD_H-20,0,3,RED,WHITE,16);
    while(1)
    {
        tp_dev.scan(0);//扫描
        if(tp_dev.sta&TP_PRES_DOWN)//有按键被按下
        {
            delay_1ms(1);//必要的延时,否则老认为有按键按下.
            if((tp_dev.x[0]<(LCD_W-1)&&tp_dev.x[0]>=1)&&(tp_dev.y[0]<(LCD_H-1)&&tp_dev.y[0]>=1))
            {
                if(lastpos[0]==0XFFFF)
                {
                    lastpos[0]=tp_dev.x[0];
                    lastpos[1]=tp_dev.y[0];
                }
                //给触摸过的地方画线
                LCD_DrawRoughLine(lastpos[0],lastpos[1],tp_dev.x[0],tp_dev.y[0],BLUE);
                lastpos[0]=tp_dev.x[0];
                lastpos[1]=tp_dev.y[0];
                //显示当前触摸位置的X轴坐标
                LCD_ShowString(10,LCD_H-40,(uint8_t *)"X:",RED,WHITE,16,0);
                LCD_ShowIntNum(26,LCD_H-40,tp_dev.x[0],3,RED,WHITE,16);
                //显示当前触摸位置的Y轴坐标
                LCD_ShowString(10,LCD_H-20,(uint8_t *)"Y:",RED,WHITE,16,0);
                LCD_ShowIntNum(26,LCD_H-20,tp_dev.y[0],3,RED,WHITE,16);
                        }
                }
    }
}

上电效果：

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

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

入门教程资料

模块移植手册

显示类

传感器类

无线通信类

控制类

电压电流表训练营资料

1. 模块来源

2. 规格参数

3. 移植过程

3.1. 查看资料

3.2. 移植至工程

3.3. 引脚选择

3.4. 软件SPI移植

3.5. 硬件SPI移植

4. 移植验证

显示类

传感器类

无线通信类

控制类

​

1. 模块来源 ​

2. 规格参数 ​

3. 移植过程 ​

3.1. 查看资料 ​

3.2. 移植至工程 ​

3.3. 引脚选择 ​

3.4. 软件SPI移植 ​

3.5. 硬件SPI移植 ​

4. 移植验证 ​

1. 模块来源

2. 规格参数

3. 移植过程

3.1. 查看资料

3.2. 移植至工程

3.3. 引脚选择

3.4. 软件SPI移植

3.5. 硬件SPI移植

4. 移植验证