Files
bootloader/include/version_mgr.h
T
robinson c90c187749 feat: 完成 STM32 Bootloader 核心功能实现和测试框架
新增核心模块:
- bootloader.c: Bootloader 主逻辑,状态机,命令处理
- protocol.c: 通信协议,帧解析,CRC16 验证
- boot_jump.c: 启动跳转,VTOR 重定向,应用程序有效性检查
- firmware_mgr.c: 固件管理,双 Bank 支持
- crc_check.c: CRC32 计算与验证 (ISO 9809-2 标准)
- aes_crypto.c: AES-256 解密 (ECB 模式)
- boot_trigger.c: 触发机制,魔术字,按键检测
- version_mgr.c: 版本管理,固件版本读取、更新、回滚

新增头文件:
- include/protocol.h: 协议接口定义
- include/boot_jump.h: 跳转接口定义
- include/firmware_mgr.h: 固件管理接口定义
- include/crc_check.h: CRC 校验接口定义
- include/aes_crypto.h: AES 加密接口定义
- include/boot_trigger.h: 触发机制接口定义
- include/version_mgr.h: 版本管理接口定义

修复现有 Bug:
- flash_port.c: 修复变量名错误 (word_data -> chunk_data)
- flash_port.c: 添加 Flash 解锁 (HAL_FLASH_Unlock)
- bsp_uart.c: 添加 uart_port_register 调用
- bsp_flash.c: 添加 flash_port_register 调用
- CMakeLists.txt: 取消核心模块注释,添加条件编译

新增测试框架 (tests/):
- unit/: 单元测试 (CRC32, AES, Boot Jump, Protocol)
- integration/: 集成测试 (完整升级流程)
- pc_tool/: PC 端烧录工具和测试固件生成器
- 提供一键编译运行脚本 (run_tests.sh, run_tests.bat)
- 完整测试文档 (README.md, TEST_REPORT.md)

配置更新:
- 所有功能默认启用 (AES, CRC, Dual Bank, Version Mgr)
- 支持条件编译和模块化配置

测试状态:
- 单元测试:36 个用例全部通过
- 集成测试:6 个场景全部通过
- 功能闭环验证完成
2026-04-05 15:49:04 +08:00

44 lines
968 B
C

#ifndef VERSION_MGR_H
#define VERSION_MGR_H
#include <stdint.h>
#include <stdbool.h>
#include "bootloader.h"
#include "bootloader_config.h"
#if BOOT_ENABLE_VERSION_MGR
/* 初始化版本管理器 */
int version_mgr_init(void);
/* 获取当前版本信息 */
firmware_version_t *version_mgr_get_version(void);
/* 更新版本信息 */
int version_mgr_update(uint32_t version, uint32_t build_time, uint32_t crc32,
uint32_t size, uint32_t bank_id);
/* 将版本信息写入 Flash */
int version_mgr_commit(void);
/* 标记固件为有效 */
int version_mgr_mark_valid(void);
/* 标记固件为无效 */
int version_mgr_mark_invalid(void);
/* 获取固件状态 */
uint32_t version_mgr_get_status(void);
/* 获取版本字符串 */
const char *version_mgr_get_version_string(void);
#if BOOT_ENABLE_DUAL_BANK
/* 版本回滚(切换到备用 Bank) */
int version_mgr_rollback(void);
#endif
#endif /* BOOT_ENABLE_VERSION_MGR */
#endif