docs: optimize SOS button behavior, add 2-step pairing wizard, and IPC exit action

This commit is contained in:
2026-07-09 17:42:55 +08:00
parent 1168e747e6
commit 32c07c0466
16 changed files with 821 additions and 478 deletions

View File

@@ -1,11 +1,11 @@
# 总体需求 (Docs/10_requirements-overview/main.md)
## 1. 项目整体框架与系统拓扑
本项目主要实现随身手环终端的底层驱动、核心业务管理以及低功耗待机逻辑。
本项目**仅包含手环端核心业务及驱动代码的实现**。
* **被动接收**:手环作为随身告警终端,独立接收来自 **7类 433MHz 传感器**的探测射频信号(本地安防联动系统)。
* **主动发射**:手环在本地触发 SOS 求救时,必须向外主动发射 **433MHz SOS 呼救射频信号**,使周边的 IPC 摄像头接收并联动
* 周围的其他组件(如 IPC 摄像头和手机 APP不在本项目编码范围内仅作外部仿真与对接边界
## 1. 项目系统拓扑与边界
* **业务流向**:手环作为智能家居安防的便携式告警与求救终端,与无线传感器以及 IPC 摄像头(网络摄像机)构成以下星型网络架构
* **设计边界**:本项目**仅开发手环端的软件代码**,传感器和 IPC 摄像头侧的软件仅作为对接调试的外界仿真源
```mermaid
graph TD
@@ -13,18 +13,34 @@ graph TD
Wristband -->|433MHz SOS 呼救信号| IPC[IPC 摄像头 (仿真对接)]
```
## 2. 核心信号流向与手环行为要求
---
1. **传感器触发**探测到异常时发射固定编码信号24位 EV1527 协议数据,包含 20位地址码 + 4位数据码
2. **手环独立接收**:手环配备 LR690L 433MHz 接收解调芯片,独立进行软件自适应时序解码。
3. **手环响应行为**
* **屏幕显示**1.14寸135x240 像素,**竖直排版**,型号为 **SPEC LHS114TC-IF03 VER A**TFT LCD 屏幕,**保持常亮显示时间**。报警时呈现对应的报警 ICON + 传感器法语名称。
* **灯效响应**:可编程 RGB 灯珠根据传感器类型亮起对应颜色并进行特定波形闪烁。
* **马达响应**:马达触发特定的振动次数与时长组合。
4. **手环主动发射与辨识**
* **主动求救**:用户短按手环上部的 SOS 键,手环进入 SOS 状态,并使用**出厂固定唯一 ID (Factory ID)** 作为源地址发射 433MHz 的 SOS 编码电报。
* **身份辨识**:该出厂 ID 作为手环的唯一物理地址标识,以便 IPC 摄像头可以通过与该 ID 配对,唯一识别该手环并将其与具体的用户绑定。
## 2. 总体功能需求
## 3. 协作规范与门禁说明
本项目的开发协作基于《开发规范.md》定义的“七个环节”。任何目录下文件的修改应当保证其依赖项是同步的。
在每次完成阶段性工作或代码调整后,应运行 `python .xagent/check-dirty.py` 进行脏检测自检。
手环系统应具备以下六大核心总体功能:
### 2.1 显示时间日期与状态栏
* 手环应支持软时钟走时,在主页面清晰直观地显示当前的小时、分钟、星期及日期信息。
* 主页面状态栏应实时指示当前电池电量、USB 充电状态,以及当前的系统安防运行状态(布防/撤防)。
### 2.2 系统安防布防与撤防控制
* 系统支持两种安防警戒模式:
* **布防状态**:对所有类型已配对的传感器报警信号(如门磁、红外等)均执行本地声光振动告警。
* **撤防状态**:对普通盗防类传感器信号予以忽略,仅对危及安全和紧急求救的传感器信号进行报警响应。
### 2.3 传感器无线对码配对
* 手环能捕获周围 433MHz 传感器发出的 EV1527 对码射频包,将其地址码与类型绑定记录在非易失存储区(掉电不丢失)。
* 手环支持多达 16 个传感器防区槽位的配对与法语前缀加数字序号的命名保存。
### 2.4 主动呼救与 IPC 绑定配对
* **主动求救**:当遇到紧急情况时,用户可一键快速触发主动 SOS 求救广播,向外以 2 秒为周期循环发射带有手环出厂固定唯一 ID 的 433MHz 载波信号。
* **IPC 绑定**:手环提供主动向 IPC发射对码信号的功能以便 IPC 摄像头将该手环地址绑定至特定用户,识别求救来源。
### 2.5 多维告警响应反馈
* 手环根据捕获到报警传感器的类型,执行差异化的硬件声光、马达振动和屏幕图标文字反馈,提供直观的物理告警。
### 2.6 低功耗待机与中断秒级唤醒
* 手环必须具备优秀的低功耗休眠机制,在连续无按键操作 10 秒后自动关闭屏幕并切断屏幕供电电路使单片机进入深度休眠Power-Down 挂起状态)。
* 手环在休眠状态下,支持任何物理按键按下瞬间被唤醒,以及接收到 433MHz 无线射频载波信号瞬间被唤醒,唤醒后应在极短时间内恢复系统运行与屏幕显示。
<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->