docs: 700BS 协议 Markdown + Modbus V1.2 700BS 兼容

- 新增 docs/rs485-700bs-protocol.md: 700BS V1.15 完整协议文档
- Modbus V1.2: DI +Freq Low/High Fault, +Init Flag; IR +DIP Virtual; HR +Device Reset(0x00FF), +Init Flag Clear(0x00FE)
- +§7 700BS 兼容对照表 (FA/1B/2C/3D/AA → Modbus 寄存器映射)

docs/rs485-700bs-protocol.md

@@ -0,0 +1,210 @@
+# 车检器 RS485 通信协议 — DLD-700BS
+
+> 版本: V1.15 | 日期: 2022-08-19 | 来源: `reference/docs/A5 20220819 车检器RS485通信协议 DLD-700BS V1.15.pdf`
+>
+> 兼容产品: DLD-700BS 系列车检器
+
+---
+
+## 1. 物理层
+
+| 参数 | 值 |
+|------|-----|
+| 接口 | RS485 半双工 |
+| 波特率 | 9600 bps |
+| 数据位 | 8 |
+| 校验 | 无 (N) |
+| 停止位 | 1 |
+| 从机地址 | 0x01–0x10（16 个地址，DIP 拨码设置） |
+
+---
+
+## 2. 地址码设置（DIP 拨码）
+
+| DIP7 | DIP8 | DIP9 | DIP10 | 地址 |
+|------|------|------|-------|------|
+| OFF | OFF | OFF | OFF | 0x01 |
+| ON | OFF | OFF | OFF | 0x02 |
+| OFF | ON | OFF | OFF | 0x03 |
+| ON | ON | OFF | OFF | 0x04 |
+| OFF | OFF | ON | OFF | 0x05 |
+| ON | OFF | ON | OFF | 0x06 |
+| OFF | ON | ON | OFF | 0x07 |
+| ON | ON | ON | OFF | 0x08 |
+| OFF | OFF | OFF | ON | 0x09 |
+| ON | OFF | OFF | ON | 0x0A |
+| OFF | ON | OFF | ON | 0x0B |
+| ON | ON | OFF | ON | 0x0C |
+| OFF | OFF | ON | ON | 0x0D |
+| ON | OFF | ON | ON | 0x0E |
+| OFF | ON | ON | ON | 0x0F |
+| ON | ON | ON | ON | 0x10 |
+
+---
+
+## 3. 通信数据包格式
+
+主机发送固定 **3 字节**：
+
+```
+| STX    | ADDR/CMD | XOR     |
+| 1 byte | 1 byte   | 1 byte  |
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| STX | uint8 | 起始字节 / 命令码 |
+| ADDR | uint8 | 目标地址 (0x01–0x10)，或命令码的组成部分 |
+| XOR | uint8 | 异或校验：`XOR = STX ^ ADDR/CMD` |
+
+---
+
+## 4. 命令集
+
+### 4.1 查询有车状态及线圈好坏
+
+**主机发送：**
+
+```
+| 0xFA | ADDR | XOR |
+```
+
+> 例：查询 1# 车检器 → `FA 01 FB`
+
+**从机回复：**
+
+```
+| 0xF5 | DATA | XOR |
+```
+
+| DATA 位 | 说明 |
+|---------|------|
+| bit7 | 车辆状态：0=无车，1=有车 |
+| bit5 | 线圈状态：0=正常，1=线圈断开 |
+| bit4–0 | 地址 (0x01–0x10) |
+| XOR | `0xF5 ^ DATA` |
+
+> 例：
+> - 1# 无车 → `F5 01 F4`
+> - 2# 有车 → `F5 82 77`
+> - 3# 无车+线圈断 → `F5 23 D6`
+
+---
+
+### 4.2 查询线圈振荡频率
+
+**主机发送：**
+
+```
+| 0x1B | ADDR | XOR |
+```
+
+> 例：查询 1# → `1B 01 1A`
+
+**从机回复：**
+
+```
+| 0x14 | Fre_1 | Fre_2 | Fre_3 | ADDR | XOR |
+```
+
+| 字段 | 说明 |
+|------|------|
+| Fre_1–3 | 3 字节频率 (big-endian): `Freq = (Fre_1 << 16) \| (Fre_2 << 8) \| Fre_3`，单位 Hz |
+| XOR | `0x14 ^ Fre_1 ^ Fre_2 ^ Fre_3 ^ ADDR` |
+
+> 例：
+> - 1# → `14 00 ED E8 01 10`，Freq = 0x00EDE8 = 60.904 kHz
+> - 2# → `14 01 63 06 02 72`，Freq = 0x016306 = 90.886 kHz
+
+---
+
+### 4.3 车检器复位重新初始化线圈
+
+**主机发送：**
+
+```
+| 0x2C | ADDR | XOR |
+```
+
+> 例：复位 1# → `2C 01 2D`
+
+**从机无回复。**
+
+---
+
+### 4.4 查询拨码开关 DIP1–5 设置
+
+**主机发送：**
+
+```
+| 0x3D | ADDR | XOR |
+```
+
+> 例：查询 1# → `3D 01 3C`
+
+**从机回复：**
+
+```
+| 0x32 | DATA | ADDR | XOR |
+```
+
+| DATA 位 | 说明 |
+|---------|------|
+| bit4–0 | DIP1–5 状态：0=OFF，1=ON |
+
+> 例：
+> - 1# → `32 0D 01 3E`（DIP1、DIP3、DIP4=ON，DIP2、DIP5=OFF）
+> - 2# → `32 0A 02 3A`（DIP2、DIP4=ON，DIP1、DIP3、DIP5=OFF）
+
+---
+
+### 4.5 主动上报心跳 (0xAA)
+
+空闲每隔 **5 秒**上报一次。线圈异常每隔 **1 秒**上报直到恢复。有车/无车事件**立即上报**。
+
+**从机主动发送：**
+
+```
+| 0xAA | Init_B | State | Fre_Err | Fre_1 | Fre_2 | Fre_3 | ADDR | XOR |
+```
+
+| 字段 | 字节 | 说明 |
+|------|------|------|
+| Init_B | 1 | `A1`=设备复位后首次上报，`A0`=正常 |
+| State | 1 | bit7=有车，bit5=线圈断开，bit4–0=地址 |
+| Fre_Err | 1 | `0x00`=频率正常。bit0=1→下限异常；bit4=1→上限异常 |
+| Fre_1–3 | 3 | 线圈振荡频率 (big-endian, Hz) |
+| ADDR | 1 | 设备地址 |
+| XOR | 1 | `0xAA ^ Init_B ^ State ^ Fre_Err ^ Fre_1 ^ Fre_2 ^ Fre_3 ^ ADDR` |
+
+> 复位触发条件：上电、协议控制复位(0x2C)、有限存在模式超时复位、重新连接线圈。
+>
+> 例：
+> - 1# 启动后首次上报 → `AA A1 01 00 00 BF 50 01 E4`
+> - 1# 车进入 → `AA A0 81 00 00 BF 84 01 B1`
+> - 1# 车离开 → `AA A0 01 00 00 BF 50 01 E5`
+> - 1# 线圈断开 → `AA A0 21 00 00 BF 4E 01 DB`（持续每秒发送，直到恢复）
+
+---
+
+## 5. 命令速查表
+
+| STX | 方向 | 功能 | 回复 |
+|-----|------|------|------|
+| 0xFA | 主→从 | 查询有车 + 线圈状态 | F5 DATA XOR |
+| 0x1B | 主→从 | 查询线圈频率 | 14 Fre1-3 ADDR XOR |
+| 0x2C | 主→从 | 复位初始化线圈 | 无回复 |
+| 0x3D | 主→从 | 查询 DIP1-5 | 32 DATA ADDR XOR |
+| 0xAA | 从→主 | 主动心跳上报 | 不回复 |
+
+---
+
+## 6. DLD154Pro 兼容说明
+
+| 700BS 命令 | DLD154Pro 兼容 | 备注 |
+|-----------|---------------|------|
+| 0xFA 查询状态 | Modbus → DI 0x0000–01 | 等价覆盖 |
+| 0x1B 查询频率 | Modbus → IR 0x0000–01 | 等价覆盖（32-bit） |
+| 0x2C 复位 | Modbus → HR 0x00FF | 新增命令寄存器 |
+| 0x3D 查拨码 | Modbus → IR 0x000C (DIP Virtual) | DLD154Pro 无物理拨码，虚拟映射 |
+| 0xAA 心跳 | Modbus 无等价 | 主从架构限制，靠轮询 DI+IR 补偿 |

docs/rs485-modbus-protocol.md

@@ -1,6 +1,6 @@
 # DLD154Pro RS485 Modbus RTU 协议
 
-> 版本: V1.1 | 日期: 2026-07-22 | 状态: 草案（待评审，未实现）
+> 版本: V1.2 | 日期: 2026-07-22 | 状态: 草案（待评审，未实现）
 >
 > 适用产品: DLD154Pro (CH591R, 单路线圈车检器)
 >
@@ -62,6 +62,11 @@
 | 0x0003 | Opto Input | 光耦输入状态 (PB10) | 0=低, 1=高 |
 | 0x0004 | Power Up State | 上电初始化中 | 0=正常, 1=初始化 |
 | 0x0005 | Relay Output | 继电器当前输出状态 | 0=释放, 1=吸合 |
+| 0x0006 | Freq Low Fault | 频率下限异常 (Fre_Err bit0) | 0=正常, 1=频率过低 |
+| 0x0007 | Freq High Fault | 频率上限异常 (Fre_Err bit4) | 0=正常, 1=频率过高 |
+| 0x0008 | Init Flag | 复位后首次指示 (Init_B) | 0=正常, 1=复位后首次—上位机读后清零* |
+
+> **Init Flag 清除机制**：上位机读到 1 后，应发送 **写 HR 0x00FE=0x0001** 清零。参见 §4.7。
 
 ### 3.2 输入寄存器 (Input Registers) — 功能码 0x04
 
@@ -79,6 +84,7 @@
 | 0x0009 | HW Version | uint16 | 1 寄存器 | 硬件版本。例 `0x0301` = v3.01 |
 | 0x000A | Freq Sens | uint16 | 1 寄存器 | 当前灵敏度等级 (0=低, 1=中, 2=高) |
 | 0x000B | Condition | uint16 | 1 寄存器 | 环境活跃度 (0=安静, 1–100=嘈杂) |
+| 0x000C | DIP Virtual | uint16 | 1 寄存器 | 虚拟拨码（700BS 兼容）: bit[7:4]=function_mode, bit[3:0]=fusion_mode |
 
 > **32-bit 值换算**：
 > - 频率：`freq_hz = (reg[0x0000] << 16) | reg[0x0001]`，单位 Hz。典型空线圈 50–120kHz。
@@ -102,9 +108,11 @@
 | 0x0009 | BT Timeout | 0–255 | 0 | R/W | 蓝牙空闲关闭超时 (分钟), 0=不关闭 |
 | 0x000A | Safe Timeout | 0–255 | 0 | R/W | 安全模式超时 (×10s), 0=关闭 |
 | 0x000B | Opto Func | 0–1 | 0 | **R** | 光耦功能: 0=雷达输入, 1=复位 |
+| 0x00FE | Init Flag Clear | 0–1 | — | **W** | 写 1 清零 Init Flag (DI 0x0008) |
+| 0x00FF | Device Reset | — | — | **W** | 写入 `0x5A5A` 触发复位初始化线圈（等效 700BS 0x2C） |
 
 > **只读寄存器 (0x0005–0x0008, 0x000B)**：写操作返回异常 0x02（Illegal Data Address）。
-> 这些参数只能通过 BLE 小程序修改。RS485 地址/波特率通过 Modbus 误改会立即失联。
+> **写入寄存器 (0x00FE, 0x00FF)**：只写不读。读返回 0x0000。写入非魔数值返回异常 0x03。
 
 ---
 
@@ -178,6 +186,22 @@
 <<< 01 86 03 02 63             (异常: 功能码 0x86, 异常码 0x03=Illegal Data Value)
 ```
 
+### 4.7 触发设备复位 — 写 HR 0x00FF
+
+```
+>>> 01 06 00 FF 5A 5A xx xx    (写 0x00FF=0x5A5A, 触发复位)
+<<< 01 06 00 FF 5A 5A xx xx    (回显, 随后设备复位)
+```
+
+> 复位后设备重新初始化线圈基线，Init Flag (DI 0x0008) 置 1。
+
+### 4.8 清除 Init Flag — 写 HR 0x00FE
+
+```
+>>> 01 06 00 FE 00 01 xx xx    (写 0x00FE=1)
+<<< 01 06 00 FE 00 01 xx xx    (Init Flag → 0)
+```
+
 ---
 
 ## 5. 功能码支持矩阵
@@ -270,9 +294,33 @@ RS485 半双工时序：发送最后一字节后等待 **1 字节时间** 再切
 
 ---
 
-## 7. 版本历史
+## 7. 700BS 协议兼容对照
+
+DLD154Pro RS485 同时支持 700BS 协议（`g_fm_700bs_disable=0`）和 Modbus RTU（`g_fm_700bs_disable=1`）。
+协议选择通过 BLE 小程序切换。参见 `docs/rs485-700bs-protocol.md`。
+
+| 700BS 命令 | 700BS 字段 | Modbus 等价 | 说明 |
+|-----------|-----------|------------|------|
+| 0xFA 查询状态 | bit7=有车 | DI 0x0000 Car Present | ✅ |
+| | bit5=线圈故障 | DI 0x0001 Loop Fault | ✅ |
+| 0x1B 查询频率 | 3 字节 Freq | IR 0x0000–01 Freq (32bit) | ✅ |
+| 0x2C 复位 | — | **HR 0x00FF** 写 0x5A5A | ✅ V1.2 新增 |
+| 0x3D 查拨码 | DIP1-5 | **IR 0x000C DIP Virtual** | ✅ V1.2 新增 (DLD154Pro 无物理拨码，虚拟映射) |
+| 0xAA 心跳 Init_B | A1=首次 | **DI 0x0008 Init Flag** | ✅ V1.2 新增 |
+| 0xAA 心跳 Fre_Err | bit0=下限异常 | **DI 0x0006 Freq Low Fault** | ✅ V1.2 新增 |
+| | bit4=上限异常 | **DI 0x0007 Freq High Fault** | ✅ V1.2 新增 |
+| 0xAA 心跳 主动上报 | 5s/1s/事件 | — | ⚠️ Modbus 主从架构不支持 push，上位机周期性轮询 DI+IR 等价 |
+
+> **主动上报限制**：Modbus RTU 为严格主从协议，从机不能主动发送数据。
+> 700BS 的心跳/事件上报在 Modbus 模式下不可用。需上位机以 >=1s 周期轮询 DI 0x0000–01
+> 并通过边沿检测模拟事件触发。
+
+---
+
+## 8. 版本历史
 
 | 版本 | 日期 | 作者 | 变更 |
 |------|------|------|------|
+| V1.2 | 2026-07-22 | wangfq | 700BS 兼容: +DI Freq Low/High Fault, +DI Init Flag, +IR DIP Virtual, +HR Device Reset(0x00FF), +HR Init Flag Clear(0x00FE); +§7 700BS 兼容对照表 |
 | V1.1 | 2026-07-22 | wangfq | 修正: CAPVD/Origin/Variation 扩展为 32-bit (×2 寄存器); Output Mode 删除脉冲模式(仅存在输出); 新增 Fusion Mode(输出组合模式 0-6); direction_mode 字段重构说明 |
 | V1.0 | 2026-07-22 | wangfq | 初版草案 |