zhunk 1 kuukausi sitten
vanhempi
commit
32b972df05

+ 36 - 0
Application_cbd_apm32f1/.workbuddy/memory/2026-09-24.md

@@ -230,3 +230,39 @@ degraded_boot_check.py 同步更新(断言改成"不再清 0"): [A][B] gcc exit=
 fal_init_check / nor_flash0_is_ready 声明(消除 implicit declaration 误报), exit=0 无警告。
 
 ### 已写入 readme.md 第十二节 + 日期条目第 5 条索引
+
+## 升级不执行: update_flag 三通道持久化(第八轮)
+
+现场: 触发升级标志位置 1, 重启后**不执行升级**, 串口无任何报错。
+
+### 根因(4 个断点, 任一命中就静默跳过)
+1. 原链路只有 `ef_set_env_blob("update_flag")` 一条通道, 而 EasyFlash env 正是
+   "概率丢参数"的重灾区 —— 标志没存住/读不出就直接跳过。
+2. 🔴 **`hmi.c` 原 1818 `device_status.update_flag = 0;`**: 它在
+   `iSave != FLASH_FLAG`(参数丢失)分支里**无条件清零升级标志**。
+   现场一丢参数, 升级必然失效 —— 与用户现象完全吻合。
+3. **快照回滚冲掉标志**: 1968 `param_unpack()` 整包覆盖 device_status,
+   而快照可能是上次运行早期落的(那时还没置位)。
+4. **屏幕路径(hmi_update)只写 EasyFlash**, 没同步 param_a/b 快照。
+
+### 修法: 三通道
+新增 `Upgrade_Flag_Set()` / `Upgrade_Flag_Clear()`(hmi.h 导出), 置位/清位同时写:
+① EasyFlash env ② param_a/b 快照 ③ **RTC 备份寄存器 BKP_DR3**(魔数 0x5AA5)。
+开机 `up_request = ef || snap || bkp`, 任一为 1 就进 ymodem_ota。
+- BKP 的价值: **env 区(0~128KB)坏 ≠ 整片 flash 坏, fm_area(3MB)可能完好**;
+  BKP 不经过 SPI flash。软件复位一定保持(升级流程正是软件复位),
+  完全断电则取决于 VBAT 有无电池。
+- DR2 是 bootloader 的 boot_flag, **新增占用 DR3(标志)/DR4(失败计数)**。
+- ⚠️ 必须有失败上限: `ymodem_ota()` 成功失败都会 rt_hw_cpu_reset(),
+  不清标志就死循环。用 BKP_DR4 计数, `UPG_TRY_MAX = 3`。
+- 1818 改为裁决保留; param_unpack 后把已置位的 flag OR 回去。
+- 新增 msh: `upgrade_flag_stat`(看三通道) / `upgrade_set`(手动置位测重启)。
+
+### 校验
+新工具 `.workbuddy/tools/upgrade_flag_check.py`: [A] gcc 编译 Set/Clear
+[B] hmi.c+dtu_uart2.c 配平 [C] 10 项符号核对 [D] 逻辑风险项 —— 全 PASS。
+回归 param_syn_check / degraded_boot_check 均 exit=0。
+踩坑: 抽宏时不能抽 `#ifndef/#endif`(会留下未闭合条件编译), 只抽 `#define`;
+桩要补 `__IO`、`rt_uint32_t`、`BKP_BASE`。
+
+### 已写入 readme.md 第十三节 + 日期条目第 6 条索引

+ 11 - 0
Application_cbd_apm32f1/.workbuddy/memory/MEMORY.md

@@ -8,6 +8,17 @@
   待确认项在文档里单列"已知未修",不要擅自改行为。
 - 用户 Readme 里长期有他自己未提交的改动 → **禁止整体重写**,只做插入。
 
+## 升级标志 update_flag(2026-09-24 第八轮)
+- 升级请求走**三通道**: ① EasyFlash env ② param_a/b 快照 ③ RTC BKP_DR3(魔数 0x5AA5)。
+  置位/清位一律调 `Upgrade_Flag_Set()` / `Upgrade_Flag_Clear()`(hmi.h 导出),
+  **不要只写 `ef_set_env_blob("update_flag")`** —— 单通道丢标志就会静默跳过升级。
+- 开机裁决 `up_request = ef || snap || bkp`,日志 `[upgrade] flag ef=%d snap=%d bkp=%d`。
+- BKP 占用: DR2=bootloader boot_flag(别动), **DR3=升级标志, DR4=连续失败计数**。
+- ⚠️ `ymodem_ota()` 成功失败都会 `rt_hw_cpu_reset()`, 所以**进 ymodem 前必须先清标志**,
+  并用 DR4 计数卡 `UPG_TRY_MAX=3`, 否则"重启→升级失败→重启"死循环。
+- ⚠️ `iSave != FLASH_FLAG`(参数丢失)分支**不许无条件清零 update_flag** —— 参数丢不等于
+  升级请求是假的, 这是历史 bug。同理 `param_unpack()` 整包覆盖后要把已置位的 flag OR 回去。
+
 ## 版本控制
 - 仓库根 = `D:\RT-ThreadStudio\workspace\IOT_CBD_BZY_CTRL`(本工程是子目录)。HEAD="3.7.13"。
 - 本机 git 不在 PATH, 用 `C:\Users\Administrator\.workbuddy\binaries\PortableGit\versions\1.2.0\cmd\git.exe`。

+ 0 - 9
Application_cbd_apm32f1/.workbuddy/probe_out.txt

@@ -1,9 +0,0 @@
-sizeof(param_persist_t)      = 820 bytes
-sizeof(param_snapshot_hdr_t) = 24 bytes
-涓や釜 param_persist_t 灞€閮ㄥ彉閲?= 1640 bytes
-
-鍙傝€? RT_MAIN_THREAD_STACK_SIZE = 2048 (rtconfig.h:69)
-
-缁撹: main 绾跨▼鏍?2048 瀛楄妭, Check_ParamConfig() 閲屾斁浜?2 涓?param_persist_t
-      灞€閮ㄥ彉閲忓叡 1640 瀛楄妭(鍗犳爤 80%), 鍐嶅姞涓?rt_kprintf/vsnprintf 绛夎皟鐢ㄦ爤,
-      蹇呯劧鏍堟孩鍑?-> hard fault

+ 0 - 5
Application_cbd_apm32f1/.workbuddy/sizeof_out.txt

@@ -1,5 +0,0 @@
-sizeof(param_persist_t)      = 820 bytes
-sizeof(param_snapshot_hdr_t) = 24 bytes
-两个 param_persist_t 局部变量 = 1640 bytes
-
-RT_MAIN_THREAD_STACK_SIZE = 2048

+ 0 - 2
Application_cbd_apm32f1/.workbuddy/syn_out.txt

@@ -1,2 +0,0 @@
-gcc exit = 0  (0 涓旀棤杈撳嚭鍗抽€氳繃)
-(鏃犺鍛?/ 鏃犻敊璇?

+ 206 - 0
Application_cbd_apm32f1/.workbuddy/tools/upgrade_flag_check.py

@@ -0,0 +1,206 @@
+# -*- coding: utf-8 -*-
+"""
+升级标志(update_flag)三通道改造的宿主校验(本机无 arm-none-eabi)
+
+[A] gcc -fsyntax-only: 抽 hmi.c 里 Upgrade_Flag_Set / Upgrade_Flag_Clear 两个函数 +
+    BKP 宏定义, 配最小桩编译, 验证语法与 device_status.update_flag 字段真实存在
+[B] hmi.c / dtu_uart2.c 大括号配平
+[C] 关键符号与调用点核对
+[D] 逻辑风险项核对(防死循环 / 防误清零 / 三通道齐全)
+
+中间文件只写 .txt, 不在工程树留 .c/.h(CDT 会扫进去导致 multiple definition)
+"""
+import io, os, re, subprocess, sys
+
+ROOT = os.path.abspath(os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", ".."))
+GCC  = r"D:\Strawberry\c\bin\gcc.exe"
+TMP  = os.path.join(ROOT, ".workbuddy", "tmp_upg.txt")
+OUT  = os.path.join(ROOT, ".workbuddy", "upgrade_out.txt")
+
+lines = []
+def log(s=""):
+    lines.append(s)
+
+def read(p):
+    with io.open(os.path.join(ROOT, p), "r", encoding="utf-8", errors="ignore") as f:
+        return f.read()
+
+def grab_func(text, sig):
+    """从 sig 所在行开始, 大括号配平切出整个函数体。
+       ★ sig 到 '{' 之间不能出现 ';', 否则会命中前向声明"""
+    m = re.search(sig + r"[^;{]*\{", text)
+    if not m:
+        return None
+    i = m.start()
+    j = m.end() - 1
+    depth, k = 0, j
+    while k < len(text):
+        if text[k] == "{":
+            depth += 1
+        elif text[k] == "}":
+            depth -= 1
+            if depth == 0:
+                return text[i:k + 1]
+        k += 1
+    return None
+
+def balance(text):
+    pairs = [("{", "}"), ("(", ")")]
+    res = {}
+    for a, b in pairs:
+        res[a] = text.count(a) - text.count(b)
+    return res
+
+# ---------------- 抽真实结构体 ----------------
+ctrl = read(os.path.join("applications", "control.h"))
+try:
+    a = ctrl.index("typedef struct")
+    b = ctrl.index("}Device_Status_typedef;") + len("}Device_Status_typedef;")
+    struct_def = ctrl[a:b]
+except ValueError:
+    raise SystemExit("未找到 Device_Status_typedef 定义")
+
+hmi = read(os.path.join("applications", "hmi.c"))
+dtu = read(os.path.join("applications", "dtu_uart2.c"))
+hmih = read(os.path.join("applications", "hmi.h"))
+
+# ---------------- [A] gcc 语法检查 ----------------
+fset   = grab_func(hmi, r"void\s+Upgrade_Flag_Set\s*\(void\)")
+fclear = grab_func(hmi, r"void\s+Upgrade_Flag_Clear\s*\(void\)")
+
+macros = ""
+# 只抓 #define, 不能抓 #ifndef/#endif —— 单独抽出来会留下未闭合的条件编译
+for name in ("BKP_BASE", "UPG_BKP_DR3", "UPG_BKP_DR4", "UPG_BKP_MAGIC", "UPG_TRY_MAX"):
+    mm = re.search(r"#define\s+" + name + r"\b.*", hmi)
+    if mm:
+        macros += mm.group(0) + "\n"
+if "BKP_BASE" not in macros:
+    macros += "#define BKP_BASE (0x40006C00UL)\n"
+if "UPG_BKP_DR3" not in macros:
+    macros += "#define UPG_BKP_DR3 (*(volatile unsigned short *)(0x40006C00UL + 4U*3U))\n"
+if "UPG_BKP_DR4" not in macros:
+    macros += "#define UPG_BKP_DR4 (*(volatile unsigned short *)(0x40006C00UL + 4U*4U))\n"
+if "UPG_BKP_MAGIC" not in macros:
+    macros += "#define UPG_BKP_MAGIC (0x5AA5U)\n"
+
+STUB = r"""
+#include <stdint.h>
+#include <stddef.h>
+#include <string.h>
+/* CMSIS: __IO 即 volatile(真实工程来自芯片头文件) */
+#define __IO volatile
+#define LOG_I(...)  ((void)0)
+#define LOG_E(...)  ((void)0)
+#define LOG_W(...)  ((void)0)
+#define LOG_D(...)  ((void)0)
+typedef unsigned int   rt_uint32_t;
+typedef unsigned short rt_uint16_t;
+typedef unsigned char  rt_uint8_t;
+typedef signed   int   rt_int32_t;
+typedef signed   short rt_int16_t;
+typedef int            rt_err_t;
+typedef rt_uint32_t    rt_size_t;
+#define RT_NULL ((void*)0)
+#define RT_EOK  0
+int  ef_set_env_blob(const char *key, const void *value_buf, size_t buf_len);
+size_t ef_get_env_blob(const char *key, void *value_buf, size_t buf_len, size_t *saved_len);
+void param_mark_dirty(void);
+int  param_flush_force(void);
+typedef struct { int dummy; } param_persist_t;
+""" + struct_def + r"""
+extern Device_Status_typedef device_status;
+"""
+
+src = STUB + "\n" + macros + "\n" + (fset or "") + "\n" + (fclear or "") + "\n"
+
+ok_a = False
+if not fset or not fclear:
+    log("[A] 未抽到 Upgrade_Flag_Set / Clear 函数体 -> FAIL")
+else:
+    with io.open(TMP, "w", encoding="utf-8") as f:
+        f.write(src)
+    r = subprocess.run([GCC, "-x", "c", "-fsyntax-only", "-std=gnu99",
+                        "-Wall", "-Wextra", "-Wno-unused-parameter", TMP],
+                       capture_output=True, text=True, encoding="utf-8", errors="ignore")
+    log("[A] gcc 语法检查 exit=%d" % r.returncode)
+    if r.stderr.strip():
+        log(r.stderr.strip()[:1200])
+    ok_a = (r.returncode == 0)
+    log("    -> %s" % ("PASS" if ok_a else "FAIL"))
+
+# ---------------- [B] 括号配平 ----------------
+log("")
+log("[B] 括号配平")
+ok_b = True
+for name, txt in (("hmi.c", hmi), ("dtu_uart2.c", dtu)):
+    b = balance(txt)
+    bad = {k: v for k, v in b.items() if v != 0}
+    log("    %-12s %s" % (name, bad if bad else "OK"))
+    if bad:
+        ok_b = False
+log("    -> %s" % ("PASS" if ok_b else "FAIL"))
+
+# ---------------- [C] 符号与调用点 ----------------
+log("")
+log("[C] 符号与调用点核对")
+checks = [
+    ("hmi.h 声明 Upgrade_Flag_Set",
+     "void Upgrade_Flag_Set(void);" in hmih),
+    ("hmi.h 声明 Upgrade_Flag_Clear",
+     "void Upgrade_Flag_Clear(void);" in hmih),
+    ("hmi.c 屏幕 hmi_update 走 Upgrade_Flag_Set",
+     re.search(r'hmi_update"\)!=NULL\)\s*\{[^}]*Upgrade_Flag_Set\(\);', hmi, re.S) is not None),
+    ("dtu_uart2.c update 走 Upgrade_Flag_Set",
+     "Upgrade_Flag_Set();" in dtu),
+    ("dtu_uart2.c 已删旧的裸 ef_set_env_blob(\"update_flag\")",
+     'ef_set_env_blob("update_flag", &device_status.update_flag' not in dtu),
+    ("dtu_uart2.c include hmi.h(可见声明)",
+     '#include "hmi.h"' in dtu),
+    ("BKP 通道宏已定义(DR3/DR4)",
+     "#define UPG_BKP_DR3" in hmi and "#define UPG_BKP_DR4" in hmi),
+    ("连续失败上限 UPG_TRY_MAX 已定义",
+     "#define UPG_TRY_MAX" in hmi),
+    ("开机裁决用了三通道 OR",
+     "up_request   = (up_flag_ef || up_flag_snap || up_flag_bkp);" in hmi),
+    ("进入 ymodem 前先清标志",
+     re.search(r"Upgrade_Flag_Clear\(\);\s*\n\s*if \(!nor_flash0_is_ready", hmi) is not None),
+]
+ok_c = True
+for name, ok in checks:
+    log("    %-52s %s" % (name, "OK" if ok else "MISSING"))
+    if not ok:
+        ok_c = False
+log("    -> %s" % ("PASS" if ok_c else "FAIL"))
+
+# ---------------- [D] 逻辑风险 ----------------
+log("")
+log("[D] 逻辑风险项")
+# 默认配置分支里不应再有孤立的无条件清零
+m2 = re.search(r"device_status\.ds = 1;\s*//设备状态\s*\n(.*?)device_status\.update_flag\s*=", hmi, re.S)
+still_forced = bool(re.search(r"device_status\.update_flag = 0;\s*\n\s*/\*孢子仪\*/", hmi))
+log("    默认配置分支仍无条件清零 update_flag: %s (期望 False)" % still_forced)
+# 快照回滚不再覆盖 update_flag
+or_back = "if(uf != 0)" in hmi
+log("    param_unpack 后保留 update_flag:      %s (期望 True)" % or_back)
+# 三通道置位
+set_all = ("ef_set_env_blob" in (fset or "")) and ("param_flush_force" in (fset or "")) \
+          and ("UPG_BKP_DR3" in (fset or ""))
+log("    置位覆盖 easyflash+快照+BKP:          %s (期望 True)" % set_all)
+ok_d = (not still_forced) and or_back and set_all
+log("    -> %s" % ("PASS" if ok_d else "FAIL"))
+
+log("")
+log("=== 汇总: A=%s B=%s C=%s D=%s ===" % (
+    "PASS" if ok_a else "FAIL", "PASS" if ok_b else "FAIL",
+    "PASS" if ok_c else "FAIL", "PASS" if ok_d else "FAIL"))
+
+try:
+    os.remove(TMP)
+except OSError:
+    pass
+
+with io.open(OUT, "w", encoding="utf-8") as f:
+    f.write("\n".join(lines))
+
+print("\n".join(lines))
+sys.exit(0 if (ok_a and ok_b and ok_c and ok_d) else 1)

+ 0 - 31
Application_cbd_apm32f1/.workbuddy/verify_out.txt

@@ -1,31 +0,0 @@
-==========================================================================
-[A] hmi.c 新增读取块 —— 语法检查
-==========================================================================
-  片段行数: 48 (含 heatvalue dtype 分支 + cold_sw 读取)
-  gcc exit=0
-  => PASS
-
-==========================================================================
-[B] ef_fal_port.c default_env_set —— 语法检查 + 语义抽查
-==========================================================================
-  gcc exit=0
-  条目数: 53
-  重复 key      : 无
-  应有但缺失    : 无
-  残留的错误 key: 无
-  => PASS
-
-==========================================================================
-[C] device_status 收敛 —— -fno-common 下的编译链接对照实验
-==========================================================================
-  对照组(模拟修复前: 1 定义 + 9 个 tentative definition, 全靠 -fcommon):
-    gcc exit=1
-    D:/Strawberry/c/bin/../lib/gcc/x86_64-w64-mingw32/13.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: t0.o:t0.c:(.bss+0x0): multiple definition of `device_status'; def.o:def.c:(.bss+0x0): first defined here
-    => 确实会 multiple definition(修复前的隐患成立)
-  修复组(1 处定义 + 9 个 extern 声明):
-    gcc exit=0
-    => PASS  -fno-common 下也能正常链接
-
-==========================================================================
-总计: 全部通过
-==========================================================================

+ 5 - 4
Application_cbd_apm32f1/applications/dtu_uart2.c

@@ -2284,12 +2284,13 @@ int parseDtu(char *json_string)
               else if (strstr(item_cmd->valuestring,"update")!=RT_NULL)
               {
                   rt_kprintf("准备升级!!!");
-                  device_status.update_flag = 1;
-                  ef_set_env_blob("update_flag", &device_status.update_flag, sizeof(device_status.update_flag));
-                  rt_kprintf("%s\n",makeJson_Warn("system will update","control"));
+                  /* ★ 三通道写入(EasyFlash + 参数快照 + BKP 备份寄存器),
+                     原来只写 EasyFlash, env 一丢重启后就静默跳过升级。 */
+                  Upgrade_Flag_Set();
+                  LOG_I("system will update...");
                   rt_thread_delay(2000);
                   DTU_Write("%s",makeJson_Warn("system will update","control"));
-                  rt_thread_delay(20);
+                  rt_thread_delay(100);
                   rt_hw_cpu_reset();
               }
               else if (strstr(item_cmd->valuestring,"read")!=RT_NULL)

+ 127 - 7
Application_cbd_apm32f1/applications/hmi.c

@@ -1354,8 +1354,9 @@ static void HMI_Decode(void)
     //屏幕上触发远程升级
     else if (strstr(rx_buffer,"hmi_update")!=NULL) {
         DTU_Write("hmi_update");
-        device_status.update_flag = 1;
-        ef_set_env_blob("update_flag", &device_status.update_flag, sizeof(device_status.update_flag));
+        /* ★ 原来只写 EasyFlash 一条通道, 没同步参数快照;
+           走三通道写入, 保证重启后一定能判到升级请求。 */
+        Upgrade_Flag_Set();
         rt_thread_delay(2000);
         rt_hw_cpu_reset();
 
@@ -1721,6 +1722,69 @@ int Hmi_Fresh(void)
     }
     return ret;
 }
+/* ===================== 升级标志 update_flag 的三通道持久化 =====================
+   原实现只有一条路径: ef_set_env_blob("update_flag") 写 EasyFlash env。
+   而 EasyFlash 正是现场"概率丢参数"的重灾区(env 区损坏 / GC 中断 / 整片 flash
+   探测失败), 标志一旦没写进去或重启后读不出来, 触发升级后重启就静静地把升级
+   跳过了 —— 串口只有一句 "REBOOT_TIME:x-x-0", 没有任何报错, 极难排查。
+   这里改成三条通道同时写、开机任一为 1 即生效:
+     ① EasyFlash env          —— 原有通道, 保留兼容
+     ② param_a/param_b 快照   —— 独立于 env 区的 4KB 双分区 + CRC32
+     ③ RTC 备份寄存器 BKP_DR3 —— 完全不依赖 SPI flash, 软件复位后仍保持
+   BKP 通道的价值在于: env 区(0~128KB)损坏 ≠ 整片 flash 坏, 固件下载区
+   fm_area(3MB 处)可能仍然完好; 此时靠 BKP 依然能把升级请求带过重启。 */
+#ifndef BKP_BASE
+#define BKP_BASE  (0x40006C00UL)   /* APM32F103 RTC/BKP 基址, 与 main.c 一致 */
+#endif
+/* RTC_BKP_DR2 已被 bootloader 的 boot_flag 占用, 这里用 DR3 / DR4 */
+#define UPG_BKP_DR3    (*(__IO uint16_t *)(BKP_BASE + 4U * 3U))
+#define UPG_BKP_DR4    (*(__IO uint16_t *)(BKP_BASE + 4U * 4U))
+#define UPG_BKP_MAGIC  (0x5AA5U)
+#define UPG_TRY_MAX    (3)         /* 连续失败上限, 防 ymodem 反复重启死循环 */
+
+void Upgrade_Flag_Set(void)
+{
+    device_status.update_flag = 1;
+    ef_set_env_blob("update_flag", &device_status.update_flag, sizeof(device_status.update_flag));
+    param_mark_dirty();
+    param_flush_force();
+    UPG_BKP_DR3 = UPG_BKP_MAGIC;
+    UPG_BKP_DR4 = 0;
+    LOG_I("[upgrade] request SET (easyflash + snapshot + BKP)");
+}
+
+void Upgrade_Flag_Clear(void)
+{
+    device_status.update_flag = 0;
+    ef_set_env_blob("update_flag", &device_status.update_flag, sizeof(device_status.update_flag));
+    param_mark_dirty();
+    param_flush_force();
+    UPG_BKP_DR3 = 0x0000;
+    LOG_I("[upgrade] request CLEARED");
+}
+
+#ifdef RT_USING_FINSH
+/* 现场诊断: 三条通道各自的状态一眼看全, 不用猜"标志到底存没存住" */
+static void upgrade_flag_stat(void)
+{
+    rt_kprintf("update_flag (RAM)   : %d\n", (int)device_status.update_flag);
+    rt_kprintf("BKP DR3 (no-flash)  : 0x%04x %s\n",
+               (unsigned)UPG_BKP_DR3,
+               (UPG_BKP_DR3 == UPG_BKP_MAGIC) ? "<- PENDING" : "(none)");
+    rt_kprintf("BKP DR4 (fail cnt)  : %d / %d\n", (int)UPG_BKP_DR4, (int)UPG_TRY_MAX);
+    rt_kprintf("easyflash / snapshot: see 'param_dump' and REBOOT_TIME log line\n");
+}
+MSH_CMD_EXPORT(upgrade_flag_stat, show upgrade flag on all 3 channels);
+
+/* 手动置位升级请求(只置位不重启), 用于验证"重启后能否判到升级" */
+static void upgrade_set(int argc, char **argv)
+{
+    Upgrade_Flag_Set();
+    rt_kprintf("upgrade request set on all 3 channels. reboot to start OTA.\n");
+}
+MSH_CMD_EXPORT(upgrade_set, set upgrade request on all 3 channels);
+#endif /* RT_USING_FINSH */
+
 void Check_ParamConfig(void)
 {
     time_t now = time(RT_NULL);
@@ -1733,6 +1797,10 @@ void Check_ParamConfig(void)
     uint32_t        param_boot_seq = 0;
     int             param_boot_snap_ok = 0;
     int             ef_ok = 0;              /* EasyFlash 是否可用 */
+    int             up_flag_ef   = 0;       /* 通道①: EasyFlash 里的升级请求 */
+    int             up_flag_snap = 0;       /* 通道②: 参数快照里的升级请求 */
+    int             up_flag_bkp  = 0;       /* 通道③: RTC 备份寄存器里的升级请求 */
+    int             up_request   = 0;       /* 三通道裁决结果 */
 
     /* ★ flash 健康检查门控(2026-09-24 加固)
        SPI flash 探测失败(虚焊/击穿/SPI 不通)时, 原链路会一路"假装正常":
@@ -1755,6 +1823,7 @@ void Check_ParamConfig(void)
         ef_ok = 1;
         ef_get_env_blob("reboot_time", &device_status.rebootcnt, sizeof(device_status.rebootcnt), NULL); //读出reboot_time的值
         ef_get_env_blob("update_flag", &device_status.update_flag, sizeof(device_status.update_flag), NULL); //读出updateflag的值
+        up_flag_ef = (device_status.update_flag != 0) ? 1 : 0;
         ef_get_env_blob("iSave", &device_status.iSave, sizeof(device_status.iSave), NULL); //判断是否用户配置了程序
         device_status.rebootcnt++;
         /* ★ 原代码在这里立即 ef_set_env_blob("reboot_time") 落 flash。
@@ -1815,7 +1884,13 @@ void Check_ParamConfig(void)
         device_status.passWord = 8888;  //屏幕密码
         device_status.dattim = 10;      //数据上传间隔
         device_status.ds = 1;           //设备状态
-        device_status.update_flag = 0;
+        /* ★ 原代码在这里无条件把 update_flag 清 0。
+           走到这个分支只说明 iSave 这条 env 丢了(EasyFlash 局部损坏),
+           并不代表升级请求是假的 —— 现场表现就是:
+           参数丢了 -> 升级标志被顺手抹掉 -> 触发升级后重启静静跳过升级。
+           这里改为保留已读到的升级请求, 交给下面的三通道统一裁决。 */
+        device_status.update_flag = ((up_flag_ef != 0)
+                                     || (param_boot_snap_ok && param_boot_snap.update_flag != 0)) ? 1 : 0;
         /*孢子仪*/
         device_status.collecting_sh1 = 9;
         device_status.collecting_eh1 = 10;
@@ -1965,7 +2040,14 @@ void Check_ParamConfig(void)
                 if(param_boot_snap_ok && (param_check_health(&param_boot_snap) == 0))
                 {
                     uint32_t rc = device_status.rebootcnt;   /* 保留本次开机累加 */
+                    /* ★ update_flag 是"一次性待办", 不能让旧快照把它回滚掉:
+                       快照可能是上一次运行早期落的(那时还没置升级标志)。 */
+                    uint8_t  uf = device_status.update_flag;
                     param_unpack(&param_boot_snap);
+                    if(uf != 0)
+                    {
+                        device_status.update_flag = 1;
+                    }
                     if(rc > device_status.rebootcnt)
                     {
                         device_status.rebootcnt = rc;
@@ -2072,14 +2154,52 @@ void Check_ParamConfig(void)
        把"改一条参数擦一次 flash"变成"一批改动擦一次"。 */
     param_backup_start();
 
+    /* ===== 升级请求: 三通道裁决 =====
+       ① EasyFlash env("update_flag")
+       ② param_a / param_b 参数快照
+       ③ RTC 备份寄存器 BKP_DR3(不依赖 SPI flash)
+       任一为 1 即判定本次开机为"升级启动"。原来只看 ①, env 一丢
+       升级就被静默跳过(串口连一句报错都没有), 这是升级时好时坏的根因。 */
+    up_flag_ef   = (device_status.update_flag != 0) ? 1 : 0;
+    up_flag_snap = (param_boot_snap_ok && (param_boot_snap.update_flag != 0)) ? 1 : 0;
+    up_flag_bkp  = (UPG_BKP_DR3 == UPG_BKP_MAGIC) ? 1 : 0;
+    up_request   = (up_flag_ef || up_flag_snap || up_flag_bkp);
+    LOG_I("[upgrade] flag ef=%d snap=%d bkp=%d -> %s",
+          up_flag_ef, up_flag_snap, up_flag_bkp,
+          up_request ? "OTA START" : "normal boot");
+
     //RTC时间判断,如果当前年份小于2020,提示需要设置时间,切换为光控
-    if(device_status.update_flag==1)
+    if(up_request)
     {
-        device_status.update_flag = 0;
-        ef_set_env_blob("update_flag", &device_status.update_flag, sizeof(device_status.update_flag));
-        ymodem_ota(1,0);
+        /* 连续失败上限: ymodem_ota 无论成功失败最后都会复位,
+           不设闸就会变成"重启 -> 升级失败 -> 重启"的死循环。 */
+        uint16_t tries = UPG_BKP_DR4;
+
+        if (tries >= UPG_TRY_MAX)
+        {
+            LOG_E("[upgrade] ABORTED: %d consecutive failures, request cleared", (int)tries);
+            Upgrade_Flag_Clear();
+            UPG_BKP_DR4 = 0;
+        }
+        else
+        {
+            UPG_BKP_DR4 = (uint16_t)(tries + 1);
+            /* ★ 三通道全部先清再进 ymodem, 保证只触发一次 */
+            Upgrade_Flag_Clear();
+            if (!nor_flash0_is_ready())
+            {
+                /* env 区坏不等于整片坏, 但整片探测不到时 fm_area 也写不进去,
+                   与其让 ymodem 在空指针上崩, 不如明确放弃并继续正常运行。 */
+                LOG_E("[upgrade] ABORTED: spi flash not ready, fm_area unavailable");
+            }
+            else
+            {
+                ymodem_ota(1,0);
+            }
+        }
     }
     else {
+        UPG_BKP_DR4 = 0;
         device_status.update_flag = 0;
         //初始化联网状态
         rt_sprintf(device_status.net,"1");

+ 6 - 0
Application_cbd_apm32f1/applications/hmi.h

@@ -80,6 +80,12 @@ typedef struct {
 void process_hex_payload(const char* hex_str, int req_id);
 
 void Check_ParamConfig(void);
+/* 升级标志(update_flag)的三通道持久化接口。
+   置位/清位会同时写 EasyFlash env、param_a/b 参数快照、RTC 备份寄存器 BKP_DR3,
+   开机只要任一通道为 1 就判定为"有升级请求", 避免单一通道损坏导致升级失效。
+   详见 readme.md 专题第十三节。 */
+void Upgrade_Flag_Set(void);
+void Upgrade_Flag_Clear(void);
 void HMI_WRITE(char *fmt,...);
 void Fresh_Hmi(void);
 int Hmi_Fresh(void);

+ 101 - 0
Application_cbd_apm32f1/readme.md

@@ -363,12 +363,113 @@ sfud 探测失败 → ready=0,len 保留 → FAL 正常建表(init_ok=1)
 
 ---
 
+## 十三、触发升级后重启不执行升级(第四轮修复)
+
+### 现场现象
+
+触发升级(平台 `{"cmd":"update"}` 或屏幕 `hmi_update`)后设备重启,**升级没有执行**,
+串口除了开机那行 `REBOOT_TIME:x-x-0` 之外**没有任何报错**,看不出被跳过了。
+
+### 根因:升级请求只有一条通道,而且恰好是最不可靠的那条
+
+原链路全靠 EasyFlash 的一条 env:
+
+```
+置位: ef_set_env_blob("update_flag", 1) ──> 重启 ──> ef_get_env_blob("update_flag") ──> ==1 才 ymodem_ota
+```
+
+这条链路上有 **4 个断点**,任意一个命中就是"静静跳过":
+
+| # | 断点 | 位置 | 触发条件 |
+|---|---|---|---|
+| 1 | env 没写进去 / 重启后读不出来 | EasyFlash ENV 区 | 本专题第二节那 9 条根因(GC 中断、ENV_PRE_WRITE 被打断……)**正是这条 env** |
+| 2 | **参数丢失时把升级标志一起抹掉** | `hmi.c` 原 1818 | `iSave != FLASH_FLAG` 走默认配置分支,里面有 `update_flag = 0;` —— 现场"概率丢参数"一发生,升级必然失效 |
+| 3 | **快照回滚把标志冲掉** | `hmi.c` 原 1968 | `param_unpack()` 整包覆盖 `device_status`;快照可能是上次运行早期落的(那时还没置位) |
+| 4 | 屏幕触发路径没同步快照 | `hmi.c` 原 1357 | 只写了 EasyFlash,没写 `param_a/b`,双备份形同虚设 |
+
+### 修法:`update_flag` 三通道持久化
+
+新增 `Upgrade_Flag_Set()` / `Upgrade_Flag_Clear()`(`hmi.h` 导出),**置位和清位都同时写三条通道**,
+开机只要任一为 1 就判定"本次是升级启动":
+
+| 通道 | 载体 | 特点 |
+|---|---|---|
+| ① EasyFlash env | `update_flag` | 原有通道,保留兼容 |
+| ② param_a/b 快照 | `param_persist_t.update_flag` | 独立于 env 区的 4KB 双分区 + CRC32 |
+| ③ **RTC 备份寄存器 BKP_DR3** | 魔数 `0x5AA5` | **完全不依赖 SPI flash**,靠 MCU 后备域保存 |
+
+配套改了 5 处:
+
+1. **三通道置位/清位**(`Upgrade_Flag_Set` / `Upgrade_Flag_Clear`),屏幕路径与平台路径都改走它
+2. **开机三通道裁决**:`up_request = up_flag_ef || up_flag_snap || up_flag_bkp`,并打日志
+   `[upgrade] flag ef=%d snap=%d bkp=%d -> OTA START / normal boot`
+3. **去掉默认配置分支的无条件清零**:改为 `up_flag_ef || snap_flag` 的裁决结果 —— 参数丢了不等于升级请求是假的
+4. **快照回滚不再覆盖标志**:`param_unpack()` 后把已置位的 `update_flag` OR 回去
+5. **连续失败上限**:BKP_DR4 计数,`UPG_TRY_MAX = 3`。`ymodem_ota()` 无论成功失败最后都会 `rt_hw_cpu_reset()`,
+   没有这道闸就会变成"重启 → 升级失败 → 重启"的死循环
+
+### 为什么 BKP 通道能救场
+
+关键判断:**env 区(0~128KB)损坏 ≠ 整片 flash 坏**,固件下载区 `fm_area` 在 3MB 处,很可能完好。
+BKP 不经过 SPI flash,所以即使 EasyFlash 完全不可用,升级请求照样能带过重启。
+
+注意两点:
+- BKP 依赖后备域供电。**软件复位(`rt_hw_cpu_reset`)一定保持**,升级流程正是软件复位,够用;
+  完全断电则取决于 VBAT 有没有电池,这一点现场要确认。
+- `BKP_BASE + 4*3`(DR3)与 `+4*4`(DR4)是本工程新增占用;DR2 仍是 bootloader 的 `boot_flag`,未动。
+
+### 现场诊断
+
+新增两条 msh 命令:
+
+```
+msh >upgrade_flag_stat       # 一眼看全三条通道各自的状态
+msh >upgrade_set             # 手动置位三通道(只置位不重启), 用来验证"重启后能否判到升级"
+```
+
+开机日志里认这一行:
+
+```
+[I/hmi] [upgrade] flag ef=1 snap=1 bkp=1 -> OTA START
+[I/hmi] [upgrade] request CLEARED
+```
+
+三个值有任意一个为 1 就会进 OTA;全是 0 说明置位那一侧根本没写进去,用 `upgrade_flag_stat` 复查。
+
+### 本轮改动文件
+
+| 文件 | 改动 |
+|---|---|
+| `applications/hmi.h` | 导出 `Upgrade_Flag_Set` / `Upgrade_Flag_Clear` |
+| `applications/hmi.c` | 新增两个函数 + BKP 宏;三通道裁决;去掉无条件清零;快照回滚保留标志;失败上限;两条 msh 命令 |
+| `applications/dtu_uart2.c` | 平台 `update` 分支改走 `Upgrade_Flag_Set()` |
+
+### 校验
+
+新增 `.workbuddy/tools/upgrade_flag_check.py`(从 `control.h` 抽真实结构体做桩,宿主 gcc `-Wall -Wextra`):
+
+```
+[A] Upgrade_Flag_Set/Clear  gcc exit=0   PASS
+[B] hmi.c / dtu_uart2.c 大括号配平       PASS
+[C] 10 项符号与调用点核对                 PASS
+[D] 逻辑风险项(无误清零/不回滚/三通道齐全) PASS
+=== 汇总: A=PASS B=PASS C=PASS D=PASS ===
+```
+
+回归:`param_syn_check.py` gcc exit=0;`degraded_boot_check.py` exit=0。
+
+上板前照旧:RT-Thread Studio **Refresh(F5) + Clean + Build**。
+
+---
+
 # 2026-09-24
 	#define VERSION_HK_2000W    "2.48.4(jjk-5)"           //经济款
 	1. 重要参数丢失的参数重置;
     2. 【修复】经济款三线电机状态机问题;
     3. 【重构】参数存储加固:EasyFlash 概率丢参数修复 + A/B 双分区备份(详见本文档顶部专题第一节~第九节);
     4. 【修复】main 线程栈溢出导致开机 hard fault(详见本文档顶部专题第十节);
+    5. 【修复】flash 损坏时死在 fal_partition_find 断言(详见本文档顶部专题第十一、十二节);
+    6. 【修复】触发升级后重启不执行升级:update_flag 改 EasyFlash + 参数快照 + BKP 备份寄存器三通道持久化(详见本文档顶部专题第十三节);
     5. 【修复】flash 损坏时 fal_partition_find 断言死循环、整机卡死(详见本文档顶部专题第十二节);
     5. 【加固】SPI flash 物理损坏时降级启动,不再变砖(详见本文档顶部专题第十一节);
 # 2026-09-23