Explorar el Código

bootv1.3.5&1.86

zhunk hace 3 semanas
padre
commit
a56ec400e3

+ 116 - 0
Application_CBD/.workbuddy/memory/2026-10-29.md

@@ -0,0 +1,116 @@
+# 2026-10-29
+
+## 开机 Flash 参数加载耗时采集 + 上报字段 + 超 10s 预警(1.84.41)
+
+- 需求:获取开机启动时 Flash 参数加载耗时,数据上报增加该字段,超过 10s 上报预警消息。
+- hmi.c `Check_ParamConfig()`:
+  - 入口 `load_t0 = rt_tick_get()`;终点放在"参数读取/默认值写入"结束处(即最后一个 else-if 块之后)。
+  - **终点不能放函数末尾**:末尾还有等待联网循环(最长 3 分钟,180 次×1s)与 `dtu_data_play()`,
+    否则测到的是联网等待时间而非参数加载时间。
+  - `device_status.boot_param_ms` = rt_tick 起点(板级初始化,tick=0)→ 加载完成,含前段全部
+    INIT_EXPORT,即上报字段 bootlt;`param_load_ms` = 函数内耗时(区分前段初始化慢 / Flash 读慢)。
+  - 二者为运行态字段,**不写入 EF、不进 param_payload_t 镜像**,不影响已有机型参数布局。
+  - RT_TICK_PER_SECOND==1000 时 tick 即 ms(本机 rtconfig.h 确认 =1000),否则 64bit 换算。
+- control.h:新增 `BOOT_PARAM_SLOW_MS 10000UL` + device_status 末尾两个 rt_uint32_t;
+  版本号 1.83.41→**1.84.41**、2000W→1.84.40、ZP/GK→1.84.1、BZY 2.70→2.71(三色光源/DZ 分支未动)。
+- dtu_uart2.c `makeJson()`:ext 新增 `"bootlt"`(字符串,ms),紧邻 blver/bltime;
+  **必须用独立 12B 缓冲**——函数内 `utos[5]` 只够 4 位数字,>9999ms 会被截断。
+- dtu_uart2.c `dtu_periodic_report()`:`boot_param_ms > BOOT_PARAM_SLOW_MS` 时发
+  `{"cmd":"warn","ext":{"status":"boot param load slow:<ms>ms","type":"device"}}`,只报一次
+  (函数内 static sent 标志,组帧成功才置位)。放在上报窗口末尾而非发送线程入口——
+  入口处 RTU(Linux) 可能未启动,盲发丢帧且不重试(沿用 1.82.41 参数备份/恢复的教训)。
+- 构建:全量重编 176 条命令 0 失败、两次一致:**text 249580 / data 2468 / bss 47388,bin 252048B**
+  (arm-none-eabi-gcc 6.3.1;基线 1.83.41 IDE 15:39 构建为 248972/2468/47372、Flash 251440B,
+  本批净增 text +608B、bss +16B)。19 条告警均为历史遗留,改动文件 0 新增告警。
+- 产物:`bin/Application_CBD-1.84.41-20261029.bin`、`Debug/Application_CBD-1.84.41-20261029.elf`;
+  已用二进制搜索确认固件内含 `bootlt` / `boot param load slow` / `开机参数加载耗时` / `1.84.41(HK)`。
+- readme:doc/readme.md 顶部已插入 2026-10-29 条目(Python 写入,保持无 BOM + 全 CRLF)。
+- 待上机验证:① 开机日志"开机参数加载耗时: boot=… load=…";② 上报 JSON ext.bootlt 数值合理
+  (预计数百 ms 级);③ 人为拖慢 >10s 时 warn 只出现一次;④ 平台侧对新增字段的兼容。
+
+## 开机参数加载慢 —— 根因定位与根治(1.85.41)
+
+用户反馈:加载参数慢,执行 `sf bench yes` 整片擦除后恢复正常,问原因与避免方法。
+
+**根因(非 Flash 损坏,是配置放大器 + 静默重试)**:
+- `packages/EasyFlash-latest/inc/ef_cfg.h:95` `ENV_AREA_SIZE = EF_ERASE_MIN_SIZE*256` = **1MB / 256 扇区**
+  (官方推荐 2 扇区,注释还留着 "2024-07-10 2 to 16")。
+- `ef_env.c` `ef_load_env()` 启动遍历**全部** SECTOR_NUM 扇区、且走两遍;`sector_iterator()` 每扇区
+  `read_sector_meta_data()` 真读 Flash(`EF_ENV_USING_CACHE` 未定义)。
+- **致命点**:`check_sec_hdr_cb()`(ef_env.c:1689)对每个 magic 不匹配的扇区**当场 format_sector()**
+  (擦 4KB + 写头),且**原实现忽略返回值** → 擦写失败也无声、下次开机重来。
+- 实际只用第 0 扇区(50 个 key≈3KB),其余 255 个扇区每次开机都被擦 → 256×~45ms ≈ **11.5s**。
+- `sf bench yes` = 整片擦除 + 整片写 0x55 + 读校验(spi_flash_sfud.c:706-780)→ 之后 EF 走
+  `ef_env_set_default()` 一次性重建全部扇区头(那次最慢),此后启动全部合法 → 不再擦除 → 恢复。
+
+**`sf bench yes` 的附带损失(重要)**:整片 16MB 擦除,连 **fm_area / df_area 一起毁掉**;
+df_area 是 OTA 固件回滚副本(`app_partion_backup()` 仅 version_type==0 时自动重建);
+参数回默认值,version_type 回 4,需屏幕 Swversion 握手切回。**现场口径改用 msh `resetenv`**
+(只格式化 ENV 区,秒级;ef_cmd.c 实现 = `ef_env_set_default()`)。EasyFlash 无 `ef format` 命令。
+
+**本次改动**:
+1. `ef_cfg.h`:ENV_AREA_SIZE `*256` → `*16`(64KB)。最坏擦除 11.5s → 0.7s。
+2. `param_mirror.h`:**必须联动**——`ef_log.c:101` 日志区起始 = `EF_START_ADDR + ENV_AREA_SIZE`,
+   ENV 缩小后日志区从 0x100000 前移到 0x10000,故 `MIRROR_BASE_OFFSET` 由 `1MB+8KB`(0x102000)
+   改为 `64KB+8KB`(0x12000),否则镜像槽落进日志区互相破坏。
+   新布局:ENV 0~0x10000 | LOG 0x10000~0x12000 | 镜像A 0x12000 | 镜像B 0x13000。
+3. EasyFlash 新增 `ef_boot_diag_t{format_cnt, format_fail_cnt}` + `ef_env_get_boot_diag()`;
+   `check_sec_hdr_cb` 检查 format 返回值并计数/报错;`ef_load_env` 入口清零。
+4. `hmi.c`:采集诊断打印 "EF重建扇区:N 失败:M";`reboot_time` 由每次开机写改为每 10 次落盘
+   (落盘值 1,11,21…;EasyFlash 是追加式 KV,每次写都推进扇区轮换/GC)。
+5. `dtu_uart2.c`:ext 新增 `bootef`("0" 或 "16:3");`ef_fmt_fail_cnt!=0` 发一次 warn
+   `ef sector format failed:M/N`。
+6. `control.h`:`ef_fmt_cnt`/`ef_fmt_fail_cnt` 运行态字段;版本 1.85.41 / 1.85.40 / 1.85.1 / BZY 2.72。
+
+**尺寸**:text 250292 / data 2468 / bss 47404,bin 252760B(全量×2 一致,176 条命令 0 失败)。
+基线 1.84.41 = 249580/2468/47388 / 252048B → 净增 text +712B、bss +16B。
+产物 `bin/Application_CBD-1.85.41-20261029.bin`、`Debug/Application_CBD-1.85.41-20261029.elf`。
+
+**告警**:改 easyflash.h 触发 ef_log.c 重编,首次暴露 3 条上游历史告警
+`SECTOR_STATUS_HEADER_ERROR not handled in switch`(ef_log.c:285/301/323)——EasyFlash 4.1.99
+自带,且应用层从未调用 `ef_log_*`(日志区只初始化扫 2 扇区),不影响功能,留待后续单独处理。
+
+**兼容性**:50 个 key 一直在第 0 扇区,缩容后仍可读;日志区与镜像槽位置变化 → 升级后首次开机
+日志区重建一次、镜像在新位置重建(旧镜像读不到,iSave 正常时无副作用);首次开机 EF 会格式化
+剩余 15 个新扇区(≈0.7s),之后 bootef 应稳定为 0。
+
+## dtu_uart2 新增远程擦除 Flash 指令(1.86.41)
+
+指令(RTU 透传,走 parseDtu 的 cmd 分支):
+- `{"cmd":"eraseflash","ext":{"target":"env"}}` —— 安全档(缺省):擦参数镜像两槽 + ENV 区
+  64KB + EF 日志区,<1s,不碰固件区。**开机参数加载慢的远程处置手段**,替代现场 sf bench yes。
+- `{"cmd":"eraseflash","ext":{"target":"chip","confirm":"ERASE"}}` —— 整片 16MB,需强确认,
+  会连带擦掉 fm_area/df_area。
+
+实现要点(踩过的坑,勿改回):
+1. **镜像必须最先擦**:否则重启后 Check_ParamConfig 走 iSave 丢失路径时 param_mirror_load()
+   会把旧参数整份搬回来,"恢复出厂"落空。
+2. **擦 ENV 不调 ef_env_set_default()**:它写的是字符串型默认值("20"/"0xAA"),而本工程用
+   ef_get_env_blob 按二进制读,读出来是 ASCII 码不是数值。直接擦净,重启后由
+   Check_ParamConfig 用代码内默认值重建。
+3. **EF 日志区清理前先 easyflash_init() 确认可用**(幂等):EF 从未 init 成功时
+   log_area_start_addr 还是 0,直调 ef_log_clean() 会擦 0 地址。
+4. **param_mirror_erase_all 必须清 s_last_valid**:该模块用"内容未变则跳过写"抑制写放大,
+   只擦 Flash 不清缓存 → 后续 sync 永远 return、镜像永久空、防丢保护静默失效。
+5. **分支位置**:插在 "reboot" 之前。parseDtu 的 cmd 链是 strstr 子串匹配,
+   `build/check_branch_order.py` 已双向机器化校验(前置 5 个分支不匹配 eraseflash;
+   eraseflash 不吞后续 11 个分支)——本工程历史上踩过"过宽前置分支吞掉后续分支"的坑。
+6. 执行流程:回执 start → 执行 → 回执 done/failed(带耗时)→ 成功后 rt_hw_cpu_reset()。
+   先回 start 是因擦除期间接收线程无法处理其它下行指令。
+7. 安全边界:**片内 Flash(bl/app)任何档位都不擦**,不存在变砖路径;target 走白名单,
+   未知名一律拒绝,不做兜底猜测。
+
+**顺带修复的既有缺陷**:`param_mirror.c` 缺 `#define DBG_ENABLE`。rtdbg.h:69 需要该宏才展开
+dbg_log_line,否则 LOG_x 全是空宏 → 该模块自建立起**所有日志从未输出**,包括
+`LOG_W("param mirror save failed")`。证据:补前 param_mirror.o 搜不到任何日志字符串、反汇编
+`param_mirror_erase_all` 无 rt_kprintf;补后 "param mirror erased"/"param mirror save failed"
+均进镜像。**教训:新模块复制 DBG_TAG/DBG_LVL 时容易漏掉 DBG_ENABLE,可用"objdump 看有没有
+rt_kprintf 调用"来验证日志是否真的生效。**
+
+**尺寸**:text 253340 / data 2468 / bss 47404,bin 255808B(全量×2 一致)。
+相对 1.85.41(250292/47404,bin 252760B)**净增 text +3048B**,其中:
+含 eraseflash 无 DBG_ENABLE 时 252628(+2336),补 DBG_ENABLE 后 253340(+712)。
+产物 `bin/Application_CBD-1.86.41-20261029.bin`、`Debug/Application_CBD-1.86.41-20261029.elf`。
+告警 19 条与 1.85.41 完全一致(仅行号位移),改动文件 0 新增告警。
+
+

+ 39 - 2
Application_CBD/.workbuddy/memory/MEMORY.md

@@ -31,8 +31,17 @@
   "xxx.o: No such file or directory"(文件实际存在、正被 IDE 重写)。规避:构建前查 tasklist 是否有
   javaw;取尺寸/告警优先走"无 touch"路径(直接 arm-none-eabi-size elf;告警读 IDE 构建日志
   .metadata/.plugins/org.eclipse.cdt.ui/Application_CBD.build.log,"0 errors, N warnings" 秒级刷新)。
-- 最新权威:**1.82.41**(2026-10-15 参数恢复/备份机制修复:盲发缺陷+变更触发+RTU 就绪门控)
-  **text 248900 / data 2468 / bss 47380,bin 251368B**(CLI 全量×2 一致);
+- 最新权威:**1.86.41**(2026-10-29 dtu_uart2 新增远程擦除 Flash 指令 `eraseflash`
+  [env 安全档 / chip 需 confirm=ERASE] + 顺带修复 param_mirror.c 缺 DBG_ENABLE 致该模块日志全失效)
+  **text 253340 / data 2468 / bss 47404,bin 255808B**(CLI 全量×2 一致);
+  1.85.41(2026-10-29 开机参数加载慢根治:EasyFlash ENV_AREA_SIZE 1MB→64KB
+  + EF 扇区重建诊断 ef_boot_diag_t 上报 ext.bootef + reboot_time 减写)
+  text 250292 / data 2468 / bss 47404,bin 252760B;
+  1.84.41(2026-10-29 开机 Flash 参数加载耗时采集:Check_ParamConfig 打点
+  boot_param_ms/param_load_ms + 上报 ext.bootlt(ms) + 超 10s 发一次 warn)
+  text 249580 / data 2468 / bss 47388,bin 252048B(CLI 全量×2 一致);
+  1.82.41(2026-10-15 参数恢复/备份机制修复:盲发缺陷+变更触发+RTU 就绪门控)
+  text 248900 / data 2468 / bss 47380,bin 251368B(CLI 全量×2 一致);
   1.81.41(2026-10-15 用户侧自行完成并定版:云端 read 应答丢失修复 hmi_fresh 保护)
   text 248084 / data 2468 / bss 47364,bin 250552B(IDE 构建口径);
 - 1.80.41(2026-10-15 屏幕版本串变化后按字符切换版本类型:hmi.c 新增
@@ -74,6 +83,34 @@
   PARAM_SOLICIT_TICK);待办标志不过期(RTU 晚到也补发)。
 - 教训:原实现(1.64 引入)在发送线程启动时盲发——RTU(Linux)启动 3~10s 期间命令丢失且永不重试;
   且 iFlag==0 每次开机都备份、真正变更时反而从不备份。勿改回"立即发送"。
+
+## EasyFlash 存储布局与"开机参数加载慢"(2026-10-29 根治,1.85.41)
+- **easyflash FAL 分区在片外 SPI NOR(MYFLASH16)0~3MB**(fal_cfg.h:47),不是片内 Flash。
+  分区内布局:`ENV 0~0x10000(64KB)` | `LOG 0x10000~0x12000(8KB)` | `镜像A 0x12000` | `镜像B 0x13000`
+  | 其余空闲。
+- **慢的根因链**:`ENV_AREA_SIZE` 曾是 `EF_ERASE_MIN_SIZE*256`=1MB/256 扇区 → `ef_load_env()`
+  启动遍历全部扇区两遍 → `check_sec_hdr_cb()` 对每个头非法的扇区**当场 format_sector()**
+  (擦 4KB+写头)→ 实际只用第 0 扇区、其余 255 个每次开机都擦 → 256×~45ms ≈ **11.5s**。
+  原实现还**忽略 format 返回值**,失败无声重试 → "常态性慢且无报错"。1.85.41 改为 16 扇区(64KB)。
+- **联动铁律**:`ef_log.c:101` 日志区起始 = `EF_START_ADDR + ENV_AREA_SIZE`。改 `ENV_AREA_SIZE`
+  **必须同步改 `param_mirror.h` 的 `MIRROR_BASE_OFFSET`**(现为 64KB+8KB=0x12000),
+  否则镜像槽落进日志区,被 ef_log 擦除互相破坏。
+- **诊断接口**:`ef_env_get_boot_diag(&d)` → `format_cnt/format_fail_cnt`(本次开机重建扇区数/
+  失败数),已上报 `ext.bootef`("0" 或 "16:3");`format_fail_cnt!=0` 发一次 warn
+  `ef sector format failed:M/N`。开机日志:"EF重建扇区:N 失败:M"。
+- **运维红线**:`sf bench yes` = 整片 16MB 擦除 + 整片写 0x55 + 读校验,会**连 fm_area/df_area
+  一起毁掉**(df_area 是 OTA 回滚副本,仅 version_type==0 时自动重建),参数回默认值且
+  version_type 回 4。现场"开机参数加载慢"的正确处置是 msh `resetenv`
+  (= `ef_env_set_default()`,只格式化 ENV 区,秒级)或 **1.86.41 起的远程指令
+  `{"cmd":"eraseflash","ext":{"target":"env"}}`**。EasyFlash 无 `ef format` 命令。
+- **远程擦除指令(1.86.41)**:`eraseflash` target=env(缺省,安全)/ chip(需 confirm="ERASE")。
+  实现铁律见 .workbuddy/memory/2026-10-29.md:镜像必须先擦、擦 ENV 不调 ef_env_set_default、
+  清日志前先 easyflash_init、param_mirror_erase_all 必须清 s_last_valid、片内 Flash 永不擦。
+- **新模块日志陷阱**:复制 `DBG_TAG`/`DBG_LVL` 时若漏 `#define DBG_ENABLE`,rtdbg.h:69 下
+  `LOG_x` 全部退化为空宏、日志无声(param_mirror.c 因此静默了整年)。验证法:objdump 看
+  该函数有没有 rt_kprintf 调用,或直接搜 .o/bin 里有没有对应字符串。
+- **写放大源**:`reboot_time` 原每次开机都 `ef_set_env_blob` 一条(EF 是追加式 KV,每次写推进
+  扇区轮换/GC)→ 1.85.41 改为每 10 次开机落盘一次。新增持久化 key 时注意同样问题。
 ## 屏幕(HMI)侧约定(2026-10-10 建立)
 - 屏幕每秒发一次 `getFullData`(页面心跳),`SwversionV**` 为版本握手帧。
 - workSta 页**整页刷新**逻辑集中在 hmi.c 的 `hmi_refresh_pages(&tm)`(由 HMI_Decode 调);

+ 31 - 7
Application_CBD/applications/control.h

@@ -35,31 +35,35 @@
     #define VERSION_HK_2000W    "1.3Lv1.40(2000W)"       //水稻
 #else
 #if DZ_260630_1 == 0
-     #define VERSION_HK          "1.83.41(HK)"            //4.0海康-1200W
+     #define VERSION_HK          "1.86.41(HK)"            //4.0海康-1200W
 #else
-    #define VERSION_HK          "1.83.41(HK-DZ260630_1)"  //4.0海康-1200W
+    #define VERSION_HK          "1.86.41(HK-DZ260630_1)"  //4.0海康-1200W
 #endif
 #if DZ_260623_2 == 0
 #if DZ_260630_1 == 0
-    #define VERSION_HK_2000W    "1.83.40(2000W)"         //4.0水稻
+    #define VERSION_HK_2000W    "1.86.40(2000W)"         //4.0水稻
 #else
-    #define VERSION_HK_2000W    "1.83.40(2000W-DZ260630_1)"         //4.0水稻
+    #define VERSION_HK_2000W    "1.86.40(2000W-DZ260630_1)"         //4.0水稻
 #endif
 #else
     #define VERSION_HK_2000W    "DZ_260623_2"         //4.0水稻
 #endif
 #endif
 #if DZ_260519 == 0
-#define VERSION_ZP          "1.83.1(ZP)"                //1.0转盘
+#define VERSION_ZP          "1.86.1(ZP)"                //1.0转盘
 #else
 #define VERSION_ZP          "DZ_260519"                 //1.0转盘
 #endif
-#define VERSION_GK          "1.83.1(GK)"                //1.0高空
+#define VERSION_GK          "1.86.1(GK)"                //1.0高空
 
 #define VERSION_XCT         "1.13.6(HK)"                //吸虫塔-海康
-#define VERSION_BZY         "2.70"                      //孢子仪
+#define VERSION_BZY         "2.73"                      //孢子仪
 
 #define CompileTime         sprintf(device_status.driver_compile,"%s-%s",__DATE__,__TIME__)              //编译时间,每次更新代码修改
+
+/* 开机 Flash 参数加载耗时预警阈值(ms):Check_ParamConfig() 记录的 boot_param_ms
+ * 超过本值即向 RTU 上报一条 warn(2026-10-29 新增) */
+#define BOOT_PARAM_SLOW_MS   10000UL
 /*********************************************************************/
 typedef struct  _packed
 {
@@ -208,6 +212,26 @@ typedef struct  _packed
     uint16_t clear_left;
     uint16_t work_total_sec;
     rt_uint32_t work_start_tick;
+
+    /* ============ 开机 Flash 参数加载耗时(2026-10-29 新增) ============
+     * 两者均为运行态字段,**不参与 EF / 镜像存储**(param_payload_t 未包含它们,
+     * 因此不影响已有机型的参数布局与向后兼容):
+     *   boot_param_ms -> 自上电 tick 起点(rt_tick=0,即板级初始化时刻)到
+     *                    Check_ParamConfig() 参数加载完成的毫秒数;
+     *                    上报字段 bootlt(ms),超 BOOT_PARAM_SLOW_MS 时上报预警;
+     *   param_load_ms -> Check_ParamConfig() 内部"参数读取 + 默认值写入"自身耗时(ms),
+     *                    仅用于日志定位(区分"前段初始化慢"还是"Flash 读慢")。 */
+    rt_uint32_t boot_param_ms;
+    rt_uint32_t param_load_ms;
+
+    /* ============ EasyFlash 开机重建诊断(2026-10-29 新增) ============
+     * 取自 ef_boot_diag_t(详见 EasyFlash inc/easyflash.h):本次开机
+     * ef_load_env() 中"扇区头非法 → 被重新格式化"的扇区数与其中失败数。
+     * 正常应全为 0;format_cnt 持续非 0 说明 ENV 区有扇区反复损坏,
+     * format_fail_cnt 非 0 说明擦除/写头确实失败(硬件或寿命问题)。
+     * 同样不参与 EF / 镜像存储。 */
+    uint16_t   ef_fmt_cnt;
+    uint16_t   ef_fmt_fail_cnt;
 }Device_Status_typedef;
 
 

+ 330 - 0
Application_CBD/applications/dtu_uart2.c

@@ -31,6 +31,8 @@
 #include <lwjson.h>
 #include "sys_monitor.h"
 #include "param_mirror.h"
+#include <fal.h>                /* 远程擦除 Flash:分区查找/擦除(2026-10-29) */
+#include <spi_flash_sfud.h>     /* 远程擦除整片:rt_sfud_flash_find_by_dev_name(2026-10-29) */
 
 
 #define DTU_THREAD_PRIORITY         6          //线程优先级
@@ -447,9 +449,297 @@ static void dtu_periodic_report(void)
         rt_free(res_fuse_warn);
     }
 
+    /* 开机 Flash 参数加载超时预警(2026-10-29 新增,只报一次):
+     * 放在本上报窗口末尾、而不是发送线程入口——线程入口处 RTU(Linux 侧)可能尚未
+     * 启动,盲发会丢帧且永不重试(与参数备份/恢复同一教训,见文件前部说明)。
+     * 组帧成功才置 sent,失败则下次上报继续尝试。 */
+    {
+        static rt_uint8_t s_boot_slow_warn_sent = 0;
+        static rt_uint8_t s_ef_fail_warn_sent  = 0;
+
+        if(s_boot_slow_warn_sent==0 &&
+           device_status.boot_param_ms > BOOT_PARAM_SLOW_MS)
+        {
+            char slow_msg[48];
+            char *slow_json;
+            rt_snprintf(slow_msg, sizeof(slow_msg), "boot param load slow:%lums",
+                        (unsigned long)device_status.boot_param_ms);
+            slow_json = makeJson_Warn(slow_msg, "device");
+            if(slow_json != RT_NULL)
+            {
+                LOG_W("上报开机参数加载超时预警:%s", slow_msg);
+                DTU_Write("%s",slow_json);
+                rt_free(slow_json);
+                s_boot_slow_warn_sent = 1;
+            }
+        }
+
+        /* EasyFlash 扇区擦写失败预警(2026-10-29 新增,只报一次):
+         * 扇区擦不干净/头写不进去 → 每次开机都会重新格式化它(check_sec_hdr_cb),
+         * 这就是"开机参数加载慢"的持续型根因;属硬件/寿命问题,必须让平台侧看到。 */
+        if(s_ef_fail_warn_sent==0 &&
+           device_status.ef_fmt_fail_cnt != 0)
+        {
+            char ef_msg[56];
+            char *ef_json;
+            rt_snprintf(ef_msg, sizeof(ef_msg), "ef sector format failed:%u/%u",
+                        (unsigned)device_status.ef_fmt_fail_cnt,
+                        (unsigned)device_status.ef_fmt_cnt);
+            ef_json = makeJson_Warn(ef_msg, "device");
+            if(ef_json != RT_NULL)
+            {
+                LOG_W("上报 EasyFlash 扇区擦写失败预警:%s", ef_msg);
+                DTU_Write("%s",ef_json);
+                rt_free(ef_json);
+                s_ef_fail_warn_sent = 1;
+            }
+        }
+    }
+
     s_reporting = 0;
 }
 
+/* ==================== 远程 Flash 擦除(2026-10-29 新增) ====================
+ * 指令(RTU 透传下发,解析见 parseDtu 的 "eraseflash" 分支):
+ *   {"cmd":"eraseflash","ext":{"target":"env"}}                     安全档(默认)
+ *   {"cmd":"eraseflash","ext":{"target":"chip","confirm":"ERASE"}}  危险档,需强确认
+ *
+ * 两档范围差异极大:
+ *   env  —— 只擦"参数存储":参数镜像两槽 + EasyFlash ENV 区 + EF 日志区。
+ *           等价 msh 的 resetenv + 镜像清理,耗时 <1s,不碰任何固件区。
+ *           这正是"开机参数加载慢"的远程处置手段(无需再现场执行 sf bench yes)。
+ *   chip —— 片外 SPI NOR 整片擦除(本板 16MB),会连带擦掉 fm_area 与 df_area,
+ *           其中 df_area 是 OTA 回滚副本(app_partion_backup 仅 version_type==0 重建)。
+ *           耗时数十秒~数分钟,必须带 confirm="ERASE"。
+ *
+ * 安全边界:片内 Flash(bl / app,固件自身所在的 onchip_flash)**任何档位都不擦**,
+ * 故本指令不存在把设备擦成砖的路径;最坏结果是参数回出厂默认 + 丢失回滚副本。
+ *
+ * 并发:擦除在 DTU 接收线程同步执行,期间 uart2 的 RTU 数据来不及读(可能丢帧、
+ * RTU 侧超时重试),属破坏性维护操作的预期代价;故先回执 start 再执行。
+ * ========================================================================== */
+
+#define DTU_ERASE_PART_NAME   "easyflash"   /* 片外 NOR 上承载 ENV/镜像/日志的分区 */
+
+/* 喂狗:整片擦除耗时可达数十秒,绝不能依赖 idle 钩子(擦除线程若长时间不让出 CPU
+ * 会停喂)。sfud 的忙等待用的是 rt_thread_delay,正常会让出,这里再显式兜一层。 */
+static void dtu_wdt_feed(void)
+{
+    static rt_device_t wdt_dev = RT_NULL;
+
+    if (wdt_dev == RT_NULL)
+    {
+        wdt_dev = rt_device_find("wdt");
+    }
+    if (wdt_dev != RT_NULL)
+    {
+        rt_device_control(wdt_dev, RT_DEVICE_CTRL_WDT_KEEPALIVE, RT_NULL);
+    }
+}
+
+/* 擦"参数存储"三块:镜像 → ENV → 日志。
+ * 顺序有讲究:镜像必须最先擦 —— 否则重启后 Check_ParamConfig 走 iSave 丢失路径时,
+ * param_mirror_load() 会把旧参数整份搬回来,"恢复出厂"就落空了。 */
+static int dtu_erase_param_area(void)
+{
+    const struct fal_partition *part;
+    int ret = RT_EOK;
+
+    part = fal_partition_find(DTU_ERASE_PART_NAME);
+    if (part == RT_NULL)
+    {
+        LOG_E("擦除失败:找不到 FAL 分区 %s", DTU_ERASE_PART_NAME);
+        return -RT_ERROR;
+    }
+
+    /* ① 参数镜像两槽(内部同时清 RAM 缓存,见 param_mirror_erase_all 注释) */
+    if (param_mirror_erase_all() != RT_EOK)
+    {
+        LOG_W("擦除参数镜像失败(继续擦 ENV)");
+        ret = -RT_ERROR;
+    }
+
+    /* ② EasyFlash ENV 区:整块擦掉,且**不写默认 key**。
+     * 不调用 ef_env_set_default() 的原因:它写入的是字符串型默认值("20"/"0xAA"…),
+     * 而本工程用 ef_get_env_blob 按二进制读取,读出来会是 ASCII 码而不是数值。
+     * 直接擦干净,重启后由 Check_ParamConfig() 用代码内的默认值重新填充,语义最干净。 */
+    if (fal_partition_erase(part, 0, ENV_AREA_SIZE) < 0)
+    {
+        LOG_E("擦除 ENV 区失败(0~%u)", (unsigned)ENV_AREA_SIZE);
+        ret = -RT_ERROR;
+    }
+    else
+    {
+        LOG_I("ENV 区已擦除(%u 字节)", (unsigned)ENV_AREA_SIZE);
+    }
+
+    /* ③ EF 日志区(起始 = ENV 区之后,见 ef_log.c:101)。
+     * 先确认 EasyFlash 可用(easyflash_init 幂等,已 init 时直接返回 EF_NO_ERR):
+     * 若 EF 从未初始化成功(现场见过 "easyflash init ERRPR!!!"),log_area_start_addr
+     * 尚未计算,直接调 ef_log_clean() 会用 0 地址去擦,故此处必须判空跳过。 */
+    if (easyflash_init() == EF_NO_ERR)
+    {
+        ef_log_clean();
+    }
+    else
+    {
+        LOG_W("EasyFlash 未就绪,跳过日志区清理(ENV 区已整块擦除,不影响结果)");
+    }
+
+    return ret;
+}
+
+/* 片外 SPI NOR 整片擦除。按 erase_gran 对齐分块,每块擦完喂一次狗。 */
+static int dtu_erase_chip(void)
+{
+    sfud_flash_t nor;
+    uint32_t gran, chunk, offset;
+
+    nor = rt_sfud_flash_find_by_dev_name(FAL_USING_NOR_FLASH_DEV_NAME);
+    if (nor == RT_NULL)
+    {
+        LOG_E("擦除失败:找不到 SPI Flash 设备 %s", FAL_USING_NOR_FLASH_DEV_NAME);
+        return -RT_ERROR;
+    }
+
+    gran = nor->chip.erase_gran;
+    if (gran == 0)
+    {
+        gran = 4096;        /* 兜底:驱动未填粒度时按 4KB 处理 */
+    }
+    /* 分块取 64KB 并向下对齐到 gran(4KB 粒度 → 64KB;64KB 粒度 → 64KB) */
+    chunk = 64UL * 1024UL;
+    if (chunk < gran)
+    {
+        chunk = gran;
+    }
+    chunk -= (chunk % gran);
+    if (chunk == 0)
+    {
+        chunk = gran;
+    }
+
+    LOG_W("开始整片擦除 %s: 容量 %u 字节, 粒度 %u, 分块 %u",
+          FAL_USING_NOR_FLASH_DEV_NAME, (unsigned)nor->chip.capacity,
+          (unsigned)gran, (unsigned)chunk);
+
+    for (offset = 0; offset < nor->chip.capacity; offset += chunk)
+    {
+        uint32_t len = nor->chip.capacity - offset;
+
+        if (len > chunk)
+        {
+            len = chunk;
+        }
+        if (sfud_erase(nor, offset, len) != SFUD_SUCCESS)
+        {
+            LOG_E("整片擦除失败于偏移 0x%08x (%u 字节)", (unsigned)offset, (unsigned)len);
+            return -RT_ERROR;
+        }
+        dtu_wdt_feed();
+    }
+
+    LOG_W("整片擦除完成: %u 字节", (unsigned)nor->chip.capacity);
+    return RT_EOK;
+}
+
+/* 远程擦除入口:解析 target/confirm → 回执 start → 执行 → 回执结果。
+ * 返回 1 = 成功且需重启;0/-1 = 未执行或失败(均已回执,调用方不重启)。 */
+static int dtu_flash_erase_exec(cJSON *ext)
+{
+    const char *target  = "env";    /* 缺省为安全档 */
+    const char *confirm = RT_NULL;
+    char msg[96];
+    char *json;
+    rt_tick_t t0;
+    int is_chip = 0;
+    int err;
+
+    if (ext != RT_NULL && ext->type == cJSON_Object)
+    {
+        cJSON *t = cJSON_GetObjectItem(ext, "target");
+        cJSON *c = cJSON_GetObjectItem(ext, "confirm");
+
+        if (t != RT_NULL && t->type == cJSON_String && t->valuestring != RT_NULL)
+        {
+            target = t->valuestring;
+        }
+        if (c != RT_NULL && c->type == cJSON_String && c->valuestring != RT_NULL)
+        {
+            confirm = c->valuestring;
+        }
+    }
+
+    /* target 白名单:不认识的档位一律拒绝,绝不做"猜你想要擦哪"的兜底 */
+    if (rt_strcmp(target, "env") == 0)
+    {
+        is_chip = 0;
+    }
+    else if (rt_strcmp(target, "chip") == 0)
+    {
+        is_chip = 1;
+        /* 强确认:整片擦除不可撤销,且会带走 fm_area / df_area */
+        if (confirm == RT_NULL || rt_strcmp(confirm, "ERASE") != 0)
+        {
+            json = makeJson_Warn("flash erase rejected: need confirm=ERASE", "device");
+            if (json != RT_NULL)
+            {
+                DTU_Write("%s", json);
+                rt_free(json);
+            }
+            LOG_W("拒绝整片擦除:缺少 confirm=ERASE");
+            return -1;
+        }
+    }
+    else
+    {
+        rt_snprintf(msg, sizeof(msg), "flash erase rejected: unknown target %s", target);
+        json = makeJson_Warn(msg, "device");
+        if (json != RT_NULL)
+        {
+            DTU_Write("%s", json);
+            rt_free(json);
+        }
+        LOG_W("拒绝擦除:未知 target=%s", target);
+        return -1;
+    }
+
+    /* 先回执 start:擦除期间本线程无法处理其它下行指令,避免平台误判设备无响应 */
+    rt_snprintf(msg, sizeof(msg), "flash erase start:%s", target);
+    json = makeJson_Warn(msg, "device");
+    if (json != RT_NULL)
+    {
+        DTU_Write("%s", json);
+        rt_free(json);
+    }
+    LOG_W("收到远程擦除指令: target=%s", target);
+
+    t0  = rt_tick_get();
+    err = is_chip ? dtu_erase_chip() : dtu_erase_param_area();
+
+    rt_snprintf(msg, sizeof(msg), "flash erase %s:%s (%lus)",
+                (err == RT_EOK) ? "done" : "failed", target,
+                (unsigned long)((rt_tick_get() - t0) / RT_TICK_PER_SECOND));
+    json = makeJson_Warn(msg, "device");
+    if (json != RT_NULL)
+    {
+        DTU_Write("%s", json);
+        rt_free(json);
+    }
+
+    if (err != RT_EOK)
+    {
+        LOG_E("%s", msg);
+        return -1;
+    }
+    LOG_I("%s", msg);
+
+    /* 两档都需重启:参数区已清空 / 整片已空,重启后由 Check_ParamConfig 按
+     * "ENV 无 iSave" 路径重建全套默认参数。注意 version_type 会回到默认 4,
+     * 机型需由屏幕 Swversion 握手(hmi_switch_version)或平台参数下发恢复。 */
+    return 1;
+}
+
 /* 按最新 dattim 重排周期上报定时器(单位分钟)。
  * 每次上报后调用:从当前时刻重新计一个完整周期,
  * 等价于原实现"上报完成后 num_updata = dattim*60"的语义。 */
@@ -1680,6 +1970,32 @@ char * makeJson()
         cJSON_AddStringToObject(pSubJson, "blver", bl_ver);      //bootloader版本
         cJSON_AddStringToObject(pSubJson, "bltime", bl_time);    //bootloader编译时间
     }
+    /* 开机 Flash 参数加载耗时 bootlt(ms),2026-10-29 新增:
+     * 由 hmi.c Check_ParamConfig() 在参数读取完成时写入 device_status.boot_param_ms。
+     * 注意用独立 12 字节缓冲——本函数内的 utos[5] 仅够 4 位数字,>9999ms 会被截断。 */
+    {
+        char bootlt[12];
+        rt_snprintf(bootlt, sizeof(bootlt), "%lu", (unsigned long)device_status.boot_param_ms);
+        cJSON_AddStringToObject(pSubJson, "bootlt", bootlt);
+    }
+    /* EasyFlash 开机重建诊断 bootef(2026-10-29 新增):
+     * 本次开机"扇区头非法被重新格式化"的扇区数 / 其中失败数。
+     * 正常为 "0";失败时形如 "16:3"。平台侧可据此看 ENV 区健康趋势——
+     * 该值非 0 且持续增长 = 扇区反复损坏(曾导致开机参数加载慢 10s+)。 */
+    {
+        char bootef[16];
+        if (device_status.ef_fmt_fail_cnt != 0)
+        {
+            rt_snprintf(bootef, sizeof(bootef), "%u:%u",
+                        (unsigned)device_status.ef_fmt_cnt,
+                        (unsigned)device_status.ef_fmt_fail_cnt);
+        }
+        else
+        {
+            rt_snprintf(bootef, sizeof(bootef), "%u", (unsigned)device_status.ef_fmt_cnt);
+        }
+        cJSON_AddStringToObject(pSubJson, "bootef", bootef);
+    }
     //设备类型
     rt_sprintf(utos, "%d",device_status.dtype);
     cJSON_AddStringToObject(pSubJson,"dtype",utos);
@@ -2548,6 +2864,20 @@ int parseDtu(char *json_string)
                   rt_free(photo);
                   rt_thread_delay(2000);
               }
+              /* 远程 Flash 擦除(2026-10-29 新增,实现见 dtu_flash_erase_exec)
+               * {"cmd":"eraseflash","ext":{"target":"env|chip","confirm":"ERASE"}}
+               * 位置:必须排在 "reset"/"read"/"reboot" 等 strstr 分支**之前**。
+               * "eraseflash" 本身不含这些子串,但破坏性指令前置更安全,也避免将来
+               * 新增更宽的分支把它吞掉(本项目出现过"过宽前置分支吞掉后续分支"的缺陷)。 */
+              else if (strstr(item_cmd->valuestring,"eraseflash")!=RT_NULL)
+              {
+                  if (dtu_flash_erase_exec(item_ext) > 0)
+                  {
+                      /* 两档都需重启:等回执发完再复位,避免报文被截断 */
+                      rt_thread_delay(2000);
+                      rt_hw_cpu_reset();
+                  }
+              }
               else if (strstr(item_cmd->valuestring,"reboot")!=RT_NULL)
               {
                   char *restart = makeJson_Warn("sysrem will restart","control");

+ 19 - 0
Application_CBD/applications/dtu_uart2.h

@@ -38,6 +38,25 @@ void dtu_request_report(void);
 //重启-------{"cmd": "reboot"}
 //升级-------{"cmd": "update"}
 //拍照-------{"cmd": "takephoto"}
+/* 远程擦除 Flash(2026-10-29 新增,实现在 dtu_uart2.c 的 dtu_flash_erase_exec)
+ *   {"cmd":"eraseflash","ext":{"target":"env"}}                      安全档(target 缺省即此档)
+ *   {"cmd":"eraseflash","ext":{"target":"chip","confirm":"ERASE"}}   危险档,缺 confirm 直接拒绝
+ *
+ *   target="env"  只擦参数存储:参数镜像两槽 + EasyFlash ENV 区 + EF 日志区。
+ *                 等价 msh 的 resetenv + 镜像清理,耗时 <1s,不碰任何固件区。
+ *                 用于"开机参数加载慢"的远程处置(替代现场执行 sf bench yes)。
+ *   target="chip" 片外 SPI NOR 整片擦除(16MB),会连带擦掉 fm_area 与 df_area
+ *                 (df_area 是 OTA 回滚副本)。耗时数十秒~数分钟。须 confirm="ERASE"。
+ *
+ *   安全边界:片内 Flash(bl/app,固件自身)任何档位都不擦,不存在变砖路径。
+ *   执行后设备重启,参数回出厂默认,version_type 回到默认 4(机型需屏幕
+ *   Swversion 握手或平台参数下发恢复)。
+ *   回执(type 均为 "device",走 cmd=warn 通道):
+ *     "flash erase start:<target>"
+ *     "flash erase done:<target> (<秒>s)" / "flash erase failed:<target> (<秒>s)"
+ *     "flash erase rejected: need confirm=ERASE" / "flash erase rejected: unknown target X"
+ */
+
 //{"cmd":"paramconf","ext":{"hst":110,"collt":10,"et":6,"datt":2,"shake_sec":1,"tpl":5,"shake":1,"tph":70,"ts":1,"st":20,"imgres":2,"htim":20,"tt":8}}
 
 //{"cmd":"synchronization","ext":{"year":1,"month":1,"day":0,"hour":25,"min":0,"sec":0,"lat":"113.2056","lng":"21.0596","csq",31,"net",0,"iccid","123135453","imei":"895864646464464"}}

+ 52 - 1
Application_CBD/applications/hmi.c

@@ -3185,6 +3185,9 @@ int Hmi_Fresh(void)
 }
 void Check_ParamConfig(void)
 {
+    /* 2026-10-29:开机参数加载耗时打点起点。终点在下方"参数加载完成"处,
+     * 不能放在函数末尾——末尾还有等待联网循环(最长3分钟)与 dtu_data_play()。 */
+    rt_tick_t load_t0 = rt_tick_get();
     time_t now = time(RT_NULL);
     static struct tm tm;
     gmtime_r(&now, &tm);
@@ -3192,8 +3195,14 @@ void Check_ParamConfig(void)
     {
         ef_get_env_blob("reboot_time", &device_status.rebootcnt, sizeof(device_status.rebootcnt), NULL); //读出reboot_time的值
         ef_get_env_blob("iSave", &device_status.iSave, sizeof(device_status.iSave), NULL); //判断是否用户配置了程序
+        /* 2026-10-29:原实现每次开机都写一条 reboot_time —— EasyFlash 是追加式 KV,
+         * 每次写占一条记录并推动扇区轮换/GC,属持续写放大。开机次数对精度要求不高,
+         * 改为每 10 次落盘一次(落盘值 1,11,21…,断电最多倒退 9 次计数)。 */
         device_status.rebootcnt++;
-        ef_set_env_blob("reboot_time", &device_status.rebootcnt, sizeof(device_status.rebootcnt));
+        if ((device_status.rebootcnt % 10) == 1)
+        {
+            ef_set_env_blob("reboot_time", &device_status.rebootcnt, sizeof(device_status.rebootcnt));
+        }
         LOG_I("rebootcnt:%d",device_status.rebootcnt);
         LOG_I("iSave:%d",device_status.iSave);
     }
@@ -3434,6 +3443,48 @@ void Check_ParamConfig(void)
         LOG_W("heat_sw加热开关:%d",device_status.heat_sw);
     }
 
+    /* ===== 开机 Flash 参数加载耗时打点(2026-10-29 新增)=====
+     * 终点必须落在"参数读取/默认值写入"结束处:下方还有等待联网循环(最长 3 分钟)
+     * 与 dtu_data_play(),若放到函数末尾,测到的将是联网等待时间而非参数加载时间。
+     * 口径(本机 RT_TICK_PER_SECOND=1000,1 tick = 1ms):
+     *   boot_param_ms = rt_tick 起点(板级初始化) → 参数加载完成,含前段全部 INIT_EXPORT,
+     *                   即上报字段 bootlt(对"开机慢"最直观);
+     *   param_load_ms = 进入本函数 → 参数加载完成,即 Flash 读取/默认值写入自身耗时。 */
+    {
+        rt_tick_t load_t1 = rt_tick_get();
+        ef_boot_diag_t efdiag;
+#if RT_TICK_PER_SECOND == 1000
+        device_status.boot_param_ms = (rt_uint32_t)load_t1;
+        device_status.param_load_ms = (rt_uint32_t)(load_t1 - load_t0);
+#else
+        device_status.boot_param_ms = (rt_uint32_t)(((rt_uint64_t)load_t1 * 1000UL) / RT_TICK_PER_SECOND);
+        device_status.param_load_ms = (rt_uint32_t)(((rt_uint64_t)(load_t1 - load_t0) * 1000UL) / RT_TICK_PER_SECOND);
+#endif
+        /* EasyFlash 重建诊断(2026-10-29):把原先"静默格式化扇区"的行为变成可观测指标。
+         * 扇区头非法 → ef_env.c 的 check_sec_hdr_cb() 会当场擦 4KB 并重写头,是开机
+         * 参数加载慢的直接原因(详见 doc/readme.md 同日条目)。 */
+        ef_env_get_boot_diag(&efdiag);
+        device_status.ef_fmt_cnt      = (efdiag.format_cnt > 0xFFFFU) ? 0xFFFFU : (uint16_t)efdiag.format_cnt;
+        device_status.ef_fmt_fail_cnt = (efdiag.format_fail_cnt > 0xFFFFU) ? 0xFFFFU : (uint16_t)efdiag.format_fail_cnt;
+
+        LOG_I("开机参数加载耗时: boot=%lu ms(含前段初始化), load=%lu ms, EF重建扇区:%u 失败:%u",
+              (unsigned long)device_status.boot_param_ms,
+              (unsigned long)device_status.param_load_ms,
+              (unsigned)device_status.ef_fmt_cnt,
+              (unsigned)device_status.ef_fmt_fail_cnt);
+        if (device_status.boot_param_ms > BOOT_PARAM_SLOW_MS)
+        {
+            LOG_W("开机参数加载超时(%lu ms > %lu ms),待上报预警",
+                  (unsigned long)device_status.boot_param_ms,
+                  (unsigned long)BOOT_PARAM_SLOW_MS);
+        }
+        if (device_status.ef_fmt_fail_cnt != 0)
+        {
+            LOG_W("EF 扇区擦写失败(%u 个),擦不干净会在每次开机重复格式化,待上报预警",
+                  (unsigned)device_status.ef_fmt_fail_cnt);
+        }
+    }
+
     {
         device_status.update_flag = 0;
         //初始化联网状态

+ 42 - 0
Application_CBD/applications/param_mirror.c

@@ -13,6 +13,11 @@
 #include "control.h"
 #include "dtu_uart2.h"      /* dtu_request_param_backup:参数变更→备份到RTU 的触发接口 */
 
+/* 2026-10-29 修复:本文件原来缺 DBG_ENABLE —— rtdbg.h:69 只有在 DBG_ENABLE 定义时
+ * 才展开 dbg_log_line,否则 LOG_x 全部退化为空宏。也就是说本模块自建立起所有日志
+ * (含 LOG_W("param mirror save failed") 等失败告警)都从未输出过,参数镜像写失败
+ * 在现场完全不可见。补上后镜像擦/写异常才能被日志和上报捕获。 */
+#define DBG_ENABLE
 #define DBG_TAG "param_mirror"
 #define DBG_LVL DBG_LOG
 #include <rtdbg.h>
@@ -168,6 +173,43 @@ int param_mirror_load(param_payload_t *dst)
     return RT_EOK;
 }
 
+/* 擦除两个镜像槽(2026-10-29 新增,供远程擦除 Flash 指令使用)。
+ * 关键:擦完必须把 s_last_valid 清掉 —— 否则后续 param_mirror_sync() 会因
+ * "内容与上次相同"直接 return,镜像将永久为空,防丢保护静默失效。 */
+int param_mirror_erase_all(void)
+{
+    if (s_part == RT_NULL)
+    {
+        s_part = fal_partition_find(MIRROR_PART_NAME);
+        if (s_part == RT_NULL)
+        {
+            return -RT_ERROR;
+        }
+    }
+
+    mirror_lock();
+
+    /* 两个槽各占一个 4KB 扇区且相邻,但分两次擦以兼容 blk_size 校验 */
+    if (fal_partition_erase(s_part, MIRROR_SLOT_A_ADDR, MIRROR_SLOT_SIZE) < 0)
+    {
+        LOG_W("mirror erase slot A failed");
+        mirror_unlock();
+        return -RT_ERROR;
+    }
+    if (fal_partition_erase(s_part, MIRROR_SLOT_B_ADDR, MIRROR_SLOT_SIZE) < 0)
+    {
+        LOG_W("mirror erase slot B failed");
+        mirror_unlock();
+        return -RT_ERROR;
+    }
+
+    s_last_valid = RT_FALSE;    /* 清 RAM 缓存:下一次 sync 必定重新落盘 */
+    mirror_unlock();
+
+    LOG_I("param mirror erased (slot A/B)");
+    return RT_EOK;
+}
+
 int param_mirror_save(const param_payload_t *src)
 {
     if (src == RT_NULL)

+ 19 - 3
Application_CBD/applications/param_mirror.h

@@ -65,10 +65,15 @@ typedef struct __packed {
 #define PARAM_PAYLOAD_VER     0x00010001U   /* bump on incompatible change */
 
 /* Mirror slot layout (one 4096-byte sector per slot).
- * Place the mirror after ENV_AREA_SIZE (1MB) and LOG_AREA_SIZE (8KB),
- * inside the 3MB "easyflash" FAL partition. */
+ * Place the mirror after ENV_AREA_SIZE (64KB) and LOG_AREA_SIZE (8KB),
+ * inside the 3MB "easyflash" FAL partition.
+ *
+ * 2026-10-29:ENV_AREA_SIZE 由 1MB 降为 64KB(见 EasyFlash 的 ef_cfg.h),
+ * 而 ef_log.c:101 的日志区起始 = EF_START_ADDR + ENV_AREA_SIZE,会随之从
+ * 0x100000 前移到 0x10000。镜像必须同步前移,否则会落在日志区里被互相破坏。
+ * 布局:ENV 0x00000~0x10000 | LOG 0x10000~0x12000 | 镜像A 0x12000 | 镜像B 0x13000 */
 #define MIRROR_SECTOR_SIZE    4096U
-#define MIRROR_BASE_OFFSET    (1UL * 1024UL * 1024UL + 8UL * 1024UL)  /* 0x102000 */
+#define MIRROR_BASE_OFFSET    (64UL * 1024UL + 8UL * 1024UL)  /* 0x12000 */
 #define MIRROR_SLOT_SIZE      MIRROR_SECTOR_SIZE
 #define MIRROR_SLOT_A_ADDR    (MIRROR_BASE_OFFSET)
 #define MIRROR_SLOT_B_ADDR    (MIRROR_BASE_OFFSET + MIRROR_SLOT_SIZE)
@@ -82,6 +87,17 @@ typedef struct __packed {
 int param_mirror_load(param_payload_t *dst);
 
 /**
+ * Erase both mirror slots and invalidate the in-RAM "last payload" cache.
+ *
+ * 2026-10-29 新增(供远程擦除 Flash 指令使用)。**必须清缓存**:本模块用
+ * s_last_payload/s_last_valid 做写放大抑制,若只擦 Flash 不清缓存,后续
+ * param_mirror_sync() 会因"内容未变化"直接返回,镜像将永久为空、失去防丢保护。
+ *
+ * @return RT_EOK on success.
+ */
+int param_mirror_erase_all(void);
+
+/**
  * Atomically store src to the mirror. Writes to the older slot first,
  * verifies, then writes to the other slot. Bumps write_seq so the next
  * load prefers the freshly written copy.

+ 194 - 0
Application_CBD/doc/readme.md

@@ -1,3 +1,197 @@
+# 2026-10-29 更新说明(dtu_uart2 新增远程擦除 Flash 指令 eraseflash + 顺带修复 param_mirror 日志全失效)
+
+		版本:VERSION_HK      1.85.41(HK)     -> 1.86.41(HK)
+		      VERSION_HK_2000W 1.85.40(2000W)  -> 1.86.40(2000W)
+		      VERSION_ZP      1.85.1(ZP)       -> 1.86.1(ZP)
+		      VERSION_GK      1.85.1(GK)       -> 1.86.1(GK)
+		      VERSION_BZY     2.72             -> 2.73
+		      VERSION_XCT     1.13.6(HK)       (吸虫塔未改动,保持不变)
+		编译:text 253340B / data 2468B / bss 47404B(arm-none-eabi-gcc 6.3.1,全量重编 176 条命令,
+		      连续两次结果一致,0 错误);相对 1.85.41(250292/2468/47404,bin 252760B)
+		      净增 text +3048B(其中 param_mirror 补 DBG_ENABLE 让该模块日志复活占约 +712B,
+		      其余为 eraseflash 指令通道与擦除实现);
+		可烧录镜像 bin/Application_CBD-1.86.41-20261029.bin(255808B),
+		带符号 elf 见 Debug/Application_CBD-1.86.41-20261029.elf。
+	1、applications/dtu_uart2.c —— 新增远程擦除 Flash 指令(RTU 透传下发):
+		指令:{"cmd":"eraseflash","ext":{"target":"env"}}
+		      {"cmd":"eraseflash","ext":{"target":"chip","confirm":"ERASE"}}
+		① target="env"(缺省值)—— 只擦"参数存储",耗时 <1s,不碰任何固件区:
+		   - 先擦参数镜像两槽(param_mirror_erase_all),**必须最先**:否则重启后
+		     Check_ParamConfig 走 iSave 丢失路径时 param_mirror_load() 会把旧参数整份
+		     搬回来,"恢复出厂"直接落空;
+		   - 再整块擦 EasyFlash ENV 区(fal_partition_erase(0, ENV_AREA_SIZE=64KB));
+		     这里**故意不调用 ef_env_set_default()**:它写的是字符串型默认值("20"/"0xAA"…),
+		     而本工程用 ef_get_env_blob 按二进制读,读出来是 ASCII 码而非数值;
+		     直接擦净,重启后由 Check_ParamConfig 用代码内默认值重建,语义最干净;
+		   - 最后清 EF 日志区;调用前先 easyflash_init() 确认 EF 可用(幂等),
+		     避免 EF 从未初始化成功时用 log_area_start_addr=0 去擦。
+		   用途:这是"开机参数加载慢"的**远程**处置手段,替代现场执行 sf bench yes。
+		② target="chip"(危险档)—— 片外 SPI NOR 整片擦除(本板 16MB),
+		   必须带 confirm="ERASE",否则直接拒绝并回执。按 erase_gran 向上对齐分块
+		   (默认 64KB),每块擦完显式喂狗。会连带擦掉 fm_area 与 df_area,
+		   其中 df_area 是 OTA 回滚副本(app_partion_backup 仅 version_type==0 时重建)。
+		   耗时数十秒~数分钟,期间 RTU 下行数据来不及读(可能丢帧/RTU 超时重试),
+		   属破坏性维护操作的预期代价。
+		③ 安全边界:片内 Flash(bl / app,固件自身所在的 onchip_flash)**任何档位都不擦**,
+		   故本指令不存在把设备擦成砖的路径。target 走白名单校验,不认识的档位一律拒绝,
+		   不做"猜你要擦哪"的兜底。
+		④ 执行流程:回执 "flash erase start:<target>" → 执行 → 回执
+		   "flash erase done:<target> (<秒>s)" 或 "flash erase failed:<target> (<秒>s)";
+		   先回 start 是因为擦除期间接收线程无法处理其它下行指令,避免平台误判无响应。
+		   两档成功后均 rt_hw_cpu_reset(),重启时 Check_ParamConfig 按"ENV 无 iSave"
+		   路径重建全套默认参数;version_type 会回到默认 4,机型需屏幕 Swversion 握手
+		   (hmi_switch_version)或平台参数下发恢复。
+		⑤ 分支位置:插入在 "reboot" 之前,并已用脚本(build/check_branch_order.py)
+		   机器化校验双向不吞噬 —— 前置 5 个 strstr 分支(takephoto/shake/ctrl/platform/
+		   mvs_photo)均不匹配 "eraseflash",本分支也不吞后续 11 个分支
+		   (reboot/reset/update/read/poweron/poweroff/log/sensor/color/synchronization/
+		   paramconf)。之所以要校验:本工程历史上出现过"过宽前置分支吞掉后续分支"
+		   导致整段代码不可达的缺陷。
+	2、applications/dtu_uart2.h —— 补充上述指令的协议说明与回执格式,供平台侧对接。
+	3、applications/param_mirror.c / .h —— 新增 param_mirror_erase_all():
+		擦两个镜像槽,并**把 s_last_valid 清零**。不清的后果:本模块用"内容与上次相同
+		则跳过擦写"抑制写放大,擦掉 Flash 后若缓存仍认为有效,后续 param_mirror_sync()
+		会永远直接 return,镜像永久为空、防丢保护静默失效。
+	4、顺带修复(既有缺陷,本次排查中发现):applications/param_mirror.c 缺
+		**#define DBG_ENABLE**。rtdbg.h:69 只有 DBG_ENABLE 定义时才展开 dbg_log_line,
+		否则 LOG_x 全部退化为空宏 —— 也就是说本模块自建立起所有日志都从未输出过,
+		包括 LOG_W("param mirror save failed")、LOG_W("mirror write newer slot ... failed")
+		等失败告警,参数镜像写失败在现场完全不可见。补上后这些告警才会真正打印。
+		(验证方式:补前 param_mirror.o 中搜不到任何日志字符串、反汇编该函数无 rt_kprintf
+		 调用;补后 "param mirror erased"/"param mirror save failed" 均进入镜像。)
+	5、验证:
+		① 全量重编(touch 2172 个源文件)176 条命令 0 失败、尺寸连续两次一致;
+		② 本次改动文件 0 新增告警(19 条与 1.85.41 完全一致,行号位移而已);
+		③ 镜像内已确认含 "eraseflash" / "flash erase start:%s" / "flash erase %s:%s" /
+		   "flash erase rejected: unknown target %s" / "need confirm=ERASE" /
+		   "param mirror erased" / "param mirror save failed" / "1.86.41(HK)";
+		④ 反汇编 param_mirror_erase_all 确认功能正确:依次擦 0x12000 与 0x13000 各 4096
+		   字节(对应镜像槽 A/B),随后 s_last_valid 置 0、加锁/解锁配对正确;
+		⑤ 指令分支吞噬风险由 build/check_branch_order.py 双向校验通过。
+	6、待上机验证(未执行):
+		① {"cmd":"eraseflash","ext":{"target":"env"}} → 应见 start/done 两条回执、
+		   设备重启、参数回出厂默认(机型由屏幕握手切回);
+		② 不带 confirm 下发 target="chip" → 应被拒绝且设备**不**重启;
+		③ 带 confirm 下发 chip → 擦除期间看门狗不复位(喂狗正常),完成后重启;
+		④ 擦除 env 后再次重启,bootlt/bootef 均应正常(bootef 归 0);
+		⑤ 平台侧确认两条回执(走 cmd=warn、type="device" 通道)能被正确解析。
+# 2026-10-29 更新说明(开机参数加载慢根治:ENV 区 1MB→64KB + EF 重建诊断上报 + 减少写放大)
+
+		版本:VERSION_HK      1.84.41(HK)     -> 1.85.41(HK)
+		      VERSION_HK_2000W 1.84.40(2000W)  -> 1.85.40(2000W)
+		      VERSION_ZP      1.84.1(ZP)       -> 1.85.1(ZP)
+		      VERSION_GK      1.84.1(GK)       -> 1.85.1(GK)
+		      VERSION_BZY     2.71             -> 2.72
+		      VERSION_XCT     1.13.6(HK)       (吸虫塔未改动,保持不变)
+		编译:text 250292B / data 2468B / bss 47404B(arm-none-eabi-gcc 6.3.1,全量重编 176 条命令,
+		      连续两次结果一致,0 错误);相对 1.84.41(249580/2468/47388,bin 252048B)
+		      净增 text +712B / bss +16B(bss 为 ef_env.c 两个静态计数 + device_status 两个 uint16);
+		可烧录镜像 bin/Application_CBD-1.85.41-20261029.bin(252760B),
+		带符号 elf 见 Debug/Application_CBD-1.85.41-20261029.elf。
+	【本次针对现场问题:开机 Flash 参数加载慢(>10s),用户执行 `sf bench yes` 整片擦除后恢复】
+	1、根因(代码取证,非 Flash 硬件损坏):
+		① packages/EasyFlash-latest/inc/ef_cfg.h 的 ENV_AREA_SIZE 原为 EF_ERASE_MIN_SIZE*256
+		   = 1MB = 256 个 4KB 扇区(官方推荐 2 个扇区;同行注释还留着"2024-07-10 2 to 16");
+		② ef_env.c 的 ef_load_env() 启动时用 sector_iterator() 遍历"全部" SECTOR_NUM 个扇区,
+		   而且要走两遍(check_sec_hdr_cb + check_and_recovery_gc_cb);
+		③ 致命点:check_sec_hdr_cb() 对每个"扇区头 magic 不匹配"的扇区当场 format_sector()
+		   = 擦 4KB + 重写扇区头,且原实现"忽略返回值"——擦写失败也毫无痕迹,下次开机重来;
+		④ 本工程实际只用第 0 个扇区(默认 50 个 key ≈ 3KB),其余 255 个扇区长期为未格式化
+		   空区/历史遗留数据 → 每个都触发 format。4KB 扇区擦除典型 45ms(厂商手册量级,
+		   未在本板实测)→ 256 个 ≈ 11.5s,与现场"10s+"吻合;擦不干净的扇区则每次开机重复擦,
+		   形成"常态性变慢且无任何报错"。
+		⑤ `sf bench yes` 的实际动作(rt-thread/components/drivers/spi/spi_flash_sfud.c:706-780)
+		   是"整片 16MB 擦除 → 整片写 0x55 → 读回校验":擦完后 EF 发现全部扇区头非法,
+		   触发 ef_env_set_default() 一次性重建全部扇区头(那一次开机其实最慢),之后每次
+		   开机所有头都合法 → 不再擦除 → 恢复正常。这就是"擦完就好了"的机理。
+		⑥ 附带损失(现场需知):`sf bench yes` 同时擦掉了 fm_area / df_area,其中 df_area 是
+		   OTA 固件回滚副本(hmi.c app_partion_backup() 仅在 version_type==0 时自动重建);
+		   参数也已回默认值(version_type 回到 4),需确认屏幕 Swversion 握手后版本类型被切回。
+	2、packages/EasyFlash-latest/inc/ef_cfg.h —— ENV_AREA_SIZE 由 (EF_ERASE_MIN_SIZE*256) 改为
+	   (EF_ERASE_MIN_SIZE*16) = 64KB、16 个扇区。50 个 key ≈ 3KB,64KB 足够 GC 周转;
+	   最坏擦除量由 256 扇区降到 16 扇区(≈11.5s → ≈0.7s)。
+	3、applications/param_mirror.h —— **联动必改**:ef_log.c:101 的日志区起始 =
+	   EF_START_ADDR + ENV_AREA_SIZE,ENV 缩小后日志区由 0x100000 前移到 0x10000,
+	   镜像基址 MIRROR_BASE_OFFSET 同步由 (1MB+8KB)=0x102000 改为 (64KB+8KB)=0x12000,
+	   否则镜像槽会落进日志区、被 ef_log 擦除互相破坏。
+	   新布局:ENV 0x00000~0x10000 | LOG 0x10000~0x12000 | 镜像A 0x12000 | 镜像B 0x13000。
+	4、packages/EasyFlash-latest(inc/easyflash.h + src/ef_env.c)—— 新增开机重建诊断:
+		① 新增 ef_boot_diag_t { format_cnt, format_fail_cnt } 与 ef_env_get_boot_diag();
+		② check_sec_hdr_cb() 改为检查 format_sector() 返回值:成功/失败分别计数,
+		   失败时打印 "Format sector (0x...) failed (code N). It will be retried on next boot.";
+		③ ef_load_env() 入口清零计数(每次加载重新统计)。
+		这样原先"静默格式化扇区"的行为变成可观测、可上报的指标。
+	5、applications/hmi.c —— Check_ParamConfig() 采集诊断并打印:
+		"开机参数加载耗时: boot=.. load=.., EF重建扇区:N 失败:M";失败数非 0 时 LOG_W 提示待上报。
+	6、applications/hmi.c —— reboot_time 写放大治理:原实现每次开机都 ef_set_env_blob 一条
+	   (EasyFlash 为追加式 KV,每次写占一条记录并推动扇区轮换/GC),改为每 10 次开机落盘一次
+	   (落盘值 1,11,21…,断电最多倒退 9 次计数)。
+	7、applications/dtu_uart2.c —— 上报与预警:
+		① 上报数据 ext 新增 "bootef":本次开机重建的扇区数,失败时形如 "16:3"(正常为 "0"),
+		   便于平台侧观察 ENV 区健康趋势;
+		② 新增预警(只报一次):ef_fmt_fail_cnt 非 0 时发
+		   {"cmd":"warn","ext":{"status":"ef sector format failed:M/N","type":"device"}}
+		   —— 扇区擦不干净属硬件/寿命问题,是"开机慢"的持续型根因,必须让平台看到。
+	8、applications/control.h —— 新增 device_status.ef_fmt_cnt / ef_fmt_fail_cnt(运行态,
+	   不写入 EF、不进镜像);版本号递增。
+	9、验证:全量重编(touch 2172 个源文件)176 条命令 0 失败、尺寸连续两次一致;
+	   镜像内已确认含 bootlt / bootef / "ef sector format failed" / "Format sector" /
+	   "EF重建扇区" / "1.85.41(HK)" 字符串。
+	   告警:本次改动文件 0 新增告警;因修改 easyflash.h 触发 ef_log.c 重编,首次暴露 3 条
+	   上游历史告警 "SECTOR_STATUS_HEADER_ERROR not handled in switch"(ef_log.c:285/301/323)——
+	   EasyFlash 4.1.99 自带问题,且本工程应用层从未调用 ef_log_*(日志区仅初始化扫描 2 个扇区),
+	   不影响功能,留待后续单独处理。
+	10、升级兼容性(现场设备从旧版本升级到本版本):
+		① 参数不受影响:50 个 key 一直在第 0 扇区,缩容后仍在读取范围内;
+		② 日志区、镜像槽位置变化 → 升级后首次开机日志区会重建一次、参数镜像会在新位置重建
+		   (旧位置 0x102000 的镜像读不到,iSave 正常时不触发恢复流程,无副作用);
+		③ 升级后首次开机 EF 会把 ENV 区剩余 15 个新扇区各格式化一次(≈0.7s),之后 bootef 应稳定为 0。
+	11、待上机验证:
+		① 正常开机日志 bootlt 应为数百 ms 级、EF重建扇区:0 失败:0,上报 ext.bootef = "0";
+		② 连续重启 5~10 次,确认 bootlt 与 bootef 保持稳定(不回退到 10s 级);
+		③ 人为破坏一个 ENV 扇区头(如 sf erase 某扇区),确认下次开机 EF重建扇区 计 1、
+		   bootlt 相应增加,且再下次开机恢复为 0;
+		④ 平台侧确认新增 bootef 字段解析;
+		⑤ 现场处置口径改为:开机参数加载慢时用 msh 的 `resetenv`(仅格式化 ENV 区,秒级),
+		   **不要用 `sf bench yes`**(会连同 fm_area/df_area 固件备份一起擦掉)。
+# 2026-10-29 更新说明(开机 Flash 参数加载耗时采集 + 数据上报 bootlt + 超 10s 预警)
+
+		版本:VERSION_HK      1.83.41(HK)     -> 1.84.41(HK)
+		      VERSION_HK_2000W 1.83.40(2000W)  -> 1.84.40(2000W)
+		      VERSION_ZP      1.83.1(ZP)       -> 1.84.1(ZP)
+		      VERSION_GK      1.83.1(GK)       -> 1.84.1(GK)
+		      VERSION_BZY     2.70             -> 2.71
+		      VERSION_XCT     1.13.6(HK)       (吸虫塔未改动,保持不变)
+		编译:text 249580B / data 2468B / bss 47388B(arm-none-eabi-gcc 6.3.1,全量重编 176 条命令,
+		      连续两次结果一致,0 错误、本次改动文件 0 新增告警);
+		可烧录镜像 bin/Application_CBD-1.84.41-20261029.bin(252048B),
+		带符号 elf 见 Debug/Application_CBD-1.84.41-20261029.elf。
+	1、applications/hmi.c(Check_ParamConfig)—— 新增开机参数加载耗时打点:
+		① 起点 = 函数入口 rt_tick_get();终点 = "参数读取/默认值写入"结束处。终点不能放到
+		   函数末尾:末尾还有等待联网循环(最长 3 分钟)与 dtu_data_play(),否则测到的是
+		   联网等待时间而非参数加载时间;
+		② boot_param_ms = rt_tick 起点(板级初始化,即上电后 tick=0)→ 参数加载完成,含前段
+		   全部 INIT_EXPORT,即上报字段 bootlt;
+		   param_load_ms = 进入 Check_ParamConfig → 参数加载完成,即 Flash 读取/默认值写入自身
+		   耗时(仅日志用,用于区分"前段初始化慢"还是"Flash 读慢");
+		③ 两者为 device_status 新增运行态字段,**不写入 EF、不进入 param_mirror 镜像**,
+		   因此不影响已有机型的参数布局与向后兼容;RT_TICK_PER_SECOND==1000 时 tick 即 ms,
+		   其余配置按 64bit 换算,避免溢出。
+	2、applications/dtu_uart2.c(makeJson)—— 上报数据 ext 新增字段 bootlt(字符串,单位 ms),
+		紧邻 blver/bltime;单独用 12 字节缓冲(函数内 utos[5] 仅够 4 位数字,>9999ms 会被截断)。
+	3、applications/dtu_uart2.c(dtu_periodic_report)—— 超阈值预警:
+		① 条件 boot_param_ms > BOOT_PARAM_SLOW_MS(10000ms),发一条
+		   {"cmd":"warn","ext":{"status":"boot param load slow:<ms>ms","type":"device"}},只报一次;
+		② 放在上报窗口末尾而非发送线程入口:入口处 RTU(Linux 侧)可能尚未启动,盲发会丢帧
+		   且不重试(与参数备份/恢复同一教训);组帧成功才置"已报"标志,组帧失败下次上报再试。
+	4、applications/control.h —— 新增 BOOT_PARAM_SLOW_MS 宏与 device_status 的
+	   boot_param_ms / param_load_ms 两个 rt_uint32_t 运行态字段;版本号递增。
+	5、验证:全量重编(touch 全部源码)176 条命令 0 失败、尺寸连续两次一致;
+	   本次改动文件 0 新增告警(19 条均为历史遗留:control.c/sht30_collect.c 未使用变量、
+	   selfcheck.h 空声明、dtu_uart2.c gettimeofday 隐式声明、hmi.c makeJson_Cam const 等)。
+	   待上机:① 正常开机应打印"开机参数加载耗时: boot=... load=...",上报 JSON 的 ext 含 bootlt;
+	   ② 人为拖慢加载验证 >10s 时应收到一次 warn(且仅一次);
+	   ③ 确认平台/RTU 侧对新增 bootlt 字段的解析(旧版本应忽略未知字段,不影响既有上报)。
 # 2026-10-27 更新说明
 1. 修复四情平台下发拍照指令立即执行清扫导致拍到推杆电机;
 # 2026-10-24 更新说明

+ 12 - 0
Application_CBD/packages/EasyFlash-latest/inc/easyflash.h

@@ -63,6 +63,18 @@ EfErrCode ef_set_and_save_env(const char *key, const char *value);
 EfErrCode ef_del_and_save_env(const char *key);
 #endif
 
+/* 开机加载诊断(2026-10-29 新增,仅 ef_env.c 的 NG 模式实现)
+ * 统计"最近一次 ef_load_env() 中扇区头校验失败、被重新 format_sector()"的情况。
+ *   format_cnt      : 本次加载执行 format_sector() 的次数(正常应为 0)
+ *   format_fail_cnt : 其中擦除或写头返回错误的次数(非 0 = 擦写真的失败,
+ *                     意味着硬件/寿命问题,且下次开机会再次重试 → 常态性变慢)
+ * 用途:把原先 check_sec_hdr_cb() 里"静默格式化"的行为变成可观测、可上报的指标。 */
+typedef struct {
+    uint32_t format_cnt;
+    uint32_t format_fail_cnt;
+} ef_boot_diag_t;
+void ef_env_get_boot_diag(ef_boot_diag_t *diag);
+
 #ifdef EF_USING_IAP
 /* ef_iap.c */
 EfErrCode ef_erase_bak_app(size_t app_size);

+ 9 - 1
Application_CBD/packages/EasyFlash-latest/inc/ef_cfg.h

@@ -92,7 +92,15 @@
 #define EF_START_ADDR             PKG_EASYFLASH_START_ADDR
 
 /* ENV area size. It's at least one empty sector for GC. So it's definition must more then or equal 2 flash sector size. */
-#define ENV_AREA_SIZE             (EF_ERASE_MIN_SIZE * 256) /* default is the double erase min size 2024-07-10 2 to 16*/
+/* 2026-10-29:256 扇区(1MB) -> 16 扇区(64KB)。原因见 doc/readme.md 同日条目:
+ *   ef_load_env() 会遍历全部 SECTOR_NUM 个扇区(且走两遍),而 check_sec_hdr_cb()
+ *   对每个"扇区头非法"的扇区当场 format_sector()(擦 4KB + 写头)。256 扇区时最坏
+ *   256 × ~45ms ≈ 11.5s,表现为"开机 Flash 参数加载慢",且失败时静默重试、每次开机重来。
+ *   本工程实际只用第 0 个扇区(默认 50 个 key ≈ 3KB),16 扇区(64KB) 足够 GC 周转,
+ *   最坏耗时降到 ≈0.7s。
+ *   警告:修改本值必须同步修改 param_mirror.h 的 MIRROR_BASE_OFFSET ——
+ *   ef_log.c:101 的日志区起始 = EF_START_ADDR + ENV_AREA_SIZE,会跟着前移。 */
+#define ENV_AREA_SIZE             (EF_ERASE_MIN_SIZE * 16)
 
 /* print debug information of flash */
 #ifdef PKG_EASYFLASH_DEBUG

+ 36 - 1
Application_CBD/packages/EasyFlash-latest/src/ef_env.c

@@ -199,6 +199,12 @@ typedef struct sector_cache_node *sector_cache_node_t;
 
 static void gc_collect(void);
 
+/* 开机加载诊断计数(2026-10-29 新增,对外由 ef_env_get_boot_diag() 读取)。
+ * 每次 ef_load_env() 入口清零,用于把 check_sec_hdr_cb() 里"静默格式化扇区"
+ * 的行为变成可观测指标,见 inc/easyflash.h 的 ef_boot_diag_t 说明。 */
+static uint32_t env_fmt_cnt = 0;
+static uint32_t env_fmt_fail_cnt = 0;
+
 /* ENV start address in flash */
 static uint32_t env_start_addr = 0;
 /* default ENV set, must be initialized by user */
@@ -1690,10 +1696,19 @@ static bool check_sec_hdr_cb(sector_meta_data_t sector, void *arg1, void *arg2)
 {
     if (!sector->check_ok) {
         size_t *failed_count = arg1;
+        EfErrCode fmt_result;
 
         EF_INFO("Warning: Sector header check failed. Format this sector (0x%08x).\n", sector->addr);
         (*failed_count) ++;
-        format_sector(sector->addr, SECTOR_NOT_COMBINED);
+        /* 2026-10-29:原实现忽略 format_sector 返回值 —— 擦除/写头失败时该扇区下次
+         * 开机仍非法,于是每次启动都重擦一遍(常态性变慢且毫无痕迹)。这里计数并报错。 */
+        fmt_result = format_sector(sector->addr, SECTOR_NOT_COMBINED);
+        env_fmt_cnt++;
+        if (fmt_result != EF_NO_ERR) {
+            env_fmt_fail_cnt++;
+            EF_INFO("Error: Format sector (0x%08x) failed (code %d). It will be retried on next boot.\n",
+                    sector->addr, fmt_result);
+        }
     }
 
     return false;
@@ -1746,6 +1761,10 @@ EfErrCode ef_load_env(void)
     struct sector_meta_data sector;
     size_t check_failed_count = 0;
 
+    /* 2026-10-29:每次加载重新统计(诊断计数,见 ef_boot_diag_t) */
+    env_fmt_cnt = 0;
+    env_fmt_fail_cnt = 0;
+
     in_recovery_check = true;
     /* check all sector header */
     sector_iterator(&sector, SECTOR_STORE_UNUSED, &check_failed_count, NULL, check_sec_hdr_cb, false);
@@ -1777,6 +1796,22 @@ __retry:
 }
 
 /**
+ * Get the boot diagnostics of the last ef_load_env().
+ * 2026-10-29 新增:供应用层(Check_ParamConfig)读取"本次开机重建了多少个扇区、
+ * 其中多少个失败",用于日志与云端上报,把静默故障变成可观测指标。
+ *
+ * @param diag output buffer
+ */
+void ef_env_get_boot_diag(ef_boot_diag_t *diag)
+{
+    if (diag == NULL) {
+        return;
+    }
+    diag->format_cnt = env_fmt_cnt;
+    diag->format_fail_cnt = env_fmt_fail_cnt;
+}
+
+/**
  * Flash ENV initialize.
  *
  * @param default_env default ENV set for user

+ 245 - 0
CBD_FOTA_BootLoader/.workbuddy/memory/2026-10-29.md

@@ -0,0 +1,245 @@
+# 2026-10-29
+
+## 任务:修复「bootloader 里 Flash 正常、跳转 APP 后 SFUD 探不到、EasyFlash 逐扇区格式化导致 APP 起不来」
+
+### 现象(用户日志)
+- bootloader 段:`[SFUD] Find a Winbond flash chip. Size is 4194304 bytes` + FAL/EasyFlash 全正常,版本 1.3.1。
+- 5s 倒计时后 78 个 `#`(= 78×4KB = 312KB,即 fm_area→app 的整包搬运/或 app→df_area 备份),随即跳转。
+- APP 段:`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-格式化-擦-写-读」四次 assert 全失败 → 启动被拖成分钟级。
+
+### 排查(关键:两工程逐文件对比,排除法)
+- `drivers/drv_spi.c`(含 `stm32_spi_init` 强制 `State=HAL_SPI_STATE_RESET` 后再 `HAL_SPI_Init`)、
+  `drivers/board.c::HAL_SPI_MspInit`(PA5/PA7=AF_PP、PA6=INPUT、SPI1 时钟)、
+  CS 引脚(都是 `rt_hw_spi_device_attach("spi1","spi10",GPIOA,GPIO_PIN_4)`)、FAL 移植层、分区表:
+  **bootloader 与 Application_CBD 完全一致**。
+- 速度差异方向相反:bootloader `RT_SFUD_SPI_MAX_HZ=50MHz`(72/64MHz→/2≈32MHz),
+  APP `=24MHz`(→/4=18MHz)→ **APP 更慢,排除"速度过快"**。
+- 时钟源不同(bootloader `clk_init(HSI…)`,APP `SystemClock_Config()` HSE×9),但 SPI 预分频由
+  `RT_SFUD_SPI_MAX_HZ` 夹住,两侧都远低于 W25Q 上限,非致因。
+- 结论:**只有"交接瞬间的外设/芯片状态"变化**。`HAL_DeInit()` 实测(libraries/STM32F1xx_HAL_Driver/Src/
+  stm32f1xx_hal.c:175)先 `__HAL_RCC_APB2_FORCE_RESET()`(GPIOA/SPI1/AFIO 复位 → PA4/PA5/PA7 变浮空输入,
+  ODR=0),`HAL_MspDeInit` 为空实现;到 APP 的 `HAL_SPI_MspInit` 重新配置引脚之间有几十毫秒悬空窗口。
+  悬空 /CS 被噪声拉低 + 时钟线毛刺会被 Flash 当指令打入(0xB9 深度掉电 / 0x38 QPI),
+  之后标准 SPI 只能读到 0xFF/0x00 —— 与 APP 侧日志完全吻合。本次跳转前刚做过 312KB 的 Flash 搬运,
+  正好处于最不利时序。
+
+### 改动(v1.3.2 / COMPILE 20261029)
+- `applications/rt_fota.c`
+  - 新增 `rt_fota_spi_flash_quiesce()`:等 SR.BUSY 清零(≤1s)→ 0xFF×8 逃逸 QPI/连续读 →
+    0xAB 释放深度掉电 → 0x66/0x99 器件复位 → 读 JEDEC ID 打印自检
+    (`SPI flash handover: SR=0x00 JEDEC ID=0xEF4015`)。**放在 `__disable_irq()` 之前**
+    (rt_spi_* 依赖总线互斥量与 `rt_thread_mdelay`)。
+  - 新增 `rt_fota_spi_pins_safe_state()`:**在 HAL_DeInit/HAL_RCC_DeInit 之后**(否则被 APB2 复位冲掉)
+    先写 BSRR=0xF0 再改 CRL:PA4 推挽输出高(不选中),PA5/6/7 上拉输入。
+    APP 的 `HAL_GPIO_Init` 不改 ODR,因此 /CS 从跳转到 SFUD 探测全程高电平。
+  - 去掉重复的第二次 `HAL_DeInit()`。
+- `applications/sys_config.h`:`RT_FOTA_SW_VERSION` 1.3.1 → 1.3.2;`main.c`:COMPILE → 20261029。
+- `readme.md`:新增「版本说明 2026-10-29(第七次)」。
+
+### 验证
+- 全量重编(`D:\RT-ThreadStudio\workspace\.bl_src_backups\build_bl.py`)0 失败 0 告警;
+  text 168716 / data 2132 / bss 8560 / bin **170848**B(v1.3.1 基线 170016B)。
+- 反汇编核对 `rt_fota_start_application`:`quiesce` → `cpsid i` → NVIC/SysTick 清理 →
+  `HAL_DeInit` → `HAL_RCC_DeInit` → `pins_safe_state` → `msr MSP` → `msr CONTROL` → `cpsie i` → 跳转,顺序正确。
+- `rt_fota_spi_pins_safe_state` 反汇编:APB2ENR|=4、BSRR=0xF0、CRL 清 bit19:16 置 0x30000(PA4 输出 PP)、
+  清 bit31:20 置 0x88800000(PA5/6/7 上拉输入),与源码意图一致。
+
+### 待上机验证
+1. 串口看跳转前是否打印 `SPI flash handover: SR=0x00 JEDEC ID=0xEF4015`(读不到即总线/芯片异常)。
+2. 跳转后 APP 的 SFUD 是否恢复正常(不再出现 SFDP/JEDEC 失败与 EasyFlash 逐扇区格式化)。
+3. 若仍失败:APP 侧再加兜底(探测失败时强制 `HAL_SPI_MspInit` + 重试一次),
+   并核对 APP 当前 `rtconfig.h`(`FAL_USING_NOR_FLASH_DEV_NAME "MYFLASH16"` / `PKG_USING_FAL_LATEST_VERSION`
+   与设备上运行固件打印的 `w25q16m` / FAL v0.5.0 不一致,说明设备上的 APP 不是当前工作树编出来的)。
+
+### 备份
+`D:\RT-ThreadStudio\workspace\.bl_src_backups\backup_20261029_1606_batch6\`(rt_fota.c / sys_config.h / main.c / readme.md / rtthread.bin)
+
+---
+
+## 任务 2:长耗时 Flash 操作喂狗(v1.3.3)
+
+### 判断依据
+- IWDG 由 syswatch 在启动阶段开启:`syswatch_wdt_startup()` → `WDT_SET_TIMEOUT(10)` + `WDT_START`;
+  `drv_wdt.c` 用 `IWDG_PRESCALER_256`、`Reload = 10 * LSI_VALUE(40000) / 256 = 1562` → **超时 10s**。
+  IWDG 一旦启动无法停止,只能靠喂狗续命。
+- 原来 backup/restore/擦除都是「整块」交给 FAL:`fal_partition_erase(df_area, 4KB, 312KB)` 在 NOR 上
+  要逐 4KB 扇区擦 78 次 —— W25Q 单扇区擦除 tSE 典型 45ms / 最大 400ms,一次调用就是 3.5s(典型)/
+  **31s(最坏)**,中途无任何喂狗机会 → 10s 超时必然复位;复位后 DR2 残留 0xDEAD 会再触发回滚,放大故障。
+- 已排除 syswatch 主动复位这一路:`syswatch_check_timeout` 只在 syswatch 线程每秒循环里自增 sec_cnt,
+  且每次切到 idle 线程就清零;backup 中有大量阻塞 I/O 让出 CPU,`SYSWATCH_EXCEPT_TIMEOUT=60s` 不会命中。
+  所以复位来源就是 IWDG 硬件超时。
+
+### 改动(v1.3.3 / COMPILE 20261029)
+- `rt_fota.c` 新增 `rt_fota_wdt_feed()`(导出到 `rt_fota.h`):
+  **只有 `IWDG->PR`/`IWDG->RLR` 非复位值 0 时才喂** —— IWDG 只要写一次 KR(0xAAAA) 就启动且无法停止,
+  对未启动的 IWDG 喂狗会把 10s 看门狗凭空带进 APP 运行期。每次读两个寄存器判断,不做一次性缓存。
+- `rt_fota.c` 新增 `rt_fota_erase_chunked(part, addr, size)`:按 4KB 分块擦、每块后喂狗。
+  4KB 同时是 NOR 扇区粒度与 onchip 页(2KB)的整数倍,两种介质都安全(onchip 驱动
+  `stm32_flash_erase_bank` 内部再按 16 页分块关中断,传 4KB 即 2 页)。
+- 调用点:`rt_fota_backup_app_to_df`(擦头后 / 读 CRC 循环 / 擦数据区 / 写循环,写循环喂在 HMI_WRITE 之前)、
+  `rt_fota_restore_app_from_df`(读循环 / 擦 APP / 写循环)、`rt_fota_erase_app_part`(升级擦 APP)、
+  `rt_fota_write_app_part`(升级搬运写)、msh `fota clone`、`main.c` 的 `eraseapp` / `erasedf_area`。
+- 时序核算:单块最坏 400ms(擦)+48ms(写 4KB=16 页×3ms) ≈ 450ms,对比 10s 超时有 20 倍以上余量。
+
+### 验证
+- 全量重编 0 失败 0 告警;text 169100 / data 2132 / bss 8568(+8,wdt_dev 静态句柄),bin **171232**B。
+- 反汇编 `rt_fota_wdt_feed`:`IWDG_BASE=0x40003000`,读 `[+4]`=PR、`[+8]`=RLR,两者为 0 直接返回;
+  否则 `rt_device_find("wdt")` + `rt_device_control(dev, 4, NULL)`(4 = `RT_DEVICE_CTRL_WDT_KEEPALIVE`,已核对 watchdog.h)✓
+- 符号表确认 `rt_fota_erase_chunked` / `rt_fota_wdt_feed` 均未被优化掉。
+
+### 备份
+`D:\RT-ThreadStudio\workspace\.bl_src_backups\backup_20261029_1630_batch7\`
+
+---
+
+## 任务 3:为什么"没触发升级、只断电重启"却跑 rt_fota_backup_app_to_df(v1.3.4)
+
+### 用户质疑(很关键,推翻了我上一轮的一个判断)
+上一轮我把日志里 78 个 `#` 判为"fm_area→app 的 312KB 搬运",用户指出**根本没下发升级包,只是断电重启**。
+
+### 真正的因果链(已逐行核对代码)
+backup 只有两个调用点:`main.c:181`(uart4 `backupapp` 命令)、`rt_fota_thread_entry` 的升级分支。
+排除了手动命令,就只能是**升级判定误入**:
+
+1. `rt_fota_part_fw_verify(fm_area)` 通过 —— fm_area 里确实躺着一个**完整有效的 RBL 包**
+   (校验很严:head CRC + `type=="RBL"` + app 分区存在 + 全包 body CRC,所以不是读到 0xFF 蒙过)
+2. `rt_fota_check_upgrade()` 比较 `fota_part_head.download_version` vs `current_version`(两者都来自
+   fm_area 的 RBL 头)→ 不等即"需升级"
+3. **唯一把 current 对齐成 download 的 `rt_fota_copy_version()` 在 `rt_fota_upgrade()` 之后**
+   → 只要 upgrade 失败/被打断,copy_version 永不执行 → 包永远"待升级"
+4. → **每次上电都重跑**:backup(312KB 读 + 擦 78 扇区 + 写 312KB) → upgrade(擦写 312KB) → …
+   而 backup 的擦除正好是上一批修的 IWDG 超时点 → 擦到一半复位 → 更不可能走到 copy_version
+   → **自锁死循环**
+
+所以顺序是:**某次升级没走完(很可能就是被 IWDG 打断)→ fm_area 包一直待升级 → 之后每次断电重启都重跑备份+升级**。
+
+### 放大因素(可观测性缺陷)
+`rt_fota_check_upgrade()` 的判据原本是 `LOG_D`,而 `DBG_LEVEL=DBG_INFO` → **根本不打印**。
+现场只能看到 backup 的打印,完全看不出"为什么升级",这也是我上一轮判断跑偏的原因之一。
+
+### 改动(v1.3.4 / COMPILE 20261029)
+- **升级重试熔断**:`fota_retry{cnt, ver[24]}` 存 EasyFlash(key `fota_retry`,掉电保持)。
+  `rt_fota_retry_allow()` 在 backup **之前**拦截:版本变化→计数归零(新包自动解禁);
+  `cnt >= 3` → 打印原因 + LED 回 shell 节奏 + 不再动 flash,直接跳 APP。
+  `rt_fota_retry_clear()` 仅在 upgrade + copy_version **都成功**后清零。
+  EF 记录被擦成 0xFF 时 cnt 会是垃圾值 → `cnt > 100` 视为无效并重置(防误永久禁用)。
+- `rt_fota_check_upgrade()` 判据改 `LOG_I` 并打印两侧版本;upgrade / copy_version 失败各自打印原因。
+- msh `fota retry` 查看熔断状态、`fota retry 0` 清零;`fota probe` 增加
+  `Applied version`(current_version) 与 `Upgrade pending`(YES/NO) 两行。
+
+### 验证
+- 全量重编 0 失败 0 告警;text 170644 / data 2132 / bss 8600,bin **172776**B。
+- 反汇编 `rt_fota_thread_entry` 顺序确认:
+  `fw_verify → check_upgrade → retry_allow → backup_app_to_df → upgrade → copy_version → retry_clear`
+  —— 熔断确实挡在 backup 之前。
+- `rt_fota_retry_allow` 反汇编:`cmp r3,#2` 即 `cnt>=3`(无符号),逻辑正确。
+
+### 现场处置建议(已写入 readme)
+`fota probe` 看 Upgrade pending → `fota retry` 看计数 → `fota retry 0` 后重新下发一次完整包(或擦 fm_area)。
+
+### 备份
+`D:\RT-ThreadStudio\workspace\.bl_src_backups\backup_20261029_1634_batch8\`
+
+---
+
+## 任务 4:生成《失效模式分析报告》docx(2026-10-29 16:40-16:51)
+
+### 产物
+- `output/8d0b86f9-406c-4915-bf25-5ba4c361904b/stage3/CBD_FOTA_BootLoader失效模式分析报告.docx`
+  (63KB,155 段 / 34 表 / 2 节,封面+目录+执行摘要+9 章)
+- 中间产物:`stage1/final_draft.md`(27KB)、`stage2/formatted-失效模式分析报告.html`(46KB)、`stage2/design_tokens.json`
+
+### 报告结构
+概述(含证据分级)→ 系统基线与失效背景(分区/启动流程/三个观测边界)→ FMEA 总表(S/O/D/RPN)
+→ FM-01/02/03 详析(现象-排查-根因-处置-验证状态)→ 共性根因与设计改进 → 残余风险 R-01~R-05
+→ 验证矩阵 V-01~V-06 → 附录(版本变更/关键参数/术语)。
+所有"未验证"项显式标注,不以构建通过替代板上验证。
+
+### 走的是 tencent-docx 全流水线(S1→S2→S3)
+- 路由:`tencent-docs-routing` → `tencent-docx` → `tdoc-orchestrator`,entry=full_pipeline
+- S1:doc-writer,genre=general(未命中 L2),general-writer,Critic skip(低风险档)
+- S2:doc-formatter,route=html_template,genre 推断 business-report → 主题 business-modern
+- S3:doc-converter,html-to-docx
+
+### 踩坑(重要,可复用)
+1. **Git Bash 传 `/c/...` 给 Windows 原生 exe(python.exe/uv)会被转成 `c:\c\...`** → 必须用 `C:/...` 正斜杠;同理 `cd /d/...` 后调用 exe 也有风险。
+2. **`setup-html-to-docx.sh` 在 Windows 上必然失败**:它用 `[ ! -x "$VENV_DIR/bin/python" ]` 判定 venv,
+   而 Windows venv 是 `Scripts/python.exe` → 每次 rm -rf 重建 → 第 4 步 `$PY -c` 失败 → `set -e` 退出 2。
+   **绕过**:手动 `uv venv --python 3.12 C:/Users/Administrator/.venv-html-to-docx`
+   + `uv pip install --python <venv>/Scripts/python.exe --only-binary=:all: -r requirements.txt`,
+   然后 `cd <skill>/scripts && <venv>/Scripts/python.exe -m html_to_docx convert in.html -o out.docx --page-size A4`。
+   依赖安装约 3.5 分钟(首次)。
+3. **html-review 门禁规则**(首检 33 分 → 修正后输出):
+   - 所有 `<table>` 必须同时有 `<thead>` 和 `<tbody>`(**连布局表/代码块表/封面信息表都要**)
+   - `margin/padding` 一律用 `var(--sp-*)`,`color`/`font-size` 一律用 `var()`,禁止裸值
+   - 每个 `<h2>` 后必须先有正文(p/table/ul)才能接 `<h3>`,否则 TQ-03 每条扣 10
+   - `<h2>` 数量 >10 触发 TQ-05 警告 → 把"目录"从 h2 改为 `p.toc-title`
+   - business-report 必须有 `.executive-summary` 容器(BR-01)
+   - 禁止 grid / dl / 装饰性 hr / span 模拟 badge;多段落底纹用裸单列 table
+4. 本机 bash 需 `export PATH=".../mingw64/bin:.../usr/bin:$PATH"`(**mingw64/bin 必须在 usr/bin 之前**,
+   否则 dirname 等 coreutils 找不到)。
+
+### 未做(如需可续)
+报告落盘在 output/<uuid>/stage3/ 下,未复制到工程根目录。若需归档到项目文档区,手工移动即可。
+
+---
+
+## 任务 5:`sf bench yes` 为何能修好"加载参数慢"(v1.3.5,2026-10-29 17:00-17:08)
+
+### 用户观测(关键,修正了前面两轮的判断)
+执行 msh `sf bench yes` → Flash 全片被擦写 → 启动恢复正常。能靠"擦全片"修好,
+说明**确实有持久化状态参与**,不是纯粹的瞬态芯片状态。
+
+### `sf bench yes` 到底做了什么(已核实源码 spi_flash_sfud.c:706)
+对整片依次执行:**擦除 4MB → 全片写入 0x55(不是 0xFF)→ 全片读校验**。
+
+一次性清掉三个持久化状态:
+| 区域 | 变化 | 后果 |
+|---|---|---|
+| fm_area | RBL 头 → 0x55555555 | 包校验必失败 → 不进升级分支 → 不再跑 backup |
+| df_area | 备份 magic → 0x55555555 | 无有效备份 → 不会自动回滚 |
+| easyflash | 扇区头 → 0x55555555 | 触发一次 `ef_env_set_default()` 重建 → 之后正常 |
+
+**副作用:EasyFlash 所有环境变量被重置为默认值**(含设备配置)。生产慎用。
+
+### "加载参数极慢"的真正机理(推翻了我此前"flash 操作耗时"的判断)
+1. SPI Flash 不可用 → SFUD 探测失败 → FAL 里 NOR 设备为空
+2. EasyFlash 仍会对 3MB 环境区 **768 个 4KB 扇区**逐个执行
+   `ef_env.c: check_sec_hdr_cb` → `format_sector()`(读头→判无效→擦→写头)
+3. FAL 的 `assert` 每失败一次就 `rt_kprintf` 一条(fal_def.h:67),加上 EasyFlash 自己的
+   `"Sector header check failed"` → **单扇区约 4~5 条日志,768 扇区近 4000 条**
+4. @115200(每字节约 87μs)→ 纯阻塞输出 **20~30 秒**
+
+**结论:慢的主因是日志洪水,不是 flash 操作本身。** 故障路径上的日志把故障放大了 4000 倍。
+
+### 改动(v1.3.5 / COMPILE 20261029 / bin 173172B)
+- `rt_fota.c` 新增 `rt_fota_nor_ready()`(导出 rt_fota.h):读 JEDEC ID,全 00/全 FF 判不可用
+- `main.c` + `rt_fota_thread_entry`:`easyflash_init()` 前加门禁,NOR 无响应则跳过并打印单条提示
+  - 收益:故障时启动 数十秒 → 毫秒级;**且避免误擦用户环境变量**(原来总线间歇异常时 format_sector 可能真擦掉配置)
+  - 安全:EasyFlash 未 init 时 `ef_set_env_blob` 内部有 init_ok 判据,返回 EF_ENV_INIT_FAILED 不崩溃(ef_env.c:1473)
+- `EasyFlash ef_env.c`:check_sec_hdr_cb 的 warning 限流(前 3 条 + 1 条汇总),失败计数照常累加不影响原有判定
+- **`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 处。
+
+### 验证
+- 全量重编 0 失败 **0 告警**(修完类型问题后);text 171040 / data 2132 / bss 8600;bin 173172B
+- 反汇编核对 `rt_fota_nor_ready`:发 0x9F(159)读 3 字节,逐字节判 0x00 / 0xFF ✓
+- 反汇编核对调用顺序:`main` 里 `nor_ready → easyflash_init`;`thread_entry` 同样 ✓
+- 备份:`backup_20261029_1707_batch9\`
+
+### 教训
+**增量构建会掩盖历史缺陷。** 之前几批只改 rt_fota.c/main.c,"0 告警"是增量结果;
+这次碰了公共头文件 fal_def.h,才把 fal_flash.c/fal_partition.c 里潜伏的类型错误翻出来。
+以后动公共头文件要预期会触发大面积重编与既有告警暴露。
+
+### 运维建议(已写入 readme)
+诊断顺序:`fota probe` → `fota retry` → 看日志有无 "Sector header check failed" → 再决定是否擦除。
+不要用 `sf bench yes` 清场(写全片 0x55,丢全部配置);精准手段是擦 fm_area/df_area 或 `eraseeasyflash`。
+
+
+
+

La diferencia del archivo ha sido suprimido porque es demasiado grande
+ 18 - 1
CBD_FOTA_BootLoader/.workbuddy/memory/MEMORY.md


+ 41 - 4
CBD_FOTA_BootLoader/applications/main.c

@@ -34,7 +34,7 @@
 #include <easyflash.h>
 
 #define BL_VERSION RT_FOTA_SW_VERSION
-#define COMPILE "20261013"
+#define COMPILE "20261029"
 
 #define RTU_DTU GET_PIN(B,13)
 #define Beep    GET_PIN(B, 4)
@@ -226,8 +226,21 @@ static void HMI_Decode(char *cmd,uint8_t cmd_len)
         fal_erase = fal_partition_find("app");
         if (fal_erase != RT_NULL)
         {
+            rt_uint32_t erased = 0, len;
             rt_kprintf("eraseapp: erase %s partition(%d bytes)...\n", fal_erase->name, fal_erase->len);
-            if (fal_partition_erase(fal_erase, 0, fal_erase->len) < 0)
+            /* 分块擦除 + 逐块喂狗:一次擦 312KB 的 onchip flash 需要数秒,
+             * 单次调用会长时间不给 IWDG 喂狗,导致擦到一半被看门狗复位 */
+            while (erased < (rt_uint32_t)fal_erase->len)
+            {
+                len = fal_erase->len - erased;
+                if (len > 4096)
+                    len = 4096;
+                if (fal_partition_erase(fal_erase, erased, len) < 0)
+                    break;
+                erased += len;
+                rt_fota_wdt_feed();
+            }
+            if (erased < (rt_uint32_t)fal_erase->len)
                 rt_kprintf("eraseapp failed!\n");
             else
                 rt_kprintf("eraseapp done.\n");
@@ -250,8 +263,21 @@ static void HMI_Decode(char *cmd,uint8_t cmd_len)
         fal_erase = fal_partition_find("df_area");
         if (fal_erase != RT_NULL)
         {
+            rt_uint32_t erased = 0, len;
             rt_kprintf("erasedf_area: erase %s partition(%d bytes)...\n", fal_erase->name, fal_erase->len);
-            if (fal_partition_erase(fal_erase, 0, fal_erase->len) < 0)
+            /* 分块擦除 + 逐块喂狗:512KB NOR 逐扇区擦最坏要几十秒,
+             * 一次性调用必然触发 IWDG 10s 超时复位 */
+            while (erased < (rt_uint32_t)fal_erase->len)
+            {
+                len = fal_erase->len - erased;
+                if (len > 4096)
+                    len = 4096;
+                if (fal_partition_erase(fal_erase, erased, len) < 0)
+                    break;
+                erased += len;
+                rt_fota_wdt_feed();
+            }
+            if (erased < (rt_uint32_t)fal_erase->len)
                 rt_kprintf("erasedf_area failed!\n");
             else
                 rt_kprintf("erasedf_area done.\n");
@@ -350,7 +376,18 @@ int main(void)
     finsh_set_prompt("rt-fota />");
 #endif
     extern void rt_fota_init(void);
-    easyflash_init();
+    /* v1.3.5:NOR 不响应时跳过 EasyFlash 初始化。
+     * EasyFlash 会对 3MB 环境区(768 个扇区)逐个做"读头-格式化"尝试,
+     * 在 SPI 不可用时这近 4000 条串口日志会把启动拖到数十秒,
+     * 且存在误擦用户环境变量的风险;未初始化时 ef_* 接口会安全返回失败。 */
+    if (rt_fota_nor_ready() != 0)
+    {
+        easyflash_init();
+    }
+    else
+    {
+        rt_kprintf("Skip EasyFlash init: NOR flash not available.\n");
+    }
     rt_fota_print_log();
     rt_fota_init();
     HMI_Thread();

+ 404 - 11
CBD_FOTA_BootLoader/applications/rt_fota.c

@@ -162,6 +162,64 @@ static void rt_fota_bkp_dr2_write(rt_uint16_t value)
 	*(__IO uint16_t *)(BKP_BASE + 4 * 2) = value;
 }
 
+/* ===================== 长耗时 Flash 操作的看门狗喂狗 =====================
+ * 背景: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(最坏),
+ *       中途没有任何喂狗机会,10s 超时必然复位(现象:备份/擦除做到一半板子重启,
+ *       重启后 DR2 残留 0xDEAD 还会触发回滚,进一步放大问题)。
+ * 对策:① rt_fota_wdt_feed() 供所有长耗时循环调用;
+ *       ② 大块擦除拆成 RT_FOTA_BACKUP_BLK_SIZE(4KB) 分块,每块后喂一次;
+ *       ③ 读/写循环每块喂一次。
+ *
+ * 安全:只有确认 IWDG 已启动(PR/RLR 非复位值 0)时才喂。IWDG 只要写入一次 KR
+ *       (0xAAAA)就会启动且无法停止,若在 bootloader 里误喂一个"未启动"的 IWDG,
+ *       会把一个 10s 看门狗凭空带进 APP 运行期,造成随机复位。
+ */
+#define RT_FOTA_WDT_DEV_NAME		"wdt"
+
+void rt_fota_wdt_feed(void)
+{
+	static rt_device_t wdt_dev = RT_NULL;
+
+	/* IWDG 未启动时 PR/RLR 保持复位值 0,直接返回:只要写一次 KR(0xAAAA)
+	 * 就会启动看门狗且无法停止,绝不能对"未启动"的 IWDG 喂狗。
+	 * 每次读两个寄存器(单周期访问)比缓存判断更稳,不受调用时机影响。 */
+	if ((IWDG->PR == 0) && (IWDG->RLR == 0))
+		return;
+
+	if (wdt_dev == RT_NULL)
+		wdt_dev = rt_device_find(RT_FOTA_WDT_DEV_NAME);
+
+	if (wdt_dev != RT_NULL)
+		rt_device_control(wdt_dev, RT_DEVICE_CTRL_WDT_KEEPALIVE, RT_NULL);
+}
+
+/* 分块擦除:把一次大块擦除拆成 chunk 大小的多次调用,块间喂狗。
+ * chunk 取 RT_FOTA_BACKUP_BLK_SIZE(4KB) = NOR 扇区粒度,对 onchip flash 亦按页对齐,
+ * 两种介质都安全。返回 0 成功,-1 失败(与 fal_partition_erase 语义一致)。 */
+static int rt_fota_erase_chunked(const struct fal_partition *part, rt_uint32_t addr, rt_size_t size)
+{
+	rt_uint32_t done = 0;
+	rt_size_t   len;
+
+	while (done < size)
+	{
+		len = size - done;
+		if (len > RT_FOTA_BACKUP_BLK_SIZE)
+			len = RT_FOTA_BACKUP_BLK_SIZE;
+
+		if (fal_partition_erase(part, addr + done, len) < 0)
+			return -1;
+
+		done += len;
+		rt_fota_wdt_feed();
+	}
+
+	return 0;
+}
+
 /* For shell */
 static rt_sem_t shell_sem = RT_NULL;
 static rt_device_t shell_dev = RT_NULL;
@@ -382,14 +440,126 @@ int rt_fota_check_upgrade(void)
 	if (rt_strcmp(fota_part_head.download_version, fota_part_head.current_version) != 0)
 	{
 		is_upgrade = 1;
-		LOG_D("Application need upgrade.");
+		/* v1.3.4:原为 LOG_D(DBG_LEVEL=DBG_INFO 时不输出),导致现场完全看不到
+		 * "为什么会跑升级/备份"。改为 LOG_I 并把两侧版本都打出来,一眼可判 */
+		LOG_I("Application need upgrade: fm_area[%s] != app[%s].",
+		      fota_part_head.download_version, fota_part_head.current_version);
 		goto __exit_check_upgrade;
 	}
 
+	LOG_I("No upgrade: fm_area[%s] == app[%s].",
+	      fota_part_head.download_version, fota_part_head.current_version);
+
 __exit_check_upgrade:
 	return is_upgrade;
 }
 
+/* ===================== v1.3.4:升级重试熔断 =====================
+ * 为什么需要(现场问题:没有下发升级包,断电重启却反复执行 backup):
+ *   rt_fota_check_upgrade() 只比较 fm_area 里 RBL 头的 download_version 与
+ *   current_version;而把 current_version 对齐成 download_version 的
+ *   rt_fota_copy_version() 位于 rt_fota_upgrade() **之后**。所以只要 upgrade
+ *   失败(擦写途中被 IWDG 复位、NOR 读写异常等),copy_version 就不会执行,
+ *   fm_area 里那个包始终"待升级"——
+ *   于是每次上电都重跑完整升级流程:先 rt_fota_backup_app_to_df() 备份 312KB
+ *   (读一遍 + 擦 78 扇区 + 写一遍),再擦写 312KB。表现为:
+ *     "没触发升级却每次启动都打印 rt_fota_backup_app_to_df!
+ *      并伴随长时间 # 输出、断电重启反复发生"。
+ * 对策:按"版本"记录连续失败次数。同一版本连续失败达到
+ *   RT_FOTA_UPGRADE_MAX_RETRY 次后不再自动升级,直接跳转 APP 并打印原因;
+ *   用户重新下发新包(版本变化)时计数自动归零,无需人工清标志。
+ *   记录存 EasyFlash(NOR,掉电保持);EF 不可用时退化为本次上电内计数。
+ */
+#define RT_FOTA_RETRY_EF_KEY			"fota_retry"
+#define RT_FOTA_UPGRADE_MAX_RETRY		3
+
+typedef struct
+{
+	rt_uint32_t cnt;		/* 同一版本连续失败次数 */
+	char        ver[24];	/* 上次尝试的 download_version */
+} rt_fota_retry_t;
+
+static rt_fota_retry_t fota_retry;
+static rt_bool_t fota_retry_loaded = RT_FALSE;
+
+static void rt_fota_retry_load(void)
+{
+	size_t saved_len = 0;
+
+	if (fota_retry_loaded)
+		return;
+
+	rt_memset(&fota_retry, 0, sizeof(fota_retry));
+	if (ef_get_env_blob(RT_FOTA_RETRY_EF_KEY, &fota_retry, sizeof(fota_retry), &saved_len) == 0)
+	{
+		/* 没有记录 or 读取失败:从头计数 */
+		rt_memset(&fota_retry, 0, sizeof(fota_retry));
+	}
+
+	/* EF 记录被擦成 0xFF 等异常时 cnt 可能是垃圾值(0xFFFFFFFF),
+	 * 直接判"已达上限"会把升级永久禁用,这里按无效记录重置。
+	 * 注意 ver 是空/0xFF 时必然与 download_version 不等,会走"新版本"分支归零,
+	 * 所以只需兜住 cnt 本身。 */
+	if (fota_retry.cnt > 100)
+	{
+		LOG_I("Retry: invalid record(cnt=0x%08X), reset.", fota_retry.cnt);
+		rt_memset(&fota_retry, 0, sizeof(fota_retry));
+	}
+
+	fota_retry_loaded = RT_TRUE;
+}
+
+static void rt_fota_retry_save(void)
+{
+	if (ef_set_env_blob(RT_FOTA_RETRY_EF_KEY, &fota_retry, sizeof(fota_retry)) != EF_NO_ERR)
+	{
+		LOG_I("Retry: save retry record failed (fallback to RAM only).");
+	}
+}
+
+/* 升级前的熔断检查:新版本自动清零;返回 RT_TRUE 表示"可以升级" */
+static rt_bool_t rt_fota_retry_allow(void)
+{
+	rt_fota_retry_load();
+
+	/* 版本不同 = 用户下发了新包,重新给满次数 */
+	if (rt_strcmp(fota_retry.ver, fota_part_head.download_version) != 0)
+	{
+		rt_strncpy(fota_retry.ver, fota_part_head.download_version, sizeof(fota_retry.ver) - 1);
+		fota_retry.ver[sizeof(fota_retry.ver) - 1] = '\0';
+		fota_retry.cnt = 0;
+	}
+
+	if (fota_retry.cnt >= RT_FOTA_UPGRADE_MAX_RETRY)
+	{
+		/* 达到上限:不再动 flash,保留现场供人工处理(msh: fota probe / dr2 0) */
+		rt_kprintf("Upgrade of version [%s] failed %d times, auto upgrade disabled.\n",
+		           fota_retry.ver, (int)fota_retry.cnt);
+		rt_kprintf("Fix the image or erase fm_area; a new version will re-enable it.\n");
+		rt_fota_signal_led_mode(led_shell_mode);
+		return RT_FALSE;
+	}
+
+	fota_retry.cnt++;
+	rt_fota_wdt_feed();
+	rt_fota_retry_save();
+
+	return RT_TRUE;
+}
+
+/* 升级完全成功(含版本对齐)后清零 */
+static void rt_fota_retry_clear(void)
+{
+	rt_fota_retry_load();
+	if (fota_retry.cnt == 0)
+		return;
+
+	fota_retry.cnt = 0;
+	rt_memset(fota_retry.ver, 0, sizeof(fota_retry.ver));
+	rt_fota_wdt_feed();
+	rt_fota_retry_save();
+}
+
 int rt_fota_copy_version(const char *part_name)
 {
 #define THE_NOR_FLASH_GRANULARITY		4096
@@ -468,7 +638,9 @@ int rt_fota_erase_app_part(void)
 	}
     
     LOG_I("Partition[%s] erase start:", part->name);
-	if (fal_partition_erase(part, 0, fota_part_head.raw_size) < 0)
+	/* 分块擦除 + 逐块喂狗:312KB 的 onchip 擦除按页进行(16 页一批关中断),
+	 * 单次调用可达数秒,与前面的 df_area 备份累加后容易撞 IWDG 10s 超时 */
+	if (rt_fota_erase_chunked(part, 0, fota_part_head.raw_size) < 0)
 	{
 		LOG_D("Partition[%s] erase failed!", part->name);
 		fota_res = RT_FOTA_PART_ERASE_ERR;
@@ -502,6 +674,8 @@ int rt_fota_write_app_part(int fw_pos, rt_uint8_t *fw_buf, int fw_len)
 		rt_fota_res = RT_FOTA_PART_WRITE_ERR;
 		goto __partition_write_exit;
 	}
+	/* 搬运循环里每块都写一次 app 分区,逐块喂狗(onchip 写 2KB/页,整包累计数秒) */
+	rt_fota_wdt_feed();
 __partition_write_exit:
 	if (rt_fota_res == RT_FOTA_NO_ERR)
 	{
@@ -560,6 +734,7 @@ __exit_read_decrypt:
 
 int rt_fota_upgrade(const char *part_name)
 {
+    rt_kprintf("rt_fota_upgrade:%s",part_name);
 	int fota_err = RT_FOTA_NO_ERR;
 	
 	const struct fal_partition *part;
@@ -945,6 +1120,156 @@ __exit_upgrade:
 	return fota_err;
 }
 
+/* ================== v1.3.2:跳转 APP 前的 SPI Flash 交接处理 ==================
+ * 现象:bootloader 内 SFUD 正常(打印 "Find a Winbond flash chip"),跳转后 APP 的
+ *       SFUD 探测失败("Read SFDP parameter header information failed" /
+ *       "This flash device is not found or not support"),FAL 里 w25q16m 设备为空,
+ *       EasyFlash 于是逐个 4KB 扇区做"检查-格式化",启动被拖死(表现为"读参数很慢")。
+ *
+ * 原因:原跳转序列里的 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 侧现象完全一致。
+ *
+ * 对策(两步,缺一不可):
+ *   1) 跳转前让芯片回到"标准 SPI + 空闲"态:等 BUSY 清零 → 0xAB 释放深度掉电 →
+ *      0xFF 逃逸 QPI/连续读 → 0x66/0x99 复位器件;
+ *   2) 外设复位之后再固定引脚电平:/CS 推挽输出高(不选中),SCK/MOSI/MISO 上拉输入。
+ *      注意必须在 HAL_DeInit() 之后做,否则会被 APB2 复位冲掉。
+ * 另外顺手读一次 JEDEC ID 打印出来,交接是否健康一眼可见(读不到 = 总线/芯片已异常)。
+ */
+#define RT_FOTA_SPI_FLASH_DEV_NAME      "spi10"
+
+#define RT_FOTA_FLASH_CMD_READ_SR       0x05    /* 读状态寄存器 */
+#define RT_FOTA_FLASH_CMD_RELEASE_PD    0xAB    /* 释放深度掉电 / 读器件 ID */
+#define RT_FOTA_FLASH_CMD_READ_ID       0x9F    /* JEDEC ID */
+#define RT_FOTA_FLASH_CMD_RESET_EN      0x66    /* 复位使能 */
+#define RT_FOTA_FLASH_CMD_RESET         0x99    /* 复位器件 */
+
+static struct rt_spi_device *rt_fota_spi_flash_dev(void)
+{
+	return (struct rt_spi_device *)rt_device_find(RT_FOTA_SPI_FLASH_DEV_NAME);
+}
+
+/* 发 1 字节命令 + 读回数据(CS 由 SPI 框架自动拉低/释放) */
+static void rt_fota_spi_flash_cmd_recv(rt_uint8_t cmd, rt_uint8_t *rx, rt_size_t rx_len)
+{
+	struct rt_spi_device *dev = rt_fota_spi_flash_dev();
+
+	if ((dev == RT_NULL) || (rx == RT_NULL) || (rx_len == 0))
+		return;
+
+	rt_spi_send_then_recv(dev, &cmd, 1, rx, rx_len);
+}
+
+/* 只发 1 字节命令 */
+static void rt_fota_spi_flash_cmd(rt_uint8_t cmd)
+{
+	struct rt_spi_device *dev = rt_fota_spi_flash_dev();
+
+	if (dev == RT_NULL)
+		return;
+
+	rt_spi_send(dev, &cmd, 1);
+}
+
+/* 跳转前:把 SPI Flash 恢复到"标准 SPI + 空闲"状态 */
+static void rt_fota_spi_flash_quiesce(void)
+{
+	struct rt_spi_device *dev = rt_fota_spi_flash_dev();
+	rt_uint8_t status = 0xFF;
+	rt_uint8_t id[3] = {0, 0, 0};
+	rt_uint32_t start;
+	int i;
+
+	if (dev == RT_NULL)
+	{
+		rt_kprintf("SPI flash handover: %s not found, skip quiesce.\n", RT_FOTA_SPI_FLASH_DEV_NAME);
+		return;
+	}
+
+	/* 1) 等上一次写/擦除结束(BUSY=0),最长等 1s,避免复位指令打断写入 */
+	start = rt_tick_get();
+	do
+	{
+		status = 0xFF;
+		rt_fota_spi_flash_cmd_recv(RT_FOTA_FLASH_CMD_READ_SR, &status, 1);
+		if ((status & 0x01) == 0)
+			break;
+	} while ((rt_tick_get() - start) < rt_tick_from_millisecond(1000));
+
+	/* 2) 0xFF 逃逸(尽力而为):若芯片被噪声带入 QPI/连续读模式,需 0xFF 才能退出;
+	 *    标准 SPI 模式下 0xFF 是空操作,无副作用。真正的兜底是后面的 0x66/0x99 复位
+	 *    与"跳转后 /CS 保持高电平"(见 rt_fota_spi_pins_safe_state) */
+	for (i = 0; i < 8; i++)
+		rt_fota_spi_flash_cmd(0xFF);
+
+	/* 3) 释放深度掉电(0xB9 之后只有 0xAB 能被响应) */
+	rt_fota_spi_flash_cmd(RT_FOTA_FLASH_CMD_RELEASE_PD);
+	rt_thread_mdelay(1);                    /* tRES1,留足余量 */
+
+	/* 4) 器件复位(不支持的型号会忽略,无副作用) */
+	rt_fota_spi_flash_cmd(RT_FOTA_FLASH_CMD_RESET_EN);
+	rt_fota_spi_flash_cmd(RT_FOTA_FLASH_CMD_RESET);
+	rt_thread_mdelay(1);                    /* tRST */
+
+	/* 5) 交接自检:读 JEDEC ID,异常时提前暴露(正常应为 0xEF4015/0xEF4016 之类) */
+	rt_fota_spi_flash_cmd_recv(RT_FOTA_FLASH_CMD_READ_ID, id, 3);
+	rt_kprintf("SPI flash handover: SR=0x%02X JEDEC ID=0x%02X%02X%02X\n",
+	           status, id[0], id[1], id[2]);
+}
+
+/* 外设复位后:把 SPI 引脚固定为安全电平,杜绝 APP 启动前的悬空窗口 */
+static void rt_fota_spi_pins_safe_state(void)
+{
+	rt_uint32_t crl;
+
+	__HAL_RCC_GPIOA_CLK_ENABLE();
+
+	/* 先置 ODR 再改模式:切换成输出的瞬间即为高电平,不会把 Flash 选中一下 */
+	GPIOA->BSRR = GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7;
+
+	crl  = GPIOA->CRL;
+	crl &= ~(0xFUL << 16);                  /* PA4:/CS */
+	crl |=  (0x3UL << 16);                  /*   推挽输出 50MHz,ODR=1 → 不选中 */
+	crl &= ~(0xFFFUL << 20);                /* PA5/PA6/PA7:SCK/MISO/MOSI */
+	crl |=  (0x888UL << 20);                /*   上拉输入,杜绝悬空引入毛刺 */
+	GPIOA->CRL = crl;
+}
+
+/* ============== v1.3.5:NOR 可用性快速检查(EasyFlash 初始化前置门禁) ==============
+ * 现场问题:SPI Flash 不可用时(SFUD 探测失败),EasyFlash 仍会对 3MB 环境区
+ *   (768 个 4KB 扇区)逐个扇区执行"读头 → 判定无效 → 擦除 → 写头"的格式化尝试:
+ *     - 每次读/擦/写都撞上 FAL 的 assert,各打一条日志;
+ *     - 加上 EasyFlash 自己的 "Sector header check failed" 提示,
+ *       单个扇区产生约 4~5 条串口输出,768 个扇区合计近 4000 条;
+ *     - @115200 下纯阻塞输出即达 20~30 秒,表现为"加载参数极慢、启动像卡死"。
+ *   更危险的是:一旦总线只是间歇异常,format_sector 有可能真的擦掉用户环境变量。
+ *
+ * 对策:在 easyflash_init() 之前先确认 NOR 真的能应答——读 JEDEC ID,
+ *   全 0x00 / 全 0xFF 视为不可用,直接跳过 EasyFlash 初始化并给出单条明确提示。
+ *   效果:故障时启动从数十秒降到毫秒级,且不会产生任何破坏性写入。
+ *   安全性:EasyFlash 未初始化时 ef_get_env_blob / ef_set_env_blob 内部有 init_ok
+ *   判据,会安全返回失败而不是崩溃(已核对 ef_env.c)。
+ */
+int rt_fota_nor_ready(void)
+{
+	rt_uint8_t id[3] = {0, 0, 0};
+
+	rt_fota_spi_flash_cmd_recv(RT_FOTA_FLASH_CMD_READ_ID, id, 3);
+
+	/* 全 0x00(MISO 被拉低/设备未接)或全 0xFF(MISO 悬空/设备无响应)均判不可用 */
+	if (((id[0] == 0x00) && (id[1] == 0x00) && (id[2] == 0x00)) ||
+	    ((id[0] == 0xFF) && (id[1] == 0xFF) && (id[2] == 0xFF)))
+	{
+		rt_kprintf("NOR flash not responding (JEDEC ID=0x%02X%02X%02X).\n", id[0], id[1], id[2]);
+		return 0;
+	}
+
+	return 1;
+}
+
 int rt_fota_start_application(void)
 {
 	int fota_res = RT_FOTA_NO_ERR;
@@ -981,6 +1306,10 @@ int rt_fota_start_application(void)
 
 	LOG_I("Implement application now.");
 
+	/* v1.3.2:把 SPI Flash 恢复到标准 SPI 空闲态(必须放在关中断之前,
+	 * 因为 rt_spi_* 走总线互斥量/延时,关中断后会失去调度) */
+	rt_fota_spi_flash_quiesce();
+
 	__disable_irq();
 	/* 禁用并清除全部 NVIC 中断(原循环因 F1 无 FPU_IRQn 被注释,改用寄存器遍历),
 	 * 防止 APP 启动初期残留/挂起中断使用旧向量表或未初始化外设 */
@@ -1001,7 +1330,10 @@ int rt_fota_start_application(void)
 	/* 外设与时钟恢复到默认状态 */
 	HAL_DeInit();
 	HAL_RCC_DeInit();
-	HAL_DeInit();
+
+	/* v1.3.2:上面的 APB2 复位会把 GPIOA 打回浮空输入,这里重新固定 SPI 引脚电平,
+	 * 保证从此刻到 APP 配好引脚之间 /CS 始终为高、时钟/数据线不被噪声干扰 */
+	rt_fota_spi_pins_safe_state();
 
 	/* 向量表预先指向 APP(其 SystemInit 会先写回 0x08000000,此步保证交接窗口安全) */
 	SCB->VTOR = app_addr;
@@ -1178,6 +1510,7 @@ static rt_err_t rt_fota_check_ymodem_request(void)
  * 返回 RT_FOTA_NO_ERR 表示备份有效。 */
 int rt_fota_backup_app_to_df(void)
 {
+    rt_kprintf("rt_fota_backup_app_to_df!");
 	rt_fota_backup_head_t head;
 	const struct fal_partition *app_part;
 	const struct fal_partition *df_part;
@@ -1219,6 +1552,7 @@ int rt_fota_backup_app_to_df(void)
 		fota_res = RT_FOTA_PART_ERASE_ERR;
 		goto __exit_backup;
 	}
+	rt_fota_wdt_feed();
 
 	/* 2. 读取 APP 分区并计算数据 CRC32 */
 	extern rt_uint32_t rt_fota_step_crc(rt_uint32_t crc, rt_uint8_t *buf, rt_uint32_t len);
@@ -1239,12 +1573,14 @@ int rt_fota_backup_app_to_df(void)
 
 		crc = rt_fota_step_crc(crc, buf, read_len);
 		pos += read_len;
+		rt_fota_wdt_feed();
 		rt_kprintf("#");
 	}
 	crc ^= 0xffffffff;
 
-	/* 3. 擦除数据区 */
-	if (fal_partition_erase(df_part, RT_FOTA_BACKUP_HEAD_RSV, erase_len) < 0)
+	/* 3. 擦除数据区:分块擦除并逐块喂狗(整块 312KB 在 NOR 上最坏要擦 30s 以上,
+	 *    一次性调用必然触发 IWDG 10s 超时复位) */
+	if (rt_fota_erase_chunked(df_part, RT_FOTA_BACKUP_HEAD_RSV, erase_len) < 0)
 	{
 		LOG_I("Backup: erase data area failed.");
 		fota_res = RT_FOTA_PART_ERASE_ERR;
@@ -1274,6 +1610,9 @@ int rt_fota_backup_app_to_df(void)
 		}
 
 		pos += read_len;
+		/* 喂狗放在 HMI_WRITE 之前:串口屏是阻塞发送(每次十几 ms),
+		 * 78 块累计也有秒级,先确保看门狗被喂过 */
+		rt_fota_wdt_feed();
 		HMI_WRITE("debug.update.val=%d", (int)(pos * 100 / data_len));
 		rt_kprintf("#");
 	}
@@ -1309,6 +1648,7 @@ __exit_backup:
  * 返回 RT_FOTA_NO_ERR 表示恢复完成。 */
 int rt_fota_restore_app_from_df(int consume_backup)
 {
+    LOG_I("rt_fota_restore_app_from_df:%d", consume_backup);
 	rt_fota_backup_head_t head;
 	const struct fal_partition *app_part;
 	const struct fal_partition *df_part;
@@ -1380,6 +1720,7 @@ int rt_fota_restore_app_from_df(int consume_backup)
 
 		crc = rt_fota_step_crc(crc, buf, read_len);
 		pos += read_len;
+		rt_fota_wdt_feed();
 		rt_kprintf("#");
 	}
 	crc ^= 0xffffffff;
@@ -1391,8 +1732,9 @@ int rt_fota_restore_app_from_df(int consume_backup)
 		goto __exit_restore;
 	}
 
-	/* 3. 擦除 APP 分区并回写备份数据 */
-	if (fal_partition_erase(app_part, 0, app_part->len) < 0)
+	/* 3. 擦除 APP 分区并回写备份数据:分块擦除 + 逐块喂狗
+	 *    (自动回滚路径尤其关键:擦到一半被看门狗复位,会变成"回滚-复位"死循环) */
+	if (rt_fota_erase_chunked(app_part, 0, app_part->len) < 0)
 	{
 		LOG_I("Restore: erase [%s] failed.", app_part->name);
 		fota_res = RT_FOTA_PART_ERASE_ERR;
@@ -1421,6 +1763,7 @@ int rt_fota_restore_app_from_df(int consume_backup)
 		}
 
 		pos += read_len;
+		rt_fota_wdt_feed();
 		HMI_WRITE("debug.update.val=%d", (int)(pos * 100 / head.data_len));
 		rt_kprintf("#");
 	}
@@ -1521,7 +1864,10 @@ void rt_fota_thread_entry(void *arg)
 	if (rt_fota_set_device(RT_CONSOLE_DEVICE_NAME) == RT_EOK)
 	{
 
-	    if(easyflash_init()==EF_NO_ERR) //初始化成功
+	    /* v1.3.5:EasyFlash 前置门禁——NOR 不响应时不要进去,
+	     * 否则会对 768 个扇区逐一做无效的格式化尝试(近 4000 条日志、
+	     * 阻塞启动 20~30 秒),且存在误擦用户环境变量的风险 */
+	    if ((rt_fota_nor_ready() != 0) && (easyflash_init() == EF_NO_ERR)) //初始化成功
 	    {
 	        rt_uint8_t boot_flag_buf[4] = {0, 0, 0, 0};
 	        ef_get_env_blob("stop_in_bootloader", boot_flag_buf, sizeof(boot_flag_buf), NULL);
@@ -1560,6 +1906,12 @@ void rt_fota_thread_entry(void *arg)
 	if (rt_fota_check_upgrade() <= 0)
 		goto __exit_boot_entry;
 
+	/* v1.3.4:重试熔断——同一版本连续失败到上限后不再动 flash,直接跳 APP。
+	 * 否则 upgrade 失败会让 fm_area 永远处于"待升级"状态,每次上电都重跑
+	 * backup(312KB 读+擦+写) + 升级,形成"重启-升级-失败"循环 */
+	if (rt_fota_retry_allow() != RT_TRUE)
+		goto __exit_boot_entry;
+
 	/* enter to upgrade mode */
 	rt_fota_signal_led_mode(led_upgrade_mode);
 
@@ -1573,12 +1925,22 @@ void rt_fota_thread_entry(void *arg)
 	/* Implement upgrade, copy firmware partition to app partition */
 	fota_err = rt_fota_upgrade(RT_FOTA_FM_PART_NAME);
 	if (fota_err != RT_FOTA_NO_ERR)
+	{
+		LOG_I("Upgrade failed(%d), fm_area image kept for retry.", fota_err);
 		goto __exit_boot_entry;
+	}
 
 	/* Update new application verison in RBL file of firmware partition */
 	fota_err = rt_fota_copy_version(RT_FOTA_FM_PART_NAME);	
 	if (fota_err != RT_FOTA_NO_ERR)
+	{
+		LOG_I("Copy version failed(%d), fm_area stays pending upgrade.", fota_err);
 		goto __exit_boot_entry;
+	}
+
+	/* 升级 + 版本对齐都成功:清零熔断计数,下次上电不会再走升级分支 */
+	rt_fota_retry_clear();
+	rt_kprintf("Upgrade done, version[%s] applied.\n", fota_part_head.download_version);
 
 __exit_boot_entry:
 	/* Implement application */
@@ -1633,8 +1995,9 @@ void rt_fota_info(rt_uint8_t argc, char **argv)
     {
             [0]     = "fota probe                       - probe RBL file of partiton",
             [1]     = "fota show partition addr size    - show 'size' bytes starting at 'addr'",
-            [2]     = "fota clone des_part src_part     - clone src partition to des partiton",
-            [3]     = "fota exec                        - execute application program",
+            [2]     = "fota retry [0]                   - show or clear upgrade retry counter",
+            [3]     = "fota clone des_part src_part     - clone src partition to des partiton",
+            [4]     = "fota exec                        - execute application program",
     };
 
 	if (argc < 2)
@@ -1691,6 +2054,12 @@ void rt_fota_info(rt_uint8_t argc, char **argv)
 					}
 					LOG_I("| Algorithm mode     | %*.s |", 11, put_buf);
 					LOG_I("| Firmware version   | %*.s |", 11, fota_part_head.download_version);
+					/* v1.3.4:把 current_version 和"是否需升级"一并打出来。
+					 * 这两个字段不等就会在每次上电触发升级+备份,原来完全看不到 */
+					LOG_I("| Applied version    | %*.s |", 11, fota_part_head.current_version);
+					LOG_I("| Upgrade pending    | %11s |",
+					      (rt_strcmp(fota_part_head.download_version, fota_part_head.current_version) != 0)
+					      ? "YES" : "NO");
 					LOG_I("| Code raw size      | %11d |", fota_part_head.raw_size);
 	                LOG_I("| Code package size  | %11d |", fota_part_head.com_size);
 					LOG_I("| Build Timestamp    | %11d |", *((rt_uint32_t *)(&fota_part_head.fm_time[2])));			
@@ -1738,6 +2107,28 @@ void rt_fota_info(rt_uint8_t argc, char **argv)
 				rt_kprintf("%s partition is not exist!\n", part_name);
 			}
        	}
+		else if (!rt_strcmp(operator, "retry"))
+		{
+			/* v1.3.4:查看/清除升级重试熔断记录。
+			 * fota retry      - 查看连续失败次数与上次尝试的版本
+			 * fota retry 0    - 清零(熔断后想再试一次、或定位问题后强制重试) */
+			rt_fota_retry_load();
+			if (argc < 3)
+			{
+				rt_kprintf("Upgrade retry: cnt=%d/%d, last version=[%s]\n",
+				           (int)fota_retry.cnt, RT_FOTA_UPGRADE_MAX_RETRY, fota_retry.ver);
+				rt_kprintf("Auto upgrade is %s.\n",
+				           (fota_retry.cnt >= RT_FOTA_UPGRADE_MAX_RETRY) ? "DISABLED" : "enabled");
+			}
+			else
+			{
+				fota_retry.cnt = 0;
+				rt_memset(fota_retry.ver, 0, sizeof(fota_retry.ver));
+				rt_fota_wdt_feed();
+				rt_fota_retry_save();
+				rt_kprintf("Upgrade retry record cleared.\n");
+			}
+		}
 		else if (!rt_strcmp(operator, "clone"))
 		{
        		const char *dst_part_name = argv[2];
@@ -1758,7 +2149,8 @@ void rt_fota_info(rt_uint8_t argc, char **argv)
 			else
 			{
 				rt_kprintf("Clone %s partition to %s partition:\n", src_part_name, dst_part_name);
-				if (fal_partition_erase(dst_part, 0, dst_part->len) >= 0)
+				/* 分块擦除 + 逐块喂狗(dst 可能是 512KB NOR,整块擦会撞 IWDG 超时) */
+				if (rt_fota_erase_chunked(dst_part, 0, dst_part->len) >= 0)
 				{
 					int clone_pos = 0;
 					int clone_len = 0, clone_tol_len;
@@ -1784,6 +2176,7 @@ void rt_fota_info(rt_uint8_t argc, char **argv)
 							break;
 						}
 
+						rt_fota_wdt_feed();
 						rt_kprintf("#");
 						clone_pos += clone_len;
 					}

+ 7 - 0
CBD_FOTA_BootLoader/applications/rt_fota.h

@@ -55,3 +55,10 @@ int rt_fota_start_application(void);
 /* v1.3.0 升级回滚接口(main.c 的 uart4 屏幕命令 backupapp / dbg_restore / resetapp 亦使用) */
 int rt_fota_backup_app_to_df(void);
 int rt_fota_restore_app_from_df(int consume_backup);
+
+/* 喂 IWDG(仅在其已被 syswatch 启动时生效):供长耗时 flash 擦/写循环调用 */
+void rt_fota_wdt_feed(void);
+
+/* v1.3.5:NOR 可用性快速检查(读 JEDEC ID)。返回 0 表示器件无响应,
+ * 调用方应跳过 EasyFlash 初始化,避免其对 768 个扇区逐一无效格式化。 */
+int rt_fota_nor_ready(void);

+ 1 - 1
CBD_FOTA_BootLoader/applications/sys_config.h

@@ -5,7 +5,7 @@
 
 
 /* RT-FOTA module define */
-#define RT_FOTA_SW_VERSION      "1.3.1"
+#define RT_FOTA_SW_VERSION      "1.3.5"
 
 /* Enable Ymodem OTA */
 #define PKG_USING_YMODEM_OTA

+ 12 - 4
CBD_FOTA_BootLoader/packages/EasyFlash-latest/src/ef_env.c

@@ -507,7 +507,7 @@ static uint32_t get_next_env_addr(sector_meta_data_t sector, env_node_obj_t pre_
             addr = find_next_env_addr(addr, sector->addr + SECTOR_SIZE - SECTOR_HDR_DATA_SIZE);
 
             if (addr > sector->addr + SECTOR_SIZE || pre_env->len == 0) {
-                //TODO 扇区连续模式
+                //TODO 锟斤拷锟斤拷锟斤拷锟斤拷模式
                 return FAILED_ADDR;
             }
         } else {
@@ -542,7 +542,7 @@ static EfErrCode read_env(env_node_obj_t env)
         env->crc_is_ok = false;
         return EF_READ_ERR;
     } else if (env->len > SECTOR_SIZE - SECTOR_HDR_DATA_SIZE && env->len < ENV_AREA_SIZE) {
-        //TODO 扇区连续模式,或者写入长度没有写入完整
+        //TODO 锟斤拷锟斤拷锟斤拷锟斤拷模式锟斤拷锟斤拷锟斤拷写锟诫长锟斤拷没锟斤拷写锟斤拷锟斤拷锟斤拷
         EF_ASSERT(0);
     }
 
@@ -1691,8 +1691,16 @@ static bool check_sec_hdr_cb(sector_meta_data_t sector, void *arg1, void *arg2)
     if (!sector->check_ok) {
         size_t *failed_count = arg1;
 
-        EF_INFO("Warning: Sector header check failed. Format this sector (0x%08x).\n", sector->addr);
+        /* v1.3.5:日志限流。原实现每个失败扇区都打印一行,环境区 768 个扇区
+         * 会刷出 768 条 warning;叠加 FAL 断言的输出,@115200 下阻塞启动
+         * 20~30 秒,表现为"加载参数极慢"。这里只打印前几条,其余汇总。 */
+        if (*failed_count < 3) {
+            EF_INFO("Warning: Sector header check failed. Format this sector (0x%08x).\n", sector->addr);
+        }
         (*failed_count) ++;
+        if (*failed_count == 4) {
+            EF_INFO("Warning: more sector header failures suppressed.\n");
+        }
         format_sector(sector->addr, SECTOR_NOT_COMBINED);
     }
 
@@ -1726,7 +1734,7 @@ static bool check_and_recovery_env_cb(env_node_obj_t env, void *arg1, void *arg2
     } else if (env->status == ENV_PRE_WRITE) {
         uint8_t status_table[ENV_STATUS_TABLE_SIZE];
         /* the ENV has not write finish, change the status to error */
-        //TODO 绘制异常处理的状态装换图
+        //TODO 锟斤拷锟斤拷锟届常锟斤拷锟斤拷锟斤拷状态装锟斤拷图
         write_status(env->addr.start, status_table, ENV_STATUS_NUM, ENV_ERR_HDR);
         return true;
     }

+ 20 - 0
CBD_FOTA_BootLoader/packages/fal-v0.5.0/inc/fal_def.h

@@ -71,6 +71,26 @@ if (!(EXPR))                                                                   \
     return 1;                                                                  \
 }
 
+/* v1.3.5:类型正确的检查宏。
+ * 背景:上面的 assert 统一 `return 1`,用在返回指针的函数里会把 1 当指针返回
+ *   (调用方拿到非 NULL 的非法地址,解引用即 HardFault);用在 void 函数里则
+ *   直接违反函数返回类型。此前这两个源文件因增量构建未被重编,问题一直被掩盖,
+ *   完整重编时暴露为 7 条 -Wint-conversion 告警。
+ * 用法:返回指针的函数用 fal_check_ptr,返回 void 的函数用 fal_check_void。 */
+#define fal_check_ptr(EXPR)                                                    \
+if (!(EXPR))                                                                   \
+{                                                                              \
+    FAL_PRINTF("(%s) bootloader fal_def.h check failed at %s.\n", #EXPR, __FUNCTION__);          \
+    return NULL;                                                               \
+}
+
+#define fal_check_void(EXPR)                                                   \
+if (!(EXPR))                                                                   \
+{                                                                              \
+    FAL_PRINTF("(%s) bootloader fal_def.h check failed at %s.\n", #EXPR, __FUNCTION__);          \
+    return;                                                                    \
+}
+
 /* debug level log */
 #ifdef  log_d
 #undef  log_d

+ 3 - 2
CBD_FOTA_BootLoader/packages/fal-v0.5.0/src/fal_flash.c

@@ -77,8 +77,9 @@ int fal_flash_init(void)
  */
 const struct fal_flash_dev *fal_flash_device_find(const char *name)
 {
-    assert(init_ok);
-    assert(name);
+    /* v1.3.5:改用类型正确的检查(原 assert 会 return 1,被当成非法指针返回) */
+    fal_check_ptr(init_ok);
+    fal_check_ptr(name);
 
     size_t i;
 

+ 8 - 5
CBD_FOTA_BootLoader/packages/fal-v0.5.0/src/fal_partition.c

@@ -310,7 +310,8 @@ _exit:
  */
 const struct fal_partition *fal_partition_find(const char *name)
 {
-    assert(init_ok);
+    /* v1.3.5:改用类型正确的检查(原 assert 会 return 1,被当成非法指针返回) */
+    fal_check_ptr(init_ok);
 
     size_t i;
 
@@ -334,8 +335,9 @@ const struct fal_partition *fal_partition_find(const char *name)
  */
 const struct fal_partition *fal_get_partition_table(size_t *len)
 {
-    assert(init_ok);
-    assert(len);
+    /* v1.3.5:改用类型正确的检查(原 assert 会 return 1,被当成非法指针返回) */
+    fal_check_ptr(init_ok);
+    fal_check_ptr(len);
 
     *len = partition_table_len;
 
@@ -351,8 +353,9 @@ const struct fal_partition *fal_get_partition_table(size_t *len)
  */
 void fal_set_partition_table_temp(struct fal_partition *table, size_t len)
 {
-    assert(init_ok);
-    assert(table);
+    /* v1.3.5:void 函数不能用带 return 值的 assert */
+    fal_check_void(init_ok);
+    fal_check_void(table);
 
     partition_table_len = len;
     partition_table = table;

+ 127 - 0
CBD_FOTA_BootLoader/readme.md

@@ -1,3 +1,130 @@
+# 版本说明 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"