131 lines
8.6 KiB
C
131 lines
8.6 KiB
C
#ifndef __OTA_CONFIG_H
|
||
#define __OTA_CONFIG_H
|
||
|
||
#include <stdint.h>
|
||
#include <string.h>
|
||
|
||
#define OTA_PAGE_SIZE 256UL /* Flash 页大小（硬件固定 256B，任何模式通用）*/
|
||
|
||
/* ════════════════════════════════════════════════════════════════
|
||
* OTA 模式配置 — 客户唯一配置入口
|
||
*
|
||
* 本文件被 APP（Core/ota_ab.c）与 Bootloader（boot_main.c）共用，
|
||
* 修改后需重新编译两个工程。
|
||
*
|
||
* 只需改 ① OTA_BACKUP_MODE（备份模式）。其余配置均由 #if 条件
|
||
* 编译保护，自动只编译生效模式需要的部分：
|
||
* ① OTA_BACKUP_MODE = SINGLE / AB 备份模式（唯一必选）
|
||
* ② OTA_SWAP_STRATEGY = SCRATCH / RAM 仅 AB 模式生效
|
||
* ③ OTA_SCRATCH_* 仅 AB+SCRATCH 生效
|
||
* 结构体 ota_param_t 的 seq/progress/phase 仅 AB 模式存在，
|
||
* OTA_STATE_SWAPPING 仅 AB 模式存在（单备份下不编译）。
|
||
*
|
||
* ┌─ 三种模式优缺点速查 ─────────────────────────────────────────┐
|
||
* │ SINGLE（单备份） │
|
||
* │ 优：最简单；最省 Flash（主区+BAK 各 58K，无需额外区） │
|
||
* │ 缺：升级失败/变砖只能整片重烧，无自动回滚 │
|
||
* │ AB + RAM（双备份 + RAM 缓冲交换） │
|
||
* │ 优：新固件崩溃可自动回滚旧固件；不预留 scratch； │
|
||
* │ 无 scratch 擦写磨损；占 Flash = A/B 各 58K │
|
||
* │ 缺：升级耗时较长（~7~12s，逐页 RAM 缓冲交换）； │
|
||
* │ 固件需 2× Flash（A、B 两份） │
|
||
* │ AB + SCRATCH（双备份 + Flash 暂存区交换） │
|
||
* │ 优：升级最快（~1~3s）；掉电恢复最稳 │
|
||
* │ 缺：需预留 scratch 区（暂存区，仅 1 页）； │
|
||
* │ scratch 固定页反复擦写有磨损（固件越大页数越多、 │
|
||
* │ 磨损越快）；固件需 2× Flash（A、B 两份） │
|
||
* │ 注：双备份两策略都需 2× 固件 Flash，scratch 仅多 1 页缓冲； │
|
||
* │ 128K 芯片上固件 > ~57K 时 2× 放不下，需外部 SPI Flash。 │
|
||
* └────────────────────────────────────────────────────────────┘
|
||
* ════════════════════════════════════════════════════════════════ */
|
||
|
||
/* ① 备份模式 ----------------------------------------------------- */
|
||
#define OTA_MODE_SINGLE 0 /* 单备份：BAK 下载→校验→拷贝覆盖主区（同 AppVersion）*/
|
||
#define OTA_MODE_AB 1 /* 双备份：A/B 区交换（新固件崩溃可回滚旧固件）*/
|
||
#define OTA_BACKUP_MODE OTA_MODE_SINGLE /* 默认单备份：最省 Flash、最简单、无磨损 */
|
||
|
||
|
||
/* ═══════ 以下 ②③ 配置仅 OTA_BACKUP_MODE == OTA_MODE_AB 时生效 ═══════ */
|
||
#if (OTA_BACKUP_MODE == OTA_MODE_AB)
|
||
|
||
/* ② 双备份交换策略 ----------------------------------------------- */
|
||
#define OTA_SWAP_SCRATCH 0 /* Flash 暂存区交换：升级快、掉电恢复最稳（需预留暂存区）*/
|
||
#define OTA_SWAP_RAM 1 /* RAM 缓冲交换：不预留暂存区，A/B 保持 55K */
|
||
#define OTA_SWAP_STRATEGY OTA_SWAP_SCRATCH
|
||
|
||
/* ③ 暂存区参数（仅 OTA_SWAP_STRATEGY == OTA_SWAP_SCRATCH 生效） --- */
|
||
#if (OTA_SWAP_STRATEGY == OTA_SWAP_SCRATCH)
|
||
#define OTA_SCRATCH_ADDR 0x0801F800UL /* 暂存区起始地址：放在 Flash 最底部（必须页对齐）*/
|
||
#define OTA_SCRATCH_SIZE OTA_PAGE_SIZE /* 暂存区只需 1 页：交换时每次仅暂存 1 页(256B)，
|
||
故大小=1 页即可；Bootloader 每次也只擦这 1 页，
|
||
避免原 1KB 整块擦除的 4 倍磨损浪费 */
|
||
#endif /* OTA_SWAP_STRATEGY == SCRATCH */
|
||
|
||
#endif /* OTA_BACKUP_MODE == AB */
|
||
|
||
/* ════════════════════════════════════════════════════════════════
|
||
* 布局宏自动联动（以下由上面配置推导，勿手工修改）
|
||
* ════════════════════════════════════════════════════════════════ */
|
||
#define OTA_PARAM_ADDR_BASE 0x08002C00UL /* OTA 状态区，1KB（固定）：Bootloader 11K 后 */
|
||
#define OTA_PARAM_MAX_SIZE (1UL * 1024)
|
||
|
||
#if (OTA_BACKUP_MODE == OTA_MODE_AB) && (OTA_SWAP_STRATEGY == OTA_SWAP_SCRATCH)
|
||
/* 双备份 + 暂存区：A/B 各 57KB（128K-12K固定-256B暂存区 ≈ 57K/份），
|
||
B 区收尾于 0x0801F800，scratch(1页)紧接其后放在 Flash 最底部 0x0801F800 */
|
||
#define OTA_RUN_ADDR_BASE 0x08003000UL /* A 区 = 运行区（固件链接地址）*/
|
||
#define OTA_BAK_ADDR_BASE 0x08011400UL /* B 区 = 备份区 */
|
||
#define OTA_SLOT_MAX_SIZE (57UL * 1024)
|
||
#else
|
||
/* 单备份（主区+BAK） 或 双备份+RAM（A/B 各 58K）：布局相同，A+B 正好填满 128K */
|
||
#define OTA_RUN_ADDR_BASE 0x08003000UL /* 主区/A 区 = 运行区 */
|
||
#define OTA_BAK_ADDR_BASE 0x08011800UL /* BAK/B 区 */
|
||
#define OTA_SLOT_MAX_SIZE (58UL * 1024)
|
||
#endif
|
||
|
||
#define OTA_SLOT_PAGE_NB (OTA_SLOT_MAX_SIZE / OTA_PAGE_SIZE)
|
||
|
||
/* ════════════════════════════════════════════════════════════════
|
||
* OTA 状态机（APP 与 Bootloader 共用）
|
||
*
|
||
* 单备份：IDLE → PENDING →(Bootloader 拷贝主区)→ 运行，无回滚
|
||
* 双备份：IDLE → PENDING →(Bootloader 交换)→ BOOT_NEW →(APP 确认)→ IDLE
|
||
* SWAPPING = 交换掉电中断，下次启动续做
|
||
* 新固件崩溃(IWDG复位)：BOOT_NEW 未确认 → 反向交换回滚 → IDLE
|
||
* ════════════════════════════════════════════════════════════════ */
|
||
#define OTA_MAGIC 0xA55A
|
||
#define OTA_STATE_IDLE 0x00 /* 正常运行 */
|
||
#define OTA_STATE_PENDING 0x01 /* 新固件已下载，待 Bootloader 校验/拷贝/交换 */
|
||
#if (OTA_BACKUP_MODE == OTA_MODE_AB)
|
||
#define OTA_STATE_SWAPPING 0x02 /* 双备份：交换进行中（掉电恢复入口）*/
|
||
#endif
|
||
#define OTA_STATE_BOOT_NEW 0x03 /* 已切到新固件，等待 APP 确认（未确认=回滚）*/
|
||
|
||
/* ════════════════════════════════════════════════════════════════
|
||
* OTA 状态结构（APP 与 Bootloader 共用，flash.c 负责读写）
|
||
*
|
||
* seq / progress / phase 仅双备份需要（4 页轮换判新、交换掉电恢复），
|
||
* 由 #if 保护 —— 单备份模式下字段不存在，结构体更小（20B vs 28B）。
|
||
* ════════════════════════════════════════════════════════════════ */
|
||
typedef struct
|
||
{
|
||
#if (OTA_BACKUP_MODE == OTA_MODE_AB)
|
||
uint32_t seq; /* 写入序号：4 页轮换判新（参与 CRC16 保护）*/
|
||
#endif
|
||
uint16_t magic; /* OTA_MAGIC，有效标志 */
|
||
uint8_t state; /* IDLE / PENDING / [SWAPPING] / BOOT_NEW */
|
||
uint8_t rsv;
|
||
uint32_t fw_size; /* 新固件长度（字节） */
|
||
uint32_t fw_crc32; /* 新固件 CRC32 */
|
||
uint32_t fw_version; /* 新固件版本（透传，可留 0） */
|
||
#if (OTA_BACKUP_MODE == OTA_MODE_AB)
|
||
uint16_t progress; /* 双备份：交换已完成页数（掉电恢复） */
|
||
uint8_t phase; /* 双备份：交换阶段标志（掉电恢复） */
|
||
#endif
|
||
uint8_t rsv2;
|
||
uint16_t crc16; /* 结构体自身 CRC16（CRC-16/CCITT）保护 */
|
||
} ota_param_t;
|
||
|
||
#define OTA_PARAM_SIZE ((uint16_t)sizeof(ota_param_t))
|
||
|
||
#endif /* __OTA_CONFIG_H */
|