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

238 lines
8.4 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.
# 功率板升级:北向转发计划
## 实施状态
已在 `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解析完整 `.upk` 文件:跳过YMODEM元数据,解析UPK头区,再将package body安装到 `APP_FLASH_BASE_ADDR`。协议板只透传UPK的YMODEM帧,不解析或重打包UPK。
升级期间采用以下原则:
1. PC 是 YMODEM 主机,负责包号推进、NAK 重发和完整时序。
2. 协议板只拼帧、校验并转发,不在内部自动重发 YMODEM 数据帧。
3. 协议板给 PC 的 ACK、NAK、`C`、CAN 必须来自南向功率板 Boot,不允许提前伪造成功应答。
4. 同一时刻只允许一个北向连接升级一个功率板通道。
## 2. 北向进入和退出命令
### 2.1 进入升级
PC 发送 8 字节 Modbus RTU 扩展命令:
```text
Byte 0 协议板地址
Byte 1 0x20
Byte 2 保留,固定 0x00
Byte 3 保留,固定 0x00
Byte 4 功率板通道号,范围 0..TOTAL_SOU_CHS-1
Byte 5 0xFF,进入升级
Byte 6 CRC_L
Byte 7 CRC_H
```
协议板必须完成以下操作后才能回复成功:
1. 校验地址、长度、通道和 Modbus CRC。
2. 锁定目标通道并停止普通南向轮询。
3. 南向发送进入升级控制帧。
4. 收到功率板 Boot 的 ACK;若同时收到 `C`,必须保留并在北向响应完成后转发。
成功响应:
```text
协议板地址 + 0x06 + CRC_L + CRC_H
```
广播地址 `0x00` 不回复。失败使用现有 Modbus 异常响应,不得进入原始 YMODEM 模式。
### 2.2 退出升级/跳转 App
在升级模式中,PC 发送同格式的 8 字节命令,Byte 5 为 `0x00`。协议板南向发送跳转 App 控制帧;功率板 Boot 必须先发送 `ACK` 并确认 UART 发送完成,再执行跳转。协议板收到该 ACK 后退出升级模式并恢复普通轮询。
结束空 SOH 获得 ACK 只表示 YMODEM 传输结束;PC 仍须发送退出命令,并在恢复通信后读取功率板版本确认升级结果。
## 3. 北向 YMODEM 包格式
进入升级成功后,北向不再使用 Modbus 封装,直接传输 YMODEM 字节流。
| 类型 | 完整长度 | 格式 |
| --- | ---: | --- |
| 元数据 SOH | 133 | `01 + pkt + ~pkt + 128B Data + CRC16_H + CRC16_L` |
| 数据 STX | 1029 | `02 + pkt + ~pkt + 1024B Data + CRC16_H + CRC16_L` |
| 可选数据 SOH | 133 | `01 + pkt + ~pkt + 128B Data + CRC16_H + CRC16_L` |
| EOT | 1 | `04` |
| CAN | 1 或 2 | `18`,取消时建议连续两个 |
CRC 使用 CRC-16/XMODEM:`poly=0x1021`、`init=0x0000`、不反射、`xorout=0x0000`。
元数据包固定为包号 0,文件名和长度对应完整功率板 `.upk` 文件:
```text
文件名 + 0x00 + `.upk` 实际十进制长度 + 0x00 + 其余补 0x00
```
数据从包号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. 北向状态机
```text
N_IDLE
收到合法 0x20/进入命令
-> N_ENTERING
N_ENTERING
南向确认进入 Boot
-> 回复 0x20 成功
-> N_WAIT_C
失败/超时
-> 回复异常
-> N_IDLE
N_WAIT_C
收到南向 C -> 原样转发 -> N_WAIT_META
N_WAIT_META
收到完整且本地校验正确的 SOH/包0
-> 原样提交南向
-> N_WAIT_META_RESP
N_WAIT_META_RESP
南向 ACK -> 转发 ACK
南向 C -> 转发 C -> N_WAIT_DATA
南向 NAK -> 转发 NAK -> N_WAIT_META
N_WAIT_DATA
收到完整 SOH/STX 数据帧
-> 原样提交南向
-> N_WAIT_DATA_RESP
收到 EOT
-> 原样提交南向
-> N_WAIT_EOT1_RESP
收到 CAN
-> 原样转发南向
-> N_ABORT
N_WAIT_DATA_RESP
南向 ACK -> 转发 ACK -> N_WAIT_DATA
南向 NAK -> 转发 NAK -> N_WAIT_DATA
南向 CAN -> 转发 CAN CAN -> N_ABORT
N_WAIT_EOT1_RESP
南向 NAK -> 原样转发 -> N_WAIT_EOT2
N_WAIT_EOT2
收到第二个 EOT -> 原样提交南向 -> N_WAIT_EOT2_RESP
N_WAIT_EOT2_RESP
南向 ACK -> 转发 ACK
南向 C -> 转发 C -> N_WAIT_END_SOH
N_WAIT_END_SOH
收到包号0、128字节全0的 SOH
-> 原样提交南向
-> N_WAIT_END_ACK
N_WAIT_END_ACK
南向 ACK -> 转发 ACK -> N_TRANSFER_DONE
N_TRANSFER_DONE
收到合法 0x20/退出命令 -> N_EXITING
N_EXITING
南向跳转确认 -> 回复命令成功 -> 恢复轮询 -> N_VERIFY
N_VERIFY
PC通过恢复后的正常协议读取功率板版本
版本正确 -> 升级确认成功 -> N_IDLE
版本不符/无响应 -> 升级确认失败 -> N_IDLE
```
## 5. 北向完整时序
```text
PC -> 协议板 : 0x20进入命令
协议板 -> 功率板 : 进入升级控制帧
功率板 -> 协议板 : ACK, C
协议板 -> PC : 0x20成功响应
协议板 -> PC : C
PC -> 协议板 : SOH包0元数据
协议板 -> 功率板 : 原样SOH
功率板 -> 协议板 : ACK, C
协议板 -> PC : ACK, C
PC -> 协议板 : STX包1
协议板 -> 功率板 : 原样STX包1
功率板 -> 协议板 : ACK
协议板 -> PC : ACK
...逐包停止等待...
PC -> 协议板 : EOT
协议板 -> 功率板 : EOT
功率板 -> 协议板 : NAK
协议板 -> PC : NAK
PC -> 协议板 : EOT
协议板 -> 功率板 : EOT
功率板 -> 协议板 : ACK, C
协议板 -> PC : ACK, C
PC -> 协议板 : SOH包0,Data全0
协议板 -> 功率板 : 原样SOH
功率板 -> 协议板 : ACK
协议板 -> PC : ACK
PC -> 协议板 : 0x20退出命令
协议板 -> 功率板 : 跳转App控制帧
功率板 -> 协议板 : ACK(发送完成后才跳转App)
协议板 -> PC : 0x20成功响应
协议板 : 恢复轮询并刷新功率板版本
PC -> 协议板 : 通过正常协议查询功率板版本并确认升级结果
```
## 6. 北向校验和异常处理
- 北向可分多次收到一帧,必须按帧头确定 133/1029/1 字节并累计完整后再转发。
- 同一帧内部超时建议 1000 ms;超时后清空半帧并向 PC 发送 NAK。
- 等待南向应答时禁止接受下一数据帧,严格执行停止等待。
- 任意传输阶段收到 PC 的 CAN 时,应转发南向、终止会话并恢复普通轮询。
- 本地包号反码或 CRC 错误:不转发南向,直接向 PC 发送 NAK。
- 包号1必须是完整1024字节UPK头区;北向只做YMODEM校验,UPK头和包体校验由功率板Boot完成。
- 南向 NAK:原样转发 PC,由 PC 重发;协议板不得自行重发。
- 南向应答超时:尽可能向功率板和 PC 各发送 CAN CAN,结束会话;不得盲目重发已可能写入的帧。
- 北向 ACK 等待建议由 PC 设置为 10 秒;进入升级擦除等待建议 15 秒。
- 升级会话空闲超过 15 秒,发送 CAN CAN、清理缓存、恢复普通轮询。
## 7. 北向实施清单
1. 删除数据帧和 EOT 的协议板内部自动重发,改为原样转发 NAK。
2. 为两次 EOT 建立独立状态,禁止把第一次 EOT 的 NAK当成普通失败。
3. 校验元数据包号、连续数据包号和结束空包内容。
4. 只有收到南向真实应答后才回复 PC。
5. 结束后执行退出命令和版本读取,区分“传输完成”与“升级确认成功”。
6. 日志至少记录通道、状态、帧类型、包号、长度、南向应答和失败原因。
7. 联调前先完成功率板Boot的UPK解析、安装和完整性校验;北向只允许发送符合功率板UPK规则的完整 `.upk` 文件。