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升级功能重构为独立代理模块,不再依赖旧版自动重发逻辑,提升升级流程的可维护性和可靠性。
This commit is contained in:
+69
-19
@@ -2,11 +2,11 @@
|
||||
|
||||
## 1. 范围与原则
|
||||
|
||||
南向链路为“协议板 App ↔ 目标功率板 Boot”。当前功率板 Boot 仅将 YMODEM 数据区直接写入 `APP_FLASH_BASE_ADDR`,因此本阶段只允许传输裸 APP 镜像。协议板不修改镜像内容,只负责锁定物理通道、连续发送完整 YMODEM 帧、采集功率板的单字节应答,并将应答按原顺序交给北向状态机。UPK 解包、分区、版本、加密和最终 CRC 校验属于后续 Boot 能力,未实现前不得向本 Boot 透传 `.upk`。
|
||||
南向链路为“协议板 App ↔ 目标功率板 Boot”。功率板Boot按UPK规则接收完整 `.upk` 文件;协议板不修改UPK内容,只负责锁定物理通道、连续发送完整YMODEM帧、采集功率板的单字节应答,并将应答按原顺序交给北向状态机。
|
||||
|
||||
南向升级期间停止普通 Modbus 轮询、LCD 插入命令、控制台命令和其他通道请求。升级数据不得经过普通 Modbus解析器。
|
||||
|
||||
协议板只校验 YMODEM 帧长度、包号反码和 CRC16;当前 Boot 的 APP 可写范围是 `0x08003800 + 0xB000`(44 KB),裸 APP 镜像长度必须受此范围限制。
|
||||
功率板UPK采用与协议板Boot相同的“1024字节首块”结构:前96字节为UPK逻辑头,后928字节固定为 `0x00`,package body从文件偏移 `0x400` 开始。协议板只校验YMODEM帧长度、包号反码和CRC16;UPK头、大小、加密和CRC由功率板Boot解析。
|
||||
|
||||
## 2. 串口和控制帧
|
||||
|
||||
@@ -40,6 +40,8 @@
|
||||
| --- | --- | --- |
|
||||
| 进入升级控制帧 | `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` | 这是正常握手,原样交北向 |
|
||||
@@ -74,9 +76,17 @@ S_META_WAIT
|
||||
NAK -> 转交北向 -> S_WAIT_META
|
||||
|
||||
S_WAIT_DATA
|
||||
收到SOH/STX -> S_DATA_TX
|
||||
收到包号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
|
||||
|
||||
@@ -175,26 +185,65 @@ YMODEM 数据帧的重试由北向 PC 负责。南向代理不得在收到 NAK
|
||||
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 跳转。
|
||||
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. 南向验证顺序
|
||||
## 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. 使用一个元数据包和一个 STX 包验证停止等待。
|
||||
5. 验证标准两次 EOT和结束空 SOH。
|
||||
6. 验证 CRC 错误时 NAK 能原样传到 PC,并由 PC 重发。
|
||||
7. 验证 ACK 丢失、半帧、超时、CAN、断电和超出功率板 UPK 分区容量的文件。
|
||||
8. 跳转后读取功率板新版本,确认升级真正成功。
|
||||
9. 连续发送 `ACK+C`、EOT、结束空 SOH 和跳转控制帧,确认 Boot 未丢字节、重复启动 DMA 或将控制帧拼入 YMODEM 帧。
|
||||
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帧。
|
||||
|
||||
## 10. 南向实施清单
|
||||
## 11. 南向实施清单
|
||||
|
||||
1. 删除南向收到 NAK或超时后的内部 YMODEM重发。
|
||||
2. 增加独立的 EOT1、EOT2和结束空包状态。
|
||||
@@ -203,5 +252,6 @@ YMODEM 数据帧的重试由北向 PC 负责。南向代理不得在收到 NAK
|
||||
5. 进入和退出控制帧禁止盲目重试。
|
||||
6. 升级期间锁定通道并完全停止普通轮询。
|
||||
7. 完成后恢复轮询并提供版本确认结果。
|
||||
8. 先修复 Boot:进入控制帧后清接收缓存、跳转前回 ACK、UART 单一 DMA 接收重启路径。
|
||||
9. 未实现 Boot 端 UPK 解包和最终完整性校验前,升级文件限定为裸 APP 镜像。
|
||||
8. 修复Boot:进入控制帧后清接收缓存、跳转前回ACK、UART使用单一DMA接收重启路径。
|
||||
9. 修改功率板Boot:包号1解析UPK头但不写APP,包号2起安装package body。
|
||||
10. 增加UPK长度、头CRC、package CRC、raw CRC、解密和向量表校验。
|
||||
|
||||
Reference in New Issue
Block a user