- 删除chrg_comm.h和chrg_def.h中的旧YMODEM状态枚举及注释代码 - 删除chrg_comm.c中已废弃的旧YMODEM重发和会话管理代码 - 更新协议板版本寄存器编码为十进制143 - 新增chrg_ymodem_proxy模块的详细中文注释,明确升级代理职责 - 更新changelog记录V1.1.43版本变更 - 删除无用的Allegro日志文件,优化PCB设计相关文档 本次提交将YMODEM升级功能重构为独立代理模块,不再依赖旧版自动重发逻辑,提升升级流程的可维护性和可靠性。
10 KiB
功率板升级:南向发送与应答计划
1. 范围与原则
南向链路为“协议板 App ↔ 目标功率板 Boot”。功率板Boot按UPK规则接收完整 .upk 文件;协议板不修改UPK内容,只负责锁定物理通道、连续发送完整YMODEM帧、采集功率板的单字节应答,并将应答按原顺序交给北向状态机。
南向升级期间停止普通 Modbus 轮询、LCD 插入命令、控制台命令和其他通道请求。升级数据不得经过普通 Modbus解析器。
功率板UPK采用与协议板Boot相同的“1024字节首块”结构:前96字节为UPK逻辑头,后928字节固定为 0x00,package body从文件偏移 0x400 开始。协议板只校验YMODEM帧长度、包号反码和CRC16;UPK头、大小、加密和CRC由功率板Boot解析。
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 |
两字节均按顺序交北向 |
| UPK头区 STX/包1 | ACK或NAK |
Boot解析96字节头并检查928字节填充,不写APP区 |
| UPK包体 STX/包2起 | ACK或NAK |
从APP首地址开始安装,仅接收pkg_size范围内的数据 |
| 普通 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
收到包号1的STX -> S_UPK_HEAD_TX
收到包号2起的SOH/STX -> S_DATA_TX
收到EOT -> S_EOT1_TX
S_UPK_HEAD_TX
UART发送完成 -> S_UPK_HEAD_WAIT
S_UPK_HEAD_WAIT
功率板解析UPK头成功并回复ACK -> 转交北向 -> S_WAIT_DATA
功率板回复NAK/CAN -> 转交北向 -> S_ABORT
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 校验。
- 包号0只解析YMODEM文件名和文件长度,不写Flash。
- 包号1必须为STX/1024:解析前96字节UPK头,校验标识、头CRC、目标分区、
raw_size、pkg_size和加密配置;检查后928字节均为0x00;整包不写APP区。 - 包号2起才处理package body,并从
0x08003800开始安装;不得把UPK头区写入APP。 - 只处理UPK头声明的
pkg_size字节,忽略最后YMODEM帧的0x1A补齐;不得按整帧把补齐数据计入固件长度。 - 完成接收后校验package CRC;若启用加密,按UPK配置解密后写APP并校验raw CRC;未加密时直接写APP并校验raw CRC。
- APP首地址必须是裸固件向量表,写入完成后校验MSP和Reset_Handler范围;任何UPK校验失败都不得跳转APP。
- 第一次EOT回复NAK,第二次EOT仅在UPK接收和校验成功后回复
ACK + C,结束空SOH回复ACK。 - 明确APP起始地址、最大
raw_size/pkg_size和Flash擦除范围;当前APP区为0x08003800~0x0800E7FF,大小0xB000(44KB),必须与App链接脚本一致。 - 跳转App前关闭中断、DMA、SysTick和相关外设,设置MSP与VTOR。
- 处理进入控制帧后,先清除控制帧接收缓存和长度计数,再启动YMODEM接收;不得将控制帧的8字节与元数据SOH拼接。
- UART接收只保留一条DMA-to-idle重启路径;禁止UART IRQ与接收回调同时中止或重复启动DMA。
- 跳转控制帧匹配成功后,先发送ACK并等待发送完成,再执行App跳转。
9. 功率板Boot的UPK安装流程
收到YMODEM包号0
-> 解析文件名和.upk实际长度
-> ACK + C
收到YMODEM包号1(STX/1024)
-> 解析前96字节UPK逻辑头
-> 校验head_crc、大小、分区、加密配置和928字节零填充
-> 初始化package CRC/解密状态
-> 不写APP区
-> ACK
收到YMODEM包号2起
-> 按pkg_size截取有效package body
-> 更新pkg_crc
-> 未加密:从0x08003800顺序写入
-> 已加密:按UPK配置解密后从0x08003800顺序写入
-> 超出pkg_size的0x1A填充不写入
-> 每帧成功后ACK
收到两次EOT
-> 校验累计pkg_size和pkg_crc
-> 校验写入APP的raw_size和raw_crc
-> 校验APP向量表
-> 全部成功后完成标准EOT和结束空SOH握手
-> 任一失败回复CAN或明确失败并禁止跳转
10. 南向验证顺序
- 逻辑分析仪确认进入帧完整发送,波特率和通道正确。
- 确认功率板完整接收 8 字节并完成 Flash 擦除。
- 确认线路依次出现
06 43,协议板应答队列也依次取到06 43。 - 确认包号0不写Flash,包号1只解析UPK头且不写APP。
- 确认包号2的数据区首字节写入
0x08003800,该地址内容为APP向量表。 - 验证最后一帧的
0x1A补齐不计入大小和CRC。 - 验证头CRC、package CRC、raw CRC、加密和超长UPK异常路径。
- 验证标准两次EOT和结束空SOH。
- 验证CRC错误时NAK能原样传到PC,并由PC重发。
- 验证ACK丢失、半帧、超时、CAN和断电。
- 跳转后读取功率板新版本,确认升级真正成功。
- 连续发送
ACK+C、EOT、结束空SOH和跳转控制帧,确认Boot未丢字节、重复启动DMA或将控制帧拼入YMODEM帧。
11. 南向实施清单
- 删除南向收到 NAK或超时后的内部 YMODEM重发。
- 增加独立的 EOT1、EOT2和结束空包状态。
- 以 UART发送完成事件启动应答计时。
- 保证 ACK、C 等应答有序排队和转交。
- 进入和退出控制帧禁止盲目重试。
- 升级期间锁定通道并完全停止普通轮询。
- 完成后恢复轮询并提供版本确认结果。
- 修复Boot:进入控制帧后清接收缓存、跳转前回ACK、UART使用单一DMA接收重启路径。
- 修改功率板Boot:包号1解析UPK头但不写APP,包号2起安装package body。
- 增加UPK长度、头CRC、package CRC、raw CRC、解密和向量表校验。