# 功率板升级:北向转发计划 ## 实施状态 已在 `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` 文件。