/***************************************************************************** * @file OTAUpgrade.h * @brief 4G OTA固件升级模块 - 通过HTTP下载加密固件、解密并校验 * @author AI Assistant * @date 2025-12-20 * * @details 功能说明： * 1. 通过4G模块HTTP下载加密固件到Flash加密区 * 2. 支持断点续传（使用HTTPClient Range功能） * 3. 下载完成后调用AES-256-CBC解密算法解密固件 * 4. 解密后进行校验和验证确保固件完整性 * * Flash分区： * - 加密固件区: 0x08100000 - 0x0813FFFF (256KB, Bank2 Sector0-1) * - 解密固件区: 0x08140000 - 0x0817FFFF (256KB, Bank2 Sector2-3) *****************************************************************************/ #ifndef __OTA_UPGRADE_H__ #define __OTA_UPGRADE_H__ #include "HIDO_TypeDef.h" #ifdef __cplusplus extern "C" { #endif /***************************************************************************** * Flash分区地址定义 *****************************************************************************/ // 加密固件存储区（Bank2 Sector0-1） #define OTA_ENCRYPTED_FLASH_ADDR 0x08100000U #define OTA_ENCRYPTED_FLASH_SIZE (256 * 1024) // 256KB // 解密固件存储区（Bank2 Sector2-3） #define OTA_DECRYPTED_FLASH_ADDR 0x08140000U #define OTA_DECRYPTED_FLASH_SIZE (256 * 1024) // 256KB /***************************************************************************** * OTA升级状态定义 *****************************************************************************/ typedef enum { OTA_STATE_IDLE = 0, // 空闲状态 OTA_STATE_DOWNLOADING, // 正在下载加密固件 OTA_STATE_DOWNLOAD_COMPLETE, // 下载完成 OTA_STATE_DOWNLOAD_FAILED, // 下载失败 OTA_STATE_DECRYPTING, // 正在解密 OTA_STATE_DECRYPT_COMPLETE, // 解密完成 OTA_STATE_DECRYPT_FAILED, // 解密失败 OTA_STATE_VERIFYING, // 正在校验 OTA_STATE_VERIFY_SUCCESS, // 校验成功 OTA_STATE_VERIFY_FAILED, // 校验失败 } E_OTAState; /***************************************************************************** * OTA升级错误码 *****************************************************************************/ typedef enum { OTA_ERR_NONE = 0, // 无错误 OTA_ERR_BUSY, // OTA正忙 OTA_ERR_INVALID_PARAM, // 无效参数 OTA_ERR_NO_NETWORK, // 网络未就绪 OTA_ERR_HTTP_FAILED, // HTTP请求失败 OTA_ERR_FLASH_ERASE_FAILED, // Flash擦除失败 OTA_ERR_FLASH_WRITE_FAILED, // Flash写入失败 OTA_ERR_FILE_TOO_LARGE, // 文件超过256KB OTA_ERR_DECRYPT_FAILED, // 解密失败 OTA_ERR_CHECKSUM_MISMATCH, // 校验和不匹配 } E_OTAError; /***************************************************************************** * OTA升级信息结构体 *****************************************************************************/ typedef struct { E_OTAState eState; // 当前状态 E_OTAError eLastError; // 最后错误码 HIDO_UINT32 u32TotalSize; // 固件总大小（字节） HIDO_UINT32 u32DownloadedSize; // 已下载大小（字节） HIDO_UINT32 u32DecryptedSize; // 已解密大小（字节） HIDO_UINT8 u8Progress; // 进度百分比 (0-100) HIDO_CHAR acETag[64]; // HTTP ETag，用于断点续传验证 } ST_OTAInfo; /***************************************************************************** * 对外接口函数 *****************************************************************************/ /** * @brief 初始化OTA升级模块 * @return HIDO_OK: 成功, HIDO_ERR: 失败 */ HIDO_INT32 OTA_Init(HIDO_VOID); /** * @brief 启动OTA固件下载 * @param _pcUrl: 固件下载URL（例如: "http://123.57.87.125:7001/hfs/STM32H743.Bin"） * @return HIDO_OK: 启动成功, 其他: 错误码 * @note 下载将自动写入加密固件区，支持断点续传 */ HIDO_INT32 OTA_StartDownload(const HIDO_CHAR *_pcUrl); /** * @brief 启动固件解密 * @return HIDO_OK: 启动成功, 其他: 错误码 * @note 从加密区读取数据，使用AES-256-CBC解密后写入解密区 */ HIDO_INT32 OTA_StartDecrypt(HIDO_VOID); /** * @brief 启动固件校验 * @return HIDO_OK: 校验成功, 其他: 错误码 * @note 读取固件末尾4字节校验和，计算并对比验证 */ HIDO_INT32 OTA_VerifyFirmware(HIDO_VOID); /** * @brief 获取OTA升级信息 * @param _pstInfo: 返回的信息结构体指针 * @return HIDO_OK: 成功, HIDO_ERR: 失败 */ HIDO_INT32 OTA_GetInfo(ST_OTAInfo *_pstInfo); /** * @brief 获取当前OTA状态 * @return 当前状态枚举值 */ E_OTAState OTA_GetState(HIDO_VOID); /** * @brief 获取下载进度百分比 * @return 进度 0-100 */ HIDO_UINT8 OTA_GetProgress(HIDO_VOID); /** * @brief 取消当前OTA操作 * @return HIDO_OK: 成功, HIDO_ERR: 失败 */ HIDO_INT32 OTA_Cancel(HIDO_VOID); /** * @brief 重置OTA模块到空闲状态 * @note 清除所有状态和进度信息 */ HIDO_VOID OTA_Reset(HIDO_VOID); /** * @brief OTA模块周期性任务 * @note 需要在主循环中周期调用，处理解密和校验等耗时任务 */ HIDO_VOID OTA_Poll(HIDO_VOID); #ifdef __cplusplus } #endif #endif /* __OTA_UPGRADE_H__ */