yhf/chrg

Files

T

wrh d231a49771 短路测试增加先下发V_ON为500mv的逻辑。让充电头一带电就打嗝

切换协议和CC线时，将V_ON设置顺序调整，避免指令被清楚

feat: 发布V1.1.19版本，优化短路测试与电压恢复逻辑

1.  更新所有文件版本号到V1.1.19，固件版本寄存器改为0x0123
2.  新增短路测试最低启动电压宏，设置为500mV，绕过普通V_ON门槛
3.  调整南向COM单次最大发送条数为8条，优化通信批次
4.  重构电压稳定确认逻辑，新增自动停止后恢复确认计数
5.  优化协议软卸载与完整握手流程，统一下发WORK_STOP和V_ON命令
6.  新增修改日志文档，补充本次更新说明与验证项
7.  新增UPK打包规则与YMODEM上位机实现文档

2026-09-10 16:43:43 +08:00

4.3 KiB

Raw Blame History

协议板 Boot：UPK 打包规则

1. 适用范围

本文用于实现协议板 App 固件的 .upk 打包和解析工具，适配 apps/boot 当前 Boot。传输层 YMODEM 规则见协议板Boot_YMODEM上位机实现规则.md。

2. 1K 文件布局

当前 Boot 收到第一个文件数据帧时，只取其中前 96 字节作为 UPK 头，会忽略该帧其余数据。因此打包文件必须使用固定 1024 字节首数据块：

输出 .upk 文件
偏移 0x000 ~ 0x05F  : 96 字节 UPK 逻辑头
偏移 0x060 ~ 0x3FF  : 928 字节 0x00 填充
偏移 0x400 起       : package body（未加密 BIN 或 AES 加密后的 body）

.upk 实际文件大小：1024 + pkg_size。
YMODEM 元数据包的文件大小必须为上述实际文件大小。
上位机必须从偏移 0 开始以 STX/1024 发送；第一个 STX 是头区，真正 body 从第二个 STX 开始。
YMODEM 最后一帧的 0x1A 补齐仅属于传输层，不能计入文件大小、raw_size 或 pkg_size。

界面中的“表头尺寸 1024 (ymodem1k)”应改名为“YMODEM 首数据块/头区尺寸”，并固定为 1024；UPK 逻辑头固定为 96，不能让用户修改。

3. 输入、分区与版本

项目	规则
输入文件	仅协议板 App 裸 `bin`，例如 `apps/chrg/build/chrg.bin`；拒绝 `.hex`、`.elf`、已有 `.upk`。
`name[4]`	固定 ASCII `upk\0`。
`part_name[16]`	仅允许 `app`、`download`、`factory`，ASCII NUL 结尾；协议板常规升级默认 `app`，Boot 会修正为 `download` 后安装到 `app`。
`fw_old_ver[16]`	目标设备当前版本，前 4 字节为数值 `major, minor, fix, build`，其余 `0x00`。
`fw_new_ver[16]`	新固件版本，编码同上。
版本输入	界面应分别提供“当前/旧版本”与“新版本”；不能只保留一个版本号，且不得写 ASCII 版本字符串。
`user_string[16]`	ASCII 水印最多 15 字节，NUL 结尾，其余 `0x00`。
`timestamp`	当前 Unix 时间戳，`uint32` 小端。
大小限制	`raw_size <= 262144` 且 `pkg_size <= 262144`，即 App/download 分区各 256KB。

4. 加密、大小与 CRC

raw_body 为原始 .bin：raw_size = len(raw_body)，raw_crc = crc32_boot(raw_body)。
未加密：package_body = raw_body，pkg_size = raw_size，pkg_crc = raw_crc，config[1]=0x00。
AES：config[1]=0x01，使用 AES-256-CBC；Key=0123456789ABCDEF0123456789ABCDEF，IV=0123456789ABCDEF。加密前 body 必须补齐到 16 字节整数倍；pkg_size、pkg_crc对应加密后的 body。Key、IV 必须与 Boot 编译配置一致。
config[0]、config[2]、config[3] 固定 0x00。
head_crc = crc32_boot(逻辑头前 92 字节)；最后 4 字节按小端写入 head_crc。
所有 uint32 字段按 STM32 小端序写入。

crc32_boot() 必须与 apps/boot/application/func/utils.c 的 crc32_step(0xFFFFFFFF, data, size) 完全一致；不能直接使用未校验的库默认 CRC32。

5. 96 字节逻辑头字段

0x00  name[4]
0x04  config[4]
0x08  fw_old_ver[16]
0x18  fw_new_ver[16]
0x28  user_string[16]
0x38  part_name[16]
0x48  raw_size      uint32 little-endian
0x4C  pkg_size      uint32 little-endian
0x50  timestamp     uint32 little-endian
0x54  raw_crc       uint32 little-endian
0x58  pkg_crc       uint32 little-endian
0x5C  head_crc      uint32 little-endian

6. 打包完成前的强制自检

重新解析刚生成的 .upk。
校验总长度是否为 1024 + pkg_size，并检查 0x60~0x3FF 全部为 0x00。
校验 name、分区名、版本字段、大小限制和 head_crc。
校验 pkg_crc；未加密时还必须校验 raw_crc。加密时使用相同 Key/IV 解密后校验 raw_crc。
解析页显示 raw_size、pkg_size、全部 CRC、加密状态、分区、旧/新版本和时间戳；任一项异常时禁止输出成功文件。

7. 当前样本

工程中的 apps/chrg/chrg.upk 已验证：实际长度 155816，pkg_size=154792，两者相差 1024，符合本规则。

8. 代码依据

apps/boot/application/include/firmware.h
apps/boot/application/func/firmware.c
apps/boot/application/func/app.c
apps/boot/application/func/utils.c

4.3 KiB Raw Blame History Unescape Escape