stc32g128k/Drivers/lcd.h

#ifndef __LCD_H__
#define __LCD_H__

#include "../App/config.h"
#include "stc32g.h"

/* ====== Truly AMOLED RM69310 屏幕驱动 (RGB565格式) 常数定义 ====== */

// 16位 RGB565 颜色常量定义：
// 格式为：Red(5位) Green(6位) Blue(5位) 拼接而成的 16 位整数值
#define COLOR_BLACK   0x0000 // 黑色
#define COLOR_WHITE   0xFFFF // 白色
#define COLOR_CYAN    0x073F // 青色/天蓝色
#define COLOR_RED     0xF800 // 红色
#define COLOR_GREEN   0x07E0 // 绿色
#define COLOR_BLUE    0x001F // 蓝色
#define COLOR_GRAY    0x5AEB // 灰色
#define COLOR_AMBER   0xFDC0 // 琥珀色/橙黄色

/* ====== 屏幕电源控制与基本驱动接口 ====== */

/**
 * @brief 通过脉冲序列为 SGM3833 屏幕负压供电芯片发送开启配置脉冲
 * @param pulse_cnt 发送的脉冲个数 (例如 27 次脉冲开启并稳压屏幕输出)
 * @details 采用单线脉冲边沿计数调制技术，为 RM69310 控制芯片提供其正常显示所需的高质量偏置正负电压。
 */
void SGM_SendPulse(u8 pulse_cnt);

/**
 * @brief 执行 Truly AMOLED 屏幕的硬件复位
 * @details 将 LCD_RST 引脚拉低保持一定时间后拉高，强制复位屏幕控制器，使其恢复到初始逻辑状态。
 */
void LCD_Reset(void);

/**
 * @brief 初始化 Truly AMOLED 屏幕控制器 RM69310
 * @details 执行屏幕硬件复位，通过软件 SPI 总线依次向屏幕控制器写入寄存器偏置、显示周期、
 *          通道选择、关闭休眠 (Sleep Out: 0x11)、开启显示 (Display On: 0x29) 等一系列
 *          出厂初始化命令序列，使屏幕准备好接收显示像素帧。
 */
void LCD_Init(void);

/**
 * @brief 向屏幕写入 1 字节控制命令
 * @param cmd 8 位命令字节
 */
void WriteComm(u8 cmd);

/**
 * @brief 设定屏幕的数据更新绘制窗口区域 (显存写入范围)
 * @param x_start X 轴起始坐标 (0 ~ 119)
 * @param x_end   X 轴终止坐标 (0 ~ 119)
 * @param y_start Y 轴起始坐标 (0 ~ 239)
 * @param y_end   Y 轴终止坐标 (0 ~ 239)
 * @details 限定后续的数据流写入范围，实现局部页面刷新或全部页面刷新。
 */
void LCD_SetWindow(u16 x_start, u16 x_end, u16 y_start, u16 y_end);

/**
 * @brief 以指定纯色清除整个屏幕显示内容
 * @param color 16位 RGB565 颜色填充值
 */
void LCD_Clear(u16 color);


/* ====== 像素级图形几何算法与字符渲染接口 ====== */

/**
 * @brief 在屏幕指定位置绘制一个单色填充的实心矩形
 * @param x 矩形左上角 X 轴坐标
 * @param y 矩形左上角 Y 轴坐标
 * @param w 矩形宽度
 * @param h 矩形高度
 * @param color 16位 RGB565 填充色彩值
 */
void LCD_FillRect(u16 x, u16 y, u16 w, u16 h, u16 color);

/**
 * @brief 绘制一个无填充的空心矩形边界框
 * @param x 矩形左上角 X 轴坐标
 * @param y 矩形左上角 Y 轴坐标
 * @param w 边框总宽度
 * @param h 边框总高度
 * @param color 16位 RGB565 边框线条色彩
 */
void LCD_DrawRectBorder(u16 x, u16 y, u16 w, u16 h, u16 color);

/**
 * @brief 绘制渲染一个自定义宽高的单色单色位图
 * @param x 绘制的左上角 X 轴坐标
 * @param y 绘制的左上角 Y 轴坐标
 * @param w 单色图宽度 (单位: 像素点数)
 * @param h 单色图高度
 * @param bmp 单色位图所在的 FLASH code 区指针 (1位对应1像素：1画前景色，0画背景色)
 * @param color 位图前景色 (RGB565)
 * @param bg_color 位图背景色
 */
void LCD_DrawMonoBitmap(u16 x, u16 y, u16 w, u16 h, unsigned char code *bmp, u16 color, u16 bg_color);

/**
 * @brief 渲染显示一个 8x16 尺寸的普通英文 ASCII 字符
 */
void LCD_ShowChar8x16(u16 x, u16 y, char ch, u16 color, u16 bg_color);

/**
 * @brief 渲染显示一行普通的英文 ASCII 字符串 (左对齐)
 * @param x 绘制行起始 X 坐标
 * @param y 绘制行 Y 坐标
 * @param str 字符串头指针
 * @param color 字符颜色 (RGB565)
 * @param bg_color 字符背景背景填充色
 */
void LCD_ShowString(u16 x, u16 y, char *str, u16 color, u16 bg_color);

/**
 * @brief 在指定 Y 轴高度上，水平居中对齐显示一行字符串
 * @param y 渲染的 Y 轴高度 (0 ~ 239)
 * @param str 字符串内容
 * @param color 颜色值
 * @param bg_color 背景色
 */
void LCD_ShowStringCentered(u16 y, char *str, u16 color, u16 bg_color);

/**
 * @brief 渲染显示一个 16x32 大号特粗尺寸的英文/数字字符
 */
void LCD_ShowChar16x32(u16 x, u16 y, char ch, u16 color, u16 bg_color);

/**
 * @brief 显示大号特粗 16x32 规格的数字/英文字符串 (如时钟大字显示)
 */
void LCD_ShowString16x32(u16 x, u16 y, char *str, u16 color, u16 bg_color);

/**
 * @brief 在指定 Y 轴高度上，居中显示 16x32 特大规格字体的字符串
 * @param y 渲染的 Y 轴高度 (0 ~ 239)
 * @param str 大字字符串内容
 * @param color 大字前景色
 * @param bg_color 大字背景色
 */
void LCD_ShowString16x32Centered(u16 y, char *str, u16 color, u16 bg_color);


/* ====== 图标与点阵字模外部数据声明 ====== */
// 这些数据实体均定义在底层字库 lcd_font.h 文件中

extern unsigned char code FONT_8x16[95][16];                     // 8x16 英文 ASCII 点阵字库
extern unsigned char code bmp_battery_20x10[];                   // 20x10 电池电量指示位图
extern unsigned char code bmp_lock_16x16[];                      // 16x16 闭合锁头位图
extern unsigned char code bmp_unlock_16x16[];                    // 16x16 开启锁头位图
extern unsigned char code bmp_radar_32x32_f1[];                  // 32x32 雷达扩散帧 1
extern unsigned char code bmp_radar_32x32_f2[];                  // 32x32 雷达扩散帧 2
extern unsigned char code bmp_radar_32x32_f3[];                  // 32x32 雷达扩散帧 3
extern unsigned char code bmp_confirm_lock_32x32[];              // 32x32 传感器类型锁头大图
extern unsigned char code bmp_checkmark_32x32[];                 // 32x32 配对成功大对勾
extern unsigned char code bmp_cross_32x32[];                     // 32x32 配对失败大红叉
extern unsigned char code bmp_door_32x32[];                      // 32x32 门磁大警告图标
extern unsigned char code bmp_siren_32x32[];                     // 32x32 烟感喇叭警示图标

#endif // __LCD_H__