改为南向主动发送C,不再向南向发送进入和退出 1 升级进入/退出命令不再向南向发送控制帧,本地会话建立后立即响应成功 2 功率板Boot主动每500ms发送'C',协议板收到后转发给上位机 3 更新协议板版本寄存器为0x0143,版本号升级至V1.1.51 4 调整升级状态机,删除等待南向ACK的相关逻辑 5 更新相关文档,同步升级协议和状态机的修改内容
225 lines
9.7 KiB
Markdown
225 lines
9.7 KiB
Markdown
# 功率板升级:南向发送与应答计划
|
||
|
||
## 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或跳转App控制帧。功率板Boot启动后每500ms主动发送 `43`,协议板收到后转发北向并开始YMODEM流程。北向退出命令仅结束协议板本地升级会话。
|
||
|
||
## 3. 南向帧和应答映射
|
||
|
||
| 协议板发送 | 功率板 Boot 正常回复 | 协议板处理 |
|
||
| --- | --- | --- |
|
||
| Boot主动发送 | `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`或无回复 | 停止会话并清理缓存 |
|
||
|
||
## 4. 南向状态机
|
||
|
||
```text
|
||
S_IDLE
|
||
北向进入请求 -> 锁通道、停轮询 -> S_WAIT_C
|
||
|
||
S_WAIT_C
|
||
Boot主动发送C -> 转交北向 -> S_WAIT_META
|
||
|
||
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_IDLE
|
||
|
||
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. 包号0只解析YMODEM文件名和文件长度,不写Flash。
|
||
5. 包号1必须为STX/1024:解析前96字节UPK头,校验标识、头CRC、目标分区、`raw_size`、`pkg_size`和加密配置;检查后928字节均为 `0x00`;整包不写APP区。
|
||
6. 包号2起才处理package body,并从 `0x08003800` 开始安装;不得把UPK头区写入APP。
|
||
7. 只处理UPK头声明的 `pkg_size` 字节,忽略最后YMODEM帧的 `0x1A`补齐;不得按整帧把补齐数据计入固件长度。
|
||
8. 完成接收后校验package CRC;若启用加密,按UPK配置解密后写APP并校验raw CRC;未加密时直接写APP并校验raw CRC。
|
||
9. APP首地址必须是裸固件向量表,写入完成后校验MSP和Reset_Handler范围;任何UPK校验失败都不得跳转APP。
|
||
10. 第一次EOT回复NAK,第二次EOT仅在UPK接收和校验成功后回复 `ACK + C`,结束空SOH回复ACK。
|
||
11. 明确APP起始地址、最大 `raw_size/pkg_size`和Flash擦除范围;当前APP区为 `0x08003800~0x0800E7FF`,大小 `0xB000`(44KB),必须与App链接脚本一致。
|
||
12. 跳转App前关闭中断、DMA、SysTick和相关外设,设置MSP与VTOR。
|
||
13. 处理进入控制帧后,先清除控制帧接收缓存和长度计数,再启动YMODEM接收;不得将控制帧的8字节与元数据SOH拼接。
|
||
14. UART接收只保留一条DMA-to-idle重启路径;禁止UART IRQ与接收回调同时中止或重复启动DMA。
|
||
15. 跳转控制帧匹配成功后,先发送ACK并等待发送完成,再执行App跳转。
|
||
|
||
## 9. 功率板Boot的UPK安装流程
|
||
|
||
```text
|
||
收到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. 南向验证顺序
|
||
|
||
1. 逻辑分析仪确认进入帧完整发送,波特率和通道正确。
|
||
2. 确认功率板完整接收 8 字节并完成 Flash 擦除。
|
||
3. 确认线路依次出现 `06 43`,协议板应答队列也依次取到 `06 43`。
|
||
4. 确认包号0不写Flash,包号1只解析UPK头且不写APP。
|
||
5. 确认包号2的数据区首字节写入 `0x08003800`,该地址内容为APP向量表。
|
||
6. 验证最后一帧的 `0x1A`补齐不计入大小和CRC。
|
||
7. 验证头CRC、package CRC、raw CRC、加密和超长UPK异常路径。
|
||
8. 验证标准两次EOT和结束空SOH。
|
||
9. 验证CRC错误时NAK能原样传到PC,并由PC重发。
|
||
10. 验证ACK丢失、半帧、超时、CAN和断电。
|
||
11. 跳转后读取功率板新版本,确认升级真正成功。
|
||
12. 连续发送 `ACK+C`、EOT、结束空SOH和跳转控制帧,确认Boot未丢字节、重复启动DMA或将控制帧拼入YMODEM帧。
|
||
|
||
## 11. 南向实施清单
|
||
|
||
1. 删除南向收到 NAK或超时后的内部 YMODEM重发。
|
||
2. 增加独立的 EOT1、EOT2和结束空包状态。
|
||
3. 以 UART发送完成事件启动应答计时。
|
||
4. 保证 ACK、C 等应答有序排队和转交。
|
||
5. 进入和退出控制帧禁止盲目重试。
|
||
6. 升级期间锁定通道并完全停止普通轮询。
|
||
7. 完成后恢复轮询并提供版本确认结果。
|
||
8. 修复Boot:进入控制帧后清接收缓存、跳转前回ACK、UART使用单一DMA接收重启路径。
|
||
9. 修改功率板Boot:包号1解析UPK头但不写APP,包号2起安装package body。
|
||
10. 增加UPK长度、头CRC、package CRC、raw CRC、解密和向量表校验。
|