docs: 更新修改日志并新增北向功率板升级计划文档
chore: 升级所有相关文件版本号至V1.1.39 feat: 实现北向事务隔离逻辑,新增通道切换清理和事务号匹配机制 feat: 新增北向请求开始函数,处理通道切换后的接收清理和事务号生成 perf: 调整北向回码等待超时时间,量测回码等待80ms,配置回码等待150ms refactor: 修改北向回码匹配函数,增加通道和事务号校验
This commit is contained in:
@@ -0,0 +1,213 @@
|
||||
# 功率板升级:北向转发计划
|
||||
|
||||
## 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 端解包和完整性校验。
|
||||
Reference in New Issue
Block a user