Files
chrg/docs/功率板升级_北向转发计划.md
T
wrh 6d694c3aca docs: 更新修改日志并新增北向功率板升级计划文档
chore: 升级所有相关文件版本号至V1.1.39

feat: 实现北向事务隔离逻辑,新增通道切换清理和事务号匹配机制

feat: 新增北向请求开始函数,处理通道切换后的接收清理和事务号生成

perf: 调整北向回码等待超时时间,量测回码等待80ms,配置回码等待150ms

refactor: 修改北向回码匹配函数,增加通道和事务号校验
2026-09-24 17:03:15 +08:00

214 lines
7.3 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. 范围与原则
北向链路为“PC 上位机 ↔ 协议板 App”。协议板通过功能码 `0x20` 进入指定功率板的升级代理模式,之后北向链路切换为原始 YMODEM 字节流。
当前功率板 Boot 仅将 YMODEM 数据区直接写入 `APP_FLASH_BASE_ADDR`,本阶段升级文件必须是可直接启动的裸 APP 镜像。若交付物带 `.upk` 头、分区或校验字段,必须先实现 Boot 解包和最终完整性校验,未完成前不得透传该 `.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 开始。首个 STX 携带 `.upk` 文件偏移 `0~1023` 的原始字节,后续帧按文件偏移连续发送;协议板不解释 UPK 内部字段。最后一帧不足固定数据区时用 `0x1A` 补齐,但补齐字节不计入元数据中的 `.upk` 文件长度。
## 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。
- 南向 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. 联调前确认升级文件为裸 APP 镜像;若使用 UPK,先完成 Boot 端解包和完整性校验。