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

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

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

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

```mermaid
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` 进行脏检测自检。