214 lines
6.5 KiB
C
214 lines
6.5 KiB
C
/*
|
||
* 模块名称：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 */
|