stc32g128k/Docs/10_requirements-overview/main.md

总体需求 (Docs/10_requirements-overview/main.md)

1. 项目整体框架与系统拓扑

本项目仅包含手环端核心业务及驱动代码的实现。

• 被动接收：手环作为随身告警终端，独立接收来自 7类 433MHz 传感器的探测射频信号（本地安防联动系统）。
• 主动发射：手环在本地触发 SOS 求救时，必须向外主动发射 433MHz SOS 呼救射频信号，使周边的 IPC 摄像头接收并联动。
• 周围的其他组件（如 IPC 摄像头和手机 APP）不在本项目编码范围内，仅作外部仿真与对接边界。

graph TD
    Sensor[433MHz 传感器] -->|433MHz 报警信号| Wristband[随身手环]
    Wristband -->|433MHz SOS 呼救信号| IPC[IPC 摄像头 (仿真对接)]

2. 核心信号流向与手环行为要求

1. 传感器触发：探测到异常时，发射固定编码信号（24位 EV1527 协议数据，包含 20位地址码 + 4位数据码）。
2. 手环独立接收：手环配备 LR690L 433MHz 接收解调芯片，独立进行软件自适应时序解码。
3. 手环响应行为：
   • 屏幕显示：1.14寸（135x240 像素，竖直排版）TFT LCD 屏幕，保持常亮显示时间。报警时呈现对应的报警 ICON + 传感器法语名称。
   • 灯效响应：可编程 RGB 灯珠根据传感器类型亮起对应颜色并进行特定波形闪烁。
   • 马达响应：马达触发特定的振动次数与时长组合。
4. 手环主动发射与辨识：
   • 主动求救：用户短按手环上部的 SOS 键，手环进入 SOS 状态，并使用出厂固定唯一 ID (Factory ID) 作为源地址发射 433MHz 的 SOS 编码电报。
   • 身份辨识：该出厂 ID 作为手环的唯一物理地址标识，以便 IPC 摄像头可以通过与该 ID 配对，唯一识别该手环并将其与具体的用户绑定。

3. 协作规范与门禁说明

本项目的开发协作基于《开发规范.md》定义的“七个环节”。任何目录下文件的修改应当保证其依赖项是同步的。 在每次完成阶段性工作或代码调整后，应运行 python .xagent/check-dirty.py 进行脏检测自检。