docs: 根据1.14寸屏幕、5按键与可编程RGB新规格更新项目文档

This commit is contained in:
2026-07-09 10:49:15 +08:00
parent 17a90ff7dc
commit fdf0c5ed1b
15 changed files with 174 additions and 113 deletions

View File

@@ -1,4 +1,4 @@
# 测试设计与验证方法 (docs/70_testing/main.md)
# 测试设计与验证方法 (Docs/70_testing/main.md)
本章节整理手环系统的仿真联调指令、IO 状态变化监控规范以及人工实机验证用例。
@@ -8,9 +8,11 @@
| 串口发送字符 | 对应仿真的物理事件与说明 | 预期系统响应 |
| :--- | :--- | :--- |
| **`u` / `U`** | 仿真短按 / 长按 **▲ 键** | 时钟界面切换 / 菜单滚动 |
| **`d` / `D`** | 仿真短按 / 长按 **▼ 键** | 时钟界面切换 / 菜单滚动 / 长按取消报警 |
| **`s` / `S`** | 仿真短按 / 长按 **SOS 键** | 触发本地主动 SOS 警报 / 触发对码保存 |
| **`u` / `U`** | 仿真短按 / 长按 **侧边 ▲ 键** | 时钟微调 / 菜单滚动 |
| **`d` / `D`** | 仿真短按 / 长按 **侧边 ▼ 键** | 时钟微调 / 菜单滚动 / 长按取消报警 |
| **`e` / `E`** | 仿真短按 / 长按 **侧边 ■ 确认键** | 选中并进入等待配对 / 短按取消报警 |
| **`s` / `S`** | 仿真短按 / 长按 **上部 SOS 1 键** | 触发本地主动 SOS 警报 / 触发对码保存 |
| **`x` / `X`** | 仿真短按 / 长按 **上部 SOS 2 键** | 同上,验证双 SOS 键并联触发等效性 |
| **`c`** | 仿真同时长按 **▲ + ▼ 键 3 秒** | 系统直接进入配对模式P-00 |
| **`a`** | 仿真捕获到**已配对门磁**报警信号 | 系统跳转到门磁报警界面,亮红灯,振动 1 次 |
| **`p`** | 仿真捕获到**已配对 PIR 红外**信号 | 系统跳转到 PIR 报警界面,亮橙灯,振动 2 次 |
@@ -23,7 +25,7 @@
## 2. LED 与马达 IO 跳变日志
主循环对外设引脚的电平状态进行了跟踪,当引脚电平发生变化时,自动通过串口向外部终端打印输出日志。这可以在没有焊接实体马达或 LED 灯的情况下验证控制逻辑是否正确:
* **LED 状态日志格式**`[STATE] LED status -> R:1 G:0 B:0` (0表示亮1表示灭)
* **LED 状态日志格式**`[STATE] LED status -> R:1 G:0 B:0` (0表示亮1表示灭WS2812B 幻彩 LED 控制状态)
* **马达状态日志格式**`[STATE] MOTOR -> 1` (1表示开启振动0表示关闭振动)
---
@@ -32,10 +34,10 @@
### 3.1 时钟待机与电量对齐
* **测试方法**:正常上电启动,查看待机界面。
* **预期结果**:时钟、日期显示正常。屏幕右上角的电量 `85%` 与电池图标对齐美观,无任何重叠或乱码(间距为 6 像素)
* **预期结果**:时钟、日期显示正常。**135 像素宽** 屏幕上,电量 `85%` 绘制在 `X=77, Y=24`,电池图标绘制在 `X=107, Y=27`,对齐美观且有 6 像素的安全间距
### 3.2 传感器对码与保存
* **测试方法**:同时长按 ▲+▼ 3秒进入配对用上下键选中 `DETEC. PIR`后物理触发 PIR 传感器,后按下 SOS 确认保存。
* **测试方法**:同时长按 ▲+▼ 3秒进入配对用上下键选中 `DETEC. PIR`按下侧边 **■ 确认键** 开启等待,随后物理触发 PIR 传感器,后按下 **SOS 1**(或 **SOS 2**确认保存。
* **预期结果**
1. 进入配对时LED 亮白色闪烁3Hz马达短振 1 次确认。
2. 解码匹配成功后OLED 屏显示 `✓已保存`LED 绿色常亮 2 秒,马达强振 1 次400ms随后自动退回配对菜单。
@@ -44,4 +46,5 @@
* **测试方法**:在常态下静置手环 10 秒钟不作任何操作。
* **预期结果**
1. 10秒后屏幕全黑关闭且 LED 熄灭,马达不鸣叫(`SGM_CTRL` 拉低为0
2. 按下任意一个物理按键(▲、▼、SOS),屏幕瞬间被点亮并重新恢复时钟待机画面。
2. 按下任意一个物理按键(▲、▼、确认键、SOS1、SOS2),屏幕瞬间被点亮并重新恢复时钟待机画面。