docs: 为所有代码源文件添加详细中文注释，并在设计文档中纠正GPIO物理引脚映射表

2026-07-16 17:52:52 +08:00
parent afd59d28ee
commit 731115e09a
26 changed files with 32803 additions and 53495 deletions
--- a/Drivers/lcd_font.h
+++ b/Drivers/lcd_font.h
@@ -1,6 +1,19 @@
 #ifndef __FONT_H__
 #define __FONT_H__

+/**************************************************************************
+ * @file lcd_font.h
+ * @brief 屏幕显示字库与单色位图数据定义文件
+ * @details 本文件存储了手环系统在 AMOLED 屏幕上渲染所使用的各类静态图形资源，
+ *          包含以下内容：
+ *          1. 电池电量单色图 (bmp_battery_20x10)
+ *          2. 布防/撤防指示用 16x16 锁图标 (bmp_lock, bmp_unlock)
+ *          3. 对码动画所需的 32x32 雷达动态扫描帧 (bmp_radar_32x32_f1 ~ f3)
+ *          4. 设备类型确认与保存界面用的 32x32 锁、成功对勾、失败红叉位图
+ *          5. 报警入侵指示用的 32x32 门磁大图 (bmp_door_32x32) 与警笛喇叭大图
+ *          6. 标准 8x16 英文 ASCII 字符点阵字库 (FONT_8x16)，用于文本渲染
+ * @note    所有数据均使用 `code` 关键字修饰，强制存储在单片机 Flash 空间中以节省 RAM。
+ **************************************************************************/

 // 1. Horizontal Battery Icon (20x10 pixels)
 // Width: 20 pixels (3 bytes per row), Height: 10 rows