docs: 更新修改日志并新增北向功率板升级计划文档

chore: 升级所有相关文件版本号至V1.1.39

feat: 实现北向事务隔离逻辑,新增通道切换清理和事务号匹配机制

feat: 新增北向请求开始函数,处理通道切换后的接收清理和事务号生成

perf: 调整北向回码等待超时时间,量测回码等待80ms,配置回码等待150ms

refactor: 修改北向回码匹配函数,增加通道和事务号校验
This commit is contained in:
wrh
2026-09-24 17:03:15 +08:00
parent 7bdc03fc0e
commit 6d694c3aca
8 changed files with 558 additions and 19 deletions
+207
View File
@@ -0,0 +1,207 @@
# 功率板升级:南向发送与应答计划
## 1. 范围与原则
南向链路为“协议板 App ↔ 目标功率板 Boot”。当前功率板 Boot 仅将 YMODEM 数据区直接写入 `APP_FLASH_BASE_ADDR`,因此本阶段只允许传输裸 APP 镜像。协议板不修改镜像内容,只负责锁定物理通道、连续发送完整 YMODEM 帧、采集功率板的单字节应答,并将应答按原顺序交给北向状态机。UPK 解包、分区、版本、加密和最终 CRC 校验属于后续 Boot 能力,未实现前不得向本 Boot 透传 `.upk`。
南向升级期间停止普通 Modbus 轮询、LCD 插入命令、控制台命令和其他通道请求。升级数据不得经过普通 Modbus解析器。
协议板只校验 YMODEM 帧长度、包号反码和 CRC16;当前 Boot 的 APP 可写范围是 `0x08003800 + 0xB000`(44 KB),裸 APP 镜像长度必须受此范围限制。
## 2. 串口和控制帧
南向串口参数:115200 bps、8N1、无流控。每次发送前必须确认目标通道已选通,并正确控制 RS485 收发方向。
进入功率板 Boot:
```text
03 06 00 0F 00 FF F8 6B
```
功率板正常应答:
```text
06 43
```
其中 `06` 表示进入命令执行成功,`43` 表示 Boot 已准备接收 CRC 模式 YMODEM。
跳转功率板 App:
```text
03 06 00 0F 00 0F F8 2F
```
正常应答为 `06`;`15` 表示失败。Boot 必须在 UART 完整发送 `06` 后才关闭 DMA/中断并跳转 App,避免协议板因未收到应答而超时。
## 3. 南向帧和应答映射
| 协议板发送 | 功率板 Boot 正常回复 | 协议板处理 |
| --- | --- | --- |
| 进入升级控制帧 | `ACK + C` | ACK确认进入,C进入应答队列,按顺序交北向 |
| 元数据 SOH/包0 | `ACK + C` | 两字节均按顺序交北向 |
| 普通 SOH/STX | `ACK` | 交北向,允许下一帧 |
| 校验错误的数据帧 | `NAK` | 原样交北向,不在南向自动重发 |
| 第一次 EOT | `NAK` | 这是正常握手,原样交北向 |
| 第二次 EOT | `ACK + C` | 两字节均按顺序交北向 |
| 结束空 SOH/包0 | `ACK` | 交北向,标记传输完成 |
| CAN | `ACK`或无回复 | 停止会话并清理缓存 |
| 跳转 App 控制帧 | `ACK` | 退出升级模式并恢复轮询 |
## 4. 南向状态机
```text
S_IDLE
北向进入请求 -> 锁通道、停轮询 -> S_ENTER_TX
S_ENTER_TX
UART发送完成 -> S_ENTER_WAIT
S_ENTER_WAIT
ACK -> 记录进入成功
C -> 记录Boot就绪 -> S_WAIT_META
NAK/超时 -> S_ABORT
S_WAIT_META
收到北向完整元数据帧 -> S_META_TX
S_META_TX
UART发送完成 -> S_META_WAIT
S_META_WAIT
ACK -> 转交北向
C -> 转交北向 -> S_WAIT_DATA
NAK -> 转交北向 -> S_WAIT_META
S_WAIT_DATA
收到SOH/STX -> S_DATA_TX
收到EOT -> S_EOT1_TX
S_DATA_TX
UART发送完成 -> S_DATA_WAIT
S_DATA_WAIT
ACK -> 转交北向 -> S_WAIT_DATA
NAK -> 转交北向 -> S_WAIT_DATA
CAN -> 转交北向 -> S_ABORT
S_EOT1_TX
UART发送完成 -> S_EOT1_WAIT
S_EOT1_WAIT
NAK -> 转交北向 -> S_WAIT_EOT2
S_WAIT_EOT2
收到第二次EOT -> S_EOT2_TX
S_EOT2_TX
UART发送完成 -> S_EOT2_WAIT
S_EOT2_WAIT
ACK -> 转交北向
C -> 转交北向 -> S_WAIT_END_SOH
S_WAIT_END_SOH
收到结束空SOH -> S_END_TX
S_END_TX
UART发送完成 -> S_END_WAIT
S_END_WAIT
ACK -> 转交北向 -> S_TRANSFER_DONE
S_TRANSFER_DONE
收到退出请求 -> S_JUMP_TX
S_JUMP_TX
UART发送完成 -> S_JUMP_WAIT
S_JUMP_WAIT
ACK -> 确认已转交北向 -> 恢复轮询 -> S_IDLE
NAK/超时 -> S_ABORT
S_ABORT
清理应答队列和半帧,解除通道锁,恢复轮询 -> S_IDLE
```
## 5. 发送完成与计时起点
`chrg_send_sou_upadata_data()` 返回成功只能表示帧已提交到发送线程,不能表示 UART 已发送完成。
南向必须区分:
1. 提交成功;
2. 通道切换成功;
3. UART 开始发送;
4. UART 发送完成;
5. 功率板返回应答。
所有应答超时必须从 UART 发送完成时开始计算,不能从放入缓存时开始。建议:
| 阶段 | 超时 |
| --- | ---: |
| 进入升级并擦除 Flash | 15 秒 |
| 元数据应答 | 10 秒 |
| 普通数据帧应答 | 10 秒 |
| EOT/结束空包应答 | 10 秒 |
| 跳转 App 应答 | 5 秒 |
## 6. 南向应答队列
功率板应答是单字节流,必须使用有序队列保存 `ACK/NAK/C/CAN`,不能使用单个覆盖变量。
- `ACK + C` 必须保留两个字节和原顺序。
- 队列满时可优先丢弃等待阶段重复出现的周期 `C`,不能丢弃 ACK、NAK 或 CAN。
- 切换通道、进入会话、退出会话前必须清空旧应答。
- 等待当前帧 ACK 时收到周期 `C`,可以暂存或忽略,但不能将其误判为当前帧成功。
- 普通 Modbus 调试文本或其他字节不得进入 YMODEM 应答队列。
## 7. 重试和异常策略
YMODEM 数据帧的重试由北向 PC 负责。南向代理不得在收到 NAK 或应答超时后自行重发上一帧,否则会破坏第一次 EOT 的正常 NAK 时序,并可能在 ACK 丢失时重复写入。
控制帧也不能无条件重发:进入命令的 ACK 丢失但功率板已经进入 Boot 时,再发送 Modbus 控制帧会被当成 YMODEM 垃圾数据。处理方式:
- 只有收到 ACK 才确认进入升级成功;随后收到 C 才确认功率板 Boot 已准备接收元数据。若只收到 C,应记录异常并终止本次会话,不能向北向伪造进入成功响应。
- ACK 或 C 缺失时终止本次会话,要求重新复位/重新进入,不盲目重发控制帧。
- 南向 NAK、CAN 或应答超时应明确上报北向;不得伪造 ACK。
- 发送失败、通道切换失败或队列溢出时立即中止会话。
- 北向取消或会话异常终止时,尽可能向功率板连续发送两个 CAN,再清理状态并恢复普通轮询。
## 8. 与功率板 Boot 的接口要求
功率板 Boot 必须满足:
1. 控制帧可以跨多次 DMA/空闲中断接收并累计到完整 8 字节后匹配。
2. 进入升级时擦除成功回复 `ACK + C`,失败回复 NAK。
3. 支持标准 YMODEM 包号、反码和 CRC16 校验。
4. 第一次 EOT 回复 NAK,第二次 EOT 回复 `ACK + C`,结束空 SOH 回复 ACK。
5. 明确 App 起始地址、最大 UPK/package body 长度和 Flash 擦除范围;当前记录的 `0x08003800 + 0xB000` 为 44 KB,必须与链接脚本和功率板 UPK 分区规则一致。
6. 跳转 App 前关闭中断、DMA、SysTick和相关外设,设置 MSP 与 VTOR。
7. 处理进入控制帧后,先清除控制帧接收缓存和长度计数,再启动 YMODEM 接收;不得将控制帧的 8 字节与元数据 SOH 拼接。
8. UART 接收只保留一条 DMA-to-idle 重启路径;禁止 UART IRQ 与接收回调同时中止或重复启动 DMA。
9. 跳转控制帧匹配成功后,先发送 ACK 并等待发送完成,再执行 App 跳转。
## 9. 南向验证顺序
1. 逻辑分析仪确认进入帧完整发送,波特率和通道正确。
2. 确认功率板完整接收 8 字节并完成 Flash 擦除。
3. 确认线路依次出现 `06 43`,协议板应答队列也依次取到 `06 43`。
4. 使用一个元数据包和一个 STX 包验证停止等待。
5. 验证标准两次 EOT和结束空 SOH。
6. 验证 CRC 错误时 NAK 能原样传到 PC,并由 PC 重发。
7. 验证 ACK 丢失、半帧、超时、CAN、断电和超出功率板 UPK 分区容量的文件。
8. 跳转后读取功率板新版本,确认升级真正成功。
9. 连续发送 `ACK+C`、EOT、结束空 SOH 和跳转控制帧,确认 Boot 未丢字节、重复启动 DMA 或将控制帧拼入 YMODEM 帧。
## 10. 南向实施清单
1. 删除南向收到 NAK或超时后的内部 YMODEM重发。
2. 增加独立的 EOT1、EOT2和结束空包状态。
3. 以 UART发送完成事件启动应答计时。
4. 保证 ACK、C 等应答有序排队和转交。
5. 进入和退出控制帧禁止盲目重试。
6. 升级期间锁定通道并完全停止普通轮询。
7. 完成后恢复轮询并提供版本确认结果。
8. 先修复 Boot:进入控制帧后清接收缓存、跳转前回 ACK、UART 单一 DMA 接收重启路径。
9. 未实现 Boot 端 UPK 解包和最终完整性校验前,升级文件限定为裸 APP 镜像。