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

8.1 KiB
Raw Blame History

功率板升级:南向发送与应答计划

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 已发送完成。

南向必须区分:

  1. 提交成功;
  2. 通道切换成功;
  3. UART 开始发送;
  4. UART 发送完成;
  5. 功率板返回应答。

所有应答超时必须从 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 必须满足:

  1. 控制帧可以跨多次 DMA/空闲中断接收并累计到完整 8 字节后匹配。
  2. 进入升级时擦除成功回复 ACK + C,失败回复 NAK。
  3. 支持标准 YMODEM 包号、反码和 CRC16 校验。
  4. 第一次 EOT 回复 NAK,第二次 EOT 回复 ACK + C,结束空 SOH 回复 ACK。
  5. 明确 App 起始地址、最大 UPK/package body 长度和 Flash 擦除范围;当前记录的 0x08003800 + 0xB000 为 44 KB,必须与链接脚本和功率板 UPK 分区规则一致。
  6. 跳转 App 前关闭中断、DMA、SysTick和相关外设,设置 MSP 与 VTOR。
  7. 处理进入控制帧后,先清除控制帧接收缓存和长度计数,再启动 YMODEM 接收;不得将控制帧的 8 字节与元数据 SOH 拼接。
  8. UART 接收只保留一条 DMA-to-idle 重启路径;禁止 UART IRQ 与接收回调同时中止或重复启动 DMA。
  9. 跳转控制帧匹配成功后,先发送 ACK 并等待发送完成,再执行 App 跳转。

9. 南向验证顺序

  1. 逻辑分析仪确认进入帧完整发送,波特率和通道正确。
  2. 确认功率板完整接收 8 字节并完成 Flash 擦除。
  3. 确认线路依次出现 06 43,协议板应答队列也依次取到 06 43。
  4. 使用一个元数据包和一个 STX 包验证停止等待。
  5. 验证标准两次 EOT和结束空 SOH。
  6. 验证 CRC 错误时 NAK 能原样传到 PC,并由 PC 重发。
  7. 验证 ACK 丢失、半帧、超时、CAN、断电和超出功率板 UPK 分区容量的文件。
  8. 跳转后读取功率板新版本,确认升级真正成功。
  9. 连续发送 ACK+C、EOT、结束空 SOH 和跳转控制帧,确认 Boot 未丢字节、重复启动 DMA 或将控制帧拼入 YMODEM 帧。

10. 南向实施清单

  1. 删除南向收到 NAK或超时后的内部 YMODEM重发。
  2. 增加独立的 EOT1、EOT2和结束空包状态。
  3. 以 UART发送完成事件启动应答计时。
  4. 保证 ACK、C 等应答有序排队和转交。
  5. 进入和退出控制帧禁止盲目重试。
  6. 升级期间锁定通道并完全停止普通轮询。
  7. 完成后恢复轮询并提供版本确认结果。
  8. 先修复 Boot:进入控制帧后清接收缓存、跳转前回 ACK、UART 单一 DMA 接收重启路径。
  9. 未实现 Boot 端 UPK 解包和最终完整性校验前,升级文件限定为裸 APP 镜像。