docs: 光耦呼吸加速文档同步 (devlog+product-manual+technical-spec)

2026-07-31 11:50:54 +08:00
parent 1790a9fd42
commit e2099ae12f
3 changed files with 17 additions and 26 deletions
@@ -10,34 +10,24 @@

 | 变更 | 说明 |
 |------|------|
-| `g_loop_cut_amount` 累加修复 | 重连路径补充 `g_loop_cut_last = 0` 边沿记忆清零，修复二次断开后 counter 卡在 1 的问题；放开硬编码 3 次上限 |
-| Modbus 主动上报线圈事件 | 线圈断开/重连时立即触发主动上报（对齐 700BS 行为） |
-| 0x2C 复位指令重构 | 700BS: `handle_reset_init()` 改为直接 `SYS_ResetExecute()` MCU 全复位；Modbus: 新增 HR 0x0012 System Cmd，写 0x2C2C 触发全复位 |
-| HR 0x0012 寄存器 | 协议文档 V1.7：新增 `MB_HR_SYSTEM_CMD` (0x0012)，旧 0x00FF 标注废弃 |
-| DLD154Tool 同步 | `protocol_modbus.py` +`build_reset_mcu()`；`main.py` Modbus Tab 红色复位按钮 |
-| RS485 初始化时序 | `rs485_init()`/`modbus_init()` 从 `gpio_uart_init()` 移至 `main()` 中 `para_store_init()` 之后，确保波特率参数加载后初始化 |
+| `g_loop_cut_amount` 累加修复 | 重连路径补充 `g_loop_cut_last = 0` 边沿记忆清零，放开 3 次上限 |
+| Modbus 主动上报线圈事件 | 线圈断开/重连立即触发主动上报（对齐 700BS） |
+| 0x2C 复位指令重构 | 700BS: `SYS_ResetExecute()` MCU 全复位；Modbus: HR 0x0012=0x2C2C |
+| DLD154Tool v1.0.0 | 版本显示 + PyInstaller 打包；Modbus 复位按钮 |
+| RS485 初始化时序 | 移至 `para_store_init()` 之后 |
+| 光耦呼吸加速 | 红灯在非复位模式下光耦有信号时加速 (~0.5s)，便于现场判断光耦状态 |

 ### 涉及文件

 | 文件 | 变更 |
 |------|------|
-| `peripheral_main.c` | cut_amount 修复 + RS485 初始化时序调整 |
+| `peripheral_main.c` | cut_amount 修复 + RS485 时序 + 光耦呼吸加速 (BREATH_OPTO_DUTY_STEP=32) |
 | `rs485_700bs.c` | `handle_reset_init()` → `SYS_ResetExecute()` |
-| `rs485_modbus.c` | +HR 0x0012 read/write (FC 0x03/0x06/0x10) |
-| `rs485_modbus.h` | +`MB_HR_SYSTEM_CMD` / `MB_CMD_RESET_MCU` |
-| `protocol_modbus.py` | +`build_reset_mcu()` |
-| `main.py` | TabModbus +复位按钮 + `_send_reset()` |
-| `rs485-modbus-protocol.md` | V1.6→V1.7 全量更新 |
-| `devlog.md` | 本条目 |
-
-### 影响
-
- 线圈断开计数器从现在起如实累加，Modbus 全数据块 `Cut Cnt` 不再卡在 1
- 0x2C/HR 0x0012 执行真正的 MCU 全复位（含外设重新初始化），而非仅"复位线圈基线"
- 上位机 DLD154Tool 同步支持新复位指令
- RS485 初始化不再受参数加载顺序影响
-
---
+| `rs485_modbus.c/h` | +HR 0x0012 (System Cmd) |
+| `protocol_modbus.py` / `main.py` | +`build_reset_mcu()` + 复位按钮 |
+| `DLD154Tool.spec` / `.gitignore` | PyInstaller 打包配置 |
+| `rs485-modbus-protocol.md` | V1.6→V1.7 |
+| `devlog.md` / `product-manual.md` / `technical-spec.md` | V3.02 文档同步 |

 ## 2026-07-30 — Modbus RTU V1.6 私有协议编码实现

@@ -86,10 +86,10 @@ DLD154Pro 是一款基于 RISC-V 微控制器的**单通道环形线圈蓝牙车

 ### 3.2 指示灯

-| 指示灯 | 颜色 | 功能 |
+| 灯 | 颜色 | 功能 |
 |--------|------|------|
 | 绿灯 (LEDA) | 绿色 | 车辆检测指示 / 自检。初始化/稳定期慢闪，有车亮，无车灭 |
-| 红灯 (LEDB) | 红色 | 系统运行指示（呼吸灯，表示正常工作） |
+| 红灯 (LEDB) | 红色 | 系统运行指示（呼吸灯）。光耦有信号时加速至 ~0.5s 周期 |

 ### 3.3 内部跳线/配置

@@ -194,8 +194,9 @@ DLD154Pro 支持通过光耦输入接入外部雷达/车检器的干接点信号
 |------|------|------|
 | 上电初始化 / 基线学习中 | **慢闪** (200ms 亮/灭) | 呼吸 (~1.9s 周期) |
 | 线圈断开 | **灭** | 呼吸 |
-| 正常运行，无车 | **灭** | 呼吸 |
+| 正常运行，无车 | **灭** | 呼吸 (~1.9s) |
 | 正常运行，有车 | **亮** | 呼吸 |
+| 光耦有信号 (非复位模式) | — | **快闪 (~0.5s)** |

 > **提示**：上电后绿灯慢闪约 1.2s 后熄灭，表示线圈稳定就绪。如果绿灯一直慢闪不灭（超过 5s），说明线圈可能未连接或电感异常。

@@ -429,7 +429,7 @@ TMR1 ISR (每 5ms)

 ### 7.3 红灯行为

-呼吸灯 (PWM11, ~1.9s 周期)，始终运行，指示系统正常工作。不参与车辆/故障指示。
+呼吸灯 (PWM11)，始终运行，指示系统正常工作。**非复位模式下光耦有信号时加速至 ~0.5s 周期**（DUTY_STEP=32），便于现场判断光耦输入是否正常。无光耦信号时 ~1.9s 周期（DUTY_STEP=8）。

 ---