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

@@ -8,25 +8,24 @@
| 串口发送字符 | 对应仿真的物理事件与说明 | 预期系统响应 |
| :--- | :--- | :--- |
| **`u` / `U`** | 仿真短按 / 长按 **侧边 ▲ 键** | 时钟微调 / 菜单滚动 / **对码确认页:自增序号 (01->99)** |
| **`d` / `D`** | 仿真短按 / 长按 **侧边 ▼ 键** | 时钟微调 / 菜单滚动 / 长按取消报警 / **对码确认页:自减序号 (99->01)** |
| **`e` / `E`** | 仿真短按 / 长按 **侧边 ■ 确认键** | 选中并进入等待配对 / 短按取消报警 / **对码确认页:确认保存配置** |
| **`s` / `S`** | 仿真短按 / 长按 **上部 SOS 1 键** | 触发本地主动 SOS 警报 / 触发对码保存 / **对码确认页:确认保存配置** |
| **`x` / `X`** | 仿真短按 / 长按 **上部 SOS 2 键** | 同上,验证双 SOS 键并联触发等效性 |
| **`c`** | 仿真同时长按 **▲ + ▼ 键 3 秒** | 系统直接进入配对模式P-00 |
| **`u`** | 仿真短按 **侧边 ▲ 键** | 菜单向上滚动 / 序号自增 / 增加数值 / 切换类型 |
| **`d`** | 仿真短按 **侧边 ▼ 键** | 菜单向下滚动 / 序号自减 / 减少数值 / 切换类型 |
| **`D`** | 仿真长按 **侧边 键** (2 秒) | 解除警报退回时钟 / 放弃 IPC 绑定返回时钟 |
| **`e`** | 仿真短按 **侧边 ■ 确认键 (CONFIRM)** | 确认选中进入 / 切换对码二步编辑 / 保存退出 |
| **`E`** | 仿真长按 **侧边 ■ 确认键 (CONFIRM)** (3 秒) | 从时钟待机进入菜单 / 菜单返回时钟 / 放弃对码或绑定返回时钟 |
| **`s` / `S`** | 仿真短按 / 长按 **上部 SOS 1 键** | 触发本地主动 SOS 报警发送 / 解除警报退回时钟 |
| **`x` / `X`** | 仿真短按 / 长按 **上部 SOS 2 键** | 验证双 SOS 键并联触发等效性 |
| **`a`** | 仿真捕获到**已配对门磁**报警信号 | 系统跳转到门磁报警界面,亮红灯,振动 1 次 |
| **`p`** | 仿真捕获到**已配对 PIR 红外**信号 | 系统跳转到 PIR 报警界面,亮橙灯,振动 2 次 |
| **`1`** | 强制切换系统状态为 **NORMAL** (撤防/常态) | 屏幕时钟状态栏显示 `NORMAL` |
| **`2`** | 强制切换系统状态为 **ARMED** (布防) | 屏幕时钟状态栏显示红色闭锁 `🔒` |
| **`3`** | 强制切换系统状态为 **DISARMED** (撤防) | 屏幕时钟状态栏显示绿色开锁 `🔓` |
| **`1`** | 强制唤醒手环并退回 **STATE_CLOCK** | 屏幕时钟状态栏显示待机时钟 |
---
## 2. LED 与马达 IO 跳变日志
主循环对外设引脚的电平状态进行了跟踪,当引脚电平发生变化时,自动通过串口向外部终端打印输出日志。这可以在没有焊接实体马达或 LED灯的情况下验证控制逻辑是否正确
* **LED 状态日志格式**`[STATE] LED status -> R:1 G:0 B:0` (0表示亮1表示灭WS2812B 幻彩 LED 控制状态)
* **马达状态日志格式**`[STATE] MOTOR -> 1` (1表示开启振动0表示关闭振动)
* **LED 状态日志格式**`[STATE] LED status -> R:1 G:0 B:0` (WS2812B 级联双灯珠输出状态)
* **马达状态日志格式**`[STATE] MOTOR -> 1` (1表示开启振动0表示关闭)
---
@@ -36,32 +35,39 @@
* **测试方法**
1. 正常上电启动,查看待机界面右上方电量。
2. 使用外部电压源微调电量采样引脚 **`P0.0`**(模拟输入)输入电压在 1.03V 到 1.31V 之间变化,检查电量百分比是否从 `0%` 线性平滑变化到 `100%`
3. 拔插 USB 充电器,或者直接改变引脚 **`P2.7`** 的电平输入(拉高至 3.3V 或拉低到地),观察百分比数值后面是否能同步增加或移除 `+` 后缀(如在 `85%``85%+` 之间切换,且格式化与电池图标不贴连)。
* **预期结果**:时钟、日期显示正常。在 **135 像素宽** 屏幕上电量百分比与电池图标X=107, Y=27对齐美观,间距大于 6 像素。在 USB 插入时电量后追加 `+` 后缀且能完整显示。
3. 拔插 USB 充电器,或者直接改变引脚 **`P2.7`** 的电平输入,观察百分比数值后面是否能同步增加或移除 `+` 后缀(如在 `85%``85%+` 之间切换,且格式化与电池图标不贴连)。
* **预期结果**:时钟、日期显示正常。在 **120 像素宽** AMOLED 屏幕上电量百分比与电池图标X=82, Y=27对齐美观。在 USB 插入时电量后追加 `+` 后缀且能完整显示。
### 3.2 传感器对码与保存
* **测试方法**:同时长按 ▲+▼ 3秒进入配对用上下键选中 `DETEC. PIR`,按下侧边 **■ 确认键** 开启等待,随后物理触发 PIR 传感器。进入对码确认页后,按 **▲ 键** 将中间括号内数字调节至 `02`(即显示 `PIR [ 02 ]`),最后按下 **■ 确认键** (或 **SOS 1**)确认保存。
* **预期结果**
1. 进入配对时LED 亮白色闪烁3Hz马达短振 1 次确认。
2. 解码匹配成功后LCD 屏显示 `✓已保存` 以及 `PIR 02`LED 绿色常亮 2 秒,马达强振 1 次400ms随后自动退回配对菜单。
### 3.3 常亮长显与射频全时监听验证
* **测试方法**:在常态待机下静置手环超过 10 秒,并在此期间使用发射装置发送已配对的传感器射频报警包,或随时短按上部的 SOS 键。
* **预期结果**
1. 手环在静置超过 10 秒后,屏幕背光不关闭,继续常亮展示时钟待机画面。
2. 无线接收解调模块 100% 保持在监听状态,即使在长时间静置后,只要触发匹配的射频报警,手环能立即接收响应,进入报警闪烁及马达震动状态。
3. 随时短按 SOS 键能立刻跳转到主动发送界面并开启 EV1527 信号广播。
### 3.4 手环主动发射 SOS 与 Factory ID 验证
### 3.2 低功耗休眠与唤醒验证
* **测试方法**
1. 正常开机,在串口输出中查看获取到的 20 位 `Factory ID`(或在绑定界面核对 ID
2. 短按上部任意一个 SOS 键触发紧急求救
3. 使用 433MHz 接收调试工具或逻辑分析仪抓取手环发射引脚或射频信号。
1. 手环置于时钟待机状态下,静置 10 秒以上,观察系统状态
2. 按下侧边任意键,或者触发射频接收信号,观察系统状态
* **预期结果**
1. 手环立刻切入 `SOS EMIS` 界面,红灯闪烁,马达周期性震动
2. 接收工具抓取到以手环 `Factory ID` 为源地址的 24 位 EV1527 信号,其 4 位数据码为 `0x08`
3. 该信号以 2 秒为周期循环向外发射,直到按下“确认键”或其它任意键退出报警状态。
1. 静置 10 秒后OLED 屏幕立刻完全黑屏,检测 `SGM_CTRL` (P3.4) 输出电平为低电平0V单片机电流降为微安级Power-Down 挂起状态)
2. 短按侧边任意按键,或触发 433MHz 信号发射,手环应能被**瞬间唤醒**`SGM_CTRL` 重新输出高电平3.3VAMOLED 重新点亮显示,无花屏或时钟错乱
### 3.3 按键菜单交互与功能选择
* **测试方法**
1. 在时钟待机页下,长按侧边 **■ 确认键** 达 3 秒。
2. 在主菜单页面使用 ▲ 和 ▼ 键进行滚动,分别选中 `1. DATE/HEURE``2. APPAIRAGE`,按下 **■ 确认键** 进入。
* **预期结果**
1. 长按 3 秒后,屏幕立刻切换显示 `- MENU -` 选项卡,且默认首项高亮。
2. 滚动选择灵活响应,高亮行外围有 `> <` 箭头指示。按下确认键后能顺利切换至子修改界面或雷达对码界面。
### 3.4 对码二步保存与微调向导
* **测试方法**
1. 同时长按 ▲+▼ 3秒进入对码触发门磁信号对码成功。
2. 观察屏幕,此时类型字样 `[ PORTE ]` 高亮,按 ▲/▼ 键确认类型名称是否可以修改切换。
3. 点击 **■ 确认键**,查看屏幕焦点是否移入到序号 `[ 01 ]` 上。
4. 此时按 ▲/▼ 键,观察序号数值是否可以进行增减微调。
5. 最后点击 **■ 确认键**,手环是否将数据写入 Flash 数据库,并立刻退回到待机时钟页。
* **预期结果**
对码成功进入微调后,系统按步骤顺序先选择传感器分类、后微调序号,点击确认后成功保存数据库退回时钟。整个过程按 CONFIRM 长按 3s 均可放弃退出。
### 3.5 手环主动发射 SOS 与 Factory ID 验证
* **测试方法**:短按或长按上部任意一个 SOS 键触发紧急求救,使用 433MHz 接收调试工具或逻辑分析仪抓取手环发射信号。
* **预期结果**
1. 手环立刻切入 `SOS EMIS` 界面,级联双红灯闪烁,马达周期性间歇长振。
2. 接收工具抓取到以手环 `Factory ID` 为源地址的 24 位 EV1527 信号,其 4 位数据码为 `0x08`,以 2 秒为周期循环向外发射。再次按下 SOS 键或其它任意键退出。
<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->