docs: update implementation plan and walkthrough
This commit is contained in:
@@ -4,42 +4,58 @@
|
||||
|
||||
## 实现功能摘要
|
||||
|
||||
1. **自适应射频解码兼容性**：
|
||||
* 重构为**基于电平比例的自适应解码算法**。放宽绝对微秒窗口限制（高电平50~2500us，低电平1500~60000us），通过低/高电平比例（15~48倍，基准为31倍）自动识别 EV1527 帧并解析数据。
|
||||
* 优化串口调试输出，避免大量多行打印造成的 CPU 阻塞。
|
||||
### 1. 法语 UI 语言包支持 (French-Only UI)
|
||||
* **全界面翻译**：手环所有的 UI 屏幕显示内容均已替换为法语。
|
||||
* **界面排版优化**：考虑到法语单词通常较长，所有中法文映射后的短语长度均严格限制在 120 像素宽的 OLED 屏幕边界内（每行最大 15 个字符），并通过调整绘图坐标和排版（如 "DESARME" 解锁图标与文字的 X 坐标微调），确保显示效果居中且不发生重叠。
|
||||
* `WATCH` ➔ `MONTRE`
|
||||
* `ARMED` ➔ `ARME`
|
||||
* `DISARM` ➔ `DESARME`
|
||||
* `PAIR MENU` ➔ `MENU APPAI.`
|
||||
* `DOOR SENSOR` ➔ `DETEC. PORTE`
|
||||
* `PIR MOTION` ➔ `DETEC. PIR`
|
||||
* `SMOKE DETECT` ➔ `DETEC. FUMEE`
|
||||
* `GAS LEAK` ➔ `DETEC. GAZ`
|
||||
* `WATER FLOOD` ➔ `DETEC. EAU`
|
||||
* `SEARCHING...` ➔ `RECHERCHE...`
|
||||
* `TRIGGER SENSOR` ➔ `DECLENCH. CAPT`
|
||||
* `CODE FOUND` ➔ `CODE TROUVE`
|
||||
* `HOLD SOS TO SAVE` ➔ `MAINTENIR SOS`
|
||||
* `PAIR SUCCESS` ➔ `SUCCES APPAI.`
|
||||
* `PAIR TIMEOUT` ➔ `DELAI DEPASSE`
|
||||
* `NO SIGNAL FOUND` ➔ `AUCUN SIGNAL`
|
||||
* `PAIR FAILED` ➔ `ECHEC APPAI.`
|
||||
* `TYPE MISMATCH` ➔ `TYPE INCORRECT`
|
||||
* `EMIT SOS` ➔ `SOS EMIS`
|
||||
* `BAND TRIGGERED` ➔ `BRACELET ACTIF`
|
||||
* `BINDING IPC` ➔ `LIAISON IPC`
|
||||
* `TRANSMITTING...` ➔ `ENVOI EN COURS`
|
||||
|
||||
2. **严格匹配要求的按键与事件交互逻辑**：
|
||||
* **进入配对菜单**：在待机模式下，同时长按 `▲`（上键）+ `▼`（下键） 3秒，进入传感器类型选择菜单（无震动与LED闪烁，保持菜单展示）。
|
||||
* **进入对码搜索 (Pair Wait)**：在菜单中选择好类型后，短按 `SOS` 确认，此时触发 1 次 100ms 短振确认，且 LED 开启白色快闪（3Hz），进入雷达扫描信号接收。
|
||||
* **主动呼救 (Emit SOS)**：在待机模式下，短按 `SOS` 键，立刻切入求救模式并开始向外循环发射 433MHz 警报信号。
|
||||
* **IPC 对码绑定**：在待机模式下，长按 `SOS` 键 5秒，显示 BINDING IPC 页面，向外发射 1 次 433MHz 绑定信号（数据码为 0x01），维持 2 秒后自动返回待机。
|
||||
* **解除求救模式**：在求救模式下，长按任意一个按键（UP、DOWN 或 SOS），即可主动解除警报退回时钟待机。
|
||||
### 2. 单线制幻彩 RGB LED (XL-2020RGBC-2812B) 驱动集成
|
||||
* **物理层引脚映射**：使用原 `LED_R` 所属引脚 `P0.0` 作为单线数据输入（DIN）引脚，将其配置为高速推挽输出。在系统初始化时主动输出熄灭状态，防止上电乱闪。
|
||||
* **精准 Bit-bang 驱动**：根据 `XL-2020` 的 800Kbps 时序规范（1T cycle ≈ 41.67ns @ 24MHz），实现了毫微秒级别的 `WS2812_Write24Bit(u8 g, u8 r, u8 b)` 与 `WS2812_Reset()` 软件驱动。在发送数据流时，关闭总中断 `EA = 0`，确保脉冲宽度不被中断打断。
|
||||
* **软件级虚拟 LED 兼容层**：将原有的 `LED_R`, `LED_G`, `LED_B` 重定义为全局 `bit` 软件变量。在 1ms `Timer1_Isr` 结尾捕获到虚拟 LED 的状态改变时，再自动调用 `WS2812` 驱动输出对应的 GRB 24 位电平。这使得应用层所有的 LED 闪烁及颜色逻辑无需任何改动，保证了系统的高稳定性与高扩展性。
|
||||
|
||||
3. **不接收/解析他人 SOS 广播**：
|
||||
* 手环只对已经配对存储在内部数据库（门磁、PIR、烟感、燃气、水浸）的传感器 ID 触发报警。
|
||||
* 防区轮询解码时严格过滤并排除 SOS 信号的被动接收，防止被其他设备的 SOS 广播误触发。
|
||||
### 3. 自适应射频解码兼容性
|
||||
* 重构为**基于电平比例的自适应解码算法**。放宽绝对微秒窗口限制，通过低/高电平比例（15~48倍，基准为31倍）自动识别 EV1527 帧并解析数据。
|
||||
* 优化串口调试输出，避免大量多行打印造成的 CPU 阻塞。
|
||||
|
||||
4. **各传感器特定声光电反射与对码状态**：
|
||||
* **对码流程**：
|
||||
* 对码中：LED 维持 **白色快闪 (3Hz)**（R+G+B 全开闪烁）。
|
||||
* 对码成功：屏幕显示 PAIR SUCCESS，触发 **强力长振 1 次 (400ms)**，并且 LED **绿色常亮 2 秒**。
|
||||
* 对码失败/超时：双击快速短振 (100ms + 100ms)，LED **红色快闪 3 次**。
|
||||
* **传感器报警触发模式** (5秒循环周期)：
|
||||
* **门磁**：LED 红色常亮，马达 1 次短振 300ms。
|
||||
* **PIR 人体感应**：LED 黄色（R+G 混色），马达 2 次短振 300ms (间隔 200ms)。
|
||||
* **烟雾**：LED 绿色，马达 3 次短振 200ms (间隔 150ms)。
|
||||
* **气体**：LED 紫色（R+B 混色），马达 4 次短振 200ms (间隔 100ms)。
|
||||
* **水浸**：LED 黄色（R+G 混色），马达 2 次长振 600ms (间隔 300ms)。
|
||||
* **手环主动 SOS 求救模式**：
|
||||
* LED **红色极速闪烁 (5Hz)**。
|
||||
* 马达 **持续 1200ms 循环长振** (振动 1000ms，静止 200ms 循环)。
|
||||
### 4. 严格匹配要求的按键与事件交互逻辑
|
||||
* **进入配对菜单**：在待机模式下，同时长按 `▲` + `▼` 3秒，进入传感器类型选择菜单。
|
||||
* **进入对码搜索 (Pair Wait)**：在菜单中选择好类型后，短按 `SOS` 确认，此时触发 1 次 100ms 短振确认，且 LED 开启白色快闪（3Hz），进入雷达扫描信号接收。
|
||||
* **主动呼救 (Emit SOS)**：在待机模式下，短按 `SOS` 键，立刻切入求救模式并开始向外循环发射 433MHz 警报信号。
|
||||
* **IPC 对码绑定**：在待机模式下，长按 `SOS` 键 5秒，显示 BINDING IPC 页面，向外发射 1 次 433MHz 绑定信号（数据码为 0x01），维持 2 秒后自动返回待机。
|
||||
* **解除求救模式**：在求救模式下，长按任意一个按键（UP、DOWN 或 SOS），即可主动解除警报退回时钟待机。
|
||||
|
||||
5. **电池百分号显示修复与坐标复原**：
|
||||
* **字模基线对齐**：将 `%` 字符（0x25）的字模数据在 8x16 矩阵中向上平移 2 像素，使其与前面的数字处于同一水平基准线。
|
||||
* **坐标优化防重合**：将电池图标右移至 `X=92, Y=27`，电量百分比置于 `X=62, Y=24`。二者之间保留 6 像素间距，既美观又完美杜绝了贴合与重叠问题。
|
||||
### 5. 不接收/解析他人 SOS 广播
|
||||
* 手环只对已经配对存储在内部数据库（门磁、PIR、烟感、燃气、水浸）的传感器 ID 触发报警。
|
||||
* 防区轮询解码时客观过滤并排除 SOS 信号的被动接收。
|
||||
|
||||
6. **对码捕获卡顿 Bug 修复**：
|
||||
* 修复了 `while(1)` 循环开头无条件执行 `state_changed = 0` 导致在 Section 4 异步检测到射频匹配信号跳入 `STATE_PAIR_CONFIRM` 后重绘标记被强行抹除、屏幕始终卡死在搜索雷达页面的 Bug。现在已改在重绘判定内部重置，检测到对码信号即可瞬间跳转至“捕获成功”确认页。
|
||||
### 6. 电池百分号显示修复与坐标复原
|
||||
* **字模基线对齐**：将 `%` 字符（0x25）的字模数据在 8x16 矩阵中向上平移 2 像素，使其与前面的数字处于同一水平基准线。
|
||||
* **坐标优化防重合**：将电池图标右移至 `X=92, Y=27`，电量百分比置于 `X=62, Y=24`。二者之间保留 6 像素间距，既美观又完美杜绝了贴合与重叠问题。
|
||||
|
||||
### 7. 对码捕获卡顿 Bug 修复
|
||||
* 修复了 `while(1)` 循环开头无条件执行 `state_changed = 0` 导致在 Section 4 异步检测到射频匹配信号跳入 `STATE_PAIR_CONFIRM` 后重绘标记被强行抹除、屏幕始终卡死在搜索雷达页面的 Bug。现在已改在重绘判定内部重置，检测到对码信号即可瞬间跳转至“捕获成功”确认页。
|
||||
|
||||
## 仿真模式扩展说明
|
||||
|
||||
@@ -52,10 +68,13 @@
|
||||
* 发送 **`2`**：强制系统进入 **ARMED** 布防模式（门磁/PIR 此时被触发会立刻报警）。
|
||||
* 发送 **`3`**：强制系统进入 **DISARMED** 撤防模式。
|
||||
|
||||
## 编译结果
|
||||
## 编译与 Git 仓库同步信息
|
||||
|
||||
* **编译器**：Keil C251 V5.60.0.0
|
||||
* **编译输出目标**：`Build\wristband.hex`
|
||||
* **Errors**：0
|
||||
* **Warnings**：2
|
||||
* **Program Size**：data=104.1, edata+hdata=351, xdata=352, const=1395, code=13552
|
||||
* **编译状态**：0 Errors, 2 Warnings (均属于未调用辅助函数的警告，无任何影响)
|
||||
* **Program Size**：data=104.7, edata+hdata=351, xdata=352, const=1390, code=13855
|
||||
* **Git 仓库地址**：`https://dev.xtell.cn/zouhaitao/stc32g128k.git`
|
||||
* **Git 提交记录**：
|
||||
* `feat: initial commit for stc32g12k128 wristband firmware` (含完整 `.gitignore` 规则，已成功忽略全部编译器生成的 `.obj` / `.lst` / `.hex` 等中间临时文件)。
|
||||
* `feat: translate UI to French and implement XL-2020RGBC-2812B addressable RGB LED driver` (添加了法语界面翻译与 WS2812B 精准时序单线驱动，并成功推送至远程 `master` 分支)。
|
||||
|
||||
Reference in New Issue
Block a user