软件SPI可以驱动屏幕

This commit is contained in:
2026-07-14 14:44:07 +08:00
parent 3577003fb6
commit 0a5c478a42
53 changed files with 9354 additions and 87 deletions

View File

@@ -0,0 +1,213 @@
/*
* 模块名称ST7735S LCD驱动
* 模块功能提供128x160 RGB TFT屏幕的初始化、画点、画线、填充、显示字符串等功能
* 适用平台STM32F103C8T6 + SPI2
* 作者:王建锋
* 创建日期2026-07-13
* 修改记录:
* 2026-07-13 王建锋 创建初始版本
*/
#ifndef __ST7735S_H
#define __ST7735S_H
#ifdef __cplusplus
extern "C" {
#endif
#include "main.h"
#include <stdint.h>
/* 屏幕参数 */
#define LCD_WIDTH 128 /* 屏幕宽度 */
#define LCD_HEIGHT 160 /* 屏幕高度 */
/* 颜色定义 (RGB565) */
#define COLOR_BLACK 0x0000
#define COLOR_WHITE 0xFFFF
#define COLOR_RED 0xF800
#define COLOR_GREEN 0x07E0
#define COLOR_BLUE 0x001F
#define COLOR_YELLOW 0xFFE0
#define COLOR_CYAN 0x07FF
#define COLOR_MAGENTA 0xF81F
#define COLOR_ORANGE 0xFD20
#define COLOR_DARK_BLUE 0x0010
#define COLOR_DARK_GREEN 0x0200
#define COLOR_DARK_RED 0x8000
/* 颜色转换宏 */
#define RGB565(r, g, b) ((uint16_t)(((r) & 0xF8) << 8 | ((g) & 0xFC) << 3 | ((b) >> 3)))
/* LCD控制引脚定义 - 根据CubeMX配置修改 */
#define LCD_CS_PORT LCD_CS_GPIO_Port
#define LCD_CS_PIN LCD_CS_Pin
#define LCD_DC_PORT LCD_DC_GPIO_Port
#define LCD_DC_PIN LCD_DC_Pin
#define LCD_RST_PORT LCD_RST_GPIO_Port
#define LCD_RST_PIN LCD_RST_Pin
#define LCD_SCL_PORT GPIOB
#define LCD_SCL_PIN GPIO_PIN_13
#define LCD_SDA_PORT GPIOB
#define LCD_SDA_PIN GPIO_PIN_15
/* LCD命令定义 */
#define LCD_CMD_SWRESET 0x01 /* 软件复位 */
#define LCD_CMD_SLPOUT 0x11 /* 退出睡眠 */
#define LCD_CMD_DISPON 0x29 /* 显示开启 */
#define LCD_CMD_DISPOFF 0x28 /* 显示关闭 */
#define LCD_CMD_CASET 0x2A /* 列地址设置 */
#define LCD_CMD_RASET 0x2B /* 行地址设置 */
#define LCD_CMD_RAMWR 0x2C /* 写入显存 */
#define LCD_CMD_MADCTL 0x36 /* 存储器访问控制 */
#define LCD_CMD_COLMOD 0x3A /* 像素格式设置 */
#define LCD_CMD_FRMCTR1 0xB1 /* 帧率控制1 */
#define LCD_CMD_FRMCTR2 0xB2 /* 帧率控制2 */
#define LCD_CMD_FRMCTR3 0xB3 /* 帧率控制3 */
#define LCD_CMD_INVCTR 0xB4 /* 显示反转控制 */
#define LCD_CMD_PWCTR1 0xC0 /* 功率控制1 */
#define LCD_CMD_PWCTR2 0xC1 /* 功率控制2 */
#define LCD_CMD_PWCTR3 0xC2 /* 功率控制3 */
#define LCD_CMD_PWCTR4 0xC3 /* 功率控制4 */
#define LCD_CMD_PWCTR5 0xC4 /* 功率控制5 */
#define LCD_CMD_VMCTR1 0xC5 /* VCOM控制1 */
#define LCD_CMD_GMCTRP1 0xE0 /* Gamma正向校正 */
#define LCD_CMD_GMCTRN1 0xE1 /* Gamma反向校正 */
/* 字体定义 */
#define FONT_WIDTH_8 8 /* 8x16字体宽度含间距 */
#define FONT_HEIGHT_16 16 /* 8x16字体高度 */
/*
* 函数功能LCD初始化
* 入口参数:无
* 返回值:无
* 函数说明初始化ST7735S屏幕包括SPI、GPIO、显示参数配置
*/
void st7735s_init(void);
/*
* 函数功能:设置显示窗口
* 入口参数x1 - 起始列
* y1 - 起始行
* x2 - 结束列
* y2 - 结束行
* 返回值:无
* 函数说明:设置后续写入操作的窗口区域
*/
void st7735s_set_window(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2);
/*
* 函数功能:填充矩形区域
* 入口参数x1 - 起始列
* y1 - 起始行
* x2 - 结束列
* y2 - 结束行
* color - 填充颜色 (RGB565)
* 返回值:无
* 函数说明:用指定颜色填充矩形区域
*/
void st7735s_fill_rect(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color);
/*
* 函数功能:全屏填充
* 入口参数color - 填充颜色 (RGB565)
* 返回值:无
* 函数说明:用指定颜色填充整个屏幕
*/
void st7735s_fill_screen(uint16_t color);
/*
* 函数功能:画点
* 入口参数x - 列坐标
* y - 行坐标
* color - 颜色 (RGB565)
* 返回值:无
* 函数说明:在指定位置画一个点
*/
void st7735s_draw_pixel(uint16_t x, uint16_t y, uint16_t color);
/*
* 函数功能:画线
* 入口参数x1 - 起始列
* y1 - 起始行
* x2 - 结束列
* y2 - 结束行
* color - 颜色 (RGB565)
* 返回值:无
* 函数说明画一条直线Bresenham算法
*/
void st7735s_draw_line(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color);
/*
* 函数功能:画矩形
* 入口参数x - 左上角列
* y - 左上角行
* width - 宽度
* height - 高度
* color - 颜色 (RGB565)
* 返回值:无
* 函数说明:画一个空心矩形
*/
void st7735s_draw_rect(uint16_t x, uint16_t y, uint16_t width, uint16_t height, uint16_t color);
/*
* 函数功能:画圆
* 入口参数x0 - 圆心列
* y0 - 圆心行
* radius - 半径
* color - 颜色 (RGB565)
* 返回值:无
* 函数说明画一个空心圆Bresenham算法
*/
void st7735s_draw_circle(uint16_t x0, uint16_t y0, uint16_t radius, uint16_t color);
/*
* 函数功能:显示字符
* 入口参数x - 列坐标
* y - 行坐标
* ch - 字符 (ASCII 32-126)
* color - 字符颜色 (RGB565)
* bg_color - 背景颜色 (RGB565)
* 返回值:无
* 函数说明在指定位置显示一个8x16 ASCII字符
*/
void st7735s_draw_char(uint16_t x, uint16_t y, char ch, uint16_t color, uint16_t bg_color);
/*
* 函数功能:显示字符串
* 入口参数x - 列坐标
* y - 行坐标
* str - 字符串指针
* color - 字符颜色 (RGB565)
* bg_color - 背景颜色 (RGB565)
* 返回值:无
* 函数说明:在指定位置显示字符串
*/
void st7735s_draw_string(uint16_t x, uint16_t y, const char *str, uint16_t color, uint16_t bg_color);
/*
* 函数功能:设置屏幕方向
* 入口参数rotation - 方向 (0-3)
* 返回值:无
* 函数说明:设置屏幕显示方向
* 0: 竖屏
* 1: 横屏
* 2: 竖屏反转
* 3: 横屏反转
*/
void st7735s_set_rotation(uint8_t rotation);
/*
* 函数功能:设置背光
* 入口参数state - 1:开 0:关
* 返回值:无
* 函数说明控制LCD背光如有硬件背光控制
*/
void st7735s_backlight(uint8_t state);
#ifdef __cplusplus
}
#endif
#endif /* __ST7735S_H */