chore: 升级所有相关文件版本号至V1.1.39 feat: 实现北向事务隔离逻辑,新增通道切换清理和事务号匹配机制 feat: 新增北向请求开始函数,处理通道切换后的接收清理和事务号生成 perf: 调整北向回码等待超时时间,量测回码等待80ms,配置回码等待150ms refactor: 修改北向回码匹配函数,增加通道和事务号校验
8.1 KiB
功率板升级:南向发送与应答计划
1. 范围与原则
南向链路为“协议板 App ↔ 目标功率板 Boot”。当前功率板 Boot 仅将 YMODEM 数据区直接写入 APP_FLASH_BASE_ADDR,因此本阶段只允许传输裸 APP 镜像。协议板不修改镜像内容,只负责锁定物理通道、连续发送完整 YMODEM 帧、采集功率板的单字节应答,并将应答按原顺序交给北向状态机。UPK 解包、分区、版本、加密和最终 CRC 校验属于后续 Boot 能力,未实现前不得向本 Boot 透传 .upk。
南向升级期间停止普通 Modbus 轮询、LCD 插入命令、控制台命令和其他通道请求。升级数据不得经过普通 Modbus解析器。
协议板只校验 YMODEM 帧长度、包号反码和 CRC16;当前 Boot 的 APP 可写范围是 0x08003800 + 0xB000(44 KB),裸 APP 镜像长度必须受此范围限制。
2. 串口和控制帧
南向串口参数:115200 bps、8N1、无流控。每次发送前必须确认目标通道已选通,并正确控制 RS485 收发方向。
进入功率板 Boot:
03 06 00 0F 00 FF F8 6B
功率板正常应答:
06 43
其中 06 表示进入命令执行成功,43 表示 Boot 已准备接收 CRC 模式 YMODEM。
跳转功率板 App:
03 06 00 0F 00 0F F8 2F
正常应答为 06;15 表示失败。Boot 必须在 UART 完整发送 06 后才关闭 DMA/中断并跳转 App,避免协议板因未收到应答而超时。
3. 南向帧和应答映射
| 协议板发送 | 功率板 Boot 正常回复 | 协议板处理 |
|---|---|---|
| 进入升级控制帧 | ACK + C |
ACK确认进入,C进入应答队列,按顺序交北向 |
| 元数据 SOH/包0 | ACK + C |
两字节均按顺序交北向 |
| 普通 SOH/STX | ACK |
交北向,允许下一帧 |
| 校验错误的数据帧 | NAK |
原样交北向,不在南向自动重发 |
| 第一次 EOT | NAK |
这是正常握手,原样交北向 |
| 第二次 EOT | ACK + C |
两字节均按顺序交北向 |
| 结束空 SOH/包0 | ACK |
交北向,标记传输完成 |
| CAN | ACK或无回复 |
停止会话并清理缓存 |
| 跳转 App 控制帧 | ACK |
退出升级模式并恢复轮询 |
4. 南向状态机
S_IDLE
北向进入请求 -> 锁通道、停轮询 -> S_ENTER_TX
S_ENTER_TX
UART发送完成 -> S_ENTER_WAIT
S_ENTER_WAIT
ACK -> 记录进入成功
C -> 记录Boot就绪 -> S_WAIT_META
NAK/超时 -> S_ABORT
S_WAIT_META
收到北向完整元数据帧 -> S_META_TX
S_META_TX
UART发送完成 -> S_META_WAIT
S_META_WAIT
ACK -> 转交北向
C -> 转交北向 -> S_WAIT_DATA
NAK -> 转交北向 -> S_WAIT_META
S_WAIT_DATA
收到SOH/STX -> S_DATA_TX
收到EOT -> S_EOT1_TX
S_DATA_TX
UART发送完成 -> S_DATA_WAIT
S_DATA_WAIT
ACK -> 转交北向 -> S_WAIT_DATA
NAK -> 转交北向 -> S_WAIT_DATA
CAN -> 转交北向 -> S_ABORT
S_EOT1_TX
UART发送完成 -> S_EOT1_WAIT
S_EOT1_WAIT
NAK -> 转交北向 -> S_WAIT_EOT2
S_WAIT_EOT2
收到第二次EOT -> S_EOT2_TX
S_EOT2_TX
UART发送完成 -> S_EOT2_WAIT
S_EOT2_WAIT
ACK -> 转交北向
C -> 转交北向 -> S_WAIT_END_SOH
S_WAIT_END_SOH
收到结束空SOH -> S_END_TX
S_END_TX
UART发送完成 -> S_END_WAIT
S_END_WAIT
ACK -> 转交北向 -> S_TRANSFER_DONE
S_TRANSFER_DONE
收到退出请求 -> S_JUMP_TX
S_JUMP_TX
UART发送完成 -> S_JUMP_WAIT
S_JUMP_WAIT
ACK -> 确认已转交北向 -> 恢复轮询 -> S_IDLE
NAK/超时 -> S_ABORT
S_ABORT
清理应答队列和半帧,解除通道锁,恢复轮询 -> S_IDLE
5. 发送完成与计时起点
chrg_send_sou_upadata_data() 返回成功只能表示帧已提交到发送线程,不能表示 UART 已发送完成。
南向必须区分:
- 提交成功;
- 通道切换成功;
- UART 开始发送;
- UART 发送完成;
- 功率板返回应答。
所有应答超时必须从 UART 发送完成时开始计算,不能从放入缓存时开始。建议:
| 阶段 | 超时 |
|---|---|
| 进入升级并擦除 Flash | 15 秒 |
| 元数据应答 | 10 秒 |
| 普通数据帧应答 | 10 秒 |
| EOT/结束空包应答 | 10 秒 |
| 跳转 App 应答 | 5 秒 |
6. 南向应答队列
功率板应答是单字节流,必须使用有序队列保存 ACK/NAK/C/CAN,不能使用单个覆盖变量。
ACK + C必须保留两个字节和原顺序。- 队列满时可优先丢弃等待阶段重复出现的周期
C,不能丢弃 ACK、NAK 或 CAN。 - 切换通道、进入会话、退出会话前必须清空旧应答。
- 等待当前帧 ACK 时收到周期
C,可以暂存或忽略,但不能将其误判为当前帧成功。 - 普通 Modbus 调试文本或其他字节不得进入 YMODEM 应答队列。
7. 重试和异常策略
YMODEM 数据帧的重试由北向 PC 负责。南向代理不得在收到 NAK 或应答超时后自行重发上一帧,否则会破坏第一次 EOT 的正常 NAK 时序,并可能在 ACK 丢失时重复写入。
控制帧也不能无条件重发:进入命令的 ACK 丢失但功率板已经进入 Boot 时,再发送 Modbus 控制帧会被当成 YMODEM 垃圾数据。处理方式:
- 只有收到 ACK 才确认进入升级成功;随后收到 C 才确认功率板 Boot 已准备接收元数据。若只收到 C,应记录异常并终止本次会话,不能向北向伪造进入成功响应。
- ACK 或 C 缺失时终止本次会话,要求重新复位/重新进入,不盲目重发控制帧。
- 南向 NAK、CAN 或应答超时应明确上报北向;不得伪造 ACK。
- 发送失败、通道切换失败或队列溢出时立即中止会话。
- 北向取消或会话异常终止时,尽可能向功率板连续发送两个 CAN,再清理状态并恢复普通轮询。
8. 与功率板 Boot 的接口要求
功率板 Boot 必须满足:
- 控制帧可以跨多次 DMA/空闲中断接收并累计到完整 8 字节后匹配。
- 进入升级时擦除成功回复
ACK + C,失败回复 NAK。 - 支持标准 YMODEM 包号、反码和 CRC16 校验。
- 第一次 EOT 回复 NAK,第二次 EOT 回复
ACK + C,结束空 SOH 回复 ACK。 - 明确 App 起始地址、最大 UPK/package body 长度和 Flash 擦除范围;当前记录的
0x08003800 + 0xB000为 44 KB,必须与链接脚本和功率板 UPK 分区规则一致。 - 跳转 App 前关闭中断、DMA、SysTick和相关外设,设置 MSP 与 VTOR。
- 处理进入控制帧后,先清除控制帧接收缓存和长度计数,再启动 YMODEM 接收;不得将控制帧的 8 字节与元数据 SOH 拼接。
- UART 接收只保留一条 DMA-to-idle 重启路径;禁止 UART IRQ 与接收回调同时中止或重复启动 DMA。
- 跳转控制帧匹配成功后,先发送 ACK 并等待发送完成,再执行 App 跳转。
9. 南向验证顺序
- 逻辑分析仪确认进入帧完整发送,波特率和通道正确。
- 确认功率板完整接收 8 字节并完成 Flash 擦除。
- 确认线路依次出现
06 43,协议板应答队列也依次取到06 43。 - 使用一个元数据包和一个 STX 包验证停止等待。
- 验证标准两次 EOT和结束空 SOH。
- 验证 CRC 错误时 NAK 能原样传到 PC,并由 PC 重发。
- 验证 ACK 丢失、半帧、超时、CAN、断电和超出功率板 UPK 分区容量的文件。
- 跳转后读取功率板新版本,确认升级真正成功。
- 连续发送
ACK+C、EOT、结束空 SOH 和跳转控制帧,确认 Boot 未丢字节、重复启动 DMA 或将控制帧拼入 YMODEM 帧。
10. 南向实施清单
- 删除南向收到 NAK或超时后的内部 YMODEM重发。
- 增加独立的 EOT1、EOT2和结束空包状态。
- 以 UART发送完成事件启动应答计时。
- 保证 ACK、C 等应答有序排队和转交。
- 进入和退出控制帧禁止盲目重试。
- 升级期间锁定通道并完全停止普通轮询。
- 完成后恢复轮询并提供版本确认结果。
- 先修复 Boot:进入控制帧后清接收缓存、跳转前回 ACK、UART 单一 DMA 接收重启路径。
- 未实现 Boot 端 UPK 解包和最终完整性校验前,升级文件限定为裸 APP 镜像。