stc32g128k/Drivers/lcd.h

#ifndef __LCD_H__
#define __LCD_H__

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

/* ====== LHS114TC-IF03 (ST7789V) 屏幕参数与常数定义 ====== */
#define LCD_WIDTH     135    // 屏幕物理宽度 
#define LCD_HEIGHT    240    // 屏幕物理高度 
#define LCD_X_OFFSET  52     // 水平 X 轴物理偏置量 
#define LCD_Y_OFFSET  40     // 垂直 Y 轴物理偏置量 

// 16位 RGB565 颜色常量定义：
#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 供电芯片写入配置 
 */
void SGM_SendPulse(u8 pulse_cnt);

/**
 * @brief 执行 LHS114TC-IF03 屏幕的硬件复位 
 */
void LCD_Reset(void);

/**
 * @brief 初始化 LHS114TC-IF03 (ST7789V) 屏幕控制器 
 */
void LCD_Init(void);

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

/**
 * @brief 向屏幕写入 1 字节显示数据 
 */
void WriteData(u8 dat);

/**
 * @brief 设定屏幕的数据更新绘制窗口区域 
 */
void LCD_SetWindow(u16 x_start, u16 x_end, u16 y_start, u16 y_end);

/**
 * @brief 用指定色彩刷写清空全屏幕 
 */
void LCD_Clear(u16 color);

/* ====== 关键图形与点阵字符渲染接口 ====== */

/**
 * @brief 在屏幕指定视口绘制实心矩形 
 */
void LCD_FillRect(u16 x, u16 y, u16 w, u16 h, u16 color);

/**
 * @brief 绘制空心矩形边界框 
 */
void LCD_DrawRectBorder(u16 x, u16 y, u16 w, u16 h, u16 color);

/**
 * @brief 渲染显示一个单色字模位图资源 
 */
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 字符串 (左对齐) 
 */
void LCD_ShowString(u16 x, u16 y, char *str, u16 color, u16 bg_color);

/**
 * @brief 在指定 Y 轴高度上，自动计算偏移以实现字符串水平居中显示 
 */
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 规格字符串 
 */
void LCD_ShowString16x32Centered(u16 y, char *str, u16 color, u16 bg_color);

/* ====== 图标外部点阵数据声明 ====== */
extern unsigned char code FONT_8x16[95][16];                     // 8x16 英文点阵字库 
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__