From 2068edd2057940979cff8c87965f0aa6802affa2 Mon Sep 17 00:00:00 2001 From: zouhaitao Date: Thu, 9 Jul 2026 18:25:28 +0800 Subject: [PATCH] docs: add core business event IO matrix to architecture design document --- Docs/30_architecture/main.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/Docs/30_architecture/main.md b/Docs/30_architecture/main.md index 865dd72..b802e9f 100644 --- a/Docs/30_architecture/main.md +++ b/Docs/30_architecture/main.md @@ -262,3 +262,23 @@ flowchart TD LocalAlarm -->|Redraw == 1| LcdPaint EmitSOS -->|Redraw == 1| LcdPaint ``` + +--- + +## 6. 核心业务事件输入输出 (I/O) 架构明细表 + +为实现绝对清晰的软硬件交互链路，以下为手环核心业务事件的端到端输入、输出及流转逻辑汇总： + +### 6.1 核心事件 I/O 矩阵 + +| 事件名称 | 输入源 (触发条件与参数) | 状态机判定逻辑 (当前状态与条件) | 输出结果 & 动作执行 (显示、灯效、马达与无线) | +| :--- | :--- | :--- | :--- | +| **按键操作事件**
`KEY_EVENT` | **源**：P0.1~P0.5 下降沿中断。
**参数**：`KEY_UP`、`KEY_DOWN`、`KEY_CONFIRM` (短按/长按)。 | **当前状态**：`STATE_CLOCK` / `STATE_MENU` 等。
**条件**：在待机下长按确认键 3 秒进入菜单；在菜单下短按 ▲/▼ 键翻页。 | 1. **显示**：置 `Redraw = 1`，LCD 刷新切换对应页面；
2. **触觉**：发出 50ms 极短振动作按键反馈。 | +| **主动求救事件**
`SOS_ACTIVE_EVENT` | **源**：上部任意 SOS 按键按下（短按或长按）。 | **当前状态**：除已报警外的任意业务状态。
**条件**：无视当前状态，拥有最高抢占优先级。 | 1. **状态**：切入 `STATE_SOS_EMITTED`；
2. **无线**：通过 LR690L 周期性（2s）发射手环 Factory ID 及 `0x08` (SOS) 数据包；
3. **显示**：LCD 闪烁呈现超大警灯与分行 `SOS EMIS` 字样；
4. **灯效**：WS2812B 红色高速交替闪烁（50ms周期）；
5. **马达**：持续间歇长振（振 1000ms，停 200ms）。 | +| **无线对码捕获事件**
`RF_PAIR_RECV_EVENT` | **源**：LR690L 接收 433MHz 对码载波包。
**参数**：24-bit 物理地址 + 4-bit 传感器类型数据码。 | **当前状态**：`STATE_PAIR_SEARCH` (搜索对码中)。
**条件**：捕获到合法 EV1527 帧。 | 1. **状态**：切换至 `STATE_PAIR_CONFIRM` (确认微调)；
2. **显示**：只读显示自动识别的传感器名称（如 `PORTE`）、大图标，以及超大 `[ 01 ]` 序号选框；
3. **马达**：发出 300ms 短振提醒成功捕获。 | +| **传感器入侵警报事件**
`RF_ALARM_RECV_EVENT` | **源**：LR690L 接收 433MHz 警报载波包。
**参数**：传感器地址 + 4-bit 状态码。 | **当前状态**：`STATE_CLOCK` (待机)。
**条件**：1. 地址与 Flash 数据库匹配；
2. 该防区属于 ZONE 0 (24h) 或处于已布防状态下的 ZONE 1。 | 1. **状态**：切入 `STATE_ALARMING`；
2. **显示**：LCD 亮起 4px 闪烁红边框与 64x64px 对应传感器报警图标，显示 `PORTE 01 INTRUSION!`；
3. **灯效**：WS2812B 闪烁对应传感器防区色彩（500ms闪烁）；
4. **马达**：根据传感器类型，输出对应的间歇振动波形（如门磁短振 1 次）。 | +| **系统自动休眠事件**
`AUTO_SLEEP_EVENT` | **源**：软件时钟 `inactivity_timer >= 1000` (10s)。 | **当前状态**：`STATE_CLOCK` / `STATE_MENU` / `STATE_SET_TIME` 等非报警状态。 | 1. **状态**：切入 `STATE_SLEEP`；
2. **硬件**：拉低 `SGM_CTRL = 0` 切断 AMOLED PMIC 供电；
3. **电源**：使能 P0 口电平中断及 INT2，挂起 CPU 进入 Power-Down 极低功耗模式。 | +| **中断唤醒系统事件**
`SYSTEM_WAKEUP_EVENT` | **源**：P0口按键沿变化或 INT2 载波接收中断。 | **当前状态**：`STATE_SLEEP` (深度休眠中)。 | 1. **状态**：切回 `STATE_CLOCK`；
2. **电源**：拉高 `SGM_CTRL = 1` 恢复 OLED 供电；
3. **延迟**：延时 50ms 避开冲击电流并完成 RM69310 的重初始化；
4. **显示**：置 `Redraw = 1` 重绘时钟走时界面。 | +| **IPC 摄像头对码事件**
`IPC_BIND_SEND_EVENT` | **源**：在菜单中确认进入 `4. LIAISON`。 | **当前状态**：`STATE_IPC_BIND`。 | 1. **无线**：连发 433MHz 手环 Factory ID 及 `0x01` 绑定对码包；
2. **显示**：呈现 48x48px 摄像头大图标及 `LIAISON EN COURS`；
3. **退出**：长按确认键 3 秒或长按 ▼ 键 2 秒，退出并恢复时钟。 | +| **警报解除复位事件**
`ALARM_CLEAR_EVENT` | **源**：报警状态下侧边或上部任意按键按下。 | **当前状态**：`STATE_ALARMING` 或 `STATE_SOS_EMITTED`。 | 1. **状态**：切回 `STATE_CLOCK`；
2. **灯效**：WS2812B 彻底熄灭；
3. **马达**：清空马达状态并立即停振；
4. **显示**：置 `Redraw = 1`，LCD 重绘走时时钟。 | +