Files
chrg/docs/功率板升级_北向转发计划.md
T
wrh 7eb30c1ab2 feat: 更新南向升级协议,修改升级流程逻辑
改为南向主动发送C,不再向南向发送进入和退出

1 升级进入/退出命令不再向南向发送控制帧,本地会话建立后立即响应成功
2 功率板Boot主动每500ms发送'C',协议板收到后转发给上位机
3 更新协议板版本寄存器为0x0143,版本号升级至V1.1.51
4 调整升级状态机,删除等待南向ACK的相关逻辑
5 更新相关文档,同步升级协议和状态机的修改内容
2026-09-29 16:54:28 +08:00

224 lines
8.0 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北向入口和现有南向发送线程。当前实现包括:
- 指定通道进入/退出升级命令完成本地状态切换后立即成功响应。
- SOH/STX分段拼帧、包号反码和CRC-16/XMODEM校验。
- `.upk` 元数据、连续数据包号、包号1固定STX和结束空SOH校验。
- 两次EOT独立状态,ACK/NAK/C/CAN均来自南向功率板。
- NAK原样转发给PC,协议板不再自动重发数据帧或EOT。
- 半帧1秒超时、南向应答10秒超时和会话15秒空闲取消。
- 退出命令恢复普通轮询,并强制目标通道重新读取版本。
## 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. 清理历史南向回码,等待功率板 Boot 每500ms主动发送 `C`。
成功响应:
```text
协议板地址 + 0x20 + 0x00 + 0x00 + 功率板通道号 + 0xFF + CRC_L + CRC_H
```
广播地址 `0x00` 不回复。失败使用现有 Modbus 异常响应,不得进入原始 YMODEM 模式。
### 2.2 退出升级
PC发送同格式的8字节命令,Byte 5为 `0x00`。协议板立即结束本地升级会话、恢复普通轮询并原样回显退出命令,不向南向发送控制帧,也不等待南向回码。
结束空 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/进入命令
-> 回复 0x20 成功
-> N_WAIT_C
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_VERIFY
N_VERIFY
PC通过恢复后的正常协议读取功率板版本
版本正确 -> 升级确认成功 -> N_IDLE
版本不符/无响应 -> 升级确认失败 -> N_IDLE
```
## 5. 北向完整时序
```text
PC -> 协议板 : 0x20进入命令
协议板 -> PC : 0x20成功响应
功率板 -> 协议板 : C(Boot每500ms主动发送)
协议板 -> 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退出命令
协议板 -> 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` 文件。