Quellcode durchsuchen

update dont need reboot

zhunk vor 1 Monat
Ursprung
Commit
e10ed73b01

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

@@ -266,3 +266,48 @@ fal_init_check / nor_flash0_is_ready 声明(消除 implicit declaration 误报),
 桩要补 `__IO`、`rt_uint32_t`、`BKP_BASE`。
 
 ### 已写入 readme.md 第十三节 + 日期条目第 6 条索引
+
+## 升级改为"收到指令直接进 ymodem"(第九轮)
+
+用户拍板: **不要标志位重启那套**, 收到 update 指令后停掉其他线程, 直接 `ymodem_ota(1,0)`。
+并明确: 该分支内**不能用 rt_kprintf**, 因为 OTA 会把调试口切到 uart2 当 ymodem 接收口。
+
+### 两个关键事实(查证所得, 以后别再查一遍)
+1. 🔴 **`ymodem_ota.c:117` 有 `rt_console_set_device("uart2")`** —— 此后所有
+   rt_kprintf / LOG 都打到 uart2, 直接污染 ymodem 数据流。所以升级分支只能用
+   LOG_W 且必须在调用 ymodem_ota 之前打完。
+2. 🔴 **`DTU_UART_NAME` 就是 `"uart2"`**(dtu_uart2.h:14) —— DTU 与工控机通信
+   和 ymodem 接收是**同一个串口**。不停掉 uart2 上的发送源, 传输必然失败:
+   - `timer_uart2`(hmi.c:76) 周期上报 → `rt_timer_stop`
+   - `dtu_send_data` 线程 → `rt_thread_delete`
+   (工程先例: dtu_uart2.c:1885 upgradehmi 分支就删 dtu_send_data)
+
+### 改动
+- `dtu_uart2.c` update 分支: 删 rt_kprintf → LOG_W; 停 timer_uart2 + dtu_send_data;
+  `Upgrade_Flag_Clear()` 清残留(防 reset 后开机又进 OTA); thread_delete_workloop();
+  thread_delete_adc(); ymodem_ota(1,0)。**不再 Upgrade_Flag_Set / rt_hw_cpu_reset**。
+- `sht30_collect.c/.h`: **新增 `thread_delete_adc()`**(原本不存在)。
+  ⚠️ 不能直接 rt_thread_delete: adc 线程正持有 ADC 设备锁时强删会死锁。
+  改为置 `g_adc_thread_stop` → 线程自己 break 退出 → 用
+  `rt_thread_find("adc_thread")` 轮询确认(最多 1s) → 超时才强删兜底。
+  adc 线程每 5s 打 3 行日志, 且雨控分支会真执行 ctr_lamp(OFF)/ctr_up_motor=2 —— 必须停。
+- `hmi.c`: 新增 msh 命令 `upgrade_clear`(老设备残留 update_flag=1 会开机误进 ymodem)。
+
+### 看门狗已排查, 无需处理(结论记下来)
+syswatch WDT=5s / EXCEPT_TIMEOUT=60s / RESOLVE_MODE=2:
+- 喂狗靠 syswatch 线程每秒执行, OTA 期间照跑 → 不会被看门狗复位;
+- `syswatch_thread_switch_hook`(syswatch.c:286-288) 切到 idle 时清零 sec_cnt,
+  ymodem 阻塞会让出 CPU 切 idle → 不会误判异常线程。
+
+### 未改(待用户定)
+`hmi.c:1355` 屏幕 `hmi_update` 仍是"置标志 + 重启", 依赖 EasyFlash。已写进 readme 待确认。
+
+### 校验
+新增 `.workbuddy/tools/ota_direct_check.py`: [A] thread_delete_adc gcc / [B] update
+分支 gcc / [C] 12 项语义符号核对(含"分支内禁止 rt_kprintf") / [D] 配平 —— 全通过。
+同步更新了 `upgrade_flag_check.py` 的 [C] 断言(改为"直接 ymodem_ota、不再 Set")。
+回归 param_syn_check / degraded_boot_check exit=0。
+踩坑: 检测"是否有 rt_kprintf"前**必须先剥注释**(注释里会提到该字样);
+桩里不要重复声明 strstr(与 <string.h> 冲突)。
+
+### 已写入 readme.md 第十四节 + 日期条目第 7 条索引

+ 90 - 0
Application_cbd_apm32f1/.workbuddy/memory/2026-09-26.md

@@ -0,0 +1,90 @@
+# 2026-09-26
+
+## 升级前停掉全部"持续打印日志"的线程(线程清理第六轮)
+
+用户要求: **把涉及日志持续打印的线程, 升级前全部退出**。
+
+### 背景
+上一轮(09-24)只停了 `thread_delete_workloop()` + `thread_delete_adc()` 两个。
+但 ymodem 期间 console 已被 `rt_console_set_device("uart2")` 切到 uart2,
+**任何还在跑的线程只要打一行日志就会污染 ymodem 字节流**。排查后还有一批在持续打印。
+
+### 🔴 最大的坑: RT_NAME_MAX = 8, 线程名被截断到 7 字符
+`rtconfig.h:8` `#define RT_NAME_MAX 8`。内核 `rt_object_init` 只存前 7 个字符:
+| 创建时 | 内核里 |
+|---|---|
+| Control_Clear_thread_entry | `Control` |
+| Control_Check_thread_entry | `Control` ← 与上面撞名 |
+| DTU_Uart_thread_send | `DTU_Uar` |
+| DTU_Uart_thread_recv | `DTU_Uar` ← **与上面撞名, 而且它就是执行升级的当前线程** |
+
+→ **`rt_thread_find(全名)` 在这套工程里不可靠, 甚至会把调用者自己删掉。**
+以后凡是要按名字操作线程, 都要记住这一点。
+
+### 解法: 遍历线程对象 + 前缀匹配 + 跳过自身
+`list_thread`(finsh/cmd.c) 就是这么做的。关键 API 都可用:
+- `rt_object_get_information(RT_Object_Class_Thread)` → `->object_list`
+- `rt_list_for_each` / `rt_list_entry(node, struct rt_thread, list)`
+  ⚠️ `struct rt_thread` 的 rt_object 部分是**内联展开**的(name/type/flags/list 直接在最前面),
+  不是 `struct rt_object parent;`, 所以 member 用 `list`。
+- `rt_container_of` 定义在 rtservice.h:33
+
+新增 `thread_stop_all_for_ota()`(control.c, control.h 导出), 三个要点:
+1. `ota_name_match()` 比较长度截到 `RT_NAME_MAX-1` → "Control" 能同时命中两个;
+2. **显式跳过 `rt_thread_self()`** → 解决 `DTU_Uar` 撞名删掉自己的问题;
+3. **先收集到数组再删**, 遍历期间 `rt_enter_critical()` 保护链表(边遍历边删会把链表走坏)。
+
+退出顺序: ① thread_delete_adc() 优雅退出(它可能持 ADC 设备锁)
+② `device_status.update_flag = 1`(**只改 RAM, 绝不落盘**)让带 `update_flag==1 break`
+   的 Control_Clear / Control_Check / thread_485play 自行退出
+③ mdelay(300) ④ 收集 + 强删其余
+
+### 要停的 17 个业务线程(前缀匹配已实测全覆盖, 0 漏网)
+work_lo / work_st / Control(×2) / thread_(485play) / adc_thr / Power C /
+Hmi_Fre / Ctr mot / sys_mon / param_s / DTU_Uar(send+recv) / Uart5_t / md_m_po / md_m_se / usage
+
+**必须保留**: syswatch(喂狗, 删了 5s 后看门狗复位) / tshell / tidle / main。
+注意 syswatch 的线程名走宏 `SYSWATCH_THREAD_NAME`, 不在字面量里, 验证脚本要单独解析。
+
+### 用户已删除的东西(这次核对时发现, 与我的记忆不一致)
+hmi.c 里 **`Upgrade_Flag_Set` / `Upgrade_Flag_Clear` 的定义、`UPG_BKP_*` 宏、
+`upgrade_set`/`upgrade_clear` 两条 msh 命令、`hmi_update` 分支体、开机侧 ymodem 分支
+全部被删**。现在**升级只有 dtu_uart2.c 一条入口**。
+→ 所以上一轮 readme 里"进 ymodem 前先清标志"那一步已经不存在。
+
+### 🔴 顺带修掉一个必然链接失败的悬空调用
+`dtu_uart2.c` 里我上一轮写的 `Upgrade_Flag_Clear()` 调用点还在, 但函数定义已被用户删掉
+→ `undefined reference`。**已删除该调用**, 并清理 hmi.h 里的悬空声明。
+教训: **函数被删时要全局搜调用点**。这条已做成脚本 `upgrade_flag_check.py` 的 [B] 项。
+
+### ⚠️ 遗留隐患(未擅自改, 已写进 readme 待用户决定)
+`hmi.c:1826`(iSave 丢失分支)仍有:
+```c
+device_status.update_flag = ((up_flag_ef != 0)
+                             || (param_boot_snap_ok && param_boot_snap.update_flag != 0)) ? 1 : 0;
+```
+消费端(开机进 ymodem)已删, 但它会把 flash/快照里残留的 1 恢复到 RAM →
+**Control_Clear / Control_Check / thread_485play 会一开机就 break 退出 → 不清扫/不恒温/不播报**。
+且 `upgrade_clear` 命令已删, 现场没法手动清。建议改回 `= 0`。
+
+### 校验
+新工具 `.workbuddy/tools/ota_thread_stop_check.py`:
+[A] thread_stop_all_for_ota gcc exit=0
+[B] 11 项语义核对(遍历/跳过自身/先收集后删/只改 RAM/未调 Set)
+[C] ★覆盖性验证: 从 applications + packages/syswatch-latest 提取全部线程名,
+    按 RT_NAME_MAX=8 模拟截断+前缀匹配 → 17 个全部命中, 0 漏网; syswatch 确认 KEEP
+[D] 配平 —— 全通过
+
+`ota_direct_check.py` 的断言已同步更新(改为"调 thread_stop_all_for_ota / 不写 flash 标志")。
+`upgrade_flag_check.py` **已改写为"升级机制现状检查"**(原三通道断言随机制废弃失效),
+核心是守 [B] 项: 全工程无对已删函数的代码级调用。
+回归: param_syn_check gcc exit=0; degraded_boot_check exit=0。
+
+踩坑: [C] 覆盖性验证第一次扫全工程, 把未参与编译的组件源码(ulog/at_cli/dhcpd/phy/
+mouse0/sdio/alarmsvc...)也算进来了, 误报 16 个"漏网"。已把范围收窄到
+applications/ + packages/syswatch-latest/; 并核实 rtconfig.h **没有 ULOG 宏**
+(所以不存在 ulog_async 异步日志线程)。
+调试提示: 桩里 `rt_container_of` 用 `(unsigned long)` 在本机 64 位 gcc 上会报
+pointer-to-int-cast 警告, 属于桩/宿主差异, 非源码问题。
+
+### 已写入 readme.md 第十五节 + 日期条目第 8 条索引

+ 60 - 10
Application_cbd_apm32f1/.workbuddy/memory/MEMORY.md

@@ -8,16 +8,53 @@
   待确认项在文档里单列"已知未修",不要擅自改行为。
 - 用户 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 回去。
+## 🔴 升级机制现状(2026-09-26 第五、六轮后,以此为准)
+- **升级只有一条入口**: `dtu_uart2.c` 收到远程 `update` 指令后,**在本线程直接调 `ymodem_ota(1,0)`**。
+  **不再"置标志 + 重启"**——那条路要过 EasyFlash,参数一丢标志就没了(现场升级静默失效的主因)。
+- 历史上的 `Upgrade_Flag_Set/Clear`、`UPG_BKP_DR3/DR4` 宏、`upgrade_set`/`upgrade_clear`
+  msh 命令、`hmi.c` 的 `hmi_update` 分支体、开机侧 ymodem 分支 **全部已被用户删除**(2026-09-26 核实)。
+  ⚠️ 提到这些名字时先 grep 确认,别再照着旧记忆改。
+- 🔴 **`ymodem_ota.c:117` 有 `rt_console_set_device("uart2")`** —— 调试口被切成 ymodem 接收口。
+  此后**任何线程的 rt_kprintf / LOG 都会污染 ymodem 字节流**。所以升级分支内禁止 rt_kprintf
+  (只能用 LOG_W,且必须在调用 ymodem_ota 之前打完)。
+- 🔴 **`DTU_UART_NAME` 就是 `"uart2"`**(dtu_uart2.h:14)—— DTU 通信与 ymodem 接收**同一个串口**。
+  进入 ymodem 前必须先停 uart2 上的发送源: `rt_timer_stop(timer_uart2)` +
+  `rt_thread_delete(dtu_send_data)`,否则传输必被打断。
+- 升级前统一调 **`thread_stop_all_for_ota()`**(control.c,control.h 导出)停掉全部业务线程,详见下一节。
+- `syswatch` 看门狗无需处理: 喂狗靠 syswatch 线程每秒执行,OTA 期间照跑;且
+  `syswatch_thread_switch_hook`(syswatch.c:286-288) 在切到 idle 时会清零计数,
+  ymodem 阻塞会让出 CPU → 不会误判异常线程。
+- ⚠️ 遗留隐患: `hmi.c` 的 `iSave != FLASH_FLAG` 分支仍会把 flash/快照里残留的
+  `update_flag=1` 恢复到 RAM,而 Control_Clear / Control_Check / thread_485play 会靠它 break
+  → 会被误认为"有升级请求"而一开机就退出(不清扫/不恒温)。已告知用户,未擅自改。
+
+## 🔴 线程名与线程清理(2026-09-26,重要)
+- **`RT_NAME_MAX = 8`**(rtconfig.h:8)→ 内核**只存前 7 个字符**。实测撞名:
+  `Control_Clear_thread_entry` 与 `Control_Check_thread_entry` 都变成 `Control`;
+  `DTU_Uart_thread_send` 与 `DTU_Uart_thread_recv` 都变成 `DTU_Uar`
+  —— 后者**就是执行升级的当前线程**。
+  → **禁止用 `rt_thread_find(全名)` 操作线程**,可能删错甚至删掉自己。
+- 正确做法(`list_thread` 同款): 遍历 `rt_object_get_information(RT_Object_Class_Thread)->object_list`
+  + `rt_list_for_each` + `rt_list_entry(node, struct rt_thread, list)` + **前缀匹配**
+  (比较长度截到 RT_NAME_MAX-1)+ **显式跳过 `rt_thread_self()`**。
+  ⚠️ `struct rt_thread` 的 rt_object 部分是**内联展开**(name/type/flags/list 在最前面),
+  没有 `struct rt_object parent;` 成员,所以 member 用 `list`。
+- **先收集到数组再删**(遍历中删节点会把链表走坏),遍历期间 `rt_enter_critical()`。
+- `thread_stop_all_for_ota()` 的保留名单: **syswatch(喂狗) / tshell / tidle / main**。
+  注意 `syswatch` 线程名走宏 `SYSWATCH_THREAD_NAME`,不是字面量。
+- 需要停的 17 个业务线程及其截断名,见 `.workbuddy/tools/ota_thread_stop_check.py` 的 [C] 项输出。
+- 停线程顺序: ① `thread_delete_adc()` 优雅退出(它可能持 ADC 设备锁, 强删会死锁)
+  ② RAM 内置 `device_status.update_flag = 1`(**绝不落盘**)让带 break 的线程自己退
+  ③ mdelay(300) ④ 收集 + 强删其余。
+
+## 升级标志 update_flag(2026-09-24 第八轮 —— 机制已于 09-26 废弃,留作历史)
+- 当年方案: 三通道 ① EasyFlash env ② param_a/b 快照 ③ RTC BKP_DR3(魔数 0x5AA5),
+  置位/清位调 `Upgrade_Flag_Set()` / `Upgrade_Flag_Clear()`。
+- ⚠️ 这套函数**现在已不存在**(定义被删)。若还要用三通道思路,需重新实现;
+  当前 `update_flag` 的唯一用途是"RAM 置 1 触发线程 break 退出",全程不写 flash。
+- 历史经验仍有价值: ① 单通道存标志必丢 → 至少双通道; ② `iSave != FLASH_FLAG` 分支
+  **不许无条件清零 update_flag**;③ `param_unpack()` 整包覆盖后要把已置位的 flag OR 回去;
+  ④ `ymodem_ota()` 成功失败都会 `rt_hw_cpu_reset()`,必须有失败上限防死循环。
 
 ## 版本控制
 - 仓库根 = `D:\RT-ThreadStudio\workspace\IOT_CBD_BZY_CTRL`(本工程是子目录)。HEAD="3.7.13"。
@@ -110,6 +147,19 @@
   `--case 标记` / `--block 起 止`。中间文件 `.workbuddy/tmp_syn.txt` + `gcc -x c`, 跑完自删。
   **改了 control.h 的结构体/原型要同步脚本里的 STUB**。
 - 备份约定: `C:\Users\Administrator\.workbuddy\backups\`(工程外)。
+- 专用检查脚本(都在 `.workbuddy/tools/`, 宿主 gcc + python, 跑完自删中间文件):
+  - `param_syn_check.py` — param_backup 模块 + control.h 真实结构体桩
+  - `ef_key_audit.py` — EasyFlash key/字段错位、default_env_set 重复/缺失审计
+  - `verify_fix.py` — device_status `-fno-common` 对照链接实验
+  - `sizeof_probe.py` — 实测结构体大小(往线程栈放大对象前先量)
+  - `degraded_boot_check.py` — flash 降级启动链路
+  - `ota_direct_check.py` — update 分支(禁 rt_kprintf、停机、进 ymodem)
+  - **`ota_thread_stop_check.py`** — ★含**线程覆盖性验证**: 从源码提取全部线程名,
+    按 RT_NAME_MAX=8 模拟截断+前缀匹配, 报告"漏网"线程。加新线程后跑一次即可确认被覆盖。
+  - `upgrade_flag_check.py` — 已改写为"升级机制现状检查", 核心是守住
+    **"函数删了但调用点还在"** 这类链接错误([B] 项)。
+- **函数被删时务必全局 grep 调用点** —— 2026-09-26 就踩到 `Upgrade_Flag_Clear()`
+  调用点还在而定义已删, 会 undefined reference。
 - `Debug/rtthread.map` 是旧构建产物(含已回退的 ctr_move_pulse), 不要拿来判当前源码状态。
 
 ## device_status 全局唯一定义(2026-09-24 收敛)

+ 131 - 180
Application_cbd_apm32f1/.workbuddy/tools/upgrade_flag_check.py

@@ -1,206 +1,157 @@
 # -*- coding: utf-8 -*-
 """
-升级标志(update_flag)三通道改造的宿主校验(本机无 arm-none-eabi)
+升级机制现状检查(原 upgrade_flag 三通道机制已废弃后的替代校验)
 
-[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] 逻辑风险项核对(防死循环 / 防误清零 / 三通道齐全)
+背景:
+  2026-09-24 曾用"EasyFlash + 参数快照 + BKP_DR3"三通道持久化 update_flag,
+  靠"置标志 -> 重启 -> 开机读回来进 ymodem"。2026-09-24 晚改为
+  **收到 update 指令直接在本线程进 ymodem**, 不再置标志/不重启;
+  随后 hmi.c 里的 Upgrade_Flag_Set/Clear 定义、BKP 宏、相关 msh 命令被移除。
 
-中间文件只写 .txt, 不在工程树留 .c/.h(CDT 会扫进去导致 multiple definition)
+  函数删了但调用点还在 = 链接期 undefined reference, 这是最容易漏的一类问题。
+  本脚本就是盯住它。
+
+[A] 确认 Upgrade_Flag_Set/Clear 的定义已移除(机制废弃)
+[B] ★确认全工程无对它们的"代码级"调用(只允许注释里提到)
+[C] 升级入口核对: update 分支的停机 + 进 ymodem 链路完整
+[D] 括号配平
 """
-import io, os, re, subprocess, sys
+import os, re, 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")
+ROOT = r"D:\RT-ThreadStudio\workspace\IOT_CBD_BZY_CTRL\Application_cbd_apm32f1"
+OUT = os.path.join(ROOT, ".workbuddy", "upgrade_state_out.txt")
+SCAN = ["applications", "drivers", os.path.join("packages", "syswatch-latest")]
 
 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:
+def read(*p):
+    with 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;
-"""
+def strip_comments(t):
+    t = re.sub(r"/\*.*?\*/", "", t, flags=re.S)
+    t = re.sub(r"//[^\n]*", "", t)
+    return t
+
+def walk_c():
+    for sub in SCAN:
+        base = os.path.join(ROOT, sub)
+        if not os.path.isdir(base):
+            continue
+        for dirpath, dirnames, filenames in os.walk(base):
+            for f in filenames:
+                if f.endswith((".c", ".h")):
+                    yield os.path.join(dirpath, f)
+
+log("=" * 66)
+log("升级机制现状检查(三通道机制废弃后)")
+log("=" * 66)
+all_ok = True
+
+# ---------------- [A] 定义已移除 ----------------
+log("")
+log("[A] Upgrade_Flag_Set/Clear 的定义是否已移除")
+defs = []
+for p in walk_c():
+    txt = strip_comments(open(p, "r", encoding="utf-8", errors="ignore").read())
+    for m in re.finditer(r"\bvoid\s+(Upgrade_Flag_(?:Set|Clear))\s*\([^;]*\)\s*\{", txt):
+        defs.append((m.group(1), os.path.relpath(p, ROOT)))
+if defs:
+    for n, p in defs:
+        log("    **FAIL**: 仍有定义 %s 在 %s" % (n, p))
+    all_ok = False
+else:
+    log("    未发现函数定义 -> 机制确已废弃   OK")
 
-src = STUB + "\n" + macros + "\n" + (fset or "") + "\n" + (fclear or "") + "\n"
+# 声明是否也清了
+hmi_h_body = strip_comments(read("applications", "hmi.h"))
+want = ("void Upgrade_Flag_Set(void);" in hmi_h_body
+        or "void Upgrade_Flag_Clear(void);" in hmi_h_body)
+log("    %-52s %s" % ("hmi.h 里的悬空声明已清除", "OK" if not want else "**FAIL**"))
+if want:
+    all_ok = False
 
-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] 括号配平 ----------------
+# ---------------- [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("[B] 全工程是否还有对它们的代码级调用(注释不算)")
+hits = []
+for p in walk_c():
+    raw = open(p, "r", encoding="utf-8", errors="ignore").read()
+    code = strip_comments(raw)
+    for m in re.finditer(r"\b(Upgrade_Flag_(?:Set|Clear))\s*\(", code):
+        # 排除函数定义本身
+        pre = code[max(0, m.start() - 40): m.start()]
+        if re.search(r"\bvoid\s*$", pre):
+            continue
+        ln = code[:m.start()].count("\n") + 1
+        hits.append((os.path.relpath(p, ROOT), ln, m.group(1)))
+if hits:
+    for p, ln, n in hits:
+        log("    **FAIL**: %s:%d 调用了 %s (但定义已删 -> 链接会失败)" % (p, ln, n))
+    all_ok = False
+else:
+    log("    没有任何代码级调用 -> 不会有 undefined reference   OK")
+
+# ---------------- [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),
+log("[C] 升级入口(remote update)链路核对")
+dtu = read("applications", "dtu_uart2.c")
+i = dtu.find('strstr(item_cmd->valuestring,"update")')
+branch, code_only = None, ""
+if i >= 0:
+    j = dtu.find("{", i)
+    d, k = 0, j
+    while k < len(dtu):
+        if dtu[k] == "{":
+            d += 1
+        elif dtu[k] == "}":
+            d -= 1
+            if d == 0:
+                break
+        k += 1
+    branch = dtu[dtu.rfind("else if", 0, i):k + 1]
+    code_only = strip_comments(branch)
+
+ck = [
+    ("找到 update 分支", branch is not None),
+    ("停掉 uart2 上的 dtu_send_data", "rt_thread_delete(dtu_send_data)" in (code_only or "")),
+    ("停掉 uart2 周期上报 timer_uart2", "rt_timer_stop(timer_uart2)" in (code_only or "")),
+    ("调 thread_stop_all_for_ota() 停全部业务线程",
+     "thread_stop_all_for_ota()" in (code_only or "")),
+    ("分支内无 rt_kprintf(会污染 ymodem)", "rt_kprintf" not in (code_only or "")),
+    ("末行进 ymodem_ota(1,0)", "ymodem_ota(1,0)" in (code_only or "")),
+    ("不再走'置标志 + 重启'", "rt_hw_cpu_reset" not in (code_only or "")),
+    ("control.h 已声明 thread_stop_all_for_ota",
+     "int thread_stop_all_for_ota(void);" in strip_comments(read("applications", "control.h"))),
+    ("control.c 已实现 thread_stop_all_for_ota",
+     "int thread_stop_all_for_ota(void)" in strip_comments(read("applications", "control.c"))),
 ]
-ok_c = True
-for name, ok in checks:
-    log("    %-52s %s" % (name, "OK" if ok else "MISSING"))
+for desc, ok in ck:
+    log("    %-52s %s" % (desc, "OK" if ok else "**FAIL**"))
     if not ok:
-        ok_c = False
-log("    -> %s" % ("PASS" if ok_c else "FAIL"))
+        all_ok = False
 
-# ---------------- [D] 逻辑风险 ----------------
+# ---------------- [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("[D] 括号配平")
+for rel in (("applications", "hmi.c"), ("applications", "hmi.h"),
+            ("applications", "control.c"), ("applications", "control.h"),
+            ("applications", "dtu_uart2.c")):
+    t = open(os.path.join(ROOT, *rel), "r", encoding="utf-8", errors="ignore").read()
+    bal = t.count("{") - t.count("}")
+    ok = (bal == 0)
+    log("    %-24s {}-}=%d %s" % (rel[-1], bal, "OK" if ok else "**FAIL**"))
+    if not ok:
+        all_ok = False
 
 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
+log("=" * 66)
+log("总体: %s" % ("全部通过" if all_ok else "存在失败项"))
+log("=" * 66)
 
-with io.open(OUT, "w", encoding="utf-8") as f:
+with 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)
+sys.exit(0 if all_ok else 1)

+ 161 - 0
Application_cbd_apm32f1/applications/control.c

@@ -71,6 +71,167 @@ int thread_restart_workloop(void)
     return result;
 }
 
+/***************************************************************************/
+/* ==================== OTA 升级前的线程清理 ==================== */
+
+#define OTA_THREAD_MAX   24
+
+/* 保留名单: 这几类线程删掉反而会让升级失败 */
+static const char *g_ota_keep[] =
+{
+    "syswatch",     /* 喂狗线程: 删了 5s 后硬件看门狗就复位, 升级必中断 */
+    "tshell",       /* 控制台 */
+    "tidle",
+    "main",
+};
+
+/* 需要停掉的业务线程前缀(写完整名即可, 比较时自动按 RT_NAME_MAX-1 截断)。
+ *
+ *   为什么用"前缀匹配 + 遍历"而不是 rt_thread_find(全名):
+ *     rtconfig.h 里 RT_NAME_MAX = 8, 线程名被内核截断到 7 个字符 ——
+ *       "Control_Clear_thread_entry" / "Control_Check_thread_entry" 都变成 "Control";
+ *       "DTU_Uart_thread_send" / "DTU_Uart_thread_recv" 都截成 "DTU_Uar",
+ *     而 recv 正是执行升级的当前线程, 用 rt_thread_find 有可能把调用者自己删掉。
+ *   所以改成遍历线程对象链表, 并显式跳过 rt_thread_self()。 */
+static const char *g_ota_stop[] =
+{
+    "work_loop_thread",             /* 工作流程, LOG_I/rt_kprintf 密集 */
+    "work_status_check_thread",     /* WorkCheck, 每 10s 一批日志 */
+    "Control_Clear_thread_entry",   /* 清扫, 会驱动电机 */
+    "Control_Check_thread_entry",   /* 恒温, LOG_I("process") 每秒 */
+    "thread_485play",               /* 485 播报 */
+    "adc_thread",                   /* ADC 采集, 每 5s 打 3 行 */
+    "Power Check thread",           /* 每秒读电流/电压 */
+    "Hmi_Fresh_thread",             /* 屏幕刷新 */
+    "Ctr motor",                    /* 仓门/光源, 带 rt_kprintf */
+    "sys_monitor",                  /* CPU/统计 */
+    "param_sv",                     /* 参数落盘: 会擦 flash(4KB≈100ms) 抢 CPU */
+    "DTU_Uart_thread_send",         /* DTU 发送 (recv 是自身, 会被跳过) */
+    "Uart5_thread_recv",            /* 485 透传 */
+    "md_m_poll",                    /* modbus 轮询 */
+    "md_m_send",                    /* modbus 发送 */
+    "usage",                        /* cpu_usage 临时线程 */
+};
+
+/* 名字前缀比较: 内核只存了前 RT_NAME_MAX-1 个字符, 所以最多比这么多 */
+static int ota_name_match(const char *thread_name, const char *prefix)
+{
+    rt_size_t n;
+
+    if (thread_name == RT_NULL || prefix == RT_NULL || thread_name[0] == '\0')
+    {
+        return 0;
+    }
+    n = rt_strlen(prefix);
+    if (n > RT_NAME_MAX - 1)
+    {
+        n = RT_NAME_MAX - 1;
+    }
+    if (n == 0)
+    {
+        return 0;
+    }
+    return (rt_strncmp(thread_name, prefix, n) == 0) ? 1 : 0;
+}
+
+static int ota_in_list(const char *thread_name, const char **list, int cnt)
+{
+    int i;
+
+    for (i = 0; i < cnt; i++)
+    {
+        if (ota_name_match(thread_name, list[i]))
+        {
+            return 1;
+        }
+    }
+    return 0;
+}
+
+/**
+ * OTA 升级前把所有业务线程停掉, 只留 tshell / idle / syswatch。
+ *
+ * 为什么必须停:
+ *   1) ymodem_ota() 会把 console 切到 uart2(ymodem_ota.c:117), 之后**任何线程**
+ *      的 LOG_xxx / rt_kprintf 都会打进 uart2, 直接污染 ymodem 字节流 -> 校验失败;
+ *   2) adc / Power Check 每秒读 ADC, param_sv 会擦 flash(4KB 约 100ms),
+ *      抢 CPU 和外设会让 ymodem 丢字节;
+ *   3) Control_Clear / Control_Check 会驱动电机, 升级过程中不该动机械部件。
+ *
+ * 顺序: ① adc_thread 优雅退出(它可能正持有 ADC 设备锁)
+ *       ② 置 RAM 内退出请求, 让带 `update_flag==1 break` 的线程自己退
+ *       ③ 其余按前缀强删(先收集再删, 不能边遍历边删)
+ *
+ * @return 实际删除的线程数; 负值为错误
+ */
+int thread_stop_all_for_ota(void)
+{
+    struct rt_object_information *info;
+    rt_list_t   *node;
+    rt_thread_t  victims[OTA_THREAD_MAX];
+    rt_thread_t  self;
+    int          nv = 0, i, done = 0;
+
+    info = rt_object_get_information(RT_Object_Class_Thread);
+    if (info == RT_NULL)
+    {
+        LOG_E("[ota] thread object information NOT found");
+        return -RT_ERROR;
+    }
+
+    /* ① adc_thread 必须优雅退出: 直接 rt_thread_delete 若刚好删在
+          rt_adc_enable/read 中间, 它持有的 ADC 设备锁永远不会释放 */
+    thread_delete_adc();
+
+    /* ② 置 RAM 内退出请求。Control_Clear / Control_Check / thread_485play
+          三处都有 `if(device_status.update_flag==1) break;`。
+          ★ 只改 RAM, 绝不写 flash / 参数快照 —— 一旦把 1 落盘, 下次开机会被
+            hmi.c 的 up_flag_* 裁决判成"有升级请求", 而带 break 的线程就会
+            一开机直接退出(设备不清扫、不恒温)。
+          因为全程不落盘, ymodem 结束复位后这个 1 自然消失, 不需要额外清理。 */
+    device_status.update_flag = 1;
+    rt_thread_mdelay(300);
+
+    /* ③ 收集待停线程。必须"先收集后删除": rt_thread_delete 会摘掉链表节点,
+          边遍历边删会把 object_list 走坏 */
+    self = rt_thread_self();
+    rt_enter_critical();
+    rt_list_for_each(node, &info->object_list)
+    {
+        rt_thread_t t = rt_list_entry(node, struct rt_thread, list);
+
+        if (t == self)                                        /* 不能删自己 */
+        {
+            continue;
+        }
+        if (ota_in_list(t->name, g_ota_keep, sizeof(g_ota_keep) / sizeof(g_ota_keep[0])))
+        {
+            continue;
+        }
+        if (!ota_in_list(t->name, g_ota_stop, sizeof(g_ota_stop) / sizeof(g_ota_stop[0])))
+        {
+            continue;                                          /* 不在名单里, 不动 */
+        }
+        if (nv < OTA_THREAD_MAX)
+        {
+            victims[nv++] = t;
+        }
+    }
+    rt_exit_critical();
+
+    /* ④ 逐个删除 */
+    for (i = 0; i < nv; i++)
+    {
+        if (rt_thread_delete(victims[i]) == RT_EOK)
+        {
+            done++;
+        }
+    }
+
+    LOG_I("[ota] stopped %d of %d candidate thread(s)", done, nv);
+    return done;
+}
+
 
 /****************************5.0***********************************/
 void ctr_turnv5(void)

+ 4 - 1
Application_cbd_apm32f1/applications/control.h

@@ -23,7 +23,7 @@
 #define UART_TEST_EN     0             ///串口测试0-关闭,1-启用
 #define TG_MODULE        0             //推杆电机结构模块化控制
 #define DINGZHI_0722     0             //控制一个电机每天12点20工作12秒
-#define QINGSAO_IO       1             //调整清扫顺序20250801
+#define QINGSAO_IO       0             //调整清扫顺序20250801
 #define WENKONG          1             //温控功能1-开启 0-关闭
 #define YUKONG           1             //雨控功能1-开启 0-关闭
 #define QIANYA           1             //欠压功能1-开启 0-关闭
@@ -362,6 +362,9 @@ int thread_485_play(void);
 
 int thread_delete_workloop(void);
 int thread_restart_workloop(void);
+/* OTA 升级前停掉全部业务线程(只留 tshell/idle/syswatch)。
+   返回实际删除的线程数。详见 control.c 的说明。 */
+int thread_stop_all_for_ota(void);
 /*******************************************************/
 void RTU_Power_Off_Safe(void);
 void RTU_Power_On_Restore(void);

+ 45 - 8
Application_cbd_apm32f1/applications/dtu_uart2.c

@@ -2283,15 +2283,52 @@ int parseDtu(char *json_string)
             }
               else if (strstr(item_cmd->valuestring,"update")!=RT_NULL)
               {
-                  rt_kprintf("准备升级!!!");
-                  /* ★ 三通道写入(EasyFlash + 参数快照 + BKP 备份寄存器),
-                     原来只写 EasyFlash, env 一丢重启后就静默跳过升级。 */
-                  Upgrade_Flag_Set();
-                  LOG_I("system will update...");
-                  rt_thread_delay(2000);
+                  /* ★ 直接在本线程进入 ymodem, 不再"置标志 + 重启"。
+                     老路子要把 update_flag 写进 EasyFlash 再靠开机读回来, 而 EasyFlash
+                     正是现场丢参数的重灾区, 标志一丢升级就静默跳过。
+
+                     ★★ 本分支内禁止使用 rt_kprintf ★★
+                     ymodem_ota() 内部会 rt_console_set_device("uart2"), 把调试口切到 uart2
+                     当 ymodem 接收口。此后任何 rt_kprintf 都会往 uart2 打, 直接污染
+                     ymodem 数据流导致校验失败。所以这里一律只用 LOG_W(在切换 console
+                     之前输出, 走 uart1), 且必须在调用 ymodem_ota 之前打完。 */
+
+                  LOG_W("准备升级!!!");
                   DTU_Write("%s",makeJson_Warn("system will update","control"));
-                  rt_thread_delay(100);
-                  rt_hw_cpu_reset();
+                  rt_thread_delay(1000);          /* 让"即将升级"这帧真正发出去 */
+
+                  /* ---- uart2 上的两个发送源先停 ----
+                     DTU 与工控机通信走的就是 uart2(DTU_UART_NAME), 和 ymodem 接收口
+                     是同一个串口。不停掉下面这两个, 上报数据会插进 ymodem 字节流里,
+                     传输必然校验失败。 */
+                  if (timer_uart2 != RT_NULL)
+                  {
+                      rt_timer_stop(timer_uart2);          /* 停 uart2 周期上报 */
+                  }
+                  if (dtu_send_data != RT_NULL)
+                  {
+                      rt_thread_delete(dtu_send_data);     /* 停 uart2 发送线程 */
+                      dtu_send_data = RT_NULL;
+                  }
+
+                  /* ---- 其余业务线程全部停掉 ----
+                     凡是会持续打印日志的线程都必须退: ymodem 期间 console 已被切到
+                     uart2, 它们的每一行日志都会打进 ymodem 数据流。
+                     另外 adc/PowerCheck 每秒读 ADC、param_sv 会擦 flash(4KB≈100ms),
+                     抢 CPU 会让 ymodem 丢字节; Control_Clear/Control_Check 还会驱动电机。
+                     统一由 thread_stop_all_for_ota() 处理(含 workloop / adc_thread)。 */
+                  thread_stop_all_for_ota();
+
+                  /* ---- 关于标志位 ----
+                     thread_stop_all_for_ota() 会让 Control_* 等线程靠 RAM 里的
+                     `device_status.update_flag==1` 自行退出。
+                     ★ 这里不需要也不应该清 flash 里的标志: 全程只改 RAM,
+                       没有把 1 写进 EasyFlash / 参数快照, 所以 ymodem_ota() 结束时的
+                       rt_hw_cpu_reset() 之后 RAM 归零、flash 里仍是 0,
+                       开机不会又被判成"有升级请求"而反复进 OTA。
+                     (原来的 Upgrade_Flag_Set/Clear 三通道机制已随开机 OTA 分支一起移除) */
+
+                  ymodem_ota(1,0);   /* 内部会切 console 到 uart2, 成功/失败均自行复位 */
               }
               else if (strstr(item_cmd->valuestring,"read")!=RT_NULL)
               {

+ 0 - 119
Application_cbd_apm32f1/applications/hmi.c

@@ -1353,12 +1353,6 @@ static void HMI_Decode(void)
     }
     //屏幕上触发远程升级
     else if (strstr(rx_buffer,"hmi_update")!=NULL) {
-        DTU_Write("hmi_update");
-        /* ★ 原来只写 EasyFlash 一条通道, 没同步参数快照;
-           走三通道写入, 保证重启后一定能判到升级请求。 */
-        Upgrade_Flag_Set();
-        rt_thread_delay(2000);
-        rt_hw_cpu_reset();
 
     }else if (strstr(rx_buffer,"SaveRecordParam")!=NULL){
         //"SaveRecordParam:10000-200"
@@ -1722,68 +1716,8 @@ 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)
 {
@@ -2040,14 +1974,7 @@ 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;
@@ -2153,53 +2080,7 @@ void Check_ParamConfig(void)
        会在静默 500ms 后合并成一次 4KB 擦写写入备份分区,
        把"改一条参数擦一次 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(up_request)
     {
-        /* 连续失败上限: 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");

+ 3 - 6
Application_cbd_apm32f1/applications/hmi.h

@@ -80,12 +80,9 @@ 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);
+/* 注: Upgrade_Flag_Set / Upgrade_Flag_Clear 的三通道持久化机制已废弃。
+   升级改为"收到 update 指令直接在本线程进 ymodem"(见 dtu_uart2.c),
+   不再需要把升级请求写进 flash 再靠开机读回来, 相关函数与声明一并移除。 */
 void HMI_WRITE(char *fmt,...);
 void Fresh_Hmi(void);
 int Hmi_Fresh(void);

+ 61 - 0
Application_cbd_apm32f1/applications/sht30_collect.c

@@ -58,6 +58,12 @@ int8_t hum_value,tem_value;
 static rt_thread_t tid1 = RT_NULL;
 static rt_thread_t tid2 = RT_NULL;
 
+/* ADC 采集线程退出请求标志。
+   OTA 升级前置位让线程自己退出, 而不是直接 rt_thread_delete —— 后者若刚好
+   删在 rt_adc_enable/read 期间, 线程持有的 ADC 设备锁永远不会被释放,
+   后面再有人读 ADC 就会死锁。 */
+static volatile uint8_t g_adc_thread_stop = 0;
+
 ADC_HandleTypeDef hadc1;
 
 int Read_Heat_Current(void);
@@ -156,6 +162,13 @@ static void adc_collect_thread_entry(void *parameter)
     static unsigned log_cnt = 0;
     while (1)
     {
+        if (g_adc_thread_stop)
+        {
+            /* OTA 升级: 优雅退出, 不要在这里动任何外设 */
+            LOG_I("adc_thread exit by OTA request");
+            tid1 = RT_NULL;
+            break;
+        }
         log_cnt ++;
         rain_value= Read_Rain_Voltage();
         light_value= Read_Light_Voltage();
@@ -577,6 +590,54 @@ int sht30_collect(void)
         rt_thread_startup(tid2);
     return 0;
 }
+
+/**
+ * 删除 ADC 采集线程(OTA 升级前调用)。
+ *
+ * 为什么要停掉它:
+ *   1) 每 100ms 读一次 ADC, 每 5s 打 3 行日志, 占用 CPU 会挤压 ymodem 接收;
+ *   2) 雨控分支会真的执行 ctr_lamp(OFF)/ctr_up_motor=2 —— 升级过程中动电机;
+ *   3) 它和 ymodem 抢 log 输出。
+ *
+ * 做法: 先置退出标志让线程自己跑完当前循环退出(不丢 ADC 设备锁),
+ *       最多等 1s; 超时才强制 rt_thread_delete 兜底。
+ *
+ * @return RT_EOK 成功; -RT_ERROR 线程不存在; 其它为 rt_thread_delete 返回值
+ */
+int thread_delete_adc(void)
+{
+    int i;
+    rt_err_t result = RT_EOK;
+
+    if (tid1 == RT_NULL)
+    {
+        LOG_W("adc_thread not running, skip delete");
+        return -RT_ERROR;
+    }
+
+    g_adc_thread_stop = 1;
+
+    /* 线程周期 100ms, 等 1s 足够它跑到循环出口 */
+    for (i = 0; i < 100; i++)
+    {
+        rt_thread_mdelay(10);
+        if (rt_thread_find("adc_thread") == RT_NULL)
+        {
+            tid1 = RT_NULL;
+            LOG_I("adc_thread deleted gracefully");
+            return RT_EOK;
+        }
+    }
+
+    /* 兜底: 仍没退出才强删 */
+    result = rt_thread_delete(tid1);
+    LOG_W("adc_thread force deleted, ret=%d", result);
+    if (result == RT_EOK)
+    {
+        tid1 = RT_NULL;
+    }
+    return result;
+}
 //控制台打印传感器信息
 void Msh_DisplaySensor(void)
 {

+ 2 - 0
Application_cbd_apm32f1/applications/sht30_collect.h

@@ -24,6 +24,8 @@ int Read_Fuse_Voltage(void);
 int Read_Rain_Voltage(void);
 int Read_Light_Voltage(void);
 int sht30_collect(void);
+/* 删除 ADC 采集线程(OTA 升级前调用, 让出 CPU 与 ADC 外设, 避免干扰 ymodem 接收) */
+int thread_delete_adc(void);
 int Read_Ntc_Voltage(void);
 int TempCalculate(float Rv,int B,int BasicRx);
 short Get_Temprate(void);

+ 289 - 3
Application_cbd_apm32f1/readme.md

@@ -462,6 +462,292 @@ msh >upgrade_set             # 手动置位三通道(只置位不重启), 用来
 
 ---
 
+## 十四、升级改为"收到指令直接进 ymodem"(第五轮,不再置标志重启)
+
+### 为什么又改一版
+
+第十三节做的三通道持久化,本质上还是在修"标志存不住"这个症状。用户拍板:
+**标志这条路本身就该砍掉**——收到升级指令就在当前线程直接进 ymodem,不写标志、不重启。
+
+理由很硬:
+
+1. 只要经过重启,就必然要把标志过一遍 EasyFlash,而 EasyFlash 正是丢参数的重灾区,
+   等于把升级成败押在最不可靠的环节上;
+2. 多一次重启就多一次"卡在 ymodem 干等"的窗口;
+3. 直接进 ymodem 不需要任何持久化,请求丢了也不会"静默跳过"——因为根本没丢这个动作。
+
+### 改后的流程
+
+```c
+else if (strstr(item_cmd->valuestring,"update")!=RT_NULL)
+{
+    LOG_W("准备升级!!!");
+    DTU_Write("%s",makeJson_Warn("system will update","control"));
+    rt_thread_delay(1000);          // 让"即将升级"这帧真正发出去
+
+    Upgrade_Flag_Clear();           // 清残留标志, 防 reset 后再进 OTA
+
+    if (timer_uart2 != RT_NULL)     // 停 uart2 周期上报
+        rt_timer_stop(timer_uart2);
+    if (dtu_send_data != RT_NULL) { // 停 uart2 发送线程
+        rt_thread_delete(dtu_send_data);
+        dtu_send_data = RT_NULL;
+    }
+
+    thread_delete_workloop();       // 停业务线程
+    thread_delete_adc();            // 停 ADC 采集线程
+
+    ymodem_ota(1,0);                // 内部切 console 到 uart2, 成功/失败均自行复位
+}
+```
+
+### ★ 本分支内绝对禁止 `rt_kprintf`
+
+`ymodem_ota()`(`packages/ota_downloader-v1.0.0/src/ymodem_ota.c:117`)里有一句:
+
+```c
+rt_console_set_device("uart2");
+```
+
+**调试口被切成 uart2 当 ymodem 接收口**。此后任何 `rt_kprintf` / `LOG_I` 都会往 uart2 打,
+字节直接插进 ymodem 数据流 → CRC 校验失败 → 升级失败。
+
+所以:
+
+- 本分支只能用 `LOG_W`,且必须在调用 `ymodem_ota()` **之前**打完(此时 console 还是 uart1);
+- 分支内原有的 `rt_kprintf("准备升级!!!")` 已删除。
+
+> 补充:`ymodem_ota` 自己那两句 `rt_kprintf`("Warning: Ymodem has started!"、
+> "Download firmware to flash success.")是官方包自带的,前一句在切换 console 之前(安全),
+> 后一句在切换之后(打在 uart2 上)。已在升级成功之后,不影响传输本身。
+
+### ★ 真正会冲掉 ymodem 的是 uart2 上的 DTU 通信
+
+这点最容易被忽略:**`DTU_UART_NAME` 就是 `"uart2"`**(`dtu_uart2.h:14`),
+和 ymodem 的接收口是**同一个串口**。
+
+| 干扰源 | 行为 | 后果 |
+|---|---|---|
+| `timer_uart2`(hmi.c:76) | 周期性往 uart2 上报数据 | 上报帧插进 ymodem 流 |
+| `dtu_send_data` 线程 | 往 uart2 发 MQTT/上报报文 | 同上,必失败 |
+| `adc_thread` | 每 100ms 读 ADC、每 5s 打 3 行日志;雨控分支会真的执行 `ctr_lamp(OFF)` / `ctr_up_motor=2` | 抢 CPU;升级过程中动电机 |
+| `workloop` | 业务流程 | 同上 |
+
+所以除了用户指定的 `thread_delete_workloop()` / `thread_delete_adc()`,
+**还必须**停 `timer_uart2` 和 `dtu_send_data` —— 否则 ymodem 传输必然被打断。
+(工程里已有先例:`dtu_uart2.c:1885` 的 `upgradehmi` 分支就做了 `rt_thread_delete(dtu_send_data)`。)
+
+### `thread_delete_adc()` 是本次新增的
+
+原来不存在这个函数。实现要点写在 `applications/sht30_collect.c`:
+
+- **不直接 `rt_thread_delete`**:adc 线程正在 `rt_adc_enable/read/disable` 时强删,
+  它持有的 ADC 设备锁永远不会释放,后面再有人读 ADC 就死锁。
+- 改为:置 `g_adc_thread_stop` 标志 → 线程自己跑完当前循环 `break` 退出(不丢锁)
+  → `thread_delete_adc()` 用 `rt_thread_find("adc_thread")` 轮询确认,最多等 1s
+  → 超时才 `rt_thread_delete` 兜底。
+
+### 顺带处理的两件事
+
+1. **`Upgrade_Flag_Clear()`**:`ymodem_ota()` 成功/失败最后都会 `rt_hw_cpu_reset()`。
+   若三通道标志还留着(例如现场之前触发过老逻辑),开机裁决会再次进 ymodem → 反复重启。
+   进 ymodem 前先清干净。
+2. **新增 msh 命令 `upgrade_clear`**:老设备刷新固件后,flash 里可能还残留 `update_flag=1`,
+   开机仍会误进 ymodem 干等。现场先执行 `upgrade_clear` 再重启即可。
+
+### 关于看门狗(已排查,无需处理)
+
+`syswatch` 硬件看门狗 5s、`SYSWATCH_EXCEPT_TIMEOUT=60s`、`RESOLVE_MODE=2`(杀异常线程):
+
+- 喂狗由 syswatch 线程每秒执行一次,OTA 期间它照常跑 → **不会被看门狗复位**;
+- `syswatch_thread_switch_hook`(syswatch.c:286-288)在**切到 idle 线程**时会把
+  `sec_cnt` 清零、`op_step` 回 0。ymodem 阻塞等串口数据时会让出 CPU → 切 idle → 计数重置
+  → **不会误判异常线程**。
+
+所以 OTA 期间不需要动 syswatch。这条结论写在这里,免得下次再查一遍。
+
+### 本轮改动文件
+
+| 文件 | 改动 |
+|---|---|
+| `applications/dtu_uart2.c` | `update` 分支改为直接 OTA;删 `rt_kprintf`;停 `timer_uart2` / `dtu_send_data` |
+| `applications/sht30_collect.c` | 新增 `thread_delete_adc()` + `g_adc_thread_stop` 优雅退出标志 |
+| `applications/sht30_collect.h` | 声明 `thread_delete_adc()` |
+| `applications/hmi.c` | 新增 msh 命令 `upgrade_clear` |
+
+### 校验
+
+新增 `.workbuddy/tools/ota_direct_check.py`:
+
+```
+[A] thread_delete_adc()        gcc exit=0  PASS
+[B] update 分支               gcc exit=0  PASS
+[C] 12 项语义/符号核对(含"分支内禁止 rt_kprintf") 全 OK
+[D] 三个改动文件大括号配平      OK
+=== 总体: 全部通过 ===
+```
+
+回归:`param_syn_check.py` gcc exit=0;`degraded_boot_check.py` exit=0;
+`upgrade_flag_check.py` A/B/C/D 全 PASS(其中 [C] 的断言已同步更新为
+"改为直接 ymodem_ota、不再 Upgrade_Flag_Set")。
+
+### 后续(2026-09-26 已落地)
+
+- `hmi.c` 的屏幕触发 `hmi_update` 分支已被**清空**,屏幕不再触发远程升级;
+- 开机侧进 ymodem 的分支也已**移除** —— 现在升级**只有 `dtu_uart2.c` 一条入口**;
+- `Upgrade_Flag_Set/Clear` 的定义、`UPG_BKP_*` 宏、`upgrade_set`/`upgrade_clear`
+  两条 msh 命令随之在 hmi.c 中删除(`hmi.h` 的悬空声明一并清理)。
+- 因此第十四节里"进 ymodem 前先清标志"这一步不再存在 —— 见第十五节。
+
+---
+
+## 十五、升级前把所有"会持续打印日志"的线程全部停掉(第六轮)
+
+### 为什么要再做一轮
+
+第十四节只停了 `thread_delete_workloop()` + `thread_delete_adc()` 两个。但 ymodem 期间
+console 已被切到 uart2,**任何一个还在跑的线程,只要它打一行日志,就会污染 ymodem 字节流**。
+排查后发现还有一批长驻线程在持续打印,必须一起停。
+
+### 清单:17 个业务线程
+
+| 线程名(创建时) | 内核实际存的名字 | 持续打印 / 干扰 |
+|---|---|---|
+| `work_loop_thread` | `work_lo` | WorkTask,LOG_I / rt_kprintf 密集 |
+| `work_status_check_thread` | `work_st` | WorkCheck,每 10s 一批日志 |
+| `Control_Clear_thread_entry` | `Control` | 清扫,会驱动电机 |
+| `Control_Check_thread_entry` | `Control` | 恒温,`LOG_I("process")` 每秒 |
+| `thread_485play` | `thread_` | 485 播报 |
+| `adc_thread` | `adc_thr` | 每 5s 打 3 行;雨控分支会真的动电机 |
+| `Power Check thread` | `Power C` | 每秒读电流/电压 |
+| `Hmi_Fresh_thread` | `Hmi_Fre` | 屏幕刷新 |
+| `Ctr motor` | `Ctr mot` | 仓门/光源,带 rt_kprintf |
+| `sys_monitor` | `sys_mon` | CPU / 统计 |
+| `param_sv` | `param_s` | **会擦 flash(4KB≈100ms)并抢 CPU** |
+| `DTU_Uart_thread_send` | `DTU_Uar` | 往 uart2 发包(与 ymodem 抢串口) |
+| `Uart5_thread_recv` | `Uart5_t` | 485 透传 |
+| `md_m_poll` / `md_m_send` | `md_m_po` / `md_m_se` | modbus 轮询 |
+| `usage` | `usage` | cpu_usage 临时线程 |
+
+**必须保留**:`syswatch`(喂狗)、`tshell`、`tidle`、`main`。
+
+### ★ 最大的坑:`RT_NAME_MAX = 8`,不能按线程名查找
+
+`rtconfig.h:8` 是 `#define RT_NAME_MAX 8`,内核只存**前 7 个字符**:
+
+| 创建时的名字 | 内核里存成 | 后果 |
+|---|---|---|
+| `Control_Clear_thread_entry` | `Control` | 两者**同名**,无法区分 |
+| `Control_Check_thread_entry` | `Control` | 同上 |
+| `DTU_Uart_thread_send` | `DTU_Uar` | 两者**同名** |
+| `DTU_Uart_thread_recv` | `DTU_Uar` | ← **这就是执行升级的当前线程** |
+
+所以用 `rt_thread_find("DTU_Uart_thread_recv")` 去删,**有可能把调用者自己删掉**。
+`rt_thread_find` 在这套工程里是不可靠的。
+
+### 实现:遍历线程对象 + 名字前缀匹配
+
+新增 `thread_stop_all_for_ota()`(`applications/control.c`,`control.h` 导出),
+照 `list_thread` 的做法遍历内核线程对象链表:
+
+```c
+struct rt_object_information *info = rt_object_get_information(RT_Object_Class_Thread);
+rt_list_for_each(node, &info->object_list)
+{
+    rt_thread_t t = rt_list_entry(node, struct rt_thread, list);
+
+    if (t == self) continue;                       /* 不能删自己 */
+    if (ota_in_list(t->name, g_ota_keep, ...)) continue;
+    if (!ota_in_list(t->name, g_ota_stop, ...)) continue;
+    if (nv < OTA_THREAD_MAX) victims[nv++] = t;     /* 先收集 */
+}
+/* 出了临界区再逐个删 —— 边遍历边删会把 object_list 走坏 */
+```
+
+三个要点:
+
+1. **名字前缀匹配**:`ota_name_match()` 把待比较长度截到 `RT_NAME_MAX-1`,
+   这样 `"Control"` 能同时命中两个 Control 线程,不受截断影响;
+2. **显式跳过 `rt_thread_self()`** —— 解决 `DTU_Uar` 撞名会删掉自己的问题;
+3. **先收集再删除**,遍历期间用 `rt_enter_critical()` 保护链表。
+
+### 退出顺序(优雅优先,强删兜底)
+
+```
+① thread_delete_adc()            先让 adc_thread 优雅退出(它可能持有 ADC 设备锁)
+② device_status.update_flag = 1  置 RAM 退出请求, 让带 `update_flag==1 break` 的
+                                 Control_Clear / Control_Check / thread_485play 自行退出
+                                 ★ 只改 RAM, 不落盘 —— 落盘会让下次开机被判成"有升级请求"
+③ rt_thread_mdelay(300)          给上面三个线程退出留时间
+④ 收集 + rt_thread_delete 其余    逐个强删
+```
+
+### 顺带修掉一个必然会链接失败的悬空调用
+
+`Upgrade_Flag_Set/Clear` 的定义已从 `hmi.c` 删除,但 `dtu_uart2.c` 里还留着
+`Upgrade_Flag_Clear()` 调用 —— 会 `undefined reference`。
+已删除该调用,并把 `hmi.h` 里的悬空声明一并清理。
+
+现在标志位只有"RAM 内 `update_flag=1` 让线程退出"这一个用途,**全程不写 flash**,
+ymodem 结束 `rt_hw_cpu_reset()` 后自然归零,不需要额外清理。
+
+### ⚠️ 一处遗留隐患(hmi.c,待你决定)
+
+`hmi.c:1826`(`iSave` 丢失分支)里还有一段开机裁决:
+
+```c
+device_status.update_flag = ((up_flag_ef != 0)
+                             || (param_boot_snap_ok && param_boot_snap.update_flag != 0)) ? 1 : 0;
+```
+
+它的消费端(开机进 ymodem)已经删掉了,但它仍会把 flash / 快照里残留的
+`update_flag=1` 恢复到 RAM。后果是:**如果某台设备 flash 里残留了 1,
+Control_Clear / Control_Check / thread_485play 会一开机就 break 退出
+→ 不清扫、不恒温、485 不播报。**
+
+而且 `upgrade_clear` msh 命令也已删除,现场没法手动清。
+建议改回 `device_status.update_flag = 0;`,或恢复一条清除命令。**未擅自改。**
+
+### 本轮改动文件
+
+| 文件 | 改动 |
+|---|---|
+| `applications/control.c` | 新增 `thread_stop_all_for_ota()` + 名单 + 匹配辅助函数 |
+| `applications/control.h` | 声明 `thread_stop_all_for_ota()` |
+| `applications/dtu_uart2.c` | 升级分支改用 `thread_stop_all_for_ota()`;删悬空的 `Upgrade_Flag_Clear()` |
+| `applications/hmi.h` | 清理废弃的 `Upgrade_Flag_Set/Clear` 声明 |
+
+### 校验
+
+新增 `.workbuddy/tools/ota_thread_stop_check.py`:
+
+```
+[A] thread_stop_all_for_ota()  gcc exit=0  PASS
+[B] 11 项语义核对(遍历方式/跳过自身/先收集后删/只改 RAM/未调 Set)  全 OK
+[C] ★覆盖性验证: 从源码提取全部线程名, 按 RT_NAME_MAX=8 模拟截断+前缀匹配
+    提取 17 个 -> 停掉 17 / 漏网 0
+    syswatch -> syswatc  KEEP (保留)          <- 喂狗线程确认被保护
+[D] 括号配平  OK
+=== 总体: 全部通过 ===
+```
+
+`upgrade_flag_check.py` 已改写为**升级机制现状检查**(原三通道断言随机制废弃而失效),
+重点是守住"函数删了但调用点还在"这类链接错误:
+
+```
+[A] Upgrade_Flag_Set/Clear 定义已移除、hmi.h 悬空声明已清   OK
+[B] 全工程无代码级调用 -> 不会有 undefined reference        OK
+[C] 升级入口链路 9 项(停机 + 无 rt_kprintf + 进 ymodem)      OK
+=== 总体: 全部通过 ===
+```
+
+回归:`ota_direct_check.py` exit=0;`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. 重要参数丢失的参数重置;
@@ -469,9 +755,9 @@ msh >upgrade_set             # 手动置位三通道(只置位不重启), 用来
     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 物理损坏时降级启动,不再变砖(详见本文档顶部专题第十一节);
+    6. 【修复】触发升级后重启不执行升级:update_flag 改 EasyFlash + 参数快照 + BKP 备份寄存器三通道持久化(详见本文档顶部专题第十三节)★该机制当日即被"直接进 ymodem"方案取代并移除,见第十五节;
+    7. 【重构】远程升级改为收到指令直接进 ymodem,不再置标志重启;新增 thread_delete_adc;升级分支禁用 rt_kprintf(详见本文档顶部专题第十四节);
+    8. 【重构】升级前把所有会持续打印日志的业务线程全部停掉(17 个,含 param_sv / Hmi / Ctr motor / PowerCheck);发现 RT_NAME_MAX=8 会让线程名截断撞名、故改用遍历线程对象+前缀匹配;并修掉 Upgrade_Flag_Clear 的悬空调用(详见本文档顶部专题第十五节);
 # 2026-09-23
 	#define VERSION_HK_2000W    "2.47.4(jjk-5)"           //经济款
 	1. 修复丢参数导致无法启动