# 版本说明 2026-10-29(第十次) #define BL_VERSION "1.3.5" #define COMPILE "20261029" 1、现场反馈:执行 msh `sf bench yes` 后 Flash 全片被擦写,启动恢复正常。 核实 SFUD 的 bench 实现(spi_flash_sfud.c:706):`sf bench yes` 对整片执行 **擦除 4MB → 全片写入 0x55 → 全片读校验**,一次性清掉了三个持久化状态: · fm_area 的 RBL 头变成 0x55555555 → 包校验必然失败 → 不再进升级分支、不再跑 backup · df_area 的备份 magic 变成 0x55555555 → 无有效备份 → 不会自动回滚 · easyflash 全部扇区头变成 0x55555555 → 触发一次 ef_env_set_default() 重建 → 之后正常 即:该操作等价于"把 NOR 恢复出厂空白",所以自动流程不再命中。属有效的应急手段, 但副作用是 **EasyFlash 里所有环境变量被重置为默认值**(含设备配置),生产环境慎用。 2、本次查明"加载参数极慢"的真正机理(此前误判为 flash 操作耗时): SPI Flash 不可用时,EasyFlash 仍会对 3MB 环境区(768 个 4KB 扇区)逐个扇区执行 "读头 → 判无效 → 擦除 → 写头"(ef_env.c: check_sec_hdr_cb / format_sector); 而 FAL 的 assert 每失败一次就 rt_kprintf 一条(fal_def.h),加上 EasyFlash 自己的 "Sector header check failed",单扇区产生约 4~5 条串口输出,768 槽合计近 4000 条; @115200 下纯阻塞输出即需 20~30 秒 —— **慢的主因是日志洪水,不是 flash 操作本身**。 3、rt_fota.c:新增 `rt_fota_nor_ready()`(导出到 rt_fota.h)——读 JEDEC ID, 全 0x00 或全 0xFF 判为器件无响应。 4、main.c / rt_fota.c:`easyflash_init()` 前加门禁,NOR 无响应时直接跳过 EasyFlash 初始化并打印单条明确提示("Skip EasyFlash init: NOR flash not available.")。 效果:故障时启动从数十秒降到毫秒级,且不会产生任何破坏性写入 (原来只要总线间歇异常,format_sector 有可能真的擦掉用户环境变量)。 安全性已核对:EasyFlash 未初始化时 ef_get_env_blob / ef_set_env_blob 内部有 init_ok 判据,会安全返回失败而非崩溃(ef_env.c:1473)。 5、EasyFlash ef_env.c:check_sec_hdr_cb 的 warning 限流(只打前 3 条 + 1 条汇总), 失败计数照常累加,不影响原有 "All sector header check failed → set default" 判定。 6、fal-v0.5.0:**修复历史遗留的类型不匹配缺陷**。原 assert 宏统一 `return 1`, 用在返回指针的函数里会把 1 当指针返回(调用方拿到非 NULL 非法地址,解引用即 HardFault), 用在 void 函数里违反返回类型。此前因增量构建未重编这两个文件而一直被掩盖, 完整重编时暴露为 7 条 -Wint-conversion 告警。新增 `fal_check_ptr` / `fal_check_void` 两个类型正确的宏,替换 fal_flash.c(2 处)、fal_partition.c(4 处)共 6 个检查点。 7、全量重编 0 失败、0 告警;text 171040 / data 2132 / bss 8600,bin 173172B (v1.3.4 基线 172776B) 8、运维建议(重要): · 诊断顺序:`fota probe` 看 Upgrade pending → `fota retry` 看熔断计数 → 看启动日志有无 "Sector header check failed" → 再决定是否擦除 · 不要再用 `sf bench yes` 清场(它写全片 0x55,代价是丢失全部配置)。 精准手段:擦 fm_area / df_area 用 `fota` 相关命令或 uart4 维护命令; 仅清配置用 `eraseeasyflash` · 擦除前确认设备配置(设备 ID、采集参数等)已备份,否则会恢复默认值 # 版本说明 2026-10-29(第九次) #define BL_VERSION "1.3.4" #define COMPILE "20261029" 1、现场问题:**没有下发升级包,只是断电重启,每次启动都执行 rt_fota_backup_app_to_df 并伴随大量 #** 2、根因:升级判定只看 fm_area 里 RBL 头的两个版本字段—— rt_fota_check_upgrade(): download_version != current_version → 判"需升级"; 而把 current_version 对齐成 download_version 的 rt_fota_copy_version() 位于 rt_fota_upgrade() **之后**。只要 upgrade 失败(擦写途中被 IWDG 复位、NOR 读写异常等), copy_version 就不会执行,fm_area 里那个包永远"待升级"—— 于是每次上电都重跑完整流程:先 backup 备份 312KB(读一遍+擦 78 扇区+写一遍), 再擦写 312KB。表现为"没触发升级却每次启动都跑备份",断电重启反复发生 3、放大因素:原判据用 LOG_D 输出(DBG_LEVEL=DBG_INFO 时不打印),现场完全看不到 "为什么要升级",只能看到 backup 的打印,难以判断 4、rt_fota.c:新增升级重试熔断——按版本记录连续失败次数(存 EasyFlash,掉电保持): 同一版本连续失败 3 次后不再自动升级,直接跳转 APP 并打印原因 + LED 回到 shell 节奏; 用户重新下发新包(版本变化)时计数自动归零,无需人工清标志; EF 记录异常(如被擦成 0xFF 导致 cnt 为垃圾值)按无效记录重置,避免误判永久禁用 5、rt_fota.c:rt_fota_check_upgrade() 判据改 LOG_I 并打印两侧版本: "Application need upgrade: fm_area[x] != app[y]" / "No upgrade: fm_area[x] == app[y]" 6、rt_fota.c:upgrade / copy_version 失败时分别打印明确原因 ("Upgrade failed(n), fm_area image kept for retry." / "Copy version failed(n), ..."), 升级完全成功才清熔断计数并打印 "Upgrade done, version[x] applied." 7、rt_fota.c:新增 msh 子命令 `fota retry` 查看熔断状态、`fota retry 0` 清零; `fota probe` 增加 "Applied version"(current_version)与 "Upgrade pending"(YES/NO)两行, 一条命令即可确认"是否被判为需升级、差在哪个版本" 8、全量重编 0 失败、0 告警;text 170640 / data 2132 / bss 8600,bin 172772B (v1.3.3 基线 171232B) 9、排查提示:现场若再出现"没升级却跑备份",先执行 `fota probe` 看 Upgrade pending, 再 `fota retry` 看计数;根因是 fm_area 里残留未对齐版本的升级包, 干净的处理是 `fota retry 0` 后再重新下发一次完整升级包(或擦掉 fm_area) # 版本说明 2026-10-29(第八次) #define BL_VERSION "1.3.3" #define COMPILE "20261029" 1、问题:备份/恢复/擦除等长耗时 Flash 操作会把 IWDG 拖到超时,做到一半整机复位。 IWDG 由 syswatch 在启动阶段开启(SYSWATCH_WDT_TIMEOUT=10s、LSI/256 分频), 启动后无法停止,只能靠喂狗续命;而原来这些操作都是"整块"交给 FAL: fal_partition_erase(df_area, 4KB, 312KB) 在 NOR 上要逐 4KB 扇区擦 78 次, W25Q 单扇区擦除典型 45ms、最坏 400ms —— 一次调用就是 3.5s(典型)/ 31s(最坏), 中途没有任何喂狗机会。复位后 DR2 还残留 0xDEAD,会再触发回滚,进一步放大问题 2、rt_fota.c:新增 rt_fota_wdt_feed(),并导出到 rt_fota.h 供 main.c 复用。 安全约束:只有确认 IWDG 已启动(PR/RLR 非复位值 0)才喂——IWDG 只要写一次 KR (0xAAAA) 就会启动且无法停止,对"未启动"的 IWDG 喂狗会把一个 10s 看门狗凭空 带进 APP 运行期,造成随机复位。每次读 PR/RLR 判断(单周期),不做一次性缓存, 不受调用时机影响 3、rt_fota.c:新增 rt_fota_erase_chunked(),把大块擦除拆成 4KB 分块,每块后喂狗。 chunk=4KB 同时是 NOR 扇区粒度与 onchip 页(2KB)的整数倍,两种介质都安全 4、rt_fota_backup_app_to_df():擦头后喂狗;读 CRC 循环、写循环逐块喂狗(喂在 HMI_WRITE 之前,串口屏阻塞发送 78 块累计也有秒级);擦数据区改用分块擦除 5、rt_fota_restore_app_from_df():同上(读循环/写循环喂狗,擦 APP 分区改分块)。 自动回滚路径尤其关键——擦到一半被看门狗复位会变成"回滚-复位"死循环 6、rt_fota_erase_app_part()(升级擦 APP)、rt_fota_write_app_part()(升级搬运写)、 msh `fota clone`:擦除改分块、循环内喂狗 7、main.c:uart4 维护命令 eraseapp / erasedf_area 改分块擦除 + 逐块喂狗 (df_area 512KB NOR 逐扇区擦最坏几十秒,原来一次性调用必然超时) 8、全量重编 0 失败、0 告警;text 169100 / data 2132 / bss 8568,bin 171232B (v1.3.2 基线 170848B) # 版本说明 2026-10-29(第七次) #define BL_VERSION "1.3.2" #define COMPILE "20261029" 1、问题现象:bootloader 内 SFUD/FAL/EasyFlash 全部正常("Find a Winbond flash chip. Size is 4194304 bytes"), 跳转 APP 后 APP 的 SFUD 探测失败——"Read SFDP parameter header information failed" + "This flash device is not found or not support" → "ERROR: SPI flash probe failed by SPI device spi10"; FAL 中 w25q16m 设备为空,EasyFlash 于是对 3MB 环境区逐个 4KB 扇区"检查 header-格式化-擦-写-读", 每个扇区刷 4 条 assert 失败,启动被拖成分钟级("读参数很慢、APP 起不来") 2、根因:原跳转序列 HAL_DeInit()/HAL_RCC_DeInit() 会复位 APB2(含 GPIOA/SPI1/AFIO), /CS(PA4)、SCK(PA5)、MOSI(PA7) 立刻变成浮空输入;到 APP 里 HAL_SPI_MspInit 重新配置引脚之间 有几十毫秒"悬空窗口",悬空 /CS 被噪声拉低后,悬空时钟线上的毛刺会被 Flash 当成指令打入 (0xB9 深度掉电 / 0x38 QPI 等),此后标准 SPI 读只能得到 0xFF/0x00,与 APP 侧日志完全吻合。 本次日志里跳转前刚做过 78 个 4KB 块(312KB)的 fm_area→app 搬运,Flash 正处在刚被大量写入、 引脚随即悬空的最不利时序上 说明:两工程 drv_spi.c / board.c(HAL_SPI_MspInit) / CS 引脚(PA4) / FAL 移植层 / 分区表完全一致, APP 侧 SFUD 上限还更低(24MHz→18MHz vs 32MHz),故排除"速度过快"与"驱动不一致" 3、rt_fota.c:新增 rt_fota_spi_flash_quiesce(),跳转前(关中断之前,因 rt_spi_* 依赖互斥量/延时) 把芯片恢复到"标准 SPI + 空闲":等状态寄存器 BUSY 清零(最长 1s)→ 0xFF×8 逃逸 QPI/连续读 → 0xAB 释放深度掉电 → 0x66/0x99 器件复位 → 读 JEDEC ID 打印自检: "SPI flash handover: SR=0x00 JEDEC ID=0xEF4015"(读不到即为总线/芯片已异常) 4、rt_fota.c:新增 rt_fota_spi_pins_safe_state(),在 HAL_DeInit()/HAL_RCC_DeInit() 之后 (必须在之后,否则被 APB2 复位冲掉)重新固定引脚:先置 ODR 再改 CRL,PA4 推挽输出高(不选中 Flash), PA5/PA6/PA7 上拉输入,彻底消除 APP 启动前的悬空窗口;APP 侧 HAL_GPIO_Init 不改 ODR, 因此 /CS 从跳到 APP 到 SFUD 探测全程保持高电平 5、rt_fota.c:去掉原来重复调用的第二次 HAL_DeInit()(HAL_DeInit+HAL_RCC_DeInit 各一次即可) 6、全量重编 0 失败、0 告警;text 168716 / data 2132 / bss 8560,bin 170848B(v1.3.1 基线 170016B) # 版本说明 2026-10-13(第六次) #define BL_VERSION "1.3.1" #define COMPILE "20261013" 1、rt_fota.c:新增 msh 命令 dr2(uart1 控制台 shell),查看/设置 RTC_BKP_DR2 启动标志: dr2 查看当前值并标注含义(0 正常 / 0x5AA5 升级请求 / 0xDEAD 启动失败标记 / 其它未知;0xDEAD 与未知值在上电时将触发回滚尝试) dr2 0 清 0;手动进入 bootloader 维护后、重新上电前调用,避免残留非 0 值(如启动失败检测写入的 0xDEAD) 在下次上电被误判为“APP 未正常启动”而误触发 app 回滚 dr2 写入指定值(调试用):0xDEAD 验证启动失败回滚、0x5AA5 验证 ymodem 升级入口 2、全量重编 147 条命令 0 失败、新增代码 0 告警;text 167884 / bin 170016B(v1.3.0 基线 169420B) # 版本说明 2026-10-13(第五次) #define BL_VERSION "1.3.0" #define COMPILE "20261013" 1、rt_fota.c:升级回滚机制——升级搬运(fm_area→app)前自动备份当前 APP 固件到 df_area; 备份格式:4KB 头(magic "FBK1" + 数据长度 + 数据 CRC32)+ APP 分区镜像;头最后写入, 任一步骤掉电都不会残留半新半旧的"有效备份" 2、rt_fota.c:跳转 APP 前(向量表/栈校验通过后)写 RTC_BKP_DR2=0xDEAD"启动尝试"标记; APP 启动后(Application_CBD main 开头)清 0 表示启动成功 3、rt_fota.c:进入 bootloader 后检测 RTC_BKP_DR2——非 0(且非 0x5AA5 升级请求)说明 APP 未正常启动: 标记 0xDEAD;若有有效备份则从 df_area 回滚 APP,并对齐 fm_area 版本(防同一升级包回滚后再次自动应用); 自动回滚成功后消费备份(擦除备份头,防"恢复-崩溃"循环反复擦写 flash) 4、main.c:uart4 屏幕命令新增 dbg_restore(从 df_area 有效备份恢复 app,保留备份便于重复执行); 填充 backupapp(手动备份 app→df_area);resetapp 改为同一"校验后恢复"路径 (原裸搬运对带格式头的 df_area 会写坏 app;如需裸搬运可用 shell 的 fota clone) 5、注意:df_area 此后由本机制自动维护(带 4KB 备份头),原 rt_fota_thread_entry 中 "df_area 作为默认固件分区(RBL)的启动失败兜底"路径不再生效(校验自然失败后跳过) 6、边界:无 VBAT 电池冷启动时 DR2 可能为随机非 0 值,将触发一次回滚尝试(有备份时); 如需仅在明确 0xDEAD 时触发,可把 rt_fota_check_boot_state 的判定收紧 7、全量重编 147 条命令 0 失败、新增代码 0 告警;text 167288 / bin 169420B # 版本说明 2026-10-08(第四次) #define BL_VERSION "1.2.9" #define COMPILE "20261008" 1、ymodem_ota.c:Ymodem 下载完整性加固——首包文件名/大小解析限定在包长范围内(防非 NUL 结尾包与 atol 越界读),并拒绝 size=0; 收满首包声明长度后拒绝继续写入数据(防超发数据写入未擦除区域造成静默损坏) 2、ymodem_ota.c:下载成功后先切回 uart1 再打印成功信息(既有改动,一并纳入本次发版) # 版本说明 2026-10-08(第三次) #define BL_VERSION "1.2.8" #define COMPILE "20261008" 1、rt_fota.c:跳转 APP 交接序列规范化——跳转前禁用并清除全部 NVIC 中断、清除 PendSV/SysTick 挂起、SCB->VTOR 指向 APP、恢复 PRIMASK 后再跳转(消除 APP 带屏蔽启动与残留中断隐患) 2、drv_flash_f1.c:擦除路径补齐“解锁前关中断”(APM32 要求,与写路径一致);大分区擦除按 16 页分块、块间开中断,保证 IWDG 喂狗不受影响 3、rt_fota.c:stop_in_bootloader 读取兼容字符串 "0"/"1" 与二进制 0/1(修复新设备因默认值 "0"(0x30) 被误判为停留引导模式的缺陷) 4、main.c:eraseapp / erasedf_area 改用 fal_partition_find 获取真实分区对象(修正 erasedf_area 旧 16MB 偏移和未初始化 len),并增加执行结果打印 # 版本说明 2026-10-08(第二次) #define BL_VERSION "1.2.7" #define COMPILE "20261008" 1、rt_fota.c:新增 RTC 备份寄存器 DR2 升级请求检测——读取 RTC_BKP_DR2==0x5AA5(应用侧 JSONRPC "update" 指令写入)时,停留 bootloader 并执行 ymodem_ota 升级;读取后立即清标志防重复进入 2、rt_fota.c:补 HMI_WRITE extern 声明,消除隐式声明编译告警 # 版本说明 2026-10-08 #define BL_VERSION "1.2.6" #define COMPILE "20261008" 1、main.c:修复HMI串口接收缓冲区溢出(rx_buffer读取长度钳位至255) 2、rt_fota.c:升级包压缩块长度block_size越界校验(防止堆越界) 3、rt_fota.c:quicklz解压长度预校验(防止解压输出越界) # 版本说明 2026-07-13 #define BL_VERSION "1.2.5" #define COMPILE "20260713" 1、增大easyflash env分区大小为4096*256 2、增加版本号打印 # 版本说明 #define BL_VERSION "1.1.5" #define COMPILE "20250428" #define RT_FOTA_ALGO_BUFF_SIZE 2048 //2025-0428 CHANGE 2048 #define BL_VERSION "1.1.4" #define COMPILE "20230901" - 1. rt_fota.c中880行增加__set_CONTROL(0); ## VERSION "1.1.1" - 增加BL版本号和编译日期保存至EASYFLASH - main函数增加easyflash_init(); 2021-03-16: flash由16m更换为4m 分区表修改: #define FAL_PART_TABLE \ { \ {FAL_PART_MAGIC_WORD, "bl", "onchip_flash", 0, 200*1024, 0}, \ {FAL_PART_MAGIC_WORD, "app", "onchip_flash", 200*1024, 312*1024, 0}, \ {FAL_PART_MAGIC_WORD, "easyflash", FAL_USING_NOR_FLASH_DEV_NAME, 0, 3*1024*1024, 0}, \ {FAL_PART_MAGIC_WORD, "fm_area", FAL_USING_NOR_FLASH_DEV_NAME, 3*1024*1024, 512*1024, 0}, \ {FAL_PART_MAGIC_WORD, "df_area", FAL_USING_NOR_FLASH_DEV_NAME, 3*1024*1024 + 512*1024, 512*1024, 0}, \ } # 2021年4月8日: ## VERSION "1.1.1" 版本更新: apm32在flash操作,解锁前需要手动关闭中断,上锁后手动打开中断,这一点在差异文件内没写。 对应文件:drv_flash_f1.c __disable_irq(); __enable_irq(); #define BL_VERSION "1.1.3" #define COMPILE "20210701" - 针对FLASH硬件失效的修改: 改动位置packages中的fal包fal_def.h ------------------------------------------------------------- #define assert(EXPR) \ if (!(EXPR)) \ { \ FAL_PRINTF("(%s) bootloader fal_def.h has assert failed at %s.\n", #EXPR, __FUNCTION__); \ while(1); \ } ------------------------------------------------------------- #define assert(EXPR) \ if (!(EXPR)) \ { \ FAL_PRINTF("(%s) bootloader fal_def.h has assert failed at %s.\n", #EXPR, __FUNCTION__); \ return 1; \ }