docs: add detailed Chinese comments for code files and correct GPIO mapping table in main.md
This commit is contained in:
Antigravity IDE
235
App/config.h
235
App/config.h
@@ -4,156 +4,171 @@
|
||||
#include "stc32g.h"
|
||||
#include "intrins.h"
|
||||
|
||||
// 重新定义基础数据类型，便于跨平台和简化代码书写
|
||||
typedef unsigned char u8;
|
||||
typedef unsigned int u16;
|
||||
typedef unsigned long u32;
|
||||
|
||||
/* ====== 硬件引脚定义 (sbit) ====== */
|
||||
sbit MOTOR = P2^5; // 振动马达控制端 (推挽输出，与 SPI SCLK 物理共享引脚)
|
||||
sbit KEY_UP = P0^1; // 侧边按键 ▲ (高阻输入 + 上拉)
|
||||
sbit KEY_CONFIRM = P0^2; // 侧边按键 ■ (高阻输入 + 上拉)
|
||||
sbit KEY_DOWN = P0^3; // 侧边按键 ▼ (高阻输入 + 上拉)
|
||||
sbit KEY_SOS = P2^6; // 物理 SOS 求救按键 (高阻输入 + 上拉)
|
||||
sbit RGB_DIN = P2^3; // FCOB 幻彩灯条 DIN 控制线
|
||||
sbit SHUT = P2^2; // LR690L 射频芯片休眠/工作控制引脚 (低使能开启工作)
|
||||
sbit SGM_CTRL = P3^4; // SGM3833 PMIC 屏幕负压供电使能脚
|
||||
sbit LCD_RST = P1^0; // Truly AMOLED 屏幕复位脚 (RESET)
|
||||
sbit LCD_DCX = P1^1; // Truly AMOLED 屏幕数据/指令选择脚 (D/C)
|
||||
sbit LCD_SDI = P1^4; // Truly AMOLED 屏幕 SPI 数据脚 (MOSI)
|
||||
sbit LCD_SCL = P1^5; // Truly AMOLED 屏幕 SPI 时钟脚 (SCLK)
|
||||
sbit LCD_CS = P1^6; // Truly AMOLED 屏幕 SPI 片选脚 (CS)
|
||||
// 振动马达控制端 (推挽输出，与 SPI SCLK 物理共享引脚)
|
||||
sbit MOTOR = P2^5;
|
||||
// 侧边按键 ▲ (高阻输入 + 上拉)，按下为低电平
|
||||
sbit KEY_UP = P0^1;
|
||||
// 侧边按键 ■ (高阻输入 + 上拉)，按下为低电平
|
||||
sbit KEY_CONFIRM = P0^2;
|
||||
// 侧边按键 ▼ (高阻输入 + 上拉)，按下为低电平
|
||||
sbit KEY_DOWN = P0^3;
|
||||
// 物理 SOS 求救按键 (高阻输入 + 上拉)，按下为低电平
|
||||
sbit KEY_SOS = P2^6;
|
||||
// FCOB 幻彩灯条 DIN 数据控制线
|
||||
sbit RGB_DIN = P2^3;
|
||||
// LR690L 射频芯片休眠/工作控制引脚 (低电平使能开启工作)
|
||||
sbit SHUT = P2^2;
|
||||
// SGM3833 PMIC 屏幕负压供电使能脚 (1使能，0关闭)
|
||||
sbit SGM_CTRL = P3^4;
|
||||
// Truly AMOLED 屏幕复位脚 (RESET)，低电平复位
|
||||
sbit LCD_RST = P1^0;
|
||||
// Truly AMOLED 屏幕数据/指令选择脚 (D/C，1:数据, 0:命令)
|
||||
sbit LCD_DCX = P1^1;
|
||||
// Truly AMOLED 屏幕 SPI 数据脚 (MOSI/SDA)
|
||||
sbit LCD_SDI = P1^4;
|
||||
// Truly AMOLED 屏幕 SPI 时钟脚 (SCLK)
|
||||
sbit LCD_SCL = P1^5;
|
||||
// Truly AMOLED 屏幕 SPI 片选脚 (CS)，低电平有效
|
||||
sbit LCD_CS = P1^6;
|
||||
|
||||
/* ====== 系统状态 ====== */
|
||||
/* ====== 系统运行状态枚举 ====== */
|
||||
typedef enum {
|
||||
STATE_NORMAL,
|
||||
STATE_ARMED,
|
||||
STATE_DISARMED,
|
||||
STATE_PAIR_MENU,
|
||||
STATE_PAIR_WAIT,
|
||||
STATE_PAIR_CONFIRM,
|
||||
STATE_PAIR_SUCCESS,
|
||||
STATE_PAIR_FAIL,
|
||||
STATE_ALARM,
|
||||
STATE_SOS_EMITTED,
|
||||
STATE_SET_TIME, // 新增：时间调整编辑状态
|
||||
STATE_IPC_BIND, // 新增：摄像机绑定状态
|
||||
STATE_SLEEP // 新增：低功耗休眠挂起状态
|
||||
STATE_NORMAL, // 正常时钟待机状态
|
||||
STATE_ARMED, // 布防状态 (监测传感器警报)
|
||||
STATE_DISARMED, // 撤防状态 (忽略普通传感器警报)
|
||||
STATE_PAIR_MENU, // 传感器对码/配置主菜单状态
|
||||
STATE_PAIR_WAIT, // 等待传感器射频信号状态 (对码搜寻中)
|
||||
STATE_PAIR_CONFIRM, // 捕获到信号，进入防区微调确认状态
|
||||
STATE_PAIR_SUCCESS, // 对码成功反馈状态
|
||||
STATE_PAIR_FAIL, // 对码失败 (超时等) 反馈状态
|
||||
STATE_ALARM, // 传感器入侵报警状态
|
||||
STATE_SOS_EMITTED, // 处于 SOS 紧急求救发射状态
|
||||
STATE_SET_TIME, // 时间调整编辑状态 (修改小时、分钟)
|
||||
STATE_IPC_BIND, // 摄像机/IPC 绑定发射信号状态
|
||||
STATE_SLEEP // 低功耗休眠挂起状态
|
||||
} SystemState;
|
||||
|
||||
/* ====== 按键事件类型 ====== */
|
||||
/* ====== 按键事件类型枚举 ====== */
|
||||
typedef enum {
|
||||
KEY_EVENT_NONE,
|
||||
KEY_EVENT_UP_CLICK,
|
||||
KEY_EVENT_DOWN_CLICK,
|
||||
KEY_EVENT_SOS_CLICK,
|
||||
KEY_EVENT_UP_LONG,
|
||||
KEY_EVENT_DOWN_LONG,
|
||||
KEY_EVENT_SOS_LONG,
|
||||
KEY_EVENT_UP_DOWN_COMB,
|
||||
KEY_EVENT_CONFIRM_CLICK, // 新增：确认键短按
|
||||
KEY_EVENT_CONFIRM_LONG // 新增：确认键长按
|
||||
KEY_EVENT_NONE, // 无按键事件
|
||||
KEY_EVENT_UP_CLICK, // ▲ 键短按释放
|
||||
KEY_EVENT_DOWN_CLICK, // ▼ 键短按释放
|
||||
KEY_EVENT_SOS_CLICK, // SOS 键短按释放
|
||||
KEY_EVENT_UP_LONG, // ▲ 键长按事件 (触发布撤防切换)
|
||||
KEY_EVENT_DOWN_LONG, // ▼ 键长按事件 (菜单返回)
|
||||
KEY_EVENT_SOS_LONG, // SOS 键长按事件
|
||||
KEY_EVENT_UP_DOWN_COMB, // ▲ 与 ▼ 双键组合按下事件
|
||||
KEY_EVENT_CONFIRM_CLICK, // ■ 确认键短按事件 (保存设置或进入子菜单)
|
||||
KEY_EVENT_CONFIRM_LONG // ■ 确认键长按事件 (打开主菜单)
|
||||
} KeyEvent;
|
||||
|
||||
/* ====== 事件优先级 (步骤4) ====== */
|
||||
/* ====== 事件优先级枚举 ====== */
|
||||
typedef enum {
|
||||
EVENT_PRIORITY_LOW, // 0: 低优先级-系统内部事件
|
||||
EVENT_PRIORITY_NORMAL, // 1: 正常优先级-用户交互
|
||||
EVENT_PRIORITY_HIGH, // 2: 高优先级-报警事件
|
||||
EVENT_PRIORITY_URGENT // 3: 紧急优先级-SOS
|
||||
EVENT_PRIORITY_LOW, // 低优先级：系统内部状态更新 (如时钟分钟更新)
|
||||
EVENT_PRIORITY_NORMAL, // 正常优先级：用户按键交互、菜单导航
|
||||
EVENT_PRIORITY_HIGH, // 高优先级：无线传感器入侵警报
|
||||
EVENT_PRIORITY_URGENT // 紧急优先级：SOS 主动求救
|
||||
} EventPriority;
|
||||
|
||||
/* ====== 系统事件 (步骤4) ====== */
|
||||
/* ====== 系统事件结构体定义 ====== */
|
||||
typedef struct {
|
||||
KeyEvent key_event; // 按键事件类型
|
||||
EventPriority priority; // 事件优先级
|
||||
u32 extra_data; // 额外数据（射频地址等）
|
||||
u8 extra_size; // 额外数据有效字节数(0~4)
|
||||
KeyEvent key_event; // 关联的按键事件类型
|
||||
EventPriority priority; // 事件的处理优先级
|
||||
u32 extra_data; // 随事件携带的额外数据 (如 24 位射频源地址等)
|
||||
u8 extra_size; // 额外数据的有效字节大小 (0~4)
|
||||
} SystemEvent;
|
||||
|
||||
/* ====== 事件处理返回值 (步骤5) ====== */
|
||||
/* ====== 事件分发处理结果枚举 ====== */
|
||||
typedef enum {
|
||||
EVENT_HANDLED, // 事件已处理，停止分发
|
||||
EVENT_IGNORED // 事件未处理，继续传递
|
||||
EVENT_HANDLED, // 事件已成功处理，不再继续向后传递
|
||||
EVENT_IGNORED // 事件未被处理，允许继续传递给后台应用或丢弃
|
||||
} EventResult;
|
||||
|
||||
/* ====== 应用ID枚举 (步骤2) ====== */
|
||||
/* ====== 应用程序 ID 枚举 ====== */
|
||||
typedef enum {
|
||||
APP_ID_CLOCK, // 0: 待机时钟
|
||||
APP_ID_MENU, // 1: 主菜单
|
||||
APP_ID_PAIR, // 2: 配对
|
||||
APP_ID_ALARM, // 3: 传感器报警
|
||||
APP_ID_SOS, // 4: 主动求救
|
||||
APP_ID_MAX // 5: 应用数量上限
|
||||
APP_ID_CLOCK, // 待机时钟应用程序 (首屏)
|
||||
APP_ID_MENU, // 系统设置与操作主菜单应用程序
|
||||
APP_ID_PAIR, // 无线传感器对码学习应用程序
|
||||
APP_ID_ALARM, // 报警接收与波形反馈应用程序
|
||||
APP_ID_SOS, // 紧急呼救与无线发射应用程序
|
||||
APP_ID_MAX // 应用程序最大数量上限，用于数组大小
|
||||
} AppID;
|
||||
|
||||
/* ====== 应用类型 (步骤5) ====== */
|
||||
/* ====== 应用程序类型枚举 ====== */
|
||||
typedef enum {
|
||||
APP_TYPE_FOREGROUND, // 前台应用：独占屏幕
|
||||
APP_TYPE_BACKGROUND // 后台应用：无屏幕，监听事件
|
||||
APP_TYPE_FOREGROUND, // 前台应用：独占 OLED 屏幕显示并优先接收按键/射频事件
|
||||
APP_TYPE_BACKGROUND // 后台应用：无屏幕显示，静默监听前台未处理的系统事件
|
||||
} AppType;
|
||||
|
||||
/* ====== 应用描述符 ====== */
|
||||
/* ====== 应用程序描述符及函数指针类型定义 ====== */
|
||||
struct WristbandApp;
|
||||
typedef struct WristbandApp WristbandApp;
|
||||
|
||||
typedef void (*AppStartFunc)(void);
|
||||
typedef void (*AppRunFunc)(void);
|
||||
typedef void (*AppCloseFunc)(void);
|
||||
typedef EventResult (*AppEventFunc)(SystemEvent *evt);
|
||||
typedef void (*AppStartFunc)(void); // 应用启动函数指针类型
|
||||
typedef void (*AppRunFunc)(void); // 主循环轮询函数指针类型
|
||||
typedef void (*AppCloseFunc)(void); // 应用关闭清理函数指针类型
|
||||
typedef EventResult (*AppEventFunc)(SystemEvent *evt); // 事件接收处理函数指针类型
|
||||
|
||||
struct WristbandApp {
|
||||
AppID app_id;
|
||||
AppType app_type;
|
||||
char *app_name;
|
||||
void (*OnStart)(void);
|
||||
void (*onRun)(void);
|
||||
void (*onClose)(void);
|
||||
EventResult (*onEvent)(SystemEvent *evt);
|
||||
u8 is_active; // 是否当前活跃
|
||||
u8 is_running; // 是否允许运行 onRun
|
||||
AppID app_id; // 应用程序唯一标识 ID
|
||||
AppType app_type; // 前后台类型标识
|
||||
char *app_name; // 应用程序名称字符串 (供串口日志调试使用)
|
||||
void (*OnStart)(void); // 启动回调：应用加载时调用，用于初始化 UI 界面与硬件状态
|
||||
void (*onRun)(void); // 循环回调：在主循环中持续轮询调用，用于非阻塞业务更新
|
||||
void (*onClose)(void); // 关闭回调：应用退出时调用，用于现场清理与外设复位
|
||||
EventResult (*onEvent)(SystemEvent *evt); // 事件回调：接收系统事件，返回处理结果以控制事件流向
|
||||
u8 is_active; // 标记该应用当前是否处于活跃运行状态 (1表示前台活跃)
|
||||
u8 is_running; // 标记应用是否处于运行态，用于 CPU 超时挂起机制控制
|
||||
};
|
||||
|
||||
/* ====== 传感器存储结构 ====== */
|
||||
/* ====== 无线传感器 Flash 存储槽位结构体 ====== */
|
||||
typedef struct {
|
||||
unsigned char is_used;
|
||||
unsigned char addr[3];
|
||||
unsigned char type;
|
||||
unsigned char zone;
|
||||
unsigned char name_gbk[16];
|
||||
unsigned char is_used; // 槽位是否已使用标志 (0x01:已启用, 其他:空闲)
|
||||
unsigned char addr[3]; // 绑定的 24 位无线传感器 EV1527 硬件地址
|
||||
unsigned char type; // 传感器设备类型 (0:门磁, 1:红外PIR, 2:烟感, 3:燃气, 4:水浸)
|
||||
unsigned char zone; // 防区编号 (例如 1~99，0 代表 24小时紧急防区)
|
||||
unsigned char name_gbk[16];// 传感器的自定义名称 (GBK 编码，用于屏幕显示)
|
||||
} Sensor_Slot;
|
||||
|
||||
/* ====== 全局变量 extern 声明 ====== */
|
||||
extern SystemState current_state;
|
||||
extern u8 current_hour;
|
||||
extern u8 current_min;
|
||||
extern u8 current_sec;
|
||||
extern volatile u8 clock_updated;
|
||||
/* ====== 全局变量 extern 外部声明 ====== */
|
||||
extern SystemState current_state; // 系统当前整体运行状态
|
||||
extern u8 current_hour; // 当前系统时间：小时
|
||||
extern u8 current_min; // 当前系统时间：分钟
|
||||
extern u8 current_sec; // 当前系统时间：秒
|
||||
extern volatile u8 clock_updated; // 时钟分钟更新标志 (1表示需要刷新待机页时间)
|
||||
|
||||
extern u8 menu_select;
|
||||
extern u32 captured_addr;
|
||||
extern u8 captured_type;
|
||||
extern u8 alarm_sensor_slot;
|
||||
extern u8 menu_select; // 当前菜单高亮的选中项索引
|
||||
extern u32 captured_addr; // 对码或报警时，当前捕获到的传感器 24 位射频地址
|
||||
extern u8 captured_type; // 正在配对的传感器类型
|
||||
extern u8 alarm_sensor_slot; // 当前触发警报的传感器在数据库列表中的槽位索引
|
||||
|
||||
extern Sensor_Slot xdata sensor_list[16];
|
||||
extern char *code sensor_names_fr[5];
|
||||
extern Sensor_Slot xdata sensor_list[16];// 传感器数据库数组 (存储在 xdata 区，共 16 个槽位)
|
||||
extern char *code sensor_names_fr[5]; // 法语传感器设备类型默认名称字串数组
|
||||
|
||||
// 系统滴答与定时计数器 (均为 1ms 中断服务中更新)
|
||||
extern volatile u16 ms_tick; // 毫秒滴答计数器 (0~999循环)
|
||||
extern volatile u16 inactivity_timer; // 用户闲置计时器 (用作无操作自动休眠，单位10ms)
|
||||
extern volatile u32 pair_timeout_ms; // 对码等待搜寻超时毫秒计数器
|
||||
extern volatile u16 alarm_timer_ms; // 报警振动与闪烁定时计数器
|
||||
extern volatile u16 motor_timer_ms; // 马达单次震动定时计时器
|
||||
extern volatile bit alarm_flash_flag; // 报警屏幕红框闪烁的周期标志位 (0或1)
|
||||
|
||||
extern volatile u16 ms_tick;
|
||||
extern volatile u16 inactivity_timer; // 无操作闲置计时器
|
||||
extern volatile u32 pair_timeout_ms;
|
||||
extern volatile u16 alarm_timer_ms;
|
||||
extern volatile u16 motor_timer_ms;
|
||||
extern volatile bit alarm_flash_flag;
|
||||
// 按键长按与消抖状态机计数器
|
||||
extern volatile u16 key_scan_timer; // 按键扫描 10ms 分频计数器
|
||||
extern volatile u16 key_up_hold; // ▲ 键持续按下计时器
|
||||
extern volatile u16 key_down_hold; // ▼ 键持续按下计时器
|
||||
extern volatile u16 key_confirm_hold; // ■ 确认键持续按下计时器
|
||||
extern volatile u16 key_sos_hold; // SOS 键持续按下计时器
|
||||
extern volatile u16 comb_hold; // 组合键持续按下计时器
|
||||
|
||||
extern volatile u16 key_scan_timer;
|
||||
extern volatile u16 key_up_hold;
|
||||
extern volatile u16 key_down_hold;
|
||||
extern volatile u16 key_confirm_hold;
|
||||
extern volatile u16 key_sos_hold;
|
||||
extern volatile u16 comb_hold;
|
||||
|
||||
#define MAIN_Fosc 24000000UL
|
||||
#define CLONED_ADDR 0x37A86UL
|
||||
|
||||
#endif
|
||||
// 常量定义
|
||||
#define MAIN_Fosc 24000000UL // STC32G 主频工作频率定义 (24.0 MHz)
|
||||
#define CLONED_ADDR 0x37A86UL // 手环自身克隆发射的默认 24 位射频出厂 ID 地址
|
||||
|
||||
#endif // __CONFIG_H__
|
||||
|
||||
Reference in New Issue
Block a user