Files
chrg/docs/功率板升级_南向应答计划.md
T
wrh 9254c82547 refactor: 清理旧YMODEM升级代码,更新版本至V1.1.43
- 删除chrg_comm.h和chrg_def.h中的旧YMODEM状态枚举及注释代码
- 删除chrg_comm.c中已废弃的旧YMODEM重发和会话管理代码
- 更新协议板版本寄存器编码为十进制143
- 新增chrg_ymodem_proxy模块的详细中文注释,明确升级代理职责
- 更新changelog记录V1.1.43版本变更
- 删除无用的Allegro日志文件,优化PCB设计相关文档

本次提交将YMODEM升级功能重构为独立代理模块,不再依赖旧版自动重发逻辑,提升升级流程的可维护性和可靠性。
2026-09-28 20:51:04 +08:00

258 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 功率板升级:南向发送与应答计划
## 1. 范围与原则
南向链路为“协议板 App ↔ 目标功率板 Boot”。功率板Boot按UPK规则接收完整 `.upk` 文件;协议板不修改UPK内容,只负责锁定物理通道、连续发送完整YMODEM帧、采集功率板的单字节应答,并将应答按原顺序交给北向状态机。
南向升级期间停止普通 Modbus 轮询、LCD 插入命令、控制台命令和其他通道请求。升级数据不得经过普通 Modbus解析器。
功率板UPK采用与协议板Boot相同的“1024字节首块”结构:前96字节为UPK逻辑头,后928字节固定为 `0x00`,package body从文件偏移 `0x400` 开始。协议板只校验YMODEM帧长度、包号反码和CRC16;UPK头、大小、加密和CRC由功率板Boot解析。
## 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` | 两字节均按顺序交北向 |
| UPK头区 STX/包1 | `ACK`或`NAK` | Boot解析96字节头并检查928字节填充,不写APP区 |
| UPK包体 STX/包2起 | `ACK`或`NAK` | 从APP首地址开始安装,仅接收`pkg_size`范围内的数据 |
| 普通 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
收到包号1的STX -> S_UPK_HEAD_TX
收到包号2起的SOH/STX -> S_DATA_TX
收到EOT -> S_EOT1_TX
S_UPK_HEAD_TX
UART发送完成 -> S_UPK_HEAD_WAIT
S_UPK_HEAD_WAIT
功率板解析UPK头成功并回复ACK -> 转交北向 -> S_WAIT_DATA
功率板回复NAK/CAN -> 转交北向 -> S_ABORT
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. 包号0只解析YMODEM文件名和文件长度,不写Flash。
5. 包号1必须为STX/1024:解析前96字节UPK头,校验标识、头CRC、目标分区、`raw_size`、`pkg_size`和加密配置;检查后928字节均为 `0x00`;整包不写APP区。
6. 包号2起才处理package body,并从 `0x08003800` 开始安装;不得把UPK头区写入APP。
7. 只处理UPK头声明的 `pkg_size` 字节,忽略最后YMODEM帧的 `0x1A`补齐;不得按整帧把补齐数据计入固件长度。
8. 完成接收后校验package CRC;若启用加密,按UPK配置解密后写APP并校验raw CRC;未加密时直接写APP并校验raw CRC。
9. APP首地址必须是裸固件向量表,写入完成后校验MSP和Reset_Handler范围;任何UPK校验失败都不得跳转APP。
10. 第一次EOT回复NAK,第二次EOT仅在UPK接收和校验成功后回复 `ACK + C`,结束空SOH回复ACK。
11. 明确APP起始地址、最大 `raw_size/pkg_size`和Flash擦除范围;当前APP区为 `0x08003800~0x0800E7FF`,大小 `0xB000`(44KB),必须与App链接脚本一致。
12. 跳转App前关闭中断、DMA、SysTick和相关外设,设置MSP与VTOR。
13. 处理进入控制帧后,先清除控制帧接收缓存和长度计数,再启动YMODEM接收;不得将控制帧的8字节与元数据SOH拼接。
14. UART接收只保留一条DMA-to-idle重启路径;禁止UART IRQ与接收回调同时中止或重复启动DMA。
15. 跳转控制帧匹配成功后,先发送ACK并等待发送完成,再执行App跳转。
## 9. 功率板Boot的UPK安装流程
```text
收到YMODEM包号0
-> 解析文件名和.upk实际长度
-> ACK + C
收到YMODEM包号1(STX/1024)
-> 解析前96字节UPK逻辑头
-> 校验head_crc、大小、分区、加密配置和928字节零填充
-> 初始化package CRC/解密状态
-> 不写APP区
-> ACK
收到YMODEM包号2起
-> 按pkg_size截取有效package body
-> 更新pkg_crc
-> 未加密:从0x08003800顺序写入
-> 已加密:按UPK配置解密后从0x08003800顺序写入
-> 超出pkg_size的0x1A填充不写入
-> 每帧成功后ACK
收到两次EOT
-> 校验累计pkg_size和pkg_crc
-> 校验写入APP的raw_size和raw_crc
-> 校验APP向量表
-> 全部成功后完成标准EOT和结束空SOH握手
-> 任一失败回复CAN或明确失败并禁止跳转
```
## 10. 南向验证顺序
1. 逻辑分析仪确认进入帧完整发送,波特率和通道正确。
2. 确认功率板完整接收 8 字节并完成 Flash 擦除。
3. 确认线路依次出现 `06 43`,协议板应答队列也依次取到 `06 43`。
4. 确认包号0不写Flash,包号1只解析UPK头且不写APP。
5. 确认包号2的数据区首字节写入 `0x08003800`,该地址内容为APP向量表。
6. 验证最后一帧的 `0x1A`补齐不计入大小和CRC。
7. 验证头CRC、package CRC、raw CRC、加密和超长UPK异常路径。
8. 验证标准两次EOT和结束空SOH。
9. 验证CRC错误时NAK能原样传到PC,并由PC重发。
10. 验证ACK丢失、半帧、超时、CAN和断电。
11. 跳转后读取功率板新版本,确认升级真正成功。
12. 连续发送 `ACK+C`、EOT、结束空SOH和跳转控制帧,确认Boot未丢字节、重复启动DMA或将控制帧拼入YMODEM帧。
## 11. 南向实施清单
1. 删除南向收到 NAK或超时后的内部 YMODEM重发。
2. 增加独立的 EOT1、EOT2和结束空包状态。
3. 以 UART发送完成事件启动应答计时。
4. 保证 ACK、C 等应答有序排队和转交。
5. 进入和退出控制帧禁止盲目重试。
6. 升级期间锁定通道并完全停止普通轮询。
7. 完成后恢复轮询并提供版本确认结果。
8. 修复Boot:进入控制帧后清接收缓存、跳转前回ACK、UART使用单一DMA接收重启路径。
9. 修改功率板Boot:包号1解析UPK头但不写APP,包号2起安装package body。
10. 增加UPK长度、头CRC、package CRC、raw CRC、解密和向量表校验。