3.9 KiB
3.9 KiB
细化需求 (Docs/20_requirements-detail/main.md)
本章节定义手环终端的物理按键交互、报警矩阵（可编程 RGB 灯颜色与振动）以及防区划分详细需求。
1. 物理按键与交互定义
手环共配备 5 个物理按键：侧边 3 个（▲ 上移、▼ 下移、■ 确认），上部 2 个（相同的 SOS1、SOS2，具备完全一致的并联电气逻辑）。
| 按键类别 | 按键动作 | 常态 (时钟待机) | 对码配对模式 | 警报触发状态 |
|---|---|---|---|---|
| 侧边按键 | ▲ 上移键 | 短按：时间微调 | 菜单向上滚动 | 无动作 |
| 侧边按键 | ▼ 下移键 | 短按：时间微调 | 菜单向下滚动 | 长按 2 秒：解除当前告警并退回时钟 |
| 侧边按键 | ▲ + ▼ (同时长按3秒) | 进入对码配对模式 | 无动作 | 无动作 |
| 侧边按键 | ■ 确认键 (CONFIRM) | 无动作 | 选中并进入该类型等待配对 | 短按：解除当前告警并退回时钟 |
| 上部按键 | SOS1 / SOS2 (短按) | 触发本地主动 SOS 呼救 + 循环发射 433MHz 呼救包 | 确认保存当前已捕获的配对 | 短按：解除告警并退回时钟 |
| 上部按键 | SOS1 / SOS2 (长按5秒) | 触发 IPC 绑定对码广播 | 无动作 | 长按：解除告警并退回时钟 |
Note
- 双 SOS 按键冗余：上部的两个 SOS 键在电路与软件上完全等价。按下其中任意一个按键，均会触发相同的 SOS 信号采集与求救动作。
- 警报快速解除：在手环发出主动 SOS 呼救或响应被动防区报警时，按下“确认键”或任意一个“SOS 键”（或者长按“▼键”2秒）均会立刻切断声光电反馈，安全重置至时钟待机状态。
2. 传感器对码与报警映射矩阵
手环接收到 433MHz 传感器射频数据后，通过匹配预设数据码（高 4 位为类型）和地址码，根据下表驱动多色 LED、马达振动波形并更新 OLED 显示。
| 传感器类型 | 数据码标识 | LED 颜色 | OLED 默认名称 (法语) | 马达振动波形 (周期 5 秒) |
|---|---|---|---|---|
| 🚪 门磁/窗磁 | 0x01 (A) |
● 红色 | PORTE ENTREE |
1 次短振 300ms |
| 👤 PIR 人体红外 | 0x02 (B) |
● 橙色 | SALON PIR |
2 次 short 300ms (间隔 200ms) |
| 🔥 烟雾传感器 | 0x03 (C) |
● 绿色 | CUISINE FUMEE |
3 次短振 200ms (间隔 150ms) |
| 💨 气体泄漏 | 0x05 (E) |
● 紫色 | CUISINE GAZ |
4 次短振 200ms (间隔 100ms) |
| 💧 水浸传感器 | 0x06 (F) |
● 黄色 | SDB EAU |
2 次长振 600ms (间隔 300ms) |
| 🚨 本地主动 SOS | 手环触发 | ● 红色闪烁 | SOS EMITTED |
持续长振 (振 1000ms, 停 200ms) |
Important
手环主动发射 SOS 射频数据格式： 当触发“本地主动 SOS”时，手环通过内置发射芯片以 2 秒 为周期循环发射 EV1527 协议数据：
- 源地址：手环的 20位出厂固定唯一 ID (Factory ID)。
- 数据码：固定为
0x08(即1000)。- 目的：使 IPC 摄像头能接收解码，将其与配对列表中该手环的 Factory ID 匹对，从而识别求救来源。
Important
屏蔽 SOS 被动报警：为避免两个手环互发 SOS 相互触发造成死循环报警，手环必须强行过滤并排除对外界发射的 SOS 求救广播（数据码为
0x04或特定紧急按钮码）的被动接收。
3. ZONE 防区划分
手环支持将配对的传感器划分至不同的防区：
- ZONE 0 (永久防区)：烟雾、气体、水浸等危及安全的传感器。不论手环是否处于布防状态，一旦捕获信号即刻报警。
- ZONE 1~N (可撤布防区)：门磁、红外等防盗传感器。只有当手环接收到布防广播（系统进入 ARMED）时才会报警；在撤防（DISARMED）状态下被动忽略。