zouhaitao/stc32g128k
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 根据架构.odg重新设计重构手环系统的分层事件驱动APP框架设计文档

Browse Source
This commit is contained in:
zouhaitao
2026-07-10 09:17:27 +08:00
parent 52d84dfc97
commit 53b859b1c1
9 changed files with 657 additions and 914 deletions
Download Patch File Download Diff File Expand all files Collapse all files

516
Docs/30_architecture/main.md
View File

@@ -1,346 +1,170 @@
# 架构设计说明书 (Docs/30_architecture/main.md) # 架构设计说明书 (Docs/30_architecture/main.md)
本章节定义手环的系统软硬件架构设计，包括引脚分配、核心状态机迁移关系、持久化数据存储结构以及软件分层框架与主循环调度流程。 本章节定义手环的系统软硬件架构设计，包括引脚分配、基于事件驱动的 APP 框架微内核设计、事件生命周期流转机制以及持久化数据存储结构。
--- ---
## 1. 硬件原理图与引脚分配架构 ## 1. 硬件原理图与引脚分配架构
手环的完整电路连接设计参见以下 KiCad 硬件工程文件： 手环的完整电路连接设计参见以下 KiCad 硬件工程文件：
* **硬件原理图**：[text.kicad_sch](file:///c:/workfile/105/stc32g12k128/Hardware/text.kicad_sch) * **硬件原理图**：[text.kicad_sch](file:///c:/workfile/105/stc32g12k128/Hardware/text.kicad_sch)
* **PCB 布局图**：[text.kicad_pcb](file:///c:/workfile/105/stc32g12k128/Hardware/text.kicad_pcb) * **PCB 布局图**：[text.kicad_pcb](file:///c:/workfile/105/stc32g12k128/Hardware/text.kicad_pcb)
主控芯片采用 **STC32G12K128**（工作频率 24.0 MHz，单周期 8051 内核，32位乘除法器）。 主控芯片采用 **STC32G12K128**（工作频率 24.0 MHz，单周期 8051 内核，32位乘除法器）。
显示端采用 **Truly 0.95寸 AMOLED 屏幕**，物理分辨率为 **120x240 像素**，控制芯片为 **RM69310**。 显示端采用 **Truly 0.95寸 AMOLED 屏幕**，物理分辨率为 **120x240 像素**，控制芯片为 **RM69310**。
### 1.1 GPIO 物理映射表 ### 1.1 GPIO 物理映射表
| 芯片引脚号 | 引脚名称 | 逻辑网络标号 | IO 模式 | 连接外设与功能描述 |
| :--- | :--- | :--- | :--- | :--- | | 芯片引脚号 | 引脚名称 | 逻辑网络标号 | IO 模式 | 连接外设与功能描述 |
| **Pin 1** | `P1.0` | `TXD` | 推挽输出 | 串口 1 (UART1) 发送脚 | | :--- | :--- | :--- | :--- | :--- |
| **Pin 2** | `P1.1` | `RXD` | 高阻输入 | 串口 1 (UART1) 接收脚 | | **Pin 1** | `P1.0` | `TXD` | 推挽输出 | 串口 1 (UART1) 发送脚 |
| **Pin 4** | `P1.5` | `+3.3V` | 电源 | 屏幕/系统 3.3V 逻辑供电 | | **Pin 2** | `P1.1` | `RXD` | 高阻输入 | 串口 1 (UART1) 接收脚 |
| **Pin 5** | `P1.6` | `+3.3V` | 电源 | 屏幕/系统 3.3V 逻辑供电 | | **Pin 4** | `P1.5` | `+3.3V` | 电源 | 屏幕/系统 3.3V 逻辑供电 |
| **Pin 6** | `P1.7` | `TP_RST` | 推挽输出 | 触摸屏复位脚 (NC) | | **Pin 5** | `P1.6` | `+3.3V` | 电源 | 屏幕/系统 3.3V 逻辑供电 |
| **Pin 8** | `UCAP` | `TP_INT` | 输入中断 | 触摸屏中断唤醒脚 (NC) | | **Pin 6** | `P1.7` | `TP_RST` | 推挽输出 | 触摸屏复位脚 (NC) |
| **Pin 9** | `P5.4` | `SPI_SDO` | 推挽输出 | Truly AMOLED 屏幕 SPI 串行数据输出 (MISO) | | **Pin 8** | `UCAP` | `TP_INT` | 输入中断 | 触摸屏中断唤醒脚 (NC) |
| **Pin 10** | `Vcc` | `SPI_CS` | 推挽输出 | Truly AMOLED 屏幕 SPI 片选信号 (CS) | | **Pin 9** | `P5.4` | `SPI_SDO` | 推挽输出 | Truly AMOLED 屏幕 SPI 串行数据输出 (MISO) |
| **Pin 11** | `VREF+` | `SPI_CLK` | 推挽输出 | Truly AMOLED 屏幕 SPI 串行时钟信号 (SCL) | | **Pin 10** | `Vcc` | `SPI_CS` | 推挽输出 | Truly AMOLED 屏幕 SPI 片选信号 (CS) |
| **Pin 12** | `GND` | `SPI_SDI` | 推挽输出 | Truly AMOLED 屏幕 SPI 串行数据输入 (MOSI/SDA) | | **Pin 11** | `VREF+` | `SPI_CLK` | 推挽输出 | Truly AMOLED 屏幕 SPI 串行时钟信号 (SCL) |
| **Pin 13** | `P3.0` | `SPI_DCX` | 推挽输出 | Truly AMOLED 屏幕 SPI 数据/指令选择脚 (D/C) | | **Pin 12** | `GND` | `SPI_SDI` | 推挽输出 | Truly AMOLED 屏幕 SPI 串行数据输入 (MOSI/SDA) |
| **Pin 14** | `P3.1` | `DIS_RST` | 推挽输出 | Truly AMOLED 屏幕复位控制脚 (RESET) | | **Pin 13** | `P3.0` | `SPI_DCX` | 推挽输出 | Truly AMOLED 屏幕 SPI 数据/指令选择脚 (D/C) |
| **Pin 19** | `P3.6` | `KEY_DOWN` | 高阻输入 + 上拉 | 侧边按键 ▼ (下移)，按下为低电平 | | **Pin 14** | `P3.1` | `DIS_RST` | 推挽输出 | Truly AMOLED 屏幕复位控制脚 (RESET) |
| **Pin 20** | `P3.7` | `KEY_CONFIRM` | 高阻输入 + 上拉 | 侧边按键 ■ (确认/菜单)，按下为低电平 | | **Pin 19** | `P3.6` | `KEY_DOWN` | 高阻输入 + 上拉 | 侧边按键 ▼ (下移)，按下为低电平 |
| **Pin 21** | `P2.0` | `KEY_UP` | 高阻输入 + 上拉 | 侧边按键 ▲ (上移)，按下为低电平 | | **Pin 20** | `P3.7` | `KEY_CONFIRM` | 高阻输入 + 上拉 | 侧边按键 ■ (确认/菜单)，按下为低电平 |
| **Pin 22** | `P2.1` | `BAT_ADC` | 模拟输入 | 电池电压采样输入端口，对应硬件 ADC 通道 9 (A9) | | **Pin 21** | `P2.0` | `KEY_UP` | 高阻输入 + 上拉 | 侧边按键 ▲ (上移)，按下为低电平 |
| **Pin 23** | `P2.2` | `DET` | 高阻输入 | USB 插入充电检测引脚，高电平代表正在充电 | | **Pin 22** | `P2.1` | `BAT_ADC` | 模拟输入 | 电池电压采样输入端口，对应硬件 ADC 通道 9 (A9) |
| **Pin 24** | `P2.3` | `KEY_SOS` | 高阻输入 + 上拉 | 上部并联 SOS 求救按键，按下为低电平 | | **Pin 23** | `P2.2` | `DET` | 高阻输入 | USB 插入充电检测引脚，高电平代表正在充电 |
| **Pin 25** | `P2.4` | `MOTOR_PWM` | 推挽输出 | 连接振动马达驱动电路。高电平震动，低电平静止 | | **Pin 24** | `P2.3` | `KEY_SOS` | 高阻输入 + 上拉 | 上部并联 SOS 求救按键，按下为低电平 |
| **Pin 27** | `P2.6` | `LED_RGB` | SPI MOSI | WS2812B 级联双幻彩灯珠 DIN 控制信号 | | **Pin 25** | `P2.4` | `MOTOR_PWM` | 推挽输出 | 连接振动马达驱动电路。高电平震动，低电平静止 |
| **Pin 28** | `P2.7` | `SHUT` | 推挽输出 | OLED 供电芯片 SGM3833 控制引脚。高电平开启供电，低电平切断 | | **Pin 27** | `P2.6` | `LED_RGB` | SPI MOSI | WS2812B 级联双幻彩灯珠 DIN 控制信号 |
| **Pin 29** | `P0.0` | `RF_RX_DATA` | 输入中断 | LR690L 433MHz 射频接收芯片数据输出脚 (INT0/INT2) | | **Pin 28** | `P2.7` | `SHUT` | 推挽输出 | OLED 供电芯片 SGM3833 控制引脚。高电平开启供电，低电平切断 |
| **Pin 30** | `P0.1` | `RF_TX` | 推挽输出 | LR690L 射频芯片发射使能控制引脚 | | **Pin 29** | `P0.0` | `RF_RX_DATA` | 输入中断 | LR690L 433MHz 射频接收芯片数据输出脚 (INT0/INT2) |
| **Pin 31** | `P0.2` | `RF_RX` | 推挽输出 | LR690L 射频芯片接收使能控制引脚 | | **Pin 30** | `P0.1` | `RF_TX` | 推挽输出 | LR690L 射频芯片发射使能控制引脚 |
| **Pin 32** | `P0.3` | `RF_TX_DAT` | 推挽输出 | LR690L 射频芯片发射调制数据输入引脚 | | **Pin 31** | `P0.2` | `RF_RX` | 推挽输出 | LR690L 射频芯片接收使能控制引脚 |
| **Pin 32** | `P0.3` | `RF_TX_DAT` | 推挽输出 | LR690L 射频芯片发射调制数据输入引脚 |
---
---
## 2. 软件核心业务状态机
## 2. 软件事件驱动 APP 框架 (Event-Driven App-Framework)
系统包含 10 个业务状态，其状态迁移关系如下图所示：
手环软件系统摒弃了传统的单线程前后台大循环设计，采用分层明确的 **事件驱动式 APP 框架** 架构。
```mermaid
stateDiagram-v2 ### 2.1 五层软件架构模型
[*] --> STATE_CLOCK
```mermaid
%% 休眠与唤醒 graph TD
STATE_CLOCK --> STATE_SLEEP : 10秒无操作超时 %% 5层立体依赖结构
STATE_SLEEP --> STATE_CLOCK : 中断唤醒 (按键/无线信号) subgraph LayerApps ["1. 应用业务层 (Applications)"]
ActiveApp["当前活跃应用 (Foreground App)"]
%% 主选择菜单迁移 BgApp["后台监测应用 (Background App)"]
STATE_CLOCK --> STATE_MENU : CONFIRM 长按 3 秒 end
STATE_MENU --> STATE_CLOCK : CONFIRM 长按 3 秒 / 10秒无操作超时
STATE_MENU --> STATE_SLEEP : 10秒无操作超时 subgraph LayerAppMgr ["2. 应用管理层 (APP Management)"]
AppManager["APP 管理器 (StartApp / CloseApp)"]
%% 子设置页面迁移 Lifecycle["生命周期调度机"]
STATE_MENU --> STATE_SET_TIME : 选中 "1. HORLOGE" + 确认键单击 end
STATE_SET_TIME --> STATE_CLOCK : 保存退出 / 10秒无操作超时
subgraph LayerEvent ["3. 事件总线层 (Event Layer)"]
STATE_MENU --> STATE_PAIR_SEARCH : 选中 "2. APPAIR." + 确认键单击 EventDispatcher["事件分配器 (Event Dispatcher)"]
STATE_PAIR_SEARCH --> STATE_PAIR_CONFIRM : 捕获 433MHz 传感器数据 (自动识别传感器类型) EventQueue["事件环形缓冲区 (EventQueue)"]
STATE_PAIR_CONFIRM --> STATE_CLOCK : 序号微调后 CONFIRM 确认保存 end
STATE_PAIR_SEARCH --> STATE_MENU : 长按 ▼ 键退出
subgraph LayerDrivers ["4. 中断与驱动层 (Drivers)"]
STATE_MENU --> STATE_ARM_DISARM_SELECT : 选中 "3. ALARME" + 确认键单击 ExtInt["外部中断 (KEY按键扫描 / RF解码)"]
STATE_ARM_DISARM_SELECT --> STATE_CLOCK : 选择完成并返回 TimeInt["时钟中断 (Timer1 1ms时基)"]
ADC_Drv["ADC 电量采集"]
STATE_MENU --> STATE_IPC_BIND : 选中 "4. LIAISON" + 确认键单击 LCD_Drv["LCD 屏幕绘制驱动"]
STATE_IPC_BIND --> STATE_CLOCK : 发射结束 / 确认键长按 3s 退出 / ▼键长按 2s 退出 end
%% 报警迁移 subgraph LayerHW ["5. 硬件实体层 (STC32 HW)"]
STATE_CLOCK --> STATE_SOS_EMITTED : 按下上部任意 SOS 键 (点击/长按) MCU["STC32G 单片机核心"]
STATE_SLEEP --> STATE_SOS_EMITTED : 中断唤醒直接报警 end
STATE_SOS_EMITTED --> STATE_CLOCK : 按任意键/超时退出
%% 单向数据与控制交互
STATE_CLOCK --> STATE_ALARMING : 捕获已配对传感器报警 (ZONE 0 或布防下的 ZONE 1) LayerHW ===> LayerDrivers
STATE_ALARMING --> STATE_CLOCK : 按任意键/超时退出 LayerDrivers ===>|异步推送事件| LayerEvent
``` LayerEvent ===>|事件分发路由| LayerAppMgr
LayerAppMgr ===>|生命周期回调与分发| LayerApps
### 2.1 低功耗设计与唤醒架构 LayerApps ===>|调用显示/报警动作| LayerDrivers
为实现超低功耗，系统在 `STATE_SLEEP` 状态下使用以下硬件与软件协同设计： ```
1. **彻底切断 PMIC**：拉低 `SGM_CTRL = 0`，使 SGM3833 停止工作，彻底消除 Truly AMOLED 屏的负压静态功耗。
2. **休眠配置**：允许 P0 口电平变化中断与射频接收引脚的中断使能。 ---
3. **进入停机**：将单片机挂起写入 `PCON |= 0x02` 进入停机模式，关闭主时钟。
4. **中断唤醒**：按键按下或 LR690L 接收到载波变化时，触发中断唤醒 MCU，ISR 立即拉高 `SGM_CTRL = 1` 并延时约 50ms 重新初始化 RM69310 屏幕控制器以恢复显示。 ## 3. 应用生命周期机制 (APP Lifecycle)
--- 手环中运行的各个子功能页面（如时钟、菜单、对码、布防）均被抽象为独立的 **App 实例**。每个 App 必须注册并实现以下生命周期回调接口：
## 3. 持久化配置数据库架构 ```c
typedef struct {
为了确保配对数据掉电不丢失，手环使用内置 IAP 读写 Flash 扇区： u8 app_id; // 应用程序 ID
* **物理存储扇区**：`0xFE0000` (末尾扇区，大小为 512 字节)。 void (*OnStart)(void); // 启动回调：应用切入前台，加载资源、初始化显示
* **数据库容量**：共 16 组传感器配置槽位。 void (*onRun)(void); // 循环回调：主循环轮询轮空调用，执行非阻塞业务逻辑
* **存储结构定义**： void (*onClose)(void); // 关闭回调：应用退出前台，保存状态、清理外设
```c void (*onEvent)(KeyEvent evt); // 事件回调：接收并消耗来自事件层的系统事件
typedef struct { } WristbandApp;
u8 is_used; // 有效标志 (0x01: 有效, 其它: 空闲) ```
u8 addr[3]; // 24位射频物理地址 (EV1527)
u8 type; // 传感器类型 (0: 门磁, 1: 红外, 2: 烟感, 3: 紧急, 4: 气体, 5: 水浸, 6: 振动) ### 3.1 活跃应用切换逻辑 (APP Switch)
u8 zone; // 防区类别 (0: 永久防区, 1: 普通可撤布防区) 1. 当调用 `StartApp(target_app_id)` 时：
char name_gbk[16]; // 法语自定义防区名称 (格式化为: [名前缀] [两位序号]) * 触发当前活跃应用的 `onClose()` 接口，执行现场保存及关屏/停振等外设清理。
} Sensor_Slot; * 更新活跃应用指针指向新 App。
``` * 触发新活跃应用的 `OnStart()` 接口，执行初始画面的绘制（置 `Redraw = 1`）。
2. 在主循环中，系统不断执行当前活跃应用的 `onRun()` 接口，以维护非阻塞的页面动画或等待超时逻辑。
---
---
## 4. 软件层级架构与核心代码框架
## 4. 事件采集、缓冲与流转机制 (Event Bus)
软件系统采用 **分层依赖、事件驱动、非阻塞** 的模块化架构设计。其层级结构与核心依赖关系如下：
事件总线层是实现前后台解耦的核心。
### 4.1 系统软件架构分层 (三层架构设计)
```mermaid
为了清晰呈现系统的软硬件隔离层次，手环系统采用单向依赖的层级架构： graph LR
%% 事件的产生与消耗流转
```mermaid HW_Sig["物理引脚状态跳变"] -->|电平变化中断| Driver["驱动中断 ISR"]
graph TD Driver -->|消抖/自适应解调| Packer["封装统一事件 (KeyEvent)"]
subgraph APP ["应用逻辑层 (APP Layer)"] Packer -->|Key_Push_Event| Queue["Event Ring Buffer (环形队列)"]
MainScheduler["主循环调度 (main.c)"] Queue -->|Key_Pop_Event| MainLoop["MainLoop 轮询读取"]
SysStateMachine["业务状态机 (sys_state)"] MainLoop -->|事件分发| AppMgr["APP 管理器"]
end AppMgr -->|onEvent(evt) 回调| ActiveApp["当前活跃 App 实例"]
subgraph DRV ["外设驱动层 (DRV Layer)"] ```
KEY["KEY 驱动"]
RF["RF 驱动"] ### 4.1 环形事件缓冲区 (EventQueue)
AMOLED["AMOLED 屏刷"] 为防止高速按键或多输入源并发导致事件丢失，系统建立一个深度为 4 级的环形事件队列。按键消抖模块与 RF 模块作为 **事件产生者** 将数据推送至队列：
PM["PM 功耗驱动"] * **按键事件产生**：Timer1 定时器每 10ms 中断扫描物理引脚，判定有效按键后执行 `Key_Push_Event(KEY_UP_SHORT)`。
LED["LED 彩灯驱动"] * **RF 事件产生**：LR690L 接收中断触发，解码线程还原 24 位载波包，识别到配对传感器动作，推送对应防区事件。
MOTOR["马达震动驱动"] * **事件路由**：主循环轮询事件队列，若队列非空，`Key_Pop_Event()` 读出事件并分配给当前活跃应用的 `onEvent(evt)` 执行特异化响应。
end
subgraph HW ["硬件抽象与时基层 (HW Layer)"] ---
Timer1["Timer 1 中断时基"]
GPIO["GPIO / ADC / IAP Flash"] ## 5. 持久化配置数据库架构
end
手环配对防区数据存储在 STC32G 内置 Flash 的第 254 扇区：
HW ===>|驱动时基与中断沿| DRV * **物理存储地址**：`0xFE0000` (末尾 512 字节)。
DRV ===>|提供抽象API与事件缓冲区| APP * **数据库容量**：共 16 组传感器配置槽位。
APP ===>|调度外设控制指令| DRV * **存储结构定义**：
``` ```c
typedef struct {
### 4.2 输入事件采集与流转链条 (Input Event Dataflow) u8 is_used; // 有效标志 (0x01: 有效, 其它: 空闲)
u8 addr[3]; // 24位射频物理地址 (EV1527)
展示按键与无线接收信号从物理引脚触发，经过驱动消抖/解码，进入软件事件缓冲区，并最终被主循环及状态机消费的完整依赖链路： u8 type; // 传感器类型 (0: 门磁, 1: 红外, 2: 烟感, 3: 紧急, 4: 气体, 5: 水浸, 6: 振动)
u8 zone; // 防区类别 (0: 永久防区, 1: 普通可撤布防区)
```mermaid char name_gbk[16]; // 法语自定义防区名称 (格式化为: [名前缀] [两位序号])
graph LR } Sensor_Slot;
%% 输入物理源 -> 驱动解码 -> 软件缓冲区 -> 状态机消费 ```
Pin_Key["物理按键 P2.0-P3.7"] -->|10ms 定时扫描| KEY["KEY 扫描与消抖"]
KEY -->|判定按键事件| Buf_Key["key_event_buf (环形事件队列)"] ---
Buf_Key -->|主循环读取并清除| Scheduler["主循环 (main.c)"]
## 6. 核心业务事件输入输出 (I/O) 架构明细表
Pin_RF["433MHz 载波沿信号"] -->|INT2 中断触发| RF["RF 自适应解调解码"]
RF -->|解码合法 RFEvent| Scheduler 手环核心事件在整个框架中的端到端流动及消耗链路如下：
Scheduler -->|分发有效事件| StateMachine["业务状态机 (SysState)"] | 事件名称 | 输入源 (触发条件与参数) | 事件总线流转 (产生端 -> 分发端) | 活跃 APP 消费处理 (逻辑响应与动作) |
``` | :--- | :--- | :--- | :--- |
| **按键操作事件**<br>`KEY_EVENT` | **源**：Pin 19/20/21 下降沿中断。<br>**参数**：▲/▼/■ (短按/长按)。 | **产生**：`KEY` 驱动 10ms 中断消抖扫描包装。<br>**分发**：`Key_Push_Event` 压入队列，主循环读出并传入活跃 App。 | **待机应用**：长按确认键 3 秒，调用 `StartApp(APP_MENU)`；<br>**菜单应用**：短按 ▲/▼ 键移动高亮焦点；短按确认键调用 `StartApp` 进入对应子设置应用。 |
### 4.3 控制输出与外设执行链路 (Output Control Flow) | **主动求救事件**<br>`SOS_ACTIVE_EVENT` | **源**：Pin 24 (`P2.3`) SOS 物理键拉低。 | **产生**：检测到低电平，直接压入事件队列 `KEY_SOS_ACTIVE`。<br>**分发**：主循环捕获，APP 管理器强制抢占调用 `StartApp(APP_SOS)`。 | **SOS报警应用**：<br>1. 显示：AMOLED 亮起 `SOS EMIS`；<br>2. 灯效：WS2812B 红色交替闪烁 (50ms)；<br>3. 马达：开启间歇长振 (振1000ms，停200ms)；<br>4. 射频：启动发送线程周期性（2s）发射手环 Factory ID 及 `0x08` (SOS) 包。 |
| **无线对码捕获事件**<br>`RF_PAIR_RECV_EVENT` | **源**：Pin 29 沿变化中断。<br>**参数**：EV1527 24位对码信号。 | **产生**：RF 驱动解调同步头并还原二进制码字。<br>**分发**：包装为 `RF_PAIR_EVENT` 传入事件队列，主循环分发。 | **配对应用**：<br>1. 状态：跳转进入 `STATE_PAIR_CONFIRM` (微调保存页)；<br>2. 显示：只读显示自动识别的传感器类型及大图标；<br>3. 马达：短振 300ms 提醒成功；<br>4. 交互：通过按键微调序号并写入 Flash 数据库。 |
展示业务状态机跳转后，如何通过驱动层向底层硬件引脚输出电平信号，以驱动显示、声光报警、马达振动及电源 PMIC 切断： | **传感器入侵警报事件**<br>`RF_ALARM_RECV_EVENT` | **源**：Pin 29 沿变化中断。<br>**参数**：传感器物理地址 + 4位状态码。 | **产生**：RF 驱动还原码字。<br>**分发**：主循环比对 Flash 数据库匹配槽位成功，触发防区报警事件。 | **警报应用**：若该防区为 ZONE 0 (24h) 或处于已布防，APP管理器启动 `StartApp(APP_ALARM)`。<br>1. 显示：AMOLED 刷红边框与对应大图标，显示入侵警报文字；<br>2. 灯效：同步闪烁该防区专属色彩；<br>3. 马达：输出对应防区的特定异步振动波形。 |
| **系统自动休眠事件**<br>`AUTO_SLEEP_EVENT` | **源**：软件时钟计时 `inactivity_timer >= 1000` (10s)。 | **产生**：Timer1 中断秒分频累加。<br>**分发**：触发超时休眠事件，分发至当前应用。 | **所有非警报应用**：执行 `onClose()` $
```mermaid ightarrow$ 调用 PM 模块拉低 `SHUT=0`（Pin 28）彻底切断屏幕供电 $
graph LR ightarrow$ 配置 GPIO 变化中断和无线唤醒源 $
%% 状态机 -> 外设执行接口 -> 物理引脚拉低/高 ightarrow$ 执行 `PCON|=0x02` 进入停机休眠。 |
StateMachine["业务状态机 (SysState)"] -->|Redraw=1 重绘页面| AMOLED["Truly RM69310 绘制"]
StateMachine -->|防区警示闪烁| LED["WS2812B 彩灯控制"]
StateMachine -->|特定防区震动模式| MOTOR["马达时序控制"]
StateMachine -->|无操作 10s 超时休眠| PM["PM 功耗与电源断电"]
AMOLED -->|SPI 引脚输出| Pin_OLED["OLED 屏幕 (Pin 9-14)"]
LED -->|P2.6 单线时序| Pin_LED["RGB 灯珠 (Pin 27)"]
MOTOR -->|P2.4 PWM 电平| Pin_Mot["马达驱动 (Pin 25)"]
PM -->|P2.7 SHUT 拉低| Pin_PMIC["SGM3833 PMIC (Pin 28)"]
```
### 4.4 架构设计与依赖原则说明
1. **单向依赖原则**：
* **APP 层**仅依赖于 **DRV 层**提供的高级抽象接口（例如 `LED_Set_Color`、`Motor_Start_Pattern`）和 **HW 层**的数据库读写。**严禁**在 APP 层直接写入具体 IO 寄存器。
* **DRV 层**调用 **HW 层**提供的基础时基与 GPIO 端口函数，不保存任何系统级别的状态变量（`current_state` 等）。
* **HW 层**为最底层，除触发中断服务子程序 (ISR) 外，不依赖任何上层逻辑。
2. **事件驱动与非阻塞机制**：
* **按键事件缓冲机制**：`KEY` 驱动在 Timer1 中断中进行每 10ms 的定时扫描消抖。识别到有效按键动作后，将其转换为 `KeyEvent` 并压入内部的 **环形事件队列**。主循环通过轮询读出该事件，避免了在按键按下时产生任何 `while` 等待导致系统挂起。
* **马达与彩灯的异步时序设计**：`MOTOR` 与 `LED` 的报警波形（如：长震、间歇闪烁）均采用在 1ms 中断中自动扣减计数器的方式实现。APP 层发出启动指令后立即返回，由硬件中断负责底层的波形电平跳转，保证了射频解码及按键响应不会因为声光报警动作而产生卡顿。
3. **电源控制与低功耗恢复链条**：
* 休眠决策完全由主循环内的 `inactivity_timer` 进行倒计时判定。
* 进入休眠前，由 `PM` 驱动断开 `SGM3833` 电源以彻底消除 AMOLED 的暗漏电流。
* 唤醒时，由 GPIO 的电平沿变化触发中断，唤醒 CPU 后由 `PM` 优先执行 **“上电 -> 强延时 50ms 避开浪涌 -> 屏幕控制器重初始化”** 的安全恢复时序，防止未稳定电网下的写屏导致屏幕损坏或花屏。
### 4.5 核心主程序调度框架 (main.c)
主程序采用完全解耦的时间片轮询加事件触发的非阻塞循环结构：
```c
#include "config.h"
// 全局状态变量
SystemState current_state;
u16 inactivity_timer;
u32 rx_addr;
u8 rx_type;
void main(void) {
// 1. 初始化底层硬件与外设驱动
System_Init();
Power_Init(); // SGM_CTRL 默认拉高工作
LCD_Init(); // Truly AMOLED 初始化
RF_Init(); // LR690L 接收中断与发射初始化
WS2812_Init(); // 双级联彩灯初始化
Motor_Init(); // 马达脉冲时序初始化
ADC_Init(); // 电池采样初始化
// 2. 载入持久化数据配置
Load_Database();
// 3. 初始化软件状态与计时器
current_state = STATE_CLOCK;
inactivity_timer = 0;
Redraw = 1;
// 开启全局中断
EA = 1;
// 4. 核心主循环轮询调度
while (1) {
// A. 轮询射频接收
if (EV1527_Decode(&rx_addr, &rx_type)) {
inactivity_timer = 0; // 重置休眠计数
Process_RF_Event(rx_addr, rx_type);
}
// B. 轮询并消耗按键事件
if (key_event_buf != KEY_EVENT_NONE) {
KeyEvent evt = key_event_buf;
key_event_buf = KEY_EVENT_NONE; // 清空事件
inactivity_timer = 0; // 重置休眠计数
Process_System_Event(evt);
}
// C. 超时低功耗检测判定
if (inactivity_timer >= 1000) { // 10秒无操作
inactivity_timer = 0;
current_state = STATE_SLEEP;
// 执行硬件关屏断电并让单片机进入深度休眠
Enter_Low_Power_Sleep();
// 被外部中断唤醒后从此处开始继续向下运行，执行电源与显示恢复
Wakeup_Restore();
current_state = STATE_CLOCK;
Redraw = 1;
}
// D. 屏幕刷新渲染调度
if (Redraw) {
Redraw = 0; // 清除标志
Render_UI_Screen(current_state);
}
// E. 喂狗操作
WDT_CONTR = 0x17;
}
}
```
---
## 5. 模块间输入/输出事件与流转处理消耗图
为了使各功能模块（Drivers & App）交互逻辑清晰可见，下表整理了各模块产生的事件源（输入）及其被消费（输出）的处理链路：
### 5.1 模块输入/输出事件矩阵
| 模块名称 | 输入源 (触发源) | 产生/发出事件 | 输出消费对象 (消费处理) |
| :--- | :--- | :--- | :--- |
| **按键模块 (KEY)** | 物理引脚（P0.1~P0.5）电平状态改变 | `KeyEvent`<br>- `KEY_UP_SHORT` / `KEY_DOWN_SHORT`<br>- `KEY_DOWN_LONG` (长按▼ 2秒)<br>- `KEY_CONFIRM_CLICK`<br>- `KEY_CONFIRM_LONG` (长按■ 3秒)<br>- `KEY_SOS_SHORT` / `KEY_SOS_LONG` (SOS键短按或长按) | 写入全局事件缓冲队列 `key_event_buf`。由 **APP 应用状态机** 读出后用于控制页面导航、退出告警或启动对码。 |
| **无线射频 (RF)** | LR690L 433MHz 载波信号接收（输入电平变化） | `RFEvent` (包含 `rx_addr` 与 `rx_type`) | 传递至 **APP 状态机** 的 `Process_RF_Event` 进行报警分发。 |
| **状态机 (APP)** | 消耗 `key_event_buf` 或 `RFEvent` | `SysState` 业务状态跳转及动作指令 | 1. 改变 `current_state` 并设置 `Redraw = 1`；<br>2. 调度 **LED** 及 **MOTOR** 开启报警灯效/马达振动；<br>3. 写入 **IAP Flash 数据库** 配对记录；<br>4. 调用 **RF** 发送对码或主动SOS信号。 |
| **显示模块 (LCD)** | 状态机重绘请求 `Redraw == 1` | SPI 像素渲染显示流 | 驱动 **Truly AMOLED** 渲染当前状态所对应的时钟、主菜单、对码、时间设定或报警画面。 |
| **供电管理 (POWER)**| 1. `inactivity_timer >= 1000` (10秒超时)<br>2. 中断唤醒信号 (GPIO/INT2) | 电源电平控制及停机状态 | 1. **进入休眠**：发出关屏指令 -> 拉低 `SGM_CTRL = 0` -> 执行停机挂起（主循环暂停在 `Enter_Low_Power_Sleep` 内）；<br>2. **唤醒恢复**：拉高 `SGM_CTRL = 1` -> 延时 50ms -> 重新初始化 RM69310 屏幕控制器（主循环恢复运行并重绘时钟）。 |
| **彩灯模块 (LED)** | 状态机调用报警指示请求 | SPI 48-bit 灯珠级联控制字 | 向两颗级联的 WS2812B 发送颜色数据（报警时交替闪烁，配对时常亮）。 |
| **马达模块 (MOTOR)**| 状态机请求按键反馈/告警振动 | IO 电平状态控制字 (P2.5) | 定时驱动 `P2.5` 引脚电平产生不同振动波形（如短振、长振、间歇循环振动）。 |
### 5.2 事件流转与消费链路拓扑
手环系统的输入事件（按键中断与无线载波中断）在主循环中的处理与消耗流转关系如下：
```mermaid
flowchart TD
%% 硬件输入事件
PinKey[物理按键按下 / 下降沿] -->|P2.0-P3.7 端口中断| ISR_Port0[GPIO 中断 ISR]
Carrier[433MHz 射频载波信号] -->|INT2 中断| ISR_INT2[INT2 唤醒中断 ISR]
%% 中断服务层 (ISR)
ISR_Port0 -->|唤醒系统并每10ms扫描| KeyScan[消抖与长短按判定]
ISR_INT2 -->|唤醒系统并使能软解码| RFDecode[EV1527 自适应比值解码]
%% 事件过滤与缓冲层
KeyScan -->|判定有效按键事件| BufKey[写入 key_event_buf 缓冲区]
RFDecode --> ProcessRF[生成合法传感器 RFEvent]
%% APP 状态机消费处理
BufKey -->|主循环读取并重置| SM_Key[消费按键事件]
ProcessRF -->|主循环调用并比对配置| SM_RF[消费已配对防区报警]
SM_Key -->|CONFIRM 长按 3s| StateMenu[切入 STATE_MENU 并 Redraw=1]
SM_Key -->|子页面确认操作| StateSub[执行配对/布防/时间设定并 IAP 写入]
SM_Key -->|点击/长按 SOS 键| EmitSOS[调用 RF 主动发射 0x08 SOS 信号]
SM_Key -->|告警状态任意键| ClearAlarm[清除本地报警状态并退回时钟]
SM_RF -->|匹配成功且处于布防| LocalAlarm[触发 LED 交替闪烁 & 马达间歇振动]
%% 显示与控制响应
StateMenu -->|Redraw == 1| LcdPaint[Truly AMOLED 屏幕局部像素重绘]
StateSub -->|Redraw == 1| LcdPaint
LocalAlarm -->|Redraw == 1| LcdPaint
EmitSOS -->|Redraw == 1| LcdPaint
```
---
## 6. 核心业务事件输入输出 (I/O) 架构明细表
为实现绝对清晰的软硬件交互链路，以下为手环核心业务事件的端到端输入、输出及流转逻辑汇总：
### 6.1 核心事件 I/O 矩阵
| 事件名称 | 输入源 (触发条件与参数) | 状态机判定逻辑 (当前状态与条件) | 输出结果 & 动作执行 (显示、灯效、马达与无线) |
| :--- | :--- | :--- | :--- |
| **按键操作事件**<br>`KEY_EVENT` | **源**：P2.0~P3.7 下降沿中断。<br>**参数**：`KEY_UP`、`KEY_DOWN`、`KEY_CONFIRM` (短按/长按)。 | **当前状态**：`STATE_CLOCK` / `STATE_MENU` 等。<br>**条件**：在待机下长按确认键 3 秒进入菜单；在菜单下短按 ▲/▼ 键翻页。 | 1. **显示**：置 `Redraw = 1`，LCD 刷新切换对应页面；<br>2. **触觉**：发出 50ms 极短振动作按键反馈。 |
| **主动求救事件**<br>`SOS_ACTIVE_EVENT` | **源**：上部任意 SOS 按键按下（短按或长按）。 | **当前状态**：除已报警外的任意业务状态。<br>**条件**：无视当前状态，拥有最高抢占优先级。 | 1. **状态**：切入 `STATE_SOS_EMITTED`；<br>2. **无线**：通过 LR690L 周期性（2s）发射手环 Factory ID 及 `0x08` (SOS) 数据包；<br>3. **显示**：LCD 闪烁呈现超大警灯与分行 `SOS EMIS` 字样；<br>4. **灯效**：WS2812B 红色高速交替闪烁（50ms周期）；<br>5. **马达**：持续间歇长振（振 1000ms，停 200ms）。 |
| **无线对码捕获事件**<br>`RF_PAIR_RECV_EVENT` | **源**：LR690L 接收 433MHz 对码载波包。<br>**参数**：24-bit 物理地址 + 4-bit 传感器类型数据码。 | **当前状态**：`STATE_PAIR_SEARCH` (搜索对码中)。<br>**条件**：捕获到合法 EV1527 帧。 | 1. **状态**：切换至 `STATE_PAIR_CONFIRM` (确认微调)；<br>2. **显示**：只读显示自动识别的传感器名称（如 `PORTE`）、大图标，以及超大 `[ 01 ]` 序号选框；<br>3. **马达**：发出 300ms 短振提醒成功捕获。 |
| **传感器入侵警报事件**<br>`RF_ALARM_RECV_EVENT` | **源**：LR690L 接收 433MHz 警报载波包。<br>**参数**：传感器地址 + 4-bit 状态码。 | **当前状态**：`STATE_CLOCK` (待机)。<br>**条件**：1. 地址与 Flash 数据库匹配；<br>2. 该防区属于 ZONE 0 (24h) 或处于已布防状态下的 ZONE 1。 | 1. **状态**：切入 `STATE_ALARMING`；<br>2. **显示**：LCD 亮起 4px 闪烁红边框与 64x64px 对应传感器报警图标，显示 `PORTE 01 INTRUSION!`；<br>3. **灯效**：WS2812B 闪烁对应传感器防区色彩（500ms闪烁）；<br>4. **马达**：根据传感器类型，输出对应的间歇振动波形（如门磁短振 1 次）。 |
| **系统自动休眠事件**<br>`AUTO_SLEEP_EVENT` | **源**：软件时钟 `inactivity_timer >= 1000` (10s)。 | **当前状态**：`STATE_CLOCK` / `STATE_MENU` / `STATE_SET_TIME` 等非报警状态。 | 1. **状态**：切入 `STATE_SLEEP`；<br>2. **硬件**：拉低 `SGM_CTRL = 0` 切断 AMOLED PMIC 供电；<br>3. **电源**：使能 P0 口电平中断及 INT2，挂起 CPU 进入 Power-Down 极低功耗模式。 |
| **中断唤醒系统事件**<br>`SYSTEM_WAKEUP_EVENT` | **源**：GPIO 端口按键沿变化或 INT2 载波接收中断。 | **当前状态**：`STATE_SLEEP` (深度休眠中)。 | 1. **状态**：切回 `STATE_CLOCK`；<br>2. **电源**：拉高 `SGM_CTRL = 1` 恢复 OLED 供电；<br>3. **延迟**：延时 50ms 避开冲击电流并完成 RM69310 的重初始化；<br>4. **显示**：置 `Redraw = 1` 重绘时钟走时界面格式。 |
| **IPC 摄像头对码事件**<br>`IPC_BIND_SEND_EVENT` | **源**：在菜单中确认进入 `4. LIAISON`。 | **当前状态**：`STATE_IPC_BIND`。 | 1. **无线**：连发 433MHz 手环 Factory ID 及 `0x01` 绑定对码包；<br>2. **显示**：呈现 48x48px 摄像头大图标及 `LIAISON EN COURS`；<br>3. **退出**：长按确认键 3 秒或长按 ▼ 键 2 秒，退出并恢复时钟。 |
| **警报解除复位事件**<br>`ALARM_CLEAR_EVENT` | **源**：报警状态下侧边或上部任意按键按下。 | **当前状态**：`STATE_ALARMING` 或 `STATE_SOS_EMITTED`。 | 1. **状态**：切回 `STATE_CLOCK`；<br>2. **灯效**：WS2812B 彻底熄灭；<br>3. **马达**：清空马达状态并立即停振；<br>4. **显示**：置 `Redraw = 1`，LCD 重绘走时时钟。 |

739
Docs/30_architecture/wristband_architecture.html
View File

File diff suppressed because it is too large Load Diff

51
Docs/50_module-breakdown/mod-key.md
View File

@@ -1,49 +1,26 @@
# 模块拆分 - 按键输入消抖与判定 (Docs/50_module-breakdown/mod-key.md) # 模块拆分 - 按键输入与事件产生 (Docs/50_module-breakdown/mod-key.md)
本模块描述物理按键输入的检测、电平消抖、长按计时以及多事件防丢处理。 本模块描述物理按键输入引脚的检测、消抖、长短按事件封包，以及其作为事件产生者向事件队列投递的过程。
## 1. 模块职责说明 ## 1. 模块职责说明
* **职责范围**： * **职责范围**：
1. 在系统上电时，将按键引脚 `P0.1~P0.5` 配置为**高阻输入且开启内部上拉电阻**（STC32G P0M0/P0M1/P0PU 寄存器配置）。 1. **事件产生者 (Event Producer)**：物理按键 `KEY_UP` (P2.0), `KEY_DOWN` (P3.6), `KEY_CONFIRM` (P3.7), `KEY_SOS` (P2.3) 被按下触发低电平，按键模块负责将物理信号翻译为 `KeyEvent` 事件，并**推送到事件队列**中。
2. 实现每 10ms 一次的硬件消抖滤波（采用 3 次扫描连续一致判定法，滤波时间约 20-30ms）。 2. **移位消抖**：在 Timer1 10ms 中断分频中读取 IO 状态，连续 3 次检测一致则确认电平状态，滤波滤除物理抖动。
3. 支持侧边 ▲/▼ 键、确认键 ■，以及上部双并联 SOS 键的独立状态判定。 3. **多事件防丢缓冲**：维护一个深度为 4 级的环形事件队列。当主循环繁忙（例如正在处理复杂的 SPI 显示或 RF 编解码）时，后续到达的按键事件被压入队列保存，避免丢键。
4. 对上部双 SOS 按键进行逻辑并联处理：只要任意一个按键拉低，即视为 SOS 触发。 4. **长短按时序**：确认键长按 3 秒产生 `KEY_CONFIRM_LONG`，▼ 键长按 2 秒产生 `KEY_DOWN_LONG`，SOS 键按下即刻产生最高优先级的 `KEY_SOS_ACTIVE` 抢占求救事件。
5. **长按计时判定**：
* 长按 **确认键 (■)** 达 3 秒（300 个时基单位）触发主菜单切换或子页面放弃退出。
* 长按 **▼ 键** 达 2 秒（200 个时基单位）触发报警清除或 IPC 绑定退出。
6. **防丢事件缓冲队列 (Ring Buffer)**：
* 为了防止高频按键或同时按下时发生丢键，本模块维护一个深度为 4 级的环形事件队列。按键扫描判定出的 `KeyEvent` 压入队列，主循环通过出队机制依次消费。
--- ---
## 2. 数据结构定义 ## 2. 接口与函数说明
### 2.1 按键事件枚举 (KeyEvent) * `void Key_Init(void)`：将 Pin 19, 20, 21, 24 配置为高阻输入并开启内部上拉电阻 (`P3PU |= 0xC0`, `P2PU |= 0x09`)。
```c
typedef enum {
KEY_EVENT_NONE,
KEY_UP_SHORT, // ▲ 键短按
KEY_DOWN_SHORT, // ▼ 键短按
KEY_DOWN_LONG, // ▼ 键长按 2 秒 (清除报警/退出)
KEY_CONFIRM_CLICK, // ■ 确认键短按
KEY_CONFIRM_LONG, // ■ 确认键长按 3 秒 (菜单切换)
KEY_SOS_ACTIVE // SOS 键触发 (不分长短按，秒级响应)
} KeyEvent;
```
---
## 3. 接口与函数说明
* `void Key_Init(void)`：配置 `P0.1~P0.5` 的 `P0M1=0x00`, `P0M0=0x00`（高阻模式），并设置 `P0PU = 0x3E` 使能上拉电阻。
* `void Key_Scan_Process(void)`： * `void Key_Scan_Process(void)`：
在 Timer 1 10ms 中断分频中调用。 在 Timer1 的 10ms 定时周期中回调。
* 读取引脚逻辑状态，并利用移位寄存器滤波判定。 * 读取 `KEY_UP`, `KEY_DOWN`, `KEY_CONFIRM`, `KEY_SOS` 引脚。
* 并联 SOS 状态：`sos_pressed = (KEY_SOS1 == 0) || (KEY_SOS2 == 0)`。 * 累加按键维持计数器以判定长按与短按。
* 累加各按键的计数器：`key_up_hold`, `key_down_hold`, `key_confirm_hold`, `key_sos_hold`。 * 将结果转换为 `KeyEvent` 传入事件队列。
* 达到长按阈值时将对应事件写入环形队列。 * `bit Key_Push_Event(KeyEvent evt)`：将产生的事件压入事件环形队列（Event Queue）。若溢出返回 0。
* `bit Key_Push_Event(KeyEvent evt)`：将事件压入环形事件队列。若满则丢弃，返回 0。 * `KeyEvent Key_Pop_Event(void)`：主循环调用该接口，读出排队事件。若空返回 `KEY_EVENT_NONE`。
* `KeyEvent Key_Pop_Event(void)`：主循环调用，从事件队列中读取未消费的事件。若空返回 `KEY_EVENT_NONE`。
<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 --> <!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->

37
Docs/50_module-breakdown/mod-lcd.md
View File

@@ -1,33 +1,28 @@
# 模块拆分 - AMOLED 显示与无障碍渲染 (Docs/50_module-breakdown/mod-lcd.md) # 模块拆分 - AMOLED 屏幕渲染驱动 (Docs/50_module-breakdown/mod-lcd.md)
本模块管理 Truly 0.95寸 AMOLED 屏的底层 SPI 通信、窗口控制、以及无障碍（A11y）超大字体和图标的渲染。 本模块描述 Truly AMOLED (RM69310) 屏幕的底层 SPI 通信、物理视窗偏置及文本/大图标像素刷写驱动。本模块为纯输出执行层，由当前活跃的前台 App 调度。
## 1. 模块职责说明 ## 1. 模块职责说明
* **职责范围**： * **职责范围**：
1. 管理 RM69310 控制器通信，提供单向 SPI 指令/数据写操作。 1. **服务应用显示**：不存储系统页面逻辑，仅提供底层画图、画字、清屏接口，供当前前台 App（如待机时钟应用、菜单应用）在 `OnStart` 或重绘标志触发时调度写入。
2. 提供 `SGM_CTRL`（引脚 `P3.4`）控制，配合低功耗模块实现屏幕 PMIC 的上电与彻底断电。 2. **局部窗口硬件偏置**：
3. **物理窗口偏置处理**：Truly 120x240 AMOLED 屏的 GRAM X 轴起始位置有 **+4 像素的偏置**，设置显示窗口时必须进行偏移修正：`LCD_SetWindow(x1 + 4, x2 + 4, y1, y2)`。 在 `LCD_SetWindow` 设置 GRAM 窗口时，X 轴坐标必须强制加 4 像素（即 `x1 += 4`, `x2 += 4`），以对齐 Truly AMOLED 屏的物理视窗偏置。
4. **无障碍大字排版（A11y）渲染**： 3. **A11y 无障碍大字模渲染**：
* 取消任何小于 16x32px 的微缩文本。 * 提供 `16x32px` 标准无障碍英文字符点阵字库。
* 时间显示使用 **32x64px** 超大点阵。 * 提供 `32x64px` 超大数字字符点阵字库（专用于时钟）。
* 防区图标使用 **48x48px** 或 **64x64px** 超大单色位图。 * 提供 `48x48px` 及 `64x64px` 传感器、锁具、摄像头位图渲染接口。
* 在 120 像素宽的屏幕内，应用水平居中公式：`X_start = (120 - len * char_width) / 2`。 * 实现了水平居中排版公式，防止大字超出 120 像素物理宽度。
5. **单页集中展示逻辑**：控制各菜单页面和子修改页面在屏幕中只显示单焦点，避免多行小字杂乱堆叠。
--- ---
## 2. 接口与函数说明 ## 2. 接口与函数说明
* `void LCD_Init(void)`：配置 `P1.1~P1.6` 控制线为推挽输出模式，并在拉高 `SGM_CTRL` 稳定后，发送 RM69310 初始化寄存器指令序列。 * `void LCD_Init(void)`：配置 Pin 9 到 Pin 14 的 SPI 通信总线引脚为推挽输出。拉高 `SHUT` 稳定后，向 RM69310 芯片写入初始化指令序列。
* `void LCD_WriteCmd(u8 cmd)`：拉低 `LCD_RS` 选择命令寄存器，通过 SPI 发送字节。 * `void LCD_SetWindow(u16 x1, u16 y1, u16 x2, u16 y2)`：设置局部像素写入视窗，自动执行 `+4` 偏置修正。
* `void LCD_WriteData(u8 dat)`：拉高 `LCD_RS` 选择数据寄存器，通过 SPI 发送字节。 * `void LCD_Clear(u16 color)`：用指定颜色刷满屏幕 GRAM。
* `void LCD_SetWindow(u16 x1, u16 y1, u16 x2, u16 y2)`：设置局部像素刷写范围，物理 X 坐标必须强制加 4 像素。 * `void LCD_ShowStringCentered(u16 y, char *str, u16 fc, u16 bc)`：居中渲染 16x32 大字符。
* `void LCD_Clear(u16 color)`：清屏为指定底色（常态使用全黑以节省功耗）。 * `void LCD_ShowString32x64Centered(u16 y, char *str, u16 fc, u16 bc)`：居中渲染 32x64 超大字符。
* `void LCD_ShowChar16x32(u16 x, u16 y, char c, u16 fc, u16 bc)`：在指定坐标绘制标准无障碍大字符（16x32点阵）。 * `void LCD_ShowImage(u16 x, u16 y, u16 w, u16 h, const u8 *img, u16 fc, u16 bc)`：将单色大位图写入屏幕指定 GRAM。
* `void LCD_ShowChar32x64(u16 x, u16 y, char c, u16 fc, u16 bc)`：在指定坐标绘制超大数字字符（32x64点阵）。
* `void LCD_ShowImage(u16 x, u16 y, u16 w, u16 h, const u8 *img, u16 fc, u16 bc)`：渲染指定单色位图（支持 32x32/48x48/64x64/80x80 图标规格）。
* `void LCD_ShowStringCentered(u16 y, char *str, u16 fc, u16 bc)`：16x32 规格字符串居中渲染，单行限制最多 7 个字符。
* `void LCD_ShowString32x64Centered(u16 y, char *str, u16 fc, u16 bc)`：32x64 规格超大字符串居中渲染（如时钟显示）。
<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 --> <!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->

48
Docs/50_module-breakdown/mod-led.md
View File

@@ -1,43 +1,27 @@
# 模块拆分 - WS2812B 可编程 RGB 灯效 (Docs/50_module-breakdown/mod-led.md) # 模块拆分 - WS2812B 幻彩 LED 控制驱动 (Docs/50_module-breakdown/mod-led.md)
本模块管理双级联幻彩 RGB 灯珠（WS2812B/FCOB-2.7）的硬件 SPI 通道、防抖抗噪切换以及指示闪烁逻辑。 本模块描述双级联可编程幻彩 RGB 灯珠的时序写驱动及异步闪烁处理。本模块由当前活跃应用或后台监测进程在报警时调度执行。
## 1. 模块职责说明 ## 1. 模块职责说明
* **职责范围**： * **职责范围**：
1. 管理物理引脚 `P2.3`（复用硬件 SPI 的 MOSI）作为单线纳秒级高速数据流输出。 1. **响应指示请求**：提供底层硬件 SPI 写接口，受前台应用（如对码指示）或后台警报进程的控制，点亮特定色彩。
2. 实现对级联的两个 RGB 灯珠（上灯 DOUT 串接下灯 DIN）输出相同的 24-bit × 2 色彩数据。 2. **隔离抗干扰时序**：
3. **硬件 SPI 复用防噪隔离处理**： WS2812B 的单线纳秒级控制数据流极易受到地线高频噪声干扰。在每次调用 `WS2812_WriteRGB` 之前，必须执行 **临时关闭全局中断 (EA=0) 并切换马达引脚 (P2.4) 为高阻输入** 状态，发送完毕后恢复 `EA=1`，以屏蔽共地杂噪。
由于单片机引脚紧缺，SPI 引脚与马达控制可能存在轻微高频串扰。在每次发送 48-bit (GRB) 灯光控制字之前，**必须临时关闭全局中断 (EA=0)**，并将马达引脚配置为高阻输入以彻底隔离噪声。发送完成后立即恢复引脚模式并使能全局中断 (EA=1)。 3. **软件定时器异步更新**：
4. **软件异步闪烁控制**： 提供 `LED_Flash_Process` 中断分频函数，由 Timer1 (1ms) 定期回调自增，以非阻塞方式改变闪烁标志电平，避免软件 `delay` 阻塞 CPU。
在 1ms 中断中自增计时器，控制报警状态下不同防区灯光的异步闪烁（500ms 亮、500ms 灭，或本地 SOS 下的 50ms 红光快速交替爆闪）。
--- ---
## 2. LED 报警色彩矩阵 ## 2. 接口与函数说明
根据防区传感器类型及报警动作亮起指示灯： * `void WS2812_Init(void)`：初始化物理引脚 `P2.6` (LED_RGB) 复用硬件 SPI 功能。
* **门磁/窗磁 (PORTE)**：红色闪烁。 * `void WS2812_WriteRGB(u8 l1_g, u8 l1_r, u8 l1_b, u8 l2_g, u8 l2_r, u8 l2_b)`：
* **PIR 人体红外 (PIR)**：橙色闪烁。 1. 保存并拉低 `EA = 0`。
* **烟雾传感器 (FUMEE)**：绿色闪烁。 2. 临时设置马达控制脚 `P2.4` 为高阻输入。
* **紧急按钮 (URGENCE)**：蓝色闪烁。 3. 通过 SPI 数据寄存器连续发送两个灯珠的 GRB 控制字节。
* **气体泄漏 (GAZ)**：紫色闪烁。 4. 发送完毕后发出 >80us 低电平复位脉冲。
* **水浸传感器 (INOND.)**：黄色闪烁。 5. 恢复马达引脚模式并还原 `EA`。
* **振动传感器 (VIBRA.)**：青色闪烁。 * `void LED_Flash_Process(void)`：中断更新闪烁标志位状态，用于驱动交替闪烁。
* **本地主动 SOS**：双红灯以 50ms 周期高速交替闪烁。
---
## 3. 接口与函数说明
* `void WS2812_Init(void)`：初始化物理引脚 `P2.3` 状态，复用硬件 SPI 通道，配置时钟展宽 LUT 码表。
* `void WS2812_WriteRGB(u8 led1_g, u8 led1_r, u8 led1_b, u8 led2_g, u8 led2_r, u8 led2_b)`：
1. 临时保存并拉低 `EA = 0`。
2. 切换 `P2.5` (MOTOR) 引脚为高阻输入以防共地噪声。
3. 通过 SPI 控制寄存器高速连发 48 字节的时序宽展码，驱动两个灯珠亮起对应颜色。
4. 发送完毕后发送 >80us 的低电平复位脉冲。
5. 恢复马达引脚为推挽输出，并还原 `EA`。
* `void LED_Set_Color(u8 g, u8 r, u8 b)`：同步设置双级联灯亮起特定颜色。
* `void LED_Flash_Process(void)`：在 1ms 中断中调用，控制指示灯处于交替爆闪或间歇闪烁的状态机更新。
<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 --> <!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->

41
Docs/50_module-breakdown/mod-motor.md
View File

@@ -1,40 +1,25 @@
# 模块拆分 - 振动马达异步驱动与反馈 (Docs/50_module-breakdown/mod-motor.md) # 模块拆分 - 振动马达非阻塞异步驱动 (Docs/50_module-breakdown/mod-motor.md)
本模块描述振动马达引脚的开关控制、异步时间片脉冲时序生成以及针对不同防区的特定振动波形。 本模块描述振动马达的异步脉冲生成及时序段控制。本模块为输出执行层，由应用在产生警报或按键反馈时调度。
## 1. 模块职责说明 ## 1. 模块职责说明
* **职责范围**： * **职责范围**：
1. 系统初始化时配置马达引脚 `P2.5` 为推挽输出模式，默认输出低电平（马达静止）。 1. **非阻塞时间片调度**：
2. **非阻塞异步脉冲处理**： 传统的 `delay_ms` 震动会导致手环在震动期间无法读取按键和解调无线信号。本模块将震动过程分解为多个电平维持段，在 Timer1 定时中断里扣减剩余毫秒数。应用在发起震动请求后**立即返回**。
为防止马达振动时间（几百毫秒）阻塞 CPU 的业务循环与射频解码，本模块将马达动作拆分为多个电平交替状态段。利用 Timer 1 (1ms 中断) 异步扣减阶段计数器，实现不占用 CPU 资源的精细振动波形。 2. **差异化防区震动**：根据报警传感器的类型，异步生成 7 种不同的警示震动节奏（如门磁短震、红外短震2次、主动求救持续震动）。
3. 配合系统状态机，在按键点击时输出 50ms 极短触觉反馈，在防区入侵报警时根据类型输出对应的振动指征，在本地主动 SOS 状态下输出连续不断的重度警示振动。 3. **按键触觉反馈**：在按键被消抖确认时，提供 50ms 的极短微振动物理触觉反馈。
--- ---
## 2. 振动模式设计 (周期 5 秒) ## 2. 接口与函数说明
* **按键操作反馈**：1 次极短振动 50ms。 * `void Motor_Init(void)`：配置 Pin 25 (`P2.4` / MOTOR_PWM) 为推挽输出，默认输出 `MOTOR_PWM = 0`。
* **门磁/窗磁 (PORTE)**：1 次短振 300ms。 * `void Motor_Start_Pattern(u8 pattern_type)`：传入震动节奏类型（按键微振/各防区警报震动/主动SOS循环震），装载维持时间片，开启异步状态机。
* **PIR 红外 (PIR)**：2 次短振 300ms (间隔 200ms)。
* **烟雾传感器 (FUMEE)**：3 次短振 200ms (间隔 150ms)。
* **紧急按钮 (URGENCE)**：1 次长振 800ms。
* **气体泄漏 (GAZ)**：4 次短振 200ms (间隔 100ms)。
* **水浸传感器 (INOND.)**：2 次长振 600ms (间隔 300ms)。
* **振动传感器 (VIBRA.)**：连续 3 次极短振动 150ms (间隔 100ms)。
* **本地主动 SOS**：持续间歇重度长振（振 1000ms，停 200ms 循环）。
---
## 3. 接口与函数说明
* `void Motor_Init(void)`：配置引脚 `P2.5` 的 `P2M1=0x00`, `P2M0=0x20`（推挽输出），默认输出 `MOTOR = 0`。
* `void Motor_Set_State(bit state)`：硬开关控制引脚 `P2.5` 的电平。
* `void Motor_Start_Pattern(u8 pattern_type)`：装载对应类型的马达振动计数器，开启异步振动状态机。
* `void Motor_Pulse_Process(void)`： * `void Motor_Pulse_Process(void)`：
在 Timer 1 的 10ms 中断分频中被调用： 在 Timer1 的 10ms 中断分频中被调度调用。
* 根据装载的波形，扣减当前阶段维持的毫秒数。 * 如果当前处于震动维持段，扣减 `motor_timer_ms` 计数器。
* 当计数器归零时，切换 `MOTOR` 引脚电平并转入下一个电平维持段。 * 计数归零时，反转物理引脚 `MOTOR_PWM` 的电平，并装填下一阶段所需维持的毫秒数。
* `void Motor_Stop(void)`：清空所有计数器，拉低 `MOTOR = 0`，强行中止当前振动。 * `void Motor_Stop(void)`：强行清空所有震动计数器，并拉低引脚电平使其停止震动。
<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 --> <!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->

35
Docs/50_module-breakdown/mod-power.md
View File

@@ -1,34 +1,31 @@
# 模块拆分 - 极低功耗与电源管理 (Docs/50_module-breakdown/mod-power.md) # 模块拆分 - 极低功耗与电源管理 (Docs/50_module-breakdown/mod-power.md)
本模块描述手环的低功耗管理、AMOLED 供电 PMIC 控制以及中断睡眠/唤醒时序。 本模块描述手环的低功耗休眠策略、OLED PMIC 供电控制、中断挂起以及安全唤醒初始化时序。
## 1. 模块职责说明 ## 1. 模块职责说明
* **职责范围**： * **职责范围**：
1. 在系统上电时使能 SGM3833 升压芯片，为 OLED 屏提供稳定的显示电源。 1. **低功耗决策与断电**：
2. **低功耗决策判定**： 当应用管理层判定 10 秒无按键且无无线事件时，PM 模块向 AMOLED 发送 Display OFF 命令，随后拉低 `SHUT = 0` (Pin 28 / P2.7)，**彻底切断 SGM3833 供电**。
当主系统处于非警报状态，且连续 10 秒（`inactivity_timer >= 1000`）无任何按键或无线包事件时，判定系统进入 `STATE_SLEEP` 极低功耗睡眠。 2. **挂起 CPU (Power-Down)**：
3. **彻底切断 PMIC**： 使能 GPIO 按键沿中断和无线接收 `P0.0` 沿中断，写入 `PCON |= 0x02` 关闭高频振荡器，使 MCU 进入深度停机挂起。
为消除 OLED 的静态负压漏电流，休眠前拉低 `SGM_CTRL = 0`，使 SGM3833 彻底断电。 3. **防浪涌安全唤醒初始化**：
4. **睡眠挂起配置**： 发生中断唤醒后，PM 必须遵循安全上电时序：首先拉高 `SHUT = 1` 开启 SGM3833，随后**执行 50ms 强阻塞延时**避开冲击电流并等待电源轨稳定，最后调用 `LCD_Init()` 完整重新配置 RM69310 寄存器，方可恢复应用绘制。
使能 `INT2`（外部中断 2，接射频接收引脚）以及 P0 口引脚电平变化中断，然后将 STC32G 写入 `PCON |= 0x02` 进入停机（Power-Down）挂起状态，关闭主高频振荡时钟，全板功耗降至微安级。
5. **安全唤醒重初始化时序**：
发生按键或无线信号中断时，CPU 瞬间被唤醒。由于升压 PMIC 的输入电容充电及负压稳压需要时间，唤醒后**严禁立即写屏**。必须首先拉高 `SGM_CTRL = 1`，接着**软件强行阻塞延时 50ms**，等电网稳定后，再次完整初始化 RM69310 的寄存器参数，最后恢复待机屏幕重绘。
--- ---
## 2. 接口与函数说明 ## 2. 接口与函数说明
* `void Power_Init(void)`：配置 `P3.4` (SGM_CTRL) 为推挽输出，默认输出高电平 `SGM_CTRL = 1`。 * `void Power_Init(void)`：配置 Pin 28 为推挽输出，默认 `SHUT = 1` 开启屏幕 PMIC。
* `void Enter_Low_Power_Sleep(void)`： * `void Enter_Low_Power_Sleep(void)`：
1. 向 RM69310 屏幕控制器发送关闭显示命令（寄存器 0x28）。 1. 向 RM69310 写入关屏指令 (0x28)。
2. 拉低 `SGM_CTRL = 0` 彻底切断 PMIC。 2. 拉低 `SHUT = 0` 关断 SGM3833 PMIC。
3. 配置并使能按键端口中断与 RF 中断。 3. 使能端口引脚沿中断 (P3.6/P3.7/P2.0/P2.3) 及 INT2 沿中断。
4. 执行 `PCON |= 0x02` 挂起 CPU。 4. 执行 `PCON |= 0x02` 进入停机模式。
* `void Wakeup_Restore(void)`： * `void Wakeup_Restore(void)`：
1. 拉高 `SGM_CTRL = 1` 开启 SGM3833 供电。 1. 拉高 `SHUT = 1` 重新开启 SGM3833。
2. 执行 `delay_ms(50)` 阻塞式等待电平平稳，过滤冲击电流。 2. 执行 `delay_ms(50)` 硬件稳压阻塞等待。
3. 调用 `LCD_Init()` 重新对 RM69310 进行整套初始化配置，恢复写屏 GRAM 通道。 3. 重新调用 `LCD_Init()` 完成屏幕控制寄存器复位和 GRAM 开启。
4. 状态机切回 `STATE_CLOCK` 并置 `Redraw = 1`。 4. 路由通知应用管理器切回时钟应用重新绘制。
<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 --> <!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->

40
Docs/50_module-breakdown/mod-rf.md
View File

@@ -1,39 +1,27 @@
# 模块拆分 - 自适应 RF 解码与发射 (Docs/50_module-breakdown/mod-rf.md) # 模块拆分 - 自适应 RF 解码事件源 (Docs/50_module-breakdown/mod-rf.md)
本模块描述 LR690L 433MHz 射频物理收发的控制、自适应宽限时间比值解码机制以及对码/呼救编码包的发射。 本模块描述 LR690L 433MHz 无线接收的自适应比值解调机制、主动射频数据发送、以及其作为事件产生者投递对码/报警事件的过程。
## 1. 模块职责说明 ## 1. 模块职责说明
* **职责范围**： * **职责范围**：
1. 配置射频芯片接收 GPIO 与发射 GPIO 的电平方向。 1. **事件产生者 (Event Producer)**：当物理引脚 `P0.0` (RF_RX_DATA) 沿中断触发，射频解调成功后，模块产生 `RF_PAIR_EVENT` (对码) 或 `RF_ALARM_EVENT` (报警) 并投递至系统事件总线。
2. **自适应比值解调算法**： 2. **自适应解调算法**：
EV1527 协议数据速率变化范围较宽。本模块采用自适应宽度比值解调机制： * 捕获 1500us~60000us 的同步低电平，动态计算时钟基准 `T = low_time / 31`。
* 捕获到一个低电平维持时间介于 1500us~60000us 之间的脉冲，判定为同步前导头。 * 连续解调 24 位宽数据：1:3 对应 0 码，3:1 对应 1 码，计算出 20 位地址码与 4 位状态数据码。
* 抓取该帧的标准时钟周期基准 `T = low_time / 31`（前导低电平占 31 个时钟周期 T，允许 T 的宽度随环境在宽限范围内自适应计算）。 3. **屏蔽接收 0x08 SOS 码**：手环被动接收到数据码为 `0x08` 的载波信号时，强制过滤忽略，不产生任何事件。仅保留主动向外界发射 `0x08` 求救码的能力。
* 连续捕获 24 位宽数据：每个 bit 的电平变化依据其高低电平的宽幅比例（1:3 对应 0，3:1 对应 1）反解出对应的数据位。 4. **主动发送驱动**：在应用层请求下，使能 `P0.1` (RF_TX) 和数据线 `P0.3` (RF_TX_DAT)，连续发射多遍调制数据（如对码绑定 `0x01` 或求救包 `0x08`）。
3. 解析出 24 位载波包：前 20 位为无线探测器的出厂唯一地址码（Address Code），后 4 位为状态数据码（Data Code）。
4. **数据包主动发送**：
将手环 Factory ID 编码为一帧 EV1527 数据，通过物理发射引脚输出同步头及 24 位调制波形，连发多遍以确保 IPC 接收质量。
--- ---
## 2. 业务状态射频数据编码定义 ## 2. 接口与函数说明
* **对码绑定发送 (LIAISON IPC)**： * `void RF_Init(void)`：配置 `P0.0~P0.3` 物理引脚。使能接收控制 `RF_RX = 1`。使能引脚电平变化中断用于休眠唤醒。
* 数据码固定为 **`0x01`** (0001)，源地址为手环 20-bit 出厂 Factory ID，周期性连续发射。
* **本地主动 SOS 呼救 (SOS EMIS)**：
* 数据码固定为 **`0x08`** (1000)，源地址为手环 20-bit 出厂 Factory ID，以 2 秒为周期循环向外发射。
* **传感器自动识别对码**：
* 手环被动接收 433MHz 对码信号。若捕获成功，状态机直接**依据后 4 位数据码的数据值自动判断识别传感器的设备类型**（如门磁为 `0x01`，红外为 `0x02`），直接跳转到对码微调序号页，类型与大图标只读高亮。
---
## 3. 接口与函数说明
* `void RF_Init(void)`：初始化射频物理端口，使能 INT2 (接收脚的沿中断)。
* `bit EV1527_Decode(u32 *out_addr, u8 *out_type)`： * `bit EV1527_Decode(u32 *out_addr, u8 *out_type)`：
主循环轮询调用。如果捕获到合法同步头且成功解调出 24 位数据流，则输出 `out_addr` 和 `out_type` 并返回 1，否则返回 0。 被主循环 `main.c` 轮询轮空调用。
* 通过状态标志检测引脚跳变沿。
* 若解调出合法 24 位数据，填入 `out_addr` 和 `out_type`，返回 1；否则返回 0。
* `void EV1527_Transmit(u32 addr, u8 data_code)`： * `void EV1527_Transmit(u32 addr, u8 data_code)`：
主动发射数据。连发至少 5 遍，每遍间歇 20ms，产生满足 T 基准的同步码头、`1` 码时序（高 3T 低 1T）和 `0` 码时序（高 1T 低 3T）。 由主动发送 App 调度。产生前导头及 24 位电平时序。连续发送 5 遍，以确保 IPC 摄像头可靠捕获。
<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 --> <!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->

64
Docs/50_module-breakdown/mod-sys.md
View File

@@ -1,60 +1,48 @@
# 模块拆分 - 系统状态机与 IAP 数据库 (Docs/50_module-breakdown/mod-sys.md) # 模块拆分 - 系统状态机与 App 框架 (Docs/50_module-breakdown/mod-sys.md)
本模块描述手环的核心生命周期调度器、业务状态机、软件 RTC 时钟，以及持久化防区配置 Flash 扇区读写。 本模块描述手环的软件事件管理器、App 调度引擎（生命周期回调）以及 IAP 持久化防区数据库。
## 1. 模块职责说明 ## 1. 模块职责说明
* **职责范围**： * **职责范围**：
1. 驱动核心 SystemState 状态迁移，为其他所有外设（显示、指示灯、振动、无线）提供全局状态指示。 1. **维护 App 生命周期**：提供 `StartApp(app_id)` 和 `CloseApp(app_id)` 的系统级接口，调度应用层组件的切入与切出。
2. 提供基于软件计数分频的高可靠 RTC 时钟（维护日历：时、分、秒、年、月、日）。 2. **事件路由器**：主循环不断查询事件环形缓冲区（Event Queue）。若有事件，分发至当前活跃 App 的 `onEvent` 接口。
3. 利用 Timer 1 产生主 1ms 系统滴答，自增休眠超时计时器 `inactivity_timer`。 3. **后台应用调度**：当有传感器入侵事件触发时，不论当前处于什么 App 页面，后台监测进程会自动唤醒并强占调用警报 App（APP_ALARM）。
4. **持久化 IAP 配置数据库管理**： 4. **Flash 数据库管理**：维护 `0xFE0000` (第 254 扇区) 物理闪存的读写擦除，管理 16 个已配对传感器的配置数据。
利用 STC32G 内部 Flash 闪存的第 254 扇区（地址：`0xFE0000`）实现数据库的掉电不丢失存储。最大支持 16 个传感器槽位，提供写入、删除、检索和配置防区类别的全套数据库处理接口。
5. 管理出厂固定唯一的 `bracelet_factory_id`（通过读取芯片全球唯一硬 UID 进行哈希映射生成，20位有效）。
--- ---
## 2. 数据结构定义 ## 2. 核心结构体与接口定义
### 2.1 传感器槽位信息结构体 (Sensor_Slot) ### 2.1 应用程序结构体原型 (WristbandApp)
```c ```c
typedef struct { typedef struct {
u8 is_used; // 0x01: 有效配置槽位，其它: 空闲槽位 u8 app_id; // 应用程序 ID
u8 addr[3]; // 24位对码 EV1527 传感器无线物理地址 void (*OnStart)(void); // 启动接口：渲染初始画面、装载应用资源
u8 type; // 传感器类型：0(门磁), 1(红外), 2(烟感), 3(紧急), 4(气体), 5(水浸), 6(振动) void (*onRun)(void); // 循环接口：主循环轮空调用，执行非阻塞业务逻辑
u8 zone; // 防区类别：0(永久防区 - 24h), 1(普通可撤布防区) void (*onClose)(void); // 关闭接口：退出前台，保存状态、复位相关驱动
char name_gbk[16]; // 法语防区名称，拼装格式为 "[预设前缀] [微调序号]" (如 PORTE 02) void (*onEvent)(KeyEvent evt); // 事件处理：接收并消耗事件队列分配的按键/射频事件
} Sensor_Slot; } WristbandApp;
``` ```
### 2.2 系统核心状态枚举 (SystemState) ### 2.2 APP 管理器全局状态
```c ```c
typedef enum { extern WristbandApp* active_app; // 指向当前前台活跃应用的指针
STATE_CLOCK, // 时钟常态待机（大字走时与电量大图标） extern u16 inactivity_timer; // 无操作自动睡眠计时器
STATE_SLEEP, // 彻底关屏断电深度睡眠（主时钟暂停，挂起 CPU）
STATE_MENU, // 主选择菜单（单大条目卡片式循环切换）
STATE_SET_TIME, // 时间日期微调修改（单大参数显示）
STATE_PAIR_SEARCH, // 对码雷达搜寻等待
STATE_PAIR_CONFIRM, // 序号微调与保存确认
STATE_ARM_DISARM_SELECT, // 系统手动布撤防更改
STATE_IPC_BIND, // 对码绑定发射
STATE_ALARMING, // 收到传感器警报响应（高频爆闪与间歇振动）
STATE_SOS_EMITTED // 本地主动发射 SOS 求救
} SystemState;
``` ```
--- ---
## 3. 接口与函数说明 ## 3. 接口与函数说明
* `void System_Init(void)`： * `void App_Manager_Init(void)`：注册所有支持的应用实例（待机时钟、主菜单、时间设置、对码、布撤防、主动SOS、被动报警），默认设置 `active_app` 指向时钟应用并执行 `active_app->OnStart()`。
配置单片机寄存器（使能 FCON，开启扩展 SFR，调整外部 RAM 模式）。读取内置全球唯一 UID 拼装 Factory ID。初始化 Timer 1 开启 1ms 时基，载入 Flash 数据库。 * `void StartApp(u8 app_id)`：
* `void Timer1_Init(void)`：配置 Timer 1 中断，提供 1ms 精度的时基回调。 1. 执行当前 `active_app->onClose()` 清理现场。
* `void Timer1_Isr(void) interrupt 3`： 2. 切换 `active_app` 指向目标 `app_id` 实例。
中断服务函数。累加 `inactivity_timer`；更新 RTC（秒/分/时/日/月/年）数值；分频驱动马达状态机和 RGB 闪烁标志。 3. 执行新应用的 `active_app->OnStart()`，并置 `Redraw = 1`。
* `void Load_Database(void)`：读取 `0xFE0000` Flash 扇区数据至内存缓冲槽。 * `void Load_Database(void)`：读取 `0xFE0000` 扇区，载入 16 组 `Sensor_Slot` 数据。
* `void Save_Database(void)`：通过 STC IAP 命令擦除 `0xFE0000` 扇区，并将缓冲槽内的 16 组数据完整写回。 * `void Save_Database(void)`：擦除 IAP 扇区并写回当前缓存的配对记录。
* `void Add_Sensor(u32 addr, u8 type, u8 suffix_idx)`：向空闲槽位添加新传感器。根据 `type` 索引获取设备名称前缀（如 `PORTE` 或 `PIR`），拼装为 `[前缀] [suffix_idx]`，存入槽位并执行 `Save_Database()` 持久化。 * `void Add_Sensor(u32 addr, u8 type, u8 suffix_idx)`：添加配对并持久化。
* `bit Check_Sensor_ID(u32 addr, u8 *out_slot_index)`：在数据库中查寻地址码，若匹配则返回槽位索引，作为警报时的名称提取依据。 * `bit Check_Sensor_ID(u32 addr, u8 *out_slot_index)`：在数据库中匹配已对码的传感器 ID，获取槽位。
<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 --> <!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->