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:
wrh
2026-09-28 20:51:04 +08:00
parent c34c537bfd
commit 9254c82547
13 changed files with 296 additions and 910 deletions
+27 -3
View File
@@ -1,10 +1,22 @@
# 功率板升级:北向转发计划
## 实施状态
已在 `chrg_ymodem_proxy.c/.h` 实现独立的非阻塞转发状态机,并接入COM北向入口和现有南向发送线程。当前实现包括:
- 指定通道进入/退出升级,以功率板真实ACK决定成功响应。
- SOH/STX分段拼帧、包号反码和CRC-16/XMODEM校验。
- `.upk` 元数据、连续数据包号、包号1固定STX和结束空SOH校验。
- 两次EOT独立状态,ACK/NAK/C/CAN均来自南向功率板。
- NAK原样转发给PC,协议板不再自动重发数据帧或EOT。
- 半帧1秒超时、南向应答10秒超时和会话15秒空闲取消。
- 跳转App确认后恢复普通轮询,并强制目标通道重新读取版本。
## 1. 范围与原则
北向链路为“PC 上位机 ↔ 协议板 App”。协议板通过功能码 `0x20` 进入指定功率板的升级代理模式,之后北向链路切换为原始 YMODEM 字节流。
当前功率板 Boot 仅将 YMODEM 数据区直接写入 `APP_FLASH_BASE_ADDR`,本阶段升级文件必须是可直接启动的裸 APP 镜像。若交付物带 `.upk` 头、分区或校验字段,必须先实现 Boot 解包和最终完整性校验,未完成前不得透传该 `.upk`。
目标方案要求功率板Boot解析完整 `.upk` 文件:跳过YMODEM元数据,解析UPK头区,再将package body安装到 `APP_FLASH_BASE_ADDR`。协议板只透传UPK的YMODEM帧,不解析或重打包UPK。
升级期间采用以下原则:
@@ -71,7 +83,18 @@ CRC 使用 CRC-16/XMODEM:`poly=0x1021`、`init=0x0000`、不反射、`xorout=0
文件名 + 0x00 + `.upk` 实际十进制长度 + 0x00 + 其余补 0x00
```
数据从包号 1 开始。首个 STX 携带 `.upk` 文件偏移 `0~1023` 的原始字节,后续帧按文件偏移连续发送;协议板不解释 UPK 内部字段。最后一帧不足固定数据区时用 `0x1A` 补齐,但补齐字节不计入元数据中的 `.upk` 文件长度。
数据从包号1开始,功率板UPK固定采用以下布局:
```text
包号0:YMODEM元数据,功率板Boot读取文件名/文件长度,不写Flash
包号1:UPK文件偏移0~1023
前96字节为UPK逻辑头,后928字节为0x00填充
功率板Boot解析并校验UPK头,不写APP区
包号2起:UPK package body
功率板Boot从APP首地址0x08003800开始安装
```
协议板只按文件偏移原样转发,不解释或修改UPK内容。最后一帧不足1024字节时用 `0x1A` 补齐,但补齐字节不计入元数据文件长度、`pkg_size`或CRC。
## 4. 北向状态机
@@ -197,6 +220,7 @@ PC -> 协议板 : 通过正常协议查询功率板版本并确认升级结果
- 等待南向应答时禁止接受下一数据帧,严格执行停止等待。
- 任意传输阶段收到 PC 的 CAN 时,应转发南向、终止会话并恢复普通轮询。
- 本地包号反码或 CRC 错误:不转发南向,直接向 PC 发送 NAK。
- 包号1必须是完整1024字节UPK头区;北向只做YMODEM校验,UPK头和包体校验由功率板Boot完成。
- 南向 NAK:原样转发 PC,由 PC 重发;协议板不得自行重发。
- 南向应答超时:尽可能向功率板和 PC 各发送 CAN CAN,结束会话;不得盲目重发已可能写入的帧。
- 北向 ACK 等待建议由 PC 设置为 10 秒;进入升级擦除等待建议 15 秒。
@@ -210,4 +234,4 @@ PC -> 协议板 : 通过正常协议查询功率板版本并确认升级结果
4. 只有收到南向真实应答后才回复 PC。
5. 结束后执行退出命令和版本读取,区分“传输完成”与“升级确认成功”。
6. 日志至少记录通道、状态、帧类型、包号、长度、南向应答和失败原因。
7. 联调前确认升级文件为裸 APP 镜像;若使用 UPK,先完成 Boot 端解包和完整性校验。
7. 联调前先完成功率板Boot的UPK解析、安装和完整性校验;北向只允许发送符合功率板UPK规则的完整 `.upk` 文件。