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

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

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

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

```mermaid
graph TD
    Sensor[433MHz 传感器] -->|433MHz 射频信号| Wristband[随身手环]
```

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

1. **传感器触发**：探测到异常时，发射固定编码信号（24位 EV1527 协议数据，包含 20位地址码 + 4位数据码）。
2. **手环独立接收**：手环配备 LR690L 433MHz 接收解调芯片，独立进行软件自适应时序解码。
3. **手环响应行为**：
    *   **屏幕显示**：1.14寸（135x240 像素）TFT LCD 屏幕显示对应的报警 ICON + 传感器法语自定义名称。
    *   **灯效响应**：可编程 RGB 灯珠根据传感器类型亮起对应颜色并进行特定波形闪烁。
    *   **马达响应**：马达触发特定的振动次数与时长组合。

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