zhunk 4bf20773cb TG_MODULE=0 1 неделя назад
..
.settings 1f7af0bc80 2.42.4 1 месяц назад
.workbuddy 14b7d3809c bootv1.3.5&app2.62 2 недель назад
applications 4bf20773cb TG_MODULE=0 1 неделя назад
doc 0f7fb6989a 2.52.4 1 месяц назад
drivers 0f7fb6989a 2.52.4 1 месяц назад
libraries b369c4ca7a bisai 1 год назад
linkscripts 065c963c21 修复自检,日志增加时间显示 1 год назад
packages 28a16c6106 ymodem 1 неделя назад
rt-thread 28a16c6106 ymodem 1 неделя назад
.config b369c4ca7a bisai 1 год назад
.config.old b369c4ca7a bisai 1 год назад
.cproject 4bf20773cb TG_MODULE=0 1 неделя назад
.gitattributes 0ca56c8d2d 重构 1 год назад
.gitignore 0ca56c8d2d 重构 1 год назад
.project 5a30eaa960 比赛设备 1 год назад
.sconsign.dblite 17b2fa46a9 2.56.4(TG) 1 месяц назад
Kconfig 065c963c21 修复自检,日志增加时间显示 1 год назад
SConscript 0ca56c8d2d 重构 1 год назад
SConstruct 0ca56c8d2d 重构 1 год назад
cconfig.h 5a30eaa960 比赛设备 1 год назад
makefile.targets 0ca56c8d2d 重构 1 год назад
readme.md 14b7d3809c bootv1.3.5&app2.62 2 недель назад
rtconfig.h d031e2c67c 固件代码审计与优化报告 1 месяц назад
rtconfig.py 0ca56c8d2d 重构 1 год назад
rtconfig.pyc 17b2fa46a9 2.56.4(TG) 1 месяц назад
rtconfig_preinc.h 0ca56c8d2d 重构 1 год назад

readme.md

2026-10-30(四)修复 chip 档擦除失败:FAL 设备名 ≠ SFUD 设备名(版本 2.61 → 2.62)

版本变更(control.h):2.61 → 2.62

  • VERSION_HK 2.62.41(HK) | VERSION_HK_2000W 2.62.4(2000W) | 2.62.4(jjk-5) | 2.62.4(TG) | VERSION_ZP 2.62.1(ZP) | VERSION_GK 2.62.1(GK)

  • 比赛设备 (TG) 3.3.4 仍为独立序列,保持不动。

一、故障现象(2026-10-30 11:16 上板实测)

[W/dtu] parseData:{"cmd":"ctrl","ext":{"target":"chip","confirm":"ERASE"}}
[D/dtu] DTU_Write:{"cmd":"warn","ext":{"status":"flash erase start:chip","type":"device"}}
[W/dtu] 收到远程擦除指令: target=chip
[E/SFUD] ERROR: Flash device norflash0 not found!
[E/dtu] 擦除失败:找不到 SPI Flash 设备 norflash0
[D/dtu] DTU_Write:{"cmd":"warn","ext":{"status":"flash erase failed:chip (0s)","type":"device"}}

chip 档在 0 秒内失败;env 档走的是 FAL 分区接口,不受影响。

二、根因

norflash0 是 FAL 设备名,不是 SFUD 设备名:

名字 来源 实际值 用途
NOR_FLASH_DEV_NAME applications/fal_cfg.h "norflash0" FAL struct fal_flash_dev 的名字
FAL_USING_NOR_FLASH_DEV_NAME rtconfig.h(Kconfig 生成) "W25Q16" SFUD 注册名

rt_hw_spi_flash_init() 里的注册调用是 rt_sfud_flash_probe(FAL_USING_NOR_FLASH_DEV_NAME, "spi10") —— 即 SFUD 里只有 "W25Q16" 这一个设备。

而 dtu_erase_chip() 写的是 rt_sfud_flash_find_by_dev_name(NOR_FLASH_DEV_NAME),等价于查 "norflash0" → 恒返回 NULL → chip 档必然失败。(2.59 移植时照抄了 hmi.c 的写法,而 hmi.c 那处本身也是错的。)

三、修复

1. dtu_uart2.c: dtu_erase_chip() —— 改为走 FAL 设备层,彻底不查名字

norflash0 是全局 struct fal_flash_dev(fal_cfg.h 已 extern 声明),直接引用即可:

const struct fal_flash_dev *dev = &nor_flash0;
if (nor_flash0_is_ready() != 1) { ... return -RT_ERROR; }     /* 物理探测失败的门控 */
gran  = dev->blk_size ? dev->blk_size : 4096;                  /* init 时已置为 sfud erase_gran */
chunk = 向下对齐到 gran(64KB,或 gran 更大时取 gran);
for (offset = 0; offset < dev->len; offset += chunk) {
    len = min(chunk, dev->len - offset);  len -= len % gran;   /* 尾块向下对齐 */
    if (len == 0) break;
    if (dev->ops.erase((long)offset, len) != (int)len) { 失败 }
    dtu_wdt_feed();                                            /* 每块擦完喂狗 */
}

优点:

  • 不需要任何名字查找,同名问题从根上消失;
  • 与 ENV 区、参数镜像的擦除走同一层(FAL),错误码语义一致(port 层 ops.erase 成功返回擦除字节数,失败返回 -1);
  • port 层 erase() 内部已有 nor_flash0_is_ready() 判空,不会在 SPI flash 故障时解空指针;
  • 顺带删掉 #include <spi_flash_sfud.h>(dtu_uart2.o 现在对 sfud 的引用数为 0),也就不再有 sfud_cfg.h 的 DBG_TAG "SFUD" 劫持风险(DBG_SECTION_NAME "dtu" 的直定义保留作双保险)。

2. 同类名字误用一并修正(同一根因,属既有缺陷)

文件 位置 原行为
hmi.c t10 调试页「外挂Flash」 rt_sfud_flash_find_by_dev_name(NOR_FLASH_DEV_NAME) 恒 NULL → 调试页一直显示"未检测到外挂Flash"
sys_monitor.c top 命令的 [Flash] 外部: 同上 → 一直显示"未找到(未初始化?)"

两处改为 FAL_USING_NOR_FLASH_DEV_NAME;sys_monitor.c 的失败分支同时打印两个名字(norflash0(SFUD名:W25Q16)),避免现场再把两者混淆。

四、验证(已执行)

  • 全量重编(touch 1947 源文件 → 170 条命令):0 失败;text 253772B / data 2772 / bss 43632,rtthread.bin 256544B(相对 2.61 的 253636 / 256408B 增 text 136B,为设备层擦除的分块/对齐代码)。
  • 告警 60 条,与 2.61 完全一致,无新增(特别确认没有 comparison of distinct pointer types —— dev->ops.erase == RT_NULL 判空未触发告警)。
  • 目标文件符号级证据:
    • dtu_uart2.o 重定位中已出现 nor_flash0(ABS32)与 nor_flash0_is_ready, 不再出现任何 sfud 符号(objdump -r | grep -c sfud = 0);
    • hmi.o 中已无 "norflash0" 字符串、保留 "W25Q16";
    • sys_monitor.o 保留一处 "norflash0",仅用于失败分支的说明文字。

五、待上机验证(未执行)

  1. {"cmd":"ctrl","ext":{"target":"chip","confirm":"ERASE"}} → 应先回 start:chip,串口打印 开始整片擦除 W25Q16: 容量 16777216 字节, 粒度 4096, 分块 65536,随后约 2~4 分钟(256 块)后 整片擦除完成 → 回执 done:chip → 设备重启。期间看门狗不得复位。
  2. 重启后 Check_ParamConfig 按"ENV 无 iSave"重建默认参数;fm_area/df_area 已被清空,OTA 回滚副本丢失属预期。
  3. {"cmd":"ctrl","ext":{"target":"env"}} 回归:仍应 <1s 完成并重启(该路径未改动)。
  4. 屏幕 t10 调试页「外挂Flash」应显示真实型号与容量(修复前恒"未检测到");串口 top 的 [Flash] 外部: 同理。
  5. 无 confirm 下发 chip → 仍应被拒绝且不重启。

六、备注

  • NOR_FLASH_DEV_NAME("norflash0") 这个宏本身没错,它是 FAL 设备名,用于 fal_flash_device_find() / FAL_PART_TABLE 之外的场合;错在拿它去查 SFUD。本次没有删除该宏。
  • 若将来 SPI flash 型号改动导致 FAL_USING_NOR_FLASH_DEV_NAME 变化,chip 档擦除不需要跟着改(已不依赖名字);但 hmi/sys_monitor 的信息显示会自动跟随 rtconfig,同样无需改代码。

2026-10-30(三)远程擦除指令并入 cmd=ctrl(版本 2.60 → 2.61)

版本变更(control.h):2.60 → 2.61

  • VERSION_HK 2.61.41(HK) | VERSION_HK_2000W 2.61.4(2000W) | 2.61.4(TG) | VERSION_ZP 2.61.1(ZP) | VERSION_GK 2.61.1(GK)

  • 经济款 (jjk-5) 2.61.4:沿用本次并行把 jjk-5 对齐主版本序列的做法(原 2.58.4 → 2.60.4 → 本次 2.61.4);比赛设备 (TG) 3.3.4 仍为独立序列,保持不动。

一、指令变更

项 旧(2.59/2.60) 新(2.61)
安全档 {"cmd":"eraseflash","ext":{"target":"env"}} {"cmd":"ctrl","ext":{"target":"env"}}
危险档 {"cmd":"eraseflash","ext":{"target":"chip","confirm":"ERASE"}} {"cmd":"ctrl","ext":{"target":"chip","confirm":"ERASE"}}

cmd 值由 eraseflash 改为 ctrl,ext 结构(target / confirm)与两档行为完全不变。

二、为什么不能只改字符串匹配(关键)

顶层命令链是 strstr(cmd_s, ...) 的顺序链,"ctrl" 分支排在 "eraseflash" 之前:

takephoto → shake → ctrl → platform → mvs_photo → eraseflash → reboot → ...

若只是把独立分支的模式从 "eraseflash" 改成 "ctrl",请求会先被更靠前的 ctrl 分支吃掉(ctrl 分支只判 ext.type,擦除指令没有 type 字段),擦除逻辑永远不可达 —— 这正是本工程历史上出现过的"过宽前置分支吞掉后续分支"缺陷。

因此改为:删除独立分支,把擦除并入 ctrl 分支内部,放在所有 type 子分支之前,用 ext.target 与其它 ctrl 子指令区分。

else if (strstr(cmd_s,"ctrl")!=RT_NULL)
{
    type_s = cj_getstr(item_ext,"type","");
    cJSON *time_s = cJSON_GetObjectItem(item_ext,"time");
    const char *erase_target = cj_getstr(item_ext,"target",RT_NULL);   /* 新增 */
    if (erase_target != RT_NULL)
    {
        if (dtu_flash_erase_exec(item_ext) > 0) { rt_thread_delay(2000); rt_hw_cpu_reset(); }
    }
    else if(strstr(type_s,"rtu_off_on")!=RT_NULL) { ... }   /* 原有 19 个 type 子分支 */
    ...
}

放置要点:

  1. 必须在第一个 strstr(type_s,...) 之前:擦除指令没有 type 字段(type_s 为空串),放在后面会一路走到链尾静默丢弃。
  2. 只要 ext 里出现 target 字段就一律交给 dtu_flash_erase_exec(),档位白名单与"未知 target 拒绝并回执"都在函数内部判定 —— 保留 master 的拒绝语义,不做"猜你要擦哪"的兜底。若写成"仅当 target 是 env/chip 才进入",未知 target 会静默消失在 type 链尾、平台收不到拒绝回执。
  3. target 字段全工程仅本指令使用(已 grep 确认),不会与 19 个 type 子指令冲突。

三、行为对照

下发内容 结果
{"cmd":"ctrl","ext":{"target":"env"}} 擦镜像两槽 → ENV 区 → EF 日志区(本工程未启用日志区,条件编译跳过)→ 回执 done → 重启
{"cmd":"ctrl","ext":{"target":"env","confirm":"xxx"}} env 档不校验 confirm,正常执行(与改前一致)
{"cmd":"ctrl","ext":{"target":"chip"}} 拒绝并回执 flash erase rejected: need confirm=ERASE,不重启
{"cmd":"ctrl","ext":{"target":"chip","confirm":"ERASE"}} 整片擦除(分块+喂狗)→ 回执 done → 重启
{"cmd":"ctrl","ext":{"target":"flash"}} 未知档位 → 回执 flash erase rejected: unknown target flash,不重启
{"cmd":"ctrl","ext":{"type":"takephoto"}} 原有 ctrl 子指令,行为不变(无 target 字段,走 type 链)
{"cmd":"eraseflash",...}(旧指令) 不再生效,无匹配分支 → 静默丢弃(平台侧须同步改 ctrl)

四、改动清单

  • applications/dtu_uart2.c
    • 删除独立 else if (strstr(cmd_s,"eraseflash")) 分支(原位于 mvs_photo 与 reboot 之间)。
    • ctrl 分支内新增 erase_target 判定及其执行块(含复位)。
    • dtu_flash_erase_exec() 头部注释、eraseflash 指令示例同步改为 cmd=ctrl。
  • applications/control.h:版本号 2.60 → 2.61。

五、验证(已执行)

  • CLI 增量 + 全量重编:0 失败;权威尺寸 text 253636B / data 2772B / bss 43632B,rtthread.bin 256408B(相对 2.60 的 253660 / 256432B 减 text 24B —— 少一个 strstr 分支判定)。
  • 告警:与 2.60 一致,无新增。
  • 分支结构机器化校验(脚本 patch 后即时跑):
    • 顶层 cmd 分支由 17 个降为 16 个,eraseflash 已不在列表中:takephoto, shake, ctrl, platform, mvs_photo, reboot, reset, update, read, poweron, poweroff, log, sensor, color, synchronization, paramconf;
    • ctrl 分支内 target 判定位置(偏移 801)早于首个 strstr(type_s,...)(偏移 1212);
    • 前置分支(takephoto/shake)均不匹配 ctrl,ctrl 也不吞任何后置分支;
    • ctrl 的 19 个 type 子分支(rtu_off_on/takephoto/turn/paichong/debug_on/debug_off/led_on/led_off/lamp_off/lamp_on/heat_on/heat_off/up_door_open/up_door_close/down_door_open/down_door_close/clear_on/route_off/selfcheck)全部走 type 字段,与 target 无交集。

六、待上机验证(未执行)

  1. {"cmd":"ctrl","ext":{"target":"env"}} → 两条回执(start/done)+ 设备重启 + 参数回出厂。
  2. {"cmd":"ctrl","ext":{"target":"chip"}}(无 confirm)→ 拒绝回执,设备不重启。
  3. {"cmd":"ctrl","ext":{"target":"chip","confirm":"ERASE"}} → 擦除期间看门狗不复位,完成后重启。
  4. {"cmd":"ctrl","ext":{"type":"led_on"}} 等原有子指令回归:确认并入擦除判定后仍正常工作(无 target 字段,走 type 链)。
  5. 平台侧确认已把旧的 cmd=eraseflash 全部替换为 cmd=ctrl;未替换的下发将无任何响应。

2026-10-30(二)参数变更同步到 RTU:一次性开机同步 → 待办机制(版本 2.59 → 2.60)

版本变更(control.h):2.59 → 2.60

  • VERSION_HK 2.60.41(HK) | VERSION_HK_2000W 2.60.4(2000W) | 2.60.4(TG) | VERSION_ZP 2.60.1(ZP) | VERSION_GK 2.60.1(GK)

  • 经济款 (jjk-5) 2.58.4、比赛设备 (TG) 3.3.4 为独立版本序列,保持不动。

一、同步 master 2026-10-15:参数变更 → 待办备份到 RTU

1. 原实现的两个缺陷(本分支 2.59 之前)

  1. 只在上电时同步一次:dtu_thread_entry_send() 入口按 iFlag 判定后,由 dtu_param_sync_poll() 三态状态机(PARAM_SYNC_IDLE/WAIT/DONE)发一次备份或恢复请求。参数真正发生变更时(屏幕改设置、平台下发、版本切换)从不备份,RTU 侧副本长期滞后。
  2. 触发条件反了:只要 iFlag==0(本地参数正常),每次开机都无条件备份一遍 —— 每次上电擦 2 个扇区写镜像并多发一帧整包参数,而真正需要同步的变更反而漏掉。

2. 现机制(与 master 同一套)

  • 唯一变更汇聚点:param_mirror_sync() 是所有参数变更路径的必经之处(屏幕设置、平台下发、Swversion 版本切换、恢复出厂、转盘记位)。它在真正写入镜像成功后调用 dtu_request_param_backup() 置待办标志;内容未变化时提前 return,不会置位 —— 天然做到"只有变更才备份"。

  • RTU 就绪判定 dtu_rtu_comm_ready():s_json_rx_cnt != 0(收到过完整 JSON,证明 RTU 已启动)且 now - s_last_json_rx_tick < 15s(链路当前仍活跃)。

  • 待办执行器 dtu_param_pending_service():发送线程主循环每轮调用(约 1s 一次,无待办时是两个标志的空判定)。优先级与规则:

    1. 恢复优先:s_param_recover_pending(iFlag==1,EF 与镜像两份都异常已落默认值)→ RTU 就绪后发 recover_param_from_rtu();发送后记录 s_recover_sent_tick,并取消备份待办(恢复会带回权威副本)。
    2. 备份其次:s_param_backup_pending → RTU 就绪后发 backup_param_to_rtu();若距上次恢复发送不足 30s 则暂缓(BACKUP_AFTER_RECOVER_TICK),避免把本地默认值覆盖掉 RTU 的恢复副本。
    3. 未就绪:不发任何恢复/备份帧,改为限时 2 分钟每 2s 主动发 getinfo(makeJson_ReadInfo)探测 RTU 通信;待办标志一直保留到 RTU 就绪后补发(RTU 晚启动、耗电模式唤醒都能补上)。
  • 发送线程入口:if (device_status.iFlag == 1) → 置恢复待办 + 设置 2 分钟探测窗口,并打印"参数两份均异常(已用默认值),等待 RTU 通信正常后执行恢复"。

3. 代码改动清单

  • applications/dtu_uart2.c

    • 删除:PARAM_SYNC_IDLE/WAIT/DONE、PARAM_SYNC_WAIT_MS/RETRY_MS/RETRY_MAX/PROBE_MS、s_rtu_rx_ok、s_param_sync_state/retry/start/last、dtu_param_sync_poll()、dtu_param_sync_on_rtu_params()。
    • 新增:s_json_rx_cnt、s_param_recover_pending、s_param_backup_pending、s_recover_sent_tick、s_param_solicit_end、宏 RTU_COMM_FRESH_TICK/PARAM_SOLICIT_TICK/BACKUP_AFTER_RECOVER_TICK、dtu_rtu_comm_ready()、dtu_request_param_backup()、dtu_param_pending_service()、dtu_param_on_rtu_params()。
    • 接收处:s_rtu_rx_ok = 1 → s_json_rx_cnt++(保留 s_last_json_rx_tick 刷新)。
    • 主循环:dtu_param_sync_poll() → dtu_param_pending_service()。
    • sync_param 分支:dtu_param_sync_on_rtu_params() → dtu_param_on_rtu_params()。
  • applications/dtu_uart2.h:新增 void dtu_request_param_backup(void); 声明。

  • applications/param_mirror.c:include dtu_uart2.h;param_mirror_sync() 写镜像成功后调用 dtu_request_param_backup()(在 pm_mtx 内,只赋一个 volatile 标志,不阻塞)。

二、与 master 的两处刻意差异

  1. s_last_json_rx_tick 保持本分支的"无条件重置":master 是 if (s_json_rx_cnt == 0) s_last_json_rx_tick = rt_tick_get();,本分支是线程启动时无条件置当前时刻(原注释说明:master 那种写法在 RTU 完全无输出时 2 小时看门狗保护失效)。两者不冲突——dtu_rtu_comm_ready() 的第一个判据就是 s_json_rx_cnt != 0,所以这段人造初值不会被误判成"RTU 活跃"。

  2. 保留 dtu_param_on_rtu_params() 钩子(master 无):收到 RTU 回传的 sync_param 时取消恢复待办并清 iFlag。master 靠"待办一次性 + 下次开机 iFlag 重新计算"达到同样效果,本分支多一个显式清理,语义更直观且不改变 master 的行为。

三、能力变化(需知悉)

  • 开机不再无条件备份:以前每次上电都往 RTU 发一帧整包参数;现在只有"镜像内容发生变化"才备份。若希望开机强制同步一次,需要人为触发一次参数变更(或在 Check_ParamConfig 里显式置待办)。
  • 恢复请求不再重发:旧实现重发最多 4 次(仅限开机那一次);master 机制是"发出即视为完成",靠恢复后 RTU 回传 sync_param 收尾。若 RTU 收到请求但回传丢包,本次上电不会重试(下次开机 iFlag 仍为 1 时会再恢复)。
  • 恢复的触发窗口:只在发送线程启动那一刻读 iFlag。运行期间参数被改坏不会再次触发恢复(与 master 一致)。

四、验证(已执行)

  • CLI 全量重编(touch 1947 源文件 → 170 条命令):0 失败。
  • 权威尺寸:text 253660B / data 2772B / bss 43632B,rtthread.bin 256432B(arm-none-eabi-gcc 6.3.1)。相对 2.59(254012/2772/43632,bin 256784B)净减 text 352B —— 删除三态状态机与重复日志的收益大于新增待办机制。
  • 告警:60 条,与 2.59 完全一致(无新增);param_mirror.c 仍 0 条。
  • 固件字符串核对:参数待办:探测 RTU 通信、参数发生变更,执行备份到 RTU、执行参数恢复、参数两份均异常、已从RTU恢复备份参数、参数异常标志已清除 均已进入镜像。
  • 源码级核对:全工程已无 PARAM_SYNC_* / s_rtu_rx_ok / dtu_param_sync_poll / dtu_param_sync_on_rtu_params 引用(仅历史注释保留)。

五、待上机验证(未执行)

  1. 变更即备份:屏幕改一项参数(如加热时间)→ 串口应见 参数发生变更,执行备份到 RTU(backup_param_to_rtu),RTU 侧收到整包参数;重复设置同一值不应再发(镜像内容未变)。
  2. RTU 晚启动:设备先上电、RTU 后上电(或 RTU 被断电重启)→ 待办期间应每 2s 见 参数待办:探测 RTU 通信(getinfo)...,RTU 起来后自动补发备份,无需重启设备。
  3. 恢复路径:擦掉 EF 的 iSave 与镜像(或下发 eraseflash env 后让参数回默认),重启 → 串口见 参数两份均异常(已用默认值),等待 RTU 通信正常后执行恢复,RTU 就绪后发 recover_param,RTU 回传 sync_param 后见 已从RTU恢复备份参数,参数恢复为 RTU 副本。
  4. 恢复后不覆盖:恢复完成后 30s 内即使有参数变更,也不应立刻备份(避免默认值覆盖 RTU 副本)。
  5. 看门狗回归:RTU 全程无输出时,2 小时 JSON_RX_TIMEOUT_TICK 到点仍能触发 DTU_EVT_RTU_WDT(确认本次改动未破坏原有看门狗起点)。

2026-10-30 参数存储对齐 master:param_backup → param_mirror(版本 2.58 → 2.59)

版本变更(control.h):2.58 → 2.59

  • VERSION_HK 2.59.41(HK) | VERSION_HK_2000W 2.59.4(2000W) | 2.59.4(TG) | VERSION_ZP 2.59.1(ZP) | VERSION_GK 2.59.1(GK)

  • 经济款 (jjk-5) 2.58.4、比赛设备 (TG) 3.3.4 为独立版本序列,保持不动;当前配置 TG_MODULE=0、JINGJIKUAN=0,实机上报 2.59.4(2000W)。

一、删除 param_backup,改用 master 的 param_mirror

1. 文件增删

  • 新增 applications/param_mirror.c / param_mirror.h(以 master 分支当前版本为基准,含 1.86 的 DBG_ENABLE 修复与 param_mirror_erase_all())。
  • 删除 applications/param_backup.c / param_backup.h(原文件已备份到 C:\Users\Administrator\.workbuddy\backups\param_backup_20261030\)。
  • Debug/applications/subdir.mk 同步把 param_backup 改为 param_mirror(IDE Refresh + Clean + Build 会按 .cproject 重新生成,内容应一致)。

2. 存储布局(与 master 逐字节一致)

  • 镜像不再占用独立 FAL 分区,改为落在 easyflash 分区内部尾部;fal_cfg.h 已删除 param_a / param_b 两个分区(老设备 flash 上残留的数据不再被引用,不影响启动)。

  • 实际布局:ENV 区 0x00000~0x10000(ENV_AREA_SIZE = EF_ERASE_MIN_SIZE*16 = 64KB)| 日志区 0x10000~0x12000(本工程 PKG_EASYFLASH_LOG 未定义,EF_USING_LOG 关闭,该段实际为空闲)| 镜像槽 A 0x12000、槽 B 0x13000(各 1 个 4KB 扇区)。

  • ⚠️ 偏移强耦合 ENV_AREA_SIZE:今后调整 ENV 区大小必须同步修改 param_mirror.h 的 MIRROR_BASE_OFFSET,否则镜像会落进日志区被互相破坏。

3. 镜像内容与写入策略

  • param_payload_t:magic('PARB') + version(0x00010001) + write_seq + crc32 + 20 个标量字段(iSave/dtype/ds/clt_time/heattime/heatvalue/thsp/sunBar/startBar/stopBar/timeSwitch/tph/tpl/shake_ws/shake_sec/passWord/dattim/version_type/Power_Type/handle_bugger),__packed,共 41 字节。

  • 写:A/B 轮写,先写较旧槽并回读校验、再写较新槽;write_seq 自增,掉电在两次写之间仍能读到上一份有效副本。CRC32 直接复用 ef_calc_crc32(),不另建表。

  • 写放大抑制:param_mirror_sync() 先比较"配置体"(跳过 16 字节头),内容未变化直接返回,不会因为每条 JSON / 每屏刷新就擦扇区。

  • 并发:param_mirror_sync() / param_mirror_erase_all() 用 pm_mtx 互斥(HMI、DTU、工作流程线程都会调用)。

4. 开机流程改造(hmi.c: Check_ParamConfig)

  • iSave 丢失:先 param_mirror_load(),有效则 mirror_to_device_status() 整包回填并把 iFlag 置 0,不再直接回出厂值(与 master 同一策略)。

  • iSave 正常:进入读取分支后先载入镜像,再按原有 key 逐条 ef_get_env_blob()。与 master 行为一致:逐条读取会覆盖镜像值,镜像只对"读不到的键"生效;字符串字段(imei/iccid/deviceId/platform/driver_bl/env_t/env_h 等)本来就不在镜像里,仍只走 EF。

  • 默认值分支写完 EF 后调用 param_mirror_sync() 用同一套出厂值初始化镜像;"丢参数补丁"块之后也改为 param_mirror_sync()(原先只改 RAM,重启会重复丢)。

  • 所有 param_mark_dirty() 调用点(hmi 12 处、control 1 处、dtu 2 处)统一改为 param_mirror_sync();param_flush_force() 删除(同步写本身就是立即生效);param_backup_start() 及 500ms 静默期落盘线程整体移除。

  • reboot_time 同步 master 1.85:改为每 10 次开机落盘一次(落盘值 1,11,21…)。原因:param_payload_t 不含 rebootcnt,这条计数不能再靠参数快照延迟落盘,逐次写又会持续放大 EF 写次数。

5. 随 param_backup 一并移除的能力(需知悉)

  • 整包 820 字节快照(含全部字符串字段)→ 现在镜像只保护 20 个标量;EF 若整片丢失,字符串仍需平台重新下发。
  • 开机"参数健康自检 + 从快照整包回写 EF"(param_check_health / param_write_back_to_easyflash)→ 移除;现由"镜像抢救 + 零值补丁"覆盖单条 env 丢失场景。
  • param_dump / param_save_now / param_restore / param_save_ef / param_stat 五条 msh 调试命令 → 随模块删除。
  • 参数快照里的 update_flag 第二通道 → 升级请求仍保留 EF 通道(up_flag_ef),但不再有快照副本。

二、新增远程擦除 Flash 指令(同步 master 1.86)

  • 指令(RTU 透传下发): {"cmd":"eraseflash","ext":{"target":"env"}}(安全档,默认) {"cmd":"eraseflash","ext":{"target":"chip","confirm":"ERASE"}}(危险档,需强确认)

  • target="env":只擦参数存储,顺序必须是 镜像两槽 → ENV 区(64KB) → EF 日志区。镜像最先擦的原因:否则重启后走 iSave 丢失路径时 param_mirror_load() 会把旧参数整份搬回来,"恢复出厂"落空。故意不调用 ef_env_set_default()——它写入的是字符串型默认值,而本工程用 ef_get_env_blob 按二进制读,读出来会是 ASCII 码。

  • target="chip":片外 SPI NOR 整片擦除,按 erase_gran 对齐分块(64KB),每块擦完显式喂狗;会连带擦掉 fm_area / df_area(OTA 回滚副本)。片内 Flash(bl/app)任何档位都不擦,不存在把设备擦成砖的路径。

  • 回执:flash erase start:<target> → 执行 → flash erase done|failed:<target> (<秒>s),成功后 rt_hw_cpu_reset()(先回 start 是因为擦除期间接收线程无法处理其它下行指令)。

  • 分支位置:插在 mvs_photo 与 reboot 之间(破坏性指令前置)。已逐一核对前置 5 个 strstr 分支(takephoto/shake/ctrl/platform/mvs_photo)均不匹配 eraseflash,且本分支不吞后续 reboot/reset/update/read/poweron/poweroff/sensor/color/synchronization/paramconf。

  • 与 master 的差异:本工程 EF_USING_LOG 未开启(PKG_EASYFLASH_LOG 未定义),日志区清理一步用 #ifdef EF_USING_LOG 包起来;master 打开了日志区,故其原实现是无条件 ef_log_clean()。

  • 安全门控:fal_partition_find() 前先查 fal_init_check()(否则撞 assert(init_ok) 死循环);整片擦除用 NOR_FLASH_DEV_NAME("norflash0")取 sfud 句柄,与 hmi/sys_monitor 取值方式一致。

三、本分支刻意保留的适配(与 master 不同之处)

  • param_mirror.c 不重复定义 device_status(本工程唯一定义在 main.c,master 那边靠 -fcommon 合并两份 tentative definition,不能照搬)。
  • 补 #define __packed __attribute__((__packed__)):本工程用 APM32 标准库,没有 STM32 HAL 的 __packed 宏(只有 CMSIS 的 __PACKED)。
  • mirror_part() 双重门控:fal_init_check() != 1 或 nor_flash0_is_ready() != 1 直接返回 NULL —— SPI flash 物理探测失败时分区表仍建得出来,不能让镜像模块去擦一块坏 flash(降级启动路径)。
  • 日志配置块放在所有 include 之前;dtu_uart2.c 的节名改用 DBG_SECTION_NAME "dtu" 直定义——新增的 spi_flash_sfud.h 会 #define DBG_TAG "SFUD",而 rtdbg.h 把 DBG_SECTION_NAME 定义为 DBG_TAG 的别名,会被劫持成 "SFUD"(构建期已实测出现该告警,改直定义后消除)。
  • dtu_uart2.c 的 ext 取值一律走 cj_getstr(),不碰 ->valuestring(平台下发 JSON 不可信铁律)。

四、验证(已执行)

  • CLI 全量重编(build_full_warn.py:touch 1947 个源文件 → 170 条命令):0 失败。
  • 权威尺寸:text 254012B / data 2772B / bss 43632B,rtthread.bin 256784B(arm-none-eabi-gcc 6.3.1)。
  • 告警:param_mirror.c 0 条;dtu_uart2.c 保留既有的 ymodem_ota 隐式声明、link_ip/lng_s 未使用三条;构建期新出现的 DBG_TAG redefined 已通过改用 DBG_SECTION_NAME 消除。
  • 源码级核对:全工程已无 param_backup / param_persist_t / param_mark_dirty / param_flush* / param_pack/unpack / param_check_health 引用(仅注释中保留历史说明)。

五、待上机验证(未执行)

  1. 老固件升级后首次开机:EF 有 iSave、镜像区为 0xFF → 应正常读 EF,日志出现镜像写入;断电重启参数保持。
  2. 人为清掉 EF 的 iSave(或下发 eraseflash env)后重启:应从镜像恢复全部 20 个标量,且不回出厂值。
  3. {"cmd":"eraseflash","ext":{"target":"env"}}:应看到 start/done 两条回执、设备重启、参数回出厂(机型靠屏幕 Swversion 握手恢复)。
  4. 不带 confirm 下发 target="chip":应被拒绝且不重启;带 confirm="ERASE" 才执行,擦除期间看门狗不复位。
  5. 屏幕/平台连续改参数:每次变更会擦 2 个扇区(约 40~100ms,HMI 线程同步执行),确认界面无可感知卡顿;同一批设置只写一次(内容未变则跳过)。
  6. eraseflash 与 reboot/reset/update 等指令混合下发,确认无分支吞噬。

六、风险与未同步项

  • 镜像只覆盖 20 个标量:字符串类参数仍是"单点"存于 EF,EF 整片损坏时需平台重新下发(master 亦如此)。
  • param_* 五条调试命令随模块删除;现场排查改用串口日志(param mirror ...)与 fal / ef 原生命令。
  • master 2026-10-15 的"参数变更 → 待办备份到 RTU(dtu_request_param_backup + dtu_param_pending_service)"未同步:本分支仍是开机一次性 dtu_param_sync_poll() 机制,param_mirror_sync() 内不触发 RTU 备份。
  • 本分支 EasyFlash 未开启日志区,eraseflash 的日志清理步骤为空实现(条件编译)。

2026-10-25 关闭清扫PWM 版本 2.57 → 2.58

2026-10-20 开机联网检测线程未退出时 HMI 侧不再重复发 read —— 版本 2.55 → 2.56

2026-10-21:屏幕触发测试拍照不执行清扫;

版本变更(control.h):2.55 → 2.56

  • VERSION_HK 2.56.41(HK) | VERSION_HK_2000W 2.56.4(2000W) | 2.56.4(TG) | VERSION_ZP 2.56.1(ZP) | VERSION_GK 2.56.1(GK)

  • 经济款 (jjk-5) 2.49.4、比赛设备 (TG) 3.3.4 为独立版本序列,保持不动;当前配置 TG_MODULE=1,实机上报 2.56.4(TG)。

根因:开机后 net_wait(联网检测线程,hmi.c)在等网期间每秒发一帧 read 刷新 RTU 状态;与此同时 refresh_hmi_Component() 每 5 个节拍(refresh_num>=5)也发一帧 read —— 两条路径同时发同一条查询,RTU 会收到双倍 read 帧,串口/RTU 侧出现重复应答、状态被重复解析。

修复(hmi.c):

  1. 新增文件级标志 static volatile uint8_t net_wait_running;

  2. net_wait_start():线程创建成功后才置 1(创建失败则保持 0,HMI 侧照常自己发,不会出现"没人刷新"的空档)。

  3. net_wait_thread_entry() 退出前(联网成功或 3 分钟超时,发完 turnon 预警后)置 0,read 刷新职责交还 refresh_hmi_Component()。

  4. refresh_hmi_Component():refresh_num>=5 分支里仅当 net_wait_running == 0 才发 read;同时补上 makeJson_ReadInfo() 的 NULL 判断(原实现会把 NULL 直接送进 DTU_Write(NULL))。

验证:

  • hmi.c 按工程真实编译选项 -fsyntax-only:0 error,无新增告警。

上机验证建议:① 开机 3 分钟内抓 uart2 日志,read 帧应只有每秒 1 帧(来自 net_wait),不再出现两帧紧邻;② 联网成功后 net wait thread exit 打印出现,此后 read 由 HMI 刷新节拍接管,状态仍正常更新;③ 弱网超时场景(180s)后同样只保留一条刷新路径。


2026-10-20 dtu_send_data 上报线程改为"等联网成功再启动"(超时 3 分钟)—— 版本 2.54 → 2.55

版本变更(control.h):2.54 → 2.55

  • VERSION_HK 2.55.41(HK) | VERSION_HK_2000W 2.55.4(2000W) | 2.55.4(TG) | VERSION_ZP 2.55.1(ZP) | VERSION_GK 2.55.1(GK)

  • 经济款 (jjk-5) 2.49.4、比赛设备 (TG) 3.3.4 为独立版本序列,保持不动;当前配置 TG_MODULE=1,实机上报 2.55.4(TG)。

根因:dtu_thread_entry_send() 在 RTU 启动延时 10s 后不判联网状态就执行开机首次上报 dtu_periodic_report()。4G/SIM 尚未注册、RTU 还没拿到 IP 时上报必然失败,而首包丢失后要等一个完整 dattim 周期(分钟级)才会重发,现场表现就是"开机后前几分钟平台收不到数据"。

修复(dtu_uart2.c):

  1. 新增宏 DTU_NET_WAIT_MS = 180000u(3 分钟)。

  2. dtu_thread_entry_send() 在 rt_thread_delay(10000)(等 RTU 启动)之后、首次上报之前,插入等联网循环:

    • atoi(device_status.net) == 0(已联网)→ 立即开始上报,打印 [net] 已联网(net=0), 启动数据上报;

    • 未联网 → 每 1s 检查一次,最多等 180s;超时打印 [net] 等联网超时 180s, 按未联网状态启动上报 并照常启动(避免永久不报)。

  3. 等网期间仍每秒调用 dtu_param_sync_poll(),开机参数备份/恢复(走本地串口,与 4G 无关)不受影响,不会被等网阻塞。

  4. net 状态由 net_wait 线程每秒发 read 触发 RTU 上报刷新(net 初值 "1",联网成功为 "0"),因此等网循环能及时退出。

验证:

  • dtu_uart2.c 按工程真实编译选项 -fsyntax-only:0 error,无新增告警。

上机验证建议:① 插着 SIM 开机,日志应在 RTU 报 net=0 后立即出现 [net] 已联网(net=0), 启动数据上报,平台首包时间提前到联网完成那一刻;② 拔掉天线/无 SIM 开机,应在 180s 后出现超时告警并按未联网状态继续运行,联网恢复后按 dattim 周期正常上报;③ 联网正常后再重启设备,等网判断应在 1s 内通过、不产生额外延时。


2026-10-20 开机参数备份/恢复改为"等 RTU 就绪后只执行一次" —— 版本 2.53 → 2.54

版本变更(control.h):2.53 → 2.54

  • VERSION_HK 2.54.41(HK) | VERSION_HK_2000W 2.54.4(2000W) | 2.54.4(TG) | VERSION_ZP 2.54.1(ZP) | VERSION_GK 2.54.1(GK)

  • 经济款 (jjk-5) 2.49.4、比赛设备 (TG) 3.3.4 为独立版本序列,保持不动;当前配置 TG_MODULE=1,实机上报 2.54.4(TG)。

根因:发送线程入口的 if(device_status.iFlag==0){ backup_param_to_rtu(); } else { recover_param_from_rtu(); } 是上电瞬间执行且只执行一次的动作。但 MCU 先起、RTU 后起(RTU 由 MCU 供电,掉电时会被整体关断、恢复供电后才重启),此刻 uart2 上发出去的帧没有接收方:备份丢包、recover_param 请求无人应答,参数就永久停在默认值,而"只执行一次"又导致永不重试。

修复(dtu_uart2.c):

  1. 引入三态状态机 PARAM_SYNC_IDLE / WAIT / DONE 与 dtu_param_sync_poll(),由发送线程主循环每秒驱动(非阻塞);线程入口不再直接发送,只登记起始时刻并复位为 IDLE。

  2. IDLE:新增 s_rtu_rx_ok(uart2 收到首个完整 JSON 时置位)作为"RTU 已启动、链路已通"判据,链路通之前不发(最多等 PARAM_SYNC_WAIT_MS=120s;超时说明 RTU 一直沉默,先盲发一帧转 WAIT)。

  3. WAIT:RTU 已就绪但未确认 → PARAM_SYNC_RETRY_MS=15s 重发、最多 PARAM_SYNC_RETRY_MAX=4 次后放弃(保持当前参数,下次上电再试);RTU 仍未就绪 → PARAM_SYNC_PROBE_MS=60s 盲发一次且不提前放弃,等 RTU 后续上电即可收到。

  4. 备份类(iFlag==0):链路已通时"发出即完成";若曾在未就绪时盲发,则链路一通自动补发一帧最新参数再置完成。

  5. 恢复类(iFlag==1):以 RTU 回传的 sync_param 作为完成标志 —— parseDtu() 的 sync_param 分支新增 dtu_param_sync_on_rtu_params(),恢复成功即置 DONE 并清 device_status.iFlag(参数已正常,本上电不再请求,下次上电走备份流程)。

  6. DONE 之后不再执行:一个上电周期只执行一次;WAIT 中的重发针对的是同一份请求,不会反复覆盖参数。

验证:

  • dtu_uart2.c 按工程真实编译选项 -fsyntax-only:0 error(仅剩既有 unused-variable、ymodem_ota 隐式声明等旧警告)。

上机验证建议:① 参数异常(iSave!=FLAG)上电时,[param] 参数异常, 请求RTU下发备份参数 应出现在 RTU 起来之后,随后出现 [param] 已从RTU恢复备份参数;② 断开 RTU 后再给 MCU 上电,RTU 恢复供电后应自动完成恢复;③ 参数正常时只出现一次 [param] 开机参数备份到RTU,之后不再重复。


2026-10-20 全量缺陷审计与修复(越界写/空指针/堆混用/流程逻辑)+ 参数快照精简 —— 版本 2.52 → 2.53

版本变更(control.h):2.52 → 2.53

  • VERSION_HK 2.53.41(HK) | VERSION_HK_2000W 2.53.4(2000W) | 2.53.4(TG) | VERSION_ZP 2.53.1(ZP) | VERSION_GK 2.53.1(GK)

  • 经济款 (jjk-5) 2.49.4、比赛设备 (TG) 3.3.4 为独立版本序列,保持不动;本次当前配置 TG_MODULE=1,实机上报 2.53.4(TG)。

一、参数快照精简(RAM -384B)

  • control.h:device_status 删除 json_w_clock[128] / json_w_reset[128] / json_w_platform[128] 三个常驻字段;

  • hmi.c:三处操作记录上报(修改工作时间 / 系统重置×2)改为函数内 192B 局部缓冲,makeJson_Warn() 用完即 rt_free;开机不再回读这 3 个 env(省 3 次 ef_get_env_blob);ef_set_env_blob("json_w_*") 记录行为保持不变;

  • param_backup.h/.c:param_persist_t 同步删除 3 个字段,PARAM_VERSION 1 → 2。旧 v1 快照自动作废(hdr.version != PARAM_VERSION → -4),首次上电回退 EasyFlash 读取,参数值不受影响。

二、越界 / 未终止字符串(栈破坏)

位置 问题
hmi.c ALARM 分支 无条件写 var[6]='\0',载荷不足 6 位时越界读写 → 先判 strlen(var)>6
hmi.c rtc_h/m/s char x[2] + strncpy(...,2) 不补 '\0',atoi() 越界读栈 → 直接 atoi(var) 后校验
hmi.c SaveRecordParam itoa(param1, char[10], 10) 位数超长/负数踩栈 → char[12] + rt_snprintf + 负值拒绝
dtu_uart2.c 告警时间 char temp[10] + "time:%s"(alarm_tg 最长 11B)→ char[24] + rt_snprintf
dtu_uart2.c lwjson 累加缓冲 追加从不补 '\0',短帧解析带出上一帧尾巴;memset(accum_buf,0,sizeof(accum_buf)) 中 sizeof 是形参指针,只清 4 字节 → 补 '\0' + MAX_DTU_SIZE

三、堆破坏与内存泄漏

  • cJSON 与 newlib free() 混用(最严重):cJSON 在 __RTTHREAD__ 下由 rt_malloc 分配,但 selfcheck.c 1 处、dtu_uart2.c 3 处(两处 json_temp、parseTimestamp 的 tm_time)用 free() 释放 —— 两套堆链表互相写坏,运行一段时间必崩。全部改 rt_free,parseTimestamp 改 rt_malloc + 判空 + memset + tm_isdst=0。

  • pSubJson 创建失败直接 return NULL → pJsonRoot 及已挂接子对象全部泄漏,补 cJSON_Delete(pJsonRoot)。

  • makeJsonRpc2_0() 三条失败路径丢弃 params(约定"传入即由本函数接管"),补 cJSON_Delete(params);COPY_IMAGE 未判 cJSON_CreateObject() 返回值。

四、空指针解引用

  • 设备句柄:DTU_Write()、uart2/485 接收线程、dtu_uart2_reinit_rx()、dtu_data_play()、Hmi_Fresh() 在串口未注册/重连窗口期直接解引用 NULL 设备 → 全部加判空。

  • dtu_uart2.c 命令解析:item_cmd 为 Object/Number 时 valuestring 为 NULL,strstr(NULL,…) 崩溃 → 统一走 cmd_s(cj_str 已兜底)。

  • parseTimestamp():sscanf 返回值未校验(6 个变量可能是栈上随机值)、malloc 未判空 → 校验 != 6 即返回。

五、流程逻辑

  1. hmi.c 屏幕命令 dtu_reboot 含子串 reboot,而 reboot 分支在前 → 屏幕"RTU 重启"实际执行整机复位;已把 dtu_reboot 判断提前。

  2. 屏幕设时间:atoi(hour_s) > 0 使合法的 00:xx:xx 永远设不进,上限写成 24 → 改 >=0 && <24(分/秒 0~59)。

  3. set_date 成功、仅时分秒非法时却打印 set_date failed 并 rt_hw_rtc_init(),把刚写好的日期冲掉 → 分离日/时判断,只在日期写失败时复位 RTC。

  4. 屏幕固件升级(hmi.c):

    • 4096B 块发完即 recv_write_pos=0,解码长度非 512 整数倍时尾部最多 511B 被丢弃(固件流缺字节)→ 改 memmove 保留余量;
    • 新一轮升级不重置 bytes_received → 第二轮首包即判"升级完成";
    • 文件长度恰为 4096 整数倍时最后一包后无新数据 → 升级永远停在 RECEIVING。
  5. dtu_uart2.c JSON-RPC 响应:外层判 String、内层判 Object,Object 分支是死代码,且 Object 时把 NULL 当字符串发屏 → 改为按类型分支处理。

  6. if (device_status.gps == NULL) 对数组恒为假(gcc 警告),空 GPS 从未补 "0" → 改 gps[0]=='\0'。

  7. Read_Real_Voltage() 连调两次,两次 ADC 采样可能不同(如 12.99 组出 "12.00")→ 读一次复用。

  8. Debug_log_OFF() 对已初始化消息队列重复 rt_mq_init()(排队指令丢失),并重复创建 Hmi_Fresh_thread(同队列两个消费者 → 指令执行两遍、每次泄漏一份线程栈)→ 移除重复 mq 初始化,rt_thread_find() 判重后再建线程。

  9. hmi.h 的 uint32_t total_file_size; 是头文件中的定义(9 个 .c 靠 -fcommon 合并)→ 改 extern,定义留在 hmi.c。

验证:

  • 按工程真实编译选项(Debug/applications/subdir.mk)对 hmi.c / dtu_uart2.c / selfcheck.c / param_backup.c / control.c 做 -fsyntax-only:0 error;仅剩既有 unused-variable、rt_memory_info() 指针类型、ymodem_ota 隐式声明等旧警告。

  • 版本字符串含 2.53.4(TG)(当前 TG_MODULE=1 配置)。

上机验证建议:① 屏幕 ALARM 短报文不再死机;② 屏幕设 00:xx:xx 生效且日期不被冲掉;③ 屏幕连续两轮 OTA 成功、非 512 对齐长度不丢字节;④ 长时间运行内存不下降、不再出现 cJSON/free 混用导致的崩溃;⑤ 升级后首次上电参数保持(v1 快照作废,回退 EasyFlash)。


2026-10-15 修复:屏幕部分控件不更新(uart4 非阻塞发送丢数据)—— 版本 2.51 → 2.52

版本变更(control.h):2.51 → 2.52

  • VERSION_HK 2.52.41(HK) | VERSION_HK_2000W 2.52.4(2000W) | VERSION_ZP 2.52.1(ZP) | VERSION_GK 2.52.1(GK)

  • 经济款 (jjk-5)、推杆结构 (TG)/(TG111)、(y) 为独立版本序列,保持不动。

现象:屏幕(menu 页)相机状态、网线连接状态不更新(明明已连接);固件侧确认在"发送"(HMI_WRITE 每轮执行),但屏幕收不到。

根因:2.49 引入的 HMI 批量发送(单次 flush 达 1024B)与 uart4 的发送模式不匹配:

  • uart4 是唯一以 TX_NON_BLOCKING 打开的串口(uart2 等默认阻塞模式,无此问题);

  • 非阻塞写的语义:数据先放入 1024B 的 TX 环形缓冲,rt_device_write 只接受能容纳的部分并立即返回,超出部分静默丢弃(且 HMI_WRITE 从不检查返回值);

  • 一次刷新(整页 60+ 条属性,全量轮 2000+ 字节)产生 2~3 批 flush:第 1 批 1024B 写满环形缓冲并启动 DMA(1024B@115200 ≈ 89ms 才发完),同一刷新内的第 2/3 批到达时缓冲仍满 → 整批丢弃;

  • 发送去重表已记录"内容未变化不重发" → 落入被丢批次的指令(menu.va_net / menu.cam_sta 等在刷新序列第 ~90 条位置)永久收不到(每 10s 全量轮的重发又落回被丢批次)。

  • 对照 2.48(正常):逐条发送(约 30B)+ 每条 mdelay(1) 自然节流,环形缓冲几乎不积压。

修复(hmi.c):

  1. 新增 hmi_write_all() 完整写入器:循环写入并检查实际写入量,未写完时让出(rt_thread_mdelay(1))等待 TX 缓冲释放后重试;上限 400 次(约 400ms,覆盖升级 4KB 块 ≈356ms);中断上下文不等待(保持 HMI_WRITE 中断可调用性);uart4_tx_bytes 统计改为"实际写入量";

  2. Hmi_Batch_End / hmi_send_now 改用 hmi_write_all;

  3. send_raw_to_hmi(屏幕 OTA 转发 4KB 块)同根因一并修复(原单次写只进 1KB 就返回 -1,升级数据静默丢 3/4)。

验证:

  • hmi.c 编译 0 error;全量构建 14 命令 0 失败;

  • 产物核验:2.52.41(HK) 唯一;hmi tx wait timeout 标记在固件内;

  • 尺寸:text 261968 / data 2772 / bss 49728;bin 264740B(含当前工作区其他并行改动)。

上机验证建议:① 屏幕 menu 页相机/网线状态随实际连接变化更新;② 观察 10s 全量轮后屏幕所有控件保持正确(此前后段控件会被丢);③ 屏幕 OTA(升级hmi)转发完整性。

说明:hmi.c 当前含并行编辑中的内容(三通道升级标志等,编译输出有若干 unused 警告),本次未改动。

中间插曲:补丁首版局部变量 p 遮蔽 rtdbg.h 全局 struct tm *p 导致编译报错("request for member 'tm_year'...",项目已知坑),已改名 pbuf 修复。


2026-10-15 Swversion 版本检测并入"页刷新"统一入口块(HMI_Decode 重构)—— 版本 2.50 → 2.51

版本变更(control.h):2.50 → 2.51

  • VERSION_HK 2.51.41(HK) | VERSION_HK_2000W 2.51.4(2000W) | VERSION_ZP 2.51.1(ZP) | VERSION_GK 2.51.1(GK)

  • 经济款 (jjk-5)、推杆结构 (TG)/(TG111)、(y) 为独立版本序列,保持不动。

把 HMI_Decode 链尾的 Swversion 版本检测链(高空 V11 / 1.0 V1 / 中端款 V43 / 低端款 V42 / 4.0 V41 / 水稻 V4,共 101 行)整体并入函数开头的"页刷新"块,合成"页刷新 + 版本握手"统一入口。

结构变化(hmi.c)

  1. 先检测、后刷新:SwversionV* 帧先做版本类型检测与持久化(EF + MA_save),再整页刷新——修正原"刷新先于检测"导致换型号后当帧刷新仍按旧版本的问题。

  2. 判定逻辑原样保留:判定顺序 V11→V1→V43→V42→V41→V4;hmi_cmd_match 严格匹配(V1/V4)与各分支 dtype 置位差异(V1 仅变更时置位、其余无条件置 3)均不动,仅清理空 else 块。

  3. 处理完 return(沿用原版本分支语义):SwversionV*/getFullData 帧不再落入下方约 500 分支指令链。

  4. 显式排除 "dbg:" 帧:debug1 页 [发送] 会回传整框文本,其中可能内嵌历史日志里的版本串(如本机口镜像的 hmi rx 行),不排除会抢在 hmi_debug1_handle 之前吞掉命令帧,导致命令不执行。

  5. 链尾原六分支移除、原位留一行注释;今后版本判定与持久化只改开头统一入口块一处。

版本串跟踪修正(去重表复位逻辑)

  • 原实现两类帧共用同一跟踪值:getFullData 心跳会反复冲掉版本串,两类帧交替到达即误判"版本变化"、反复复位去重表,60+ 条属性的重复过滤被持续清空;

  • 改为只跟踪版本帧本身、按"首个 \r 前的版本 token"比较(同 master hmi_ver_changed 语义);仅换型号/换页面工程时才复位去重表,并输出 LOG_I("hmi ver frame changed: ...")。

验证

  • 分支路由模拟(6 种版本帧 + getFullData + "dbg:" 回传帧真值表):全部命中预期分支、链上无截胡点;

  • hmi.c 编译零告警;全量工程完整编译链接通过(含工作区其余并发改动一并编译);

  • 产物校验:2.51.41(HK) 唯一(无 2.50/2.49 残留),hmi ver frame changed / hmi rx / D/hmi / SwversionV43 标记齐全;

  • 尺寸:text 261736 / data 2772 / bss 49728;bin 264508B。

上机验证建议:① 换接另一种屏幕型号(或改屏工程版本串),确认 version_type/dtype 切换且页面当帧即按新版本刷新;② 调试页 [发送] 回传含历史日志的整框,确认命令仍正常执行;③ 同一版本串心跳下整页属性不再周期性全量下发(去重生效)。


2026-10-15 修复:屏幕(uart4)接收数据不在控制台打印(LOG_D 被裁剪)

版本变更(control.h):2.49 → 2.50

  • VERSION_HK 2.50.41(HK) | VERSION_HK_2000W 2.50.4(2000W) | VERSION_ZP 2.50.1(ZP) | VERSION_GK 2.50.1(GK)
  • 经济款 (jjk-5)、推杆结构 (TG)/(TG111)、(y) 为独立版本序列,保持不动。

现象:刷入 2.49 后,屏幕(uart4)收到的原始数据不再出现在控制台(2.48 时每帧可见)。

根因:本次移植 debug1 时给 hmi.c 新增了 #include <spi_flash_sfud.h>,其链路 spi_flash_sfud.h → sfud.h → sfud_def.h → sfud_cfg.h 会在 hmi.c 的日志配置块之前 抢先 #include <rtdbg.h> —— 该头带 include guard(RT_DBG_H__),首次引入即定型: sfud_cfg.h 以 DBG_LVL=DBG_INFO + DBG_TAG "SFUD" 完成首次引入后,hmi.c 文件中部 原有的 DBG_LEVEL DBG_LOG 配置块因 guard 被整体跳过,该文件所有 LOG_D 被编译裁剪。 (证据:2.49 编译产物中无 hmi rx / D/hmi 字符串。)而 2.49 恰好把屏幕接收打印从 LOG_I 降为了 LOG_D,于是表现为"控制台不再打印屏幕接收数据"。 全工程排查:仅 hmi.c 受影响;sys_monitor.c 同样 include 了 sfud 头但其无 LOG_x 调用, dtu / param / mbmst 各文件的 LOG_D 本就正常,无需改动。

修复(hmi.c 三处):

  1. 日志配置块上移至本文件所有 include 之前(DBG_ENABLE / DBG_COLOR / DBG_LEVEL + #include <rtdbg.h>), 使其成为本文件的首次引入、等级 DBG_LOG 正式生效;
  2. 节名改用 DBG_SECTION_NAME "hmi" 直接定义(不走 DBG_TAG),避免 sfud_cfg.h 的 DBG_TAG "SFUD" 重定义影响本文件 [x/hmi] 日志节名;
  3. 屏幕原始数据打印恢复 LOG_I 可见级:控制台按 hmi rx(N): <原始数据>([I/hmi] 节) 逐帧输出,与 2.48 行为一致;副带恢复 button!、震动时间设置 两处 LOG_D 打印。

验证:

  • 预处理复核:rtdbg.h 首次引入回到本文件顶部、LOG_D 展开为真实打印、预处理零告警;
  • 增量编译 14 条命令 0 失败:text 260712→261464(+752B),bss 49664→49728(+64B), bin 263484→264236B;
  • 编译产物字符串核对:2.50.41(HK) 取代 2.49.41(HK);hmi rx / D/hmi / button! 等此前被裁剪的字符串全部回归。

注:hmi rx 打印会随屏幕刷新持续输出(2.48 即如此)。若后续需要长期运行降噪, 可加开关(如 msh 命令)控制,不建议再降回 LOG_D 依赖文件头部等级配置。


2026-10-15 同步 master 应用改动全量移植(c562c46c 之后 8 个提交)

版本变更(control.h):2.48 → 2.49

  • VERSION_HK 2.49.41(HK) | VERSION_HK_2000W 2.49.4(2000W) | VERSION_ZP 2.49.1(ZP) | VERSION_GK 2.49.1(GK)
  • 经济款 2.48.4(jjk-5)、推杆结构 3.3.4(TG)/2.13.4(TG111)、2.42.4(y) 为独立版本序列,保持不动。

把 master 分支 c562c46c(2026-10-07)之后的全部应用层改动(8 个提交,2026-10-07 ~ 10-14: 运行时 OTA 改造 / sys_monitor 重构 / DTU 发送重构 / JSONRPC 升级 / Swversion 分包修复 / workSta 工作过程 / HMI 收发优化 / 测试加热 / debug1 调试页 / t10~t14 / 审查修复批次① / 运行指示灯) 逐项移植到本分支(PCB_V2 / APM32F1)。本分支与 master 在内核版本、串口驱动(serial_v2)、 硬件 IO/电流传感器上不同 —— 移植以 master 实现为基准、按本平台适配, 平台差异导致的偏离逐条记录在第五节(平台适配说明)。


一、通信 / HMI 基础(hmi.c / hmi.h)

  1. HMI 发送优化(HMI_WRITE 签名不变,调用方无感):
    • 批量下发 HMI_BATCH_BEGIN/END(1KB 累积缓冲,满自动 flush):整页刷新 60+ 条属性由 60+ 次串口写合并为 1~3 次;
    • 重复过滤:按调用点(格式化串地址)CRC32 直接映射去重表(96 槽;冲突按未命中,只多发不漏发); 每 10s 整体复位 + Swversion 握手串变化时立即复位;
    • 升级闸门 Hmi_Upgrade_Begin/End:屏幕升级传输期间屏蔽普通刷新,60s 无新数据自动解除;
    • 去掉每条 1ms 的 rt_thread_mdelay;发送缓冲从 static 共享(1024B)改为栈缓冲(256+3B);
    • 结束符 0xFF×3 与指令合并一次写入。
  2. 屏幕接收帧组装:Hmi_Rx_Feed/Hmi_Frame_Handle 按 '\n' 切帧 —— 分包残段拼接、一包多条全部处理、 0x05 升级应答内聚处理、单帧上限 512B。
  3. Swversion 分包误切修复:新增 hmi_cmd_match()(命令完整相等 + 紧跟 '\r'),SwversionV1/V4 分支严格匹配。
  4. 屏幕测试加热 10 分钟自动关闭(软定时器 t_testheat;工作流程中不干预);删除重复的 switchHeat 死分支对。
  5. sysTest 页 t1/t3/t0/t5 控件映射。

二、屏幕功能(workSta + debug1)

  1. workSta 工作过程显示:
    • Device_Status_typedef 新增 work_heat_left / work_clt_left / work_door_left / work_progress / photo_left / clear_left / work_total_sec / work_start_tick 八个运行态字段;
    • t1 加热倒计时(calorstat / WorkTask 加热分支)、t2 收集倒计时(WorkTask)、t3 仓门动作倒计时 (Ctr_Mortor_entry 四个电机计数 /10)、t5 拍照倒计时(photo_led_sec 900→300 段 /10)、 t6 清扫倒计时(ctr_TG_Clear 正反两程);
    • t4 工作进度:Work_Progress_Start/Get 时间加权(收集+加热+拍照 60s+清扫 85s+仓门 40s 估算,上限 99%);
    • photoSta/clearSta 状态 + hmi_write_num_or_blank()(数值为 0 下发空串);整批挂进 getFullData 批量块。
  2. debug1 调试页(整段移植):
    • 信息区:t0 RT-Thread版本 / t1 内核 / t2 BSP(APM32F103RET6) / t13 运行时长(hh:mm:ss 不回绕) / t5 BL版本 / t3 固件版本 / t4 编译时间 / t11+j0 CPU / t12+j1 RAM / t10 外挂Flash(三级兜底)/ t14 FAL 分区表;getDebugData 心跳触发整批刷新;
    • 按钮:reboot / bootloader / startapp / dbg_on / dbg_off / dbg_clr / dbg_erase / dbg_restore / dbg:<命令>;
    • 屏幕端 msh 控制台:dbgcap 只写捕获设备 + uart1 日志转发 + 行缓存(ANSI/控制字符过滤)+ 分片节流推送 + 页面心跳存活窗口(离开页面自动停推)+ 独立执行线程(3072B 栈,msh_exec)+ "最后一个 >> 之后"取命令;HMI_Decode 链最前分发(先于 reboot/clear 等既有分支)。
  3. t10 Flash 名三级兜底(SFDP 路径 chip.name=NULL → 厂商+JEDEC ID+容量)/ t13 hh:mm:ss / t14 分区表。

三、数据链路(dtu_uart2.c / sht30_collect.c)

  1. DTU 发送线程重构:
    • 不再区分联网状态;周期上报改由软定时器 du_report(dattim 分钟)驱动;
    • 新增事件集 + du_check 1s 检查(雨控/温控异常提前上报 + RTU 2h 看门狗断电重启);
    • 新增 dtu_request_report()(屏幕设置时间后立即请求一次上报,替代 num_updata=2);
    • s_reporting 标志替代 num_updata==0 上报窗口;
    • 掉电检测移入 ADC 模块 Power_ReadCheck(<5V 持续 10s 确认 → 预警上报 + 上报最后一帧 + 关 Router/RTU;≥12V 恢复;tick 防抖),Power 线程栈 2048→2560(掉电时需调用 UpLoad_Data);
    • 灯管电流检测保留在本线程(每秒节拍);停发送线程时同步停两个定时器。
  2. JSONRPC update 指令:回复应答后置 stop_in_bootloader=1(EF)并重启,由 bootloader 进入升级流程 (平台适配:master 用 BKP_DR2=0x5AA5,本板 DR2=0xDEAD 另有"启动失败恢复"语义,故用本平台既有契约)。
  3. 上报新增 blver/bltime(bootloader 版本/编译时间,现读 EF driver_bl/driver_compile)。
  4. sys_monitor 重构:取消后台线程 → sys_monitor_refresh() 现场采集(上报前调用); 控制台 top / Msh_DisplaySysMonitor 循环刷新(CPU/RAM/Flash/分区/上报进度/工作状态/外设/线程,q 退出)。
  5. 杂项:makeJsonselfCheck voltage_s[6]→[10]+snprintf;平台切换/修改工作时间上报改局部缓冲+无条件上报; 删除 json_w_clock/reset/platform 三个"主动查询"分支;同步数据到达清 menu.warn;sht30 掉电 tick 防抖。

四、升级与修复

  1. 运行时 OTA 加固:
    • kservice 新增 rt_console_mute()([BZY-OTA-PATCH]):升级开始即全局静默打印(rt_kprintf/rt_kputs), 防止日志字节混入 Ymodem 数据流;
    • 进 ymodem 前 WDT 超时 5s→25s(NorFlash 擦除阻塞,防擦除阶段误复位)。
  2. 审查修复批次①可适用项:cpu_usage -l 参数钳位 ≤98(原 ≥99 忙等死循环 → 喂狗停摆复位); rt_hw_us_delay 逐拍累计(原 ≥1000us 死循环);beep 判空/泄漏/格式串族此前批次已修,复核未动。
  3. 运行指示灯(LED0/PB3):双闪图案 亮100→灭100→亮100→灭500 循环(原每 1s 翻转,无固定节奏)。

五、平台适配说明(与 master 的刻意差异)

  • uart1/uart4 接收位保护(dbg_chain_fixup / hmi_uart4_fixup_rx)未移植:那是 RT-Thread v1 serial 的 open_flag 覆盖缺陷;本工程用 serial_v2(open 已打开设备直接返回、标志位只增不覆盖,已核实源码),无此问题。
  • JSONRPC 升级标志用 stop_in_bootloader(EF),不用 master 的 BKP_DR2=0x5AA5(DR2 在本 BL 是启动失败恢复)。
  • OTA 流程主体保留本工程第五批实现(thread_stop_all_for_ota 前缀匹配删除 → uart_stop_for_ota 关 uart4/5 → 本线程直进 ymodem);未改 master 的"独立 4KB 线程 + uart2 FORCE_RESET"结构 —— 本工程 DTU 线程栈 4096、 uart2 引用计数由 serial_v2 维护、DTU 收发线程已停净,等效且已经过验证。
  • 未移植项:cam_model 上报字段(本工程结构体无此字段);master 审查修复①中的驱动层专属项 (drv_usart CLR_INT 停 DMA、drv_rtc BKP 时钟、board.h FLASH 尺寸等 —— 本工程驱动为 APM32/serial_v2, 另行维护);master 的空闲钩子喂狗结构(本工程 LED 在主循环按时序走)。
  • 保留本工程现行行为:read 命令的 refresh_num=15 语义;同步数据 hmi_fresh==2 时的 A7_DTU_V3 立即上报分支。
  • 文件名修正:applications/ cpu_usage_cmd.c(前导空格,GNU make 无法解析)改名为 applications/cpu_usage_cmd.c,Debug 生成脚本已同步。

六、构建(GCC 6.3.1 全量重编,170 条命令,0 失败)

  • 权威尺寸:text 260712 / data 2772 / bss 49664;rtthread.bin 263484B(带符号 elf:Debug/rtthread.elf)。
  • 较本次起点基线(2.48:text 253808 / bss 42864 / bin 256580B):text +6904B / bss +6800B (批量/去重/帧组装缓冲 + debug1 捕获缓存与执行线程 + 事件/定时器 + 结构体新字段)。
  • 无新增告警(构建输出中的 warning/note 均为历史遗留:EasyFlash switch、drv_usart_v2 maybe-uninit、 selfcheck.h、ymodem 隐式声明等)。
  • Debug/ 生成脚本修正(CLI 构建通道):补入曾缺失的 cpu_usage.c / cpu_usage_cmd.c / param_backup.c / sys_monitor.c 与 rtc/alarm.c,剔除工程已排除的 lwjson.c / lwjson_debug.c / signal.c,与 .cproject 排除表一致。

七、待上机验证(建议)

  1. workSta 页 t1~t6 / photoSta / clearSta 显示与倒计时节奏(屏幕工程需含对应控件);
  2. debug1 页联调(屏幕工程需含对应控件;dbg_on / dbg:<命令> / b4 回传);
  3. RTU {"cmd":"update"} 运行时 OTA 与平台 JSONRPC update(重启进 BL)两条升级链路;
  4. 掉电检测(<5V 持 10s)与恢复(≥12V)路径;
  5. top / Msh_DisplaySysMonitor 控制台界面。

2026-09-30 紧急修复:rt_snprintf 不支持浮点 → 电流电压上报显示 "%f"

版本变更(control.h):2.47 → 2.48

这是 2026-09-28 第四批 P2-7 修复引入的回归,由用户上机后反馈发现。 第四批把定长数组写入统一换成 rt_snprintf 限长时,没有排除浮点格式符。


一、问题与根因

现象:平台/屏幕上电流、电压数据显示成字面量 %f。

根因链条:

  1. RT-Thread 的 rt_snprintf() 只是 rt_vsnprintf() 的薄封装(kservice.c:1160)。
  2. rt_vsnprintf()(rt-thread/src/kservice.c:886)的转换字符 switch 只有 case 'c' / 's' / 'd' / 'i' / 'o' / 'u' / 'x' / 'X' / '%', 没有 case 'f' / 'e' / 'g'。
  3. rtconfig.h 里也没有 RT_USING_LIBC_FLOAT_PRINT(只有 RT_KPRINTF_USING_LONGLONG)。
  4. 于是 "%.2f" 一路走到 default: 分支(kservice.c:1090):
default:
    if (str < end) *str = '%';   /* 原样写 '%' */
    ++ str;
    if (*fmt)
    {
        if (str < end) *str = *fmt;   /* 再写 '.' 或 'f' */
        ++ str;
    }
    ...
    continue;

它把 % 和后面的字符当成普通字符原样输出 → 缓冲区里得到字面量 "%f"。 更糟的是这个分支不消费对应的 double 可变参数,如果同一格式串里后面还有别的格式符, 可变参数会整体错位。

为什么不能简单换回 sprintf

老代码用的是标准库 sprintf("%.2f", ...)。但 newlib 的 float printf 默认不使能, 要额外链入 _printf_float(Flash 体积显著增加);而且原来 power[8] 装 "25000.00" 本来就会越界。两条路都不通。


二、改法:新增 fmt_fixed2() 定点格式化

在 control.c 实现、control.h 导出,纯整数定点运算,只用 %ld / %02ld, 任何 printf 实现都支持:

void fmt_fixed2(char *buf, rt_size_t size, double val, int prec)
{
    const double MAX_VAL = 20000.0;   /* 防 val*100 溢出 long */
    long scaled, ip, fp;
    int  neg = 0;

    if (buf == RT_NULL || size == 0) return;
    if (prec < 0) prec = 0;
    if (prec > 2) prec = 2;

    if (val < 0.0) { neg = 1; val = -val; }
    if (val > MAX_VAL) val = MAX_VAL;

    /* 加 0.5 后强转 = 四舍五入到 0.01 */
    scaled = (long)(val * 100.0 + 0.5);
    ip = scaled / 100;
    fp = scaled % 100;

    if (prec == 0)      { if (fp >= 50) ip += 1;
                          rt_snprintf(buf, size, "%s%ld", neg?"-":"", ip); }
    else if (prec == 1) { if (fp % 10 >= 5) { fp += 10;
                          if (fp >= 100) { fp -= 100; ip += 1; } }
                          rt_snprintf(buf, size, "%s%ld.%ld", neg?"-":"", ip, fp/10); }
    else                 rt_snprintf(buf, size, "%s%ld.%02ld", neg?"-":"", ip, fp);
}

三个精度档都做了正确的四舍五入(prec=1 时 12.99 → 13.0,不是截断成 12.9)。


三、修复的 5 个调用点

文件 位置 原来 现在
sht30_collect.c ~348 rt_snprintf(power, ..., "%.2f", (cur-2400)/0.4) fmt_fixed2(..., 2)
sht30_collect.c ~363 rt_snprintf(heat_power, ..., "%.2f", (heatcur-2450)/0.1) fmt_fixed2(..., 2)
sht30_collect.c ~372 rt_snprintf(power, ..., "%.2f", ...+20.0)(PCB_V1 分支) fmt_fixed2(..., 2)
dtu_uart2.c ~1977 sprintf(d_ExposureTime, "%lf", ...) fmt_fixed2(..., 2)
dtu_uart2.c ~1988 sprintf(d_Gamma, "%.1lf", ...) fmt_fixed2(..., 1)

后两处是额外发现的老雷:它们用标准 sprintf 配 %lf,newlib 浮点 printf 未使能时 会输出 nan 或在链接期报 _printf_float 未定义。相机曝光时间/Gamma 现在也走定点。

device_status.voltage / fuse_voltage / voltage_sun / tempture / humidity 原本用的就是 "%d.%02d" / "%d.%d" 这种纯整数格式,不受影响,未改动。


四、验证

新增 .workbuddy/tools/float_fmt_check.py,报告 .workbuddy/float_fmt_check.txt, 四项全 PASS:

  • [A] 全 applications 扫描 rt_snprintf/sprintf/HMI_WRITE/DTU_Write/LOG_* 等 13 个入口,零浮点格式符(会先剥离注释与字符串字面量,避免误报)。
  • [B] fmt_fixed2() 切块宿主 gcc -fsyntax-only -Wall -Wextra → exit=0。
  • [C] 把真函数切出来编译成 exe 真跑,23 个数值用例全过,覆盖: 0.00 / 3.14 / 3.145→3.15 / 2.675→2.68(二进制舍入陷阱)/ 9.999→10.00(进位)/ 0.005→0.01 边界 / 负数 / 钳位 / prec=0,1,2 三档舍入。
  • [D] 5 个调用点 + 定义 + 声明数量核对。

五、后续约定(务必遵守)

������ 本工程任何 printf 家族函数都不得使用 %f / %e / %g。 包括 rt_snprintf / rt_sprintf / sprintf / HMI_WRITE / DTU_Write / Uart5_Write / LOG_I 等所有最终会走到 rt_vsnprintf 的封装。 需要输出小数 → 调 fmt_fixed2(),或手写 "%d.%02d" 整数拆分。


2026-09-28 更新说明(第五批:OTA 升级前关闭串口4/串口5)

版本变更(control.h):2.46 → 2.47

#define VERSION_HK          "2.47.41(HK)"       //4.0海康-1200W
#define VERSION_HK_2000W    "2.47.4(2000W)"     //4.0水稻
#define VERSION_ZP          "2.47.1(ZP)"        //1.0转盘
#define VERSION_GK          "2.47.1(GK)"        //1.0高空

用户要求:升级(ymodem OTA)之前把串口4(屏幕)和串口5(485)关掉。


一、为什么要关

ymodem 传输的是裸字节流,走的是 uart2。而升级窗口内还有两类东西会往串口上写字节:

串口 设备 升级期间如果还开着会怎样
uart4 HMI 屏幕 屏幕刷新/心跳字节混进 ymodem 帧 → 传输校验失败、升级静默卡死
uart5 485 从机 485 定时轮询/上报字节同上

更要命的是 shell/console 会被切到 uart4(Debug_log_ON() 的效果), 此时 rt_console_set_device() 已经把 uart4 的 ref_count 抬到 2(业务 + console), finsh 又是一份。只关一次 rt_device_close() 引用计数只减到 1,设备根本不会真正关闭。

还有一个必炸的坑:rt_serial_close() 会 rt_free 掉 rx/tx 的 ringbuffer 并置 NULL, 但 dev 指针本身仍然非空。此后任何线程再调 rt_device_write(serial4, ...), rt_serial_write() 会解引用已释放的 serial->serial_tx->activated → HardFault。 所以光把句柄置 NULL 是不够的,必须有显式标志。


二、改动清单

1. 新增显式关闭标志 g_hmi_port_closed(hmi.c / hmi.h)

rt_uint8_t g_hmi_port_closed = 0;    /* hmi.c:148 */

void HMI_WRITE(char *fmt, ...)
{
    ...
    if (g_hmi_port_closed || serial == RT_NULL) return;   /* 必须最先判断 */
    ...
}

send_raw_to_hmi() 同样加 if (g_hmi_port_closed || !serial || !data || size == 0) return -1;。

hmi.h 里导出 extern rt_uint8_t g_hmi_port_closed;。 注意:不能只靠 serial == RT_NULL 判断,理由见上面那段"必炸的坑"。

2. 新增 ota_close_uart() / uart_stop_for_ota()(control.c)

static void ota_close_uart(rt_device_t dev, const char *name)
{
    if (dev == RT_NULL) return;
    rt_device_set_rx_indicate(dev, RT_NULL);      /* 先摘掉 rx 回调 */
    int guard = 8;
    while (dev->ref_count > 0 && guard-- > 0)     /* ★ 循环关到引用归零 */
        rt_device_close(dev);
}

int uart_stop_for_ota(void)
{
    g_hmi_port_closed = 1;                          /* ① 先置标志,后关设备 */

    /* ② console 若在 uart4,先摘回 RT_CONSOLE_DEVICE_NAME(uart1)。
          rt_console_set_device 内部会 open 新设备 + close 旧设备,
          这里只应在"当前 console 就是 uart4"时才切。 */
    if (RT_CONSOLE_DEVICE_NAME != RT_NULL) { ... }
    #if defined(RT_USING_FINSH) && !defined(RT_USING_POSIX_STDIO) && defined(RT_USING_DEVICE)
        finsh_set_device(RT_CONSOLE_DEVICE_NAME);  /* finsh 同样 open新+close旧 */
    #endif

    /* ③ 关设备 */
    ota_close_uart(serial,     UART_NAME);   /* uart4 */
    ota_close_uart(serial_485, "uart5");

    /* ④ 句柄置 NULL:即使上层漏判标志,也不会往已废设备写 */
    serial     = RT_NULL;
    serial_485 = RT_NULL;
    return 0;
}

为什么必须循环 close:rt_device_open 每调一次 ref_count+1,而 rt_device_close 只在计数减到 0 时才真正调驱动 close。uart4 可能同时被「HMI 业务 + console + finsh」 持有,引用数 ≥2,单次 close 只会减计数。

control.h 导出 int uart_stop_for_ota(void);,紧邻 thread_stop_all_for_ota 声明。

3. 调用点(dtu_uart2.c 的 update 分支,约 2571 行)

thread_stop_all_for_ota();     /* ① 先停线程 */
uart_stop_for_ota();           /* ② 再关串口4/5 —— 顺序不能反 */
ymodem_ota(1, 0);

顺序反了会出问题:线程还在跑的时候把它的设备关了,线程下一次收发就直接 HardFault。 另外 ymodem_ota() 自己第一件事是 rt_console_set_device("uart2"), 所以我们在这里把 console 摘回 uart1 不会干扰 ymodem。

4. serial_485 收敛为唯一定义

原来 serial_485 在 dtu_uart2.c:72 和 sht30_collect.c:51 各有一份定义, 靠 -fcommon 合并 —— 又一个雷。现在:

  • dtu_uart2.c:72 保留唯一定义;
  • sht30_collect.c 删掉自己那份,改 #include "dtu_uart2.h" 用 extern;
  • dtu_uart2.h 新增 extern rt_device_t serial_485;(注释写明为何要导出来给 control.c 用)。

已用脚本验证:全工程 serial_485 定义点只剩 1 处。

5. Uart5_Write_Bin() 补判空(dtu_uart2.c:272)

if (data == RT_NULL || len == 0 || serial_485 == RT_NULL) return;

OTA 后 serial_485 被置 NULL,缺这个判断就是 HardFault。


三、改动文件清单

文件 改动
applications/control.c 新增 ota_close_uart() / uart_stop_for_ota();include shell.h(条件编译)
applications/control.h 声明 uart_stop_for_ota();版本号 2.46 → 2.47
applications/dtu_uart2.c update 分支调用 uart_stop_for_ota();Uart5_Write_Bin() 判空
applications/dtu_uart2.h extern rt_device_t serial_485;
applications/hmi.c g_hmi_port_closed 定义 + HMI_WRITE / send_raw_to_hmi 护栏
applications/hmi.h extern rt_uint8_t g_hmi_port_closed;
applications/sht30_collect.c 删除重复的 serial_485 定义,改用 extern

四、待上机确认

  1. IDE 里 Refresh(F5) + Clean + Build(本机无 arm-none-eabi,未本地编译)。
  2. 触发一次远程 update,确认:
    • ymodem 传输不再被屏幕/485 字节打断;
    • 升级后 uart2 能正常收发。
  3. 若升级前 console 被切到过 uart4,升级后从 uart1 恢复(RT_CONSOLE_DEVICE_NAME)。

2026-09-28 更新说明(第四批:清理 + 接收链路批量化)

版本变更(control.h):2.45 → 2.46

#define VERSION_HK          "2.46.41(HK)"       //4.0海康-1200W
#define VERSION_HK_2000W    "2.46.4(2000W)"     //4.0水稻
#define VERSION_ZP          "2.46.1(ZP)"        //1.0转盘
#define VERSION_GK          "2.46.1(GK)"        //1.0高空

对应审计报告第七节的第四批(清理,P3 全部) + P2 里剩下几条, 另按要求重做了 uart2 / uart5 接收链路的批量读。


〇、★ 接收线程:逐字节系统调用 → 批量读(用户指定项)

问题

原接收线程是:

char ch;
while (1) {
    while (rt_device_read(dtuserial, -1, &ch, 1) != 1)   /* 一次系统调用取 1 字节 */
        rt_sem_take(&rx_sem, RT_WAITING_FOREVER);
    ret = lwjson_stream_parse(&lwparser, ch);
    ...
}

uart2 跑 115200bps 8N1 = 11520 字节/秒,也就是每秒一万多次 rt_device_read。 而 serial_v2 的 _serial_fifo_rx() 每次都要进临界区做 rt_ringbuffer_read/upd, 临界区总占用时间与字节数成正比 —— 等于把 CPU 花在"关中断 → memcpy 1 字节 → 开中断" 上,还会连带拖慢所有其他中断的响应。

改法

rx_indicate 回调只做记账 + 唤醒,接收线程一次读走一整块:

#define DTU_RX_BLK_SIZE        128

static volatile rt_size_t dtu_rx_pending  = 0;   /* 已到达未读走的字节数 */
static volatile rt_size_t uart5_rx_pending = 0;

static rt_err_t dtu_input(rt_device_t dev, rt_size_t size)
{
    dtu_rx_pending += size;         /* 只记账 */
    rt_sem_release(&rx_sem);        /* 只唤醒 */
    return RT_EOK;
}

/* 接收线程 */
static char rx_blk[DTU_RX_BLK_SIZE];
n = rt_device_read(dtuserial, 0, rx_blk, sizeof(rx_blk));
if (n == 0) { rt_sem_take(&rx_sem, RT_WAITING_FOREVER); continue; }
...
dtu_feed_block(&lwparser, accum_buf, &accum_len, rx_blk, n, 1);

系统调用次数从"每字节一次"降到"每块一次",约 1/128。 同时把两路重复的逐字节 switch 抽成公共的 dtu_feed_block()。

关于 lwjson_stream_parse():它本身就是单字节 API,这一步没法省, 但"取字节"已经从系统调用变成了遍历内存,省掉的是上万次/秒的临界区进出。

设计上的两个保守选择

点 做法 原因
dtu_rx_pending 的用途 只作参考,不参与正确性判断 计数不准(中断与线程竞争)也无所谓:读多了 read 自然返回实际条数,读空了返回 0 就退回等信号量。既不丢数据也不死等
uart5 解析器 独立实例 lwparser_485 原来 uart5 和 uart2 共用同一个全局 lwparser,双线程会把 parse_state/stack_pos 互相破坏,两边都等不到 lwjsonSTREAMDONE。当前 MATCH_DEVICE=0 不建该线程(休眠缺陷),一旦打开就是必现故障

一、P3-5 board.h 补 PWM 通道宏(这批最关键的一条)

#define BSP_USING_PWM3
#define BSP_USING_PWM8
#define BSP_USING_PWM3_CH1   /* PC6  蜂鸣器 / 步进脉冲 (BEEP_PWM_CH=1) */
#define BSP_USING_PWM3_CH2   /* 清扫左电机 */
#define BSP_USING_PWM3_CH3   /* 清扫右电机 */
#define BSP_USING_PWM3_CH4   /* PB1  清洁刷电机 (PB1_TIM3_CH=4) */
#define BSP_USING_PWM8_CH2   /* PC7 */
#define BSP_USING_PWM8_CH3   /* PC8 */

原来只定义了 BSP_USING_PWM3/PWM8,没有 _CH*。 drv_pwm.c 的 pwm_get_channel() 靠 #ifdef BSP_USING_PWM3_CH1 这些宏累加 channel 位, 一个都没有定义 → channel == 0 → stm32_hw_pwm_init() 里 4 个 if (device->channel & 0x0x) 全不成立,HAL_TIM_PWM_ConfigChannel() 一次都没被调用。

PWM 能出波形完全是靠 board.c 的 MX_TIM3_Init()/MX_TIM8_Init() 里的残留配置在撑着 (那两个函数确实调了 ConfigChannel,只是 drv_pwm 这一侧整个没配)。 这是一处隐式耦合:只要有人把 CubeMX 生成的 MX_xxx_Init() 换成简洁版, 或者调整 Prescaler/Period,PWM 就会静默失效,而代码里看不出任何依赖。

补齐后 drv_pwm 自己完成通道配置,与 board.c 显式对齐。

⚠️ 上机后请确认:pwm3/pwm8 的实际频率、占空比与改动前一致 (stm32_hw_pwm_init() 会把 Prescaler 设 0、Period 设 0, 随后的 drv_pwm_set() 每次都会重算,这套逻辑改动前后完全相同)。


二、第四批顺手收掉的并发/安全问题(不在原报告里,改到时发现的)

2.1 DTU_Write() 的锁位置错了 ★

原来:

str_length = rt_vsnprintf(dtu_str, sizeof(dtu_str)-1, fmt, ap);  /* 锁外! */
...
rt_mutex_take(&dtu_write_mutex, RT_WAITING_FOREVER);
rt_device_write(dtuserial, 0, dtu_str, str_length);
rt_mutex_release(&dtu_write_mutex);

dtu_str 是 static char[1024] 共享缓冲,加锁却只护住了 rt_device_write。 两个线程并发进来会各自往同一块内存写,后写的赢,前一个线程发出去的是被截断/混合的 JSON。 DTU_Write 被发送线程、上报线程、自检线程、平台命令处理线程并发调用, 现场表现是偶发"平台收到半截 JSON 就丢弃"。

已把锁提到 va_start 之前,覆盖 格式化 + 写串口 + 转发 + 日志 全过程。 与 P2-2 的 HMI_WRITE() 静态缓冲是同一类问题。

2.2 Uart5_Write() 同样的毛病 + 格式串注入

static struct rt_mutex uart5_write_mutex;   /* 独立锁, 不能复用 dtu_write_mutex */
  • 静态缓冲裸奔 → 补锁(独立一把:DTU_Write 转发时已持有 dtu_write_mutex, 同一把锁再取就是自死锁)
  • 补 serial_485 == RT_NULL 判空
  • DTU_Write() 里原来的 Uart5_Write(dtu_str) 是拿 JSON 内容当格式串, 平台下发的内容里出现 %s/%n 会被当格式指令解释 → 改成 Uart5_Write("%s", dtu_str)
  • hmi.c 的 DTU_Write(rep)(在 #if 0 死代码块里)同样统一成 dtu_write_json(rep), 避免以后有人打开 #if 0 又踩一次

2.3 P3-1 lwjson.c 从构建中排除

lwjson_init / lwjson_parse / lwjson_find(DOM 解析器)全工程无调用,只有流式解析器在用, 却仍参与编译。已在 .cproject 的 sourceEntries 排除列表加 //applications/lwjson.c、//applications/lwjson_debug.c。

顺带补回 //.workbuddy(该排除项此前已丢失, 将来若在 .workbuddy/ 下放了 .c/.h 会引入重复符号)。 改完必须在 IDE 里 Refresh(F5) 后 Clean + Build,否则 Debug/sources.mk 不会更新。


三、P3 其余各条

编号 位置 改法
P3-2 main.c 补 extern int memtrace(int argc, char **argv);(mem.c 里有定义并已 MSH 导出,但无原型 → 隐式声明,GCC14+ 默认报错)
P3-3 dtu_uart2.c hasElementGreaterThan400() 实现判的是 arr[i] < LAMP_CURRENT,名实相反。已互换两个函数名(..._lessThan400 ↔ ..._greaterThan400)并同步调用点,比较方向不动 —— 现有逻辑靠"取反"恰好正确,改比较方向会直接改变行为
P3-4 dtu_uart2.c atoi(&ivalue[3])<<8 \| atoi(&ivalue[2]) 移位拼十进制,正确与否完全依赖 uint8_t 截断的巧合。改为 sscanf(ivalue, "%u-%u", &sh, &eh),并把原来 8 个靠 ivalue[1]/[2]=='-' 猜结构的分支合成一处
P3-6 drv_common.c HAL_Delay() 原为空实现。用 HAL_GetTick() 差值忙等实现 —— 不能用 rt_thread_mdelay():hw_board_init() 在调度器启动之前就调 HAL_Init(),那时 mdelay 会永久挂起导致整机起不来
P3-7 drv_usart_v2.c LOG_E("... drop %d bytes", size) → %lu(rt_size_t 是 unsigned long,原来长包显示负数)
P3-8 drv_rtc.c HAL_RCC_OscConfig() 返回 HAL_TIMEOUT(LSE 起振超时回退 LSI)时被丢弃;set_rtc_time_stamp() 无论成败都返回 RT_EOK。两处都判返回值并向上透传

四、P2 剩余项

编号 位置 改法
P2-6 sht30_collect.c NTC 三处:① 10000*(4096-Read_Ntc_Voltage())/Read_Ntc_Voltage() 除零;② 一行里调两次 Read_Ntc_Voltage(),每次内部含 filter_Mid() 的 6×10ms 阻塞(10ms 周期的线程里卡 120ms);③ TempCalculate(RV,…)-TempCalculate(RV,…)>10 同参相减恒为 0,异常检测是死代码。改为:只采样一次 → 判 0 < adc < 4096 → 用区间检查(-40℃ ~ 160℃)代替恒假判断,异常时保留上一次有效值而不是兜成 25℃
P2-7 control.h / sht30_collect.c / sample_mb_master.c / dtu_uart2.c voltage[6] 装 "39.80" 零余量;power[8]/heat_power[8] 装 "25000.00" 必溢出 1 字节,踩掉紧邻的 deviceId/voltage_sun(结构体是全局单例)。三字段统一放宽到 16,全部改 rt_snprintf 限长。已确认 param_persist_t 不含这些字段,不影响持久化格式
P2-8 sht30_collect.c 两个线程栈 1024 → 2048(sprintf("%.2f") 的软浮点 dtoa 峰值 500~800B,且 TempCalculate() 内含 log())
P2-9 sht30_collect.c UART_485_INIT() 里 rt_device_find() 未判空就 rt_device_control/open → 补判空 + return -RT_ERROR
P2-11 param_backup.c param_dump/param_restore 原来在锁外用共享 g_work(param_backup_read 在函数内已释放锁),与落盘线程的 param_pack(&g_work) 竞争。改为各用一份私有静态快照 g_dbg_dump / g_dbg_restore(820 字节不能放栈)
P2-12 sample_mb_master.c ① 栈 512 → 1024;② tempture/humidity 原来被 485 线程多步 rt_sprintf 写入、被落盘/温控/上传并发读 → 拼好再一次性写入;③ 每 5s 无条件 rt_kprintf 刷两行 → 降为 LOG_D(DBG_LVL 调到 DEBUG 才输出)。补 #include <rtdbg.h>
P2-14 hmi.c 开机在 main 线程里做最长 180s + 12s 的阻塞等联网,期间 dtu_send_data_start / Workstatus_check / Work_Loop_Task 全部延后(现场表现:开机后近 3 分钟不自检、不进工作循环、不上报)。搬到独立线程 net_wait(栈 2048,优先级 12),main 立刻往下走。线程内用自己的时间快照,不借用 Check_ParamConfig() 的 static struct tm(那里开机后还会被别处改写)

五、遗留未动(需现场确认后再改)

  • ymodem_ota / itoa 的隐式声明 warning(itoa 在 hmi.c 有使用)
  • 报告第六节"待上机确认"的 6 项(线程栈实测余量、看门狗余量等)

版本变更(control.h):2.44 → 2.45

#define VERSION_HK          "2.45.41(HK)"       //4.0海康-1200W
#define VERSION_HK_2000W    "2.45.4(2000W)"     //4.0水稻
#define VERSION_ZP          "2.45.1(ZP)"        //1.0转盘
#define VERSION_GK          "2.45.1(GK)"        //1.0高空

对应审计报告第七节的第三批(稳定性/寿命),另外顺手把前两批漏掉的几条 P1 一起收了。

一、P1-6 内存泄漏收口:新增 dtu_write_json()

/* dtu_uart2.h */
void dtu_write_json(char *json);   /* 发送堆上分配的 JSON 串并自动释放 */

内部固定 DTU_Write("%s", json) + rt_free(json),把"生成 → 发送 → 释放"合成一步, 杜绝 DTU_Write("%s", makeJson_xxx(...)) 这种"分配了没人释放"的写法。 已替换的漏点:

位置 原问题
dtu_uart2.c backup_param_to_rtu / recover_param_from_rtu / upload_sys_monitor_info DTU_Write(temp) 把 JSON 当格式串 + 失败分支不释放
dtu_uart2.c switch_mode / alarm / 自检上报 / mvs_photo / update / 掉电预警 makeJson_Warn() 返回值从未释放(每次泄漏几十~上百字节)
dtu_uart2.c 切换平台两处 makeJson_platform() 分配了两份,发送第一份、释放第二份 → 第一份永久泄漏;现在只分配一次
dtu_uart2.c / hmi.c 的 read_record / write_record_param / upgrade_hmi / makeJson_Cam 同上
hmi.c 开机 turnon、control.c 转盘超时 / 工作开始 / 预制执行 同上

⚠️ dtu_write_json() 只能传堆内存(cJSON_PrintUnformatted / malloc 的产物)。 栈上缓冲(如 hmi.c 的 progress_json[256])仍用 DTU_Write("%s", buf),已就地加 "%s"。

顺带修掉 P2-4:makeJson_Warn / makeJson_Cam / makeJson_C01_Warn / makeJson_Rtutakephoto / makeJson_platform / makeJson_record_read / makeJson_record_write 在子对象创建失败的分支 原来直接 return NULL,父对象泄漏 → 各补一句 cJSON_Delete(父对象)。

二、P1-7 删线程不再留下"悬挂 owner"的 mutex

void dtu_stop_send_thread(void);   /* 新增,替代裸 rt_thread_delete(dtu_send_data) */

rt_thread_delete() 不会释放被删线程已持有的 mutex。若删除瞬间它正卡在 rt_mutex_take(&dtu_write_mutex, RT_WAITING_FOREVER),mutex 的 owner 就指向已销毁线程, 之后所有 DTU_Write() 永久挂起(上报/预警/应答全停,5s 后看门狗复位)。 现在删完会 rt_mutex_detach + rt_mutex_init 重建一把干净的锁。

⚠️ 实测确认:本工程 RT-Thread 的 rt_mutex_control() 是空实现 (rt-thread/src/ipc.c:1216-1223 直接 return -RT_ERROR),RT_IPC_CMD_RESET 对 mutex 无效,不能用它来复位锁 —— 只能 detach + init。 调用点:dtu_uart2.c 的 HMI 升级分支、远程 update 升级分支。

三、P1-9 / P1-12 驱动层

  • drv_flash_f1.c:片内 flash 的擦除和编程全程加 rt_enter_critical()/rt_exit_critical()。 单 Bank 的 STM32F1 擦一页要 20~40ms,期间取指被挂起、所有 ISR 停摆, uart2 的 1024 字节 DMA 环形缓冲在 115200bps 下会被灌满 → DTU 丢帧,同时丢约 30 个 tick。
  • drv_adc.c:新增静态 adc_lock,把"配通道 → 启动 → 等转换 → 取值"整段串行化 (原来两个线程同时 rt_adc_read() 会互相改写 ADC_ChanConf,传感值串通道); 并且 HAL_ADC_ConfigChannel / HAL_ADC_Start / HAL_ADC_PollForConversion 的返回值全部判了 (原来超时后仍去取 DR,读到上一通道残留值且无任何日志)。

四、P1-10 / P1-11 串口驱动(drv_usart_v2.c)

  • dma_recv_isr():把 rt_hw_serial_isr() 移出关中断区(先 rt_hw_interrupt_enable() 再上报)。原来它跑在中断全关状态,内部会 rt_completion_done() 并执行应用注册的 rx_indicate 回调 —— 回调里一旦有阻塞调用就是死锁;即便不阻塞也把关中断窗口拉成回调执行时长。
  • HAL_UART_ErrorCallback():错误自愈重启 RX DMA 时,补 rt_ringbuffer_reset(&rx_fifo->rb)。 原来只把 DMA 复位到 buffer[0] 而 rb.write_index 仍停在故障前的 N,自愈后每次 IDLE 都按 "从 0 开始"算长度 → 读到重复旧数据/错位,DTU 解析持续报校验错且不会自愈。

五、P1-13 / P1-14 / P1-17(前两批漏掉的 P1)

  • P1-13 param_backup.c 选槽逻辑:两个分支都加了 g_part_x != RT_NULL 判断, 并在写之前对 target 做空指针兜底 —— 单分区降级时原来 target->name 是空指针解引用。
  • P1-14 sht30_collect.c:moving_average_filter_update() 内部判空(filter/buffer/bufferSize); Power_ReadCheck() 里两个 moving_average_filter_init() 失败时打 LOG_E 而不是直接崩。
  • P1-17 sample_mb_master.c:RT_WAITING_FOREVER → 3000 tick。485 从机不应答时 原来调用线程永久挂起,温湿度采集卡死。

六、P2 关键项

项 改动
P2-1 system_status 五处重复定义 sys_monitor.h 加 extern System_stats_t system_status;;只保留 sys_monitor.c 一处定义,control.c / dtu_uart2.c / hmi.c / sht30_collect.c 里的同名定义删除(四个文件都已 include sys_monitor.h)。这是 device_status 已修掉的同款 -fcommon 坑
P2-2 HMI_WRITE 无锁共享静态缓冲 新增 hmi_write_mutex(惰性初始化放在临界区),把"格式化 + 发送"整段保护起来;拿不到锁(200ms)丢帧并 LOG_E。⚠️ 内部仍有 rt_thread_mdelay,ISR/HARD_TIMER 回调禁止调用
P2-3 uart5 与 uart2 共用 lwparser 新增独立的 lwparser_485,uart5 线程用自己的解析器(当前 MATCH_DEVICE=0 未创建该线程,属休眠缺陷)
P2-10 落盘失败无退避 新增 g_fail_backoff_tick + PARAM_FAIL_BACKOFF_TICKS(默认 60s):flash 写失败后退避,不再每 200ms 重试一次完整 4KB 擦写(原来既加速磨损又刷爆串口)
P2-13 rt_timer_stop 未判空 timer_uart2 / timer_takephoto 停止前判空
P2-15 DTU_Write 惰性初始化 mutex 首次 init 放进 rt_enter_critical(),防止两线程同时首次调用重复 init
P2-9 rt_device_find 未判空 sht30_collect.c UART_485_INIT() 找不到 uart5 时直接返回 -RT_ERROR
P2-12 modbus 轮询栈 md_m_poll 线程栈 512 → 1024

七、改动文件清单

文件 改动
applications/dtu_uart2.c / .h 新增 dtu_write_json() / dtu_stop_send_thread();泄漏点替换;lwparser_485;timer 判空;mutex 惰性初始化加锁
applications/hmi.c HMI_WRITE 加锁;多处 dtu_write_json;makeJson_Cam const 转换
applications/control.c 三处 dtu_write_json
applications/param_backup.c / .h 选槽 NULL 兜底;失败退避(g_fail_backoff_tick / PARAM_FAIL_BACKOFF_TICKS)
applications/sys_monitor.c / .h system_status 收敛为唯一定义 + extern 声明
applications/control.c / dtu_uart2.c / hmi.c / sht30_collect.c 删除各自的 system_status 定义
applications/sht30_collect.c 滤波器判空;UART_485_INIT 判空
applications/sample_mb_master.c Modbus 超时改 3000;轮询栈 1024
drivers/drv_flash_f1.c 擦除/编程屏蔽中断
drivers/drv_adc.c adc_lock + HAL 返回值判断
drivers/drv_usart_v2.c rt_hw_serial_isr 移出关中断区;DMA 自愈时 reset ringbuffer
applications/control.h 版本号 2.44 → 2.45

八、验证与遗留

  • 本机无 arm-none-eabi,未编译。上机必做:RT-Thread Studio Refresh(F5) + Clean + Build。
  • 仍残留的既有 warning(非本次引入,未改):dtu_uart2.c ymodem_ota 隐式声明、 main.c memtrace 隐式声明、hmi.c itoa 隐式声明、若干 unused-variable。
  • 仍未处理(建议放第四批):P2-6 NTC 除零与恒假判断、P2-7 voltage[6]/power[8] 零余量、 P2-8 1024 栈里用 %f、P2-11 g_work 锁外使用、P2-14 main 线程 180s 阻塞等待、 P3 死代码与命名问题。

2026-09-28 更新说明(第二批:远程输入面收口)

版本变更(control.h):2.43 → 2.44

#define VERSION_HK          "2.44.41(HK)"       //4.0海康-1200W
#define VERSION_HK_2000W    "2.44.4(2000W)"     //4.0水稻
#define VERSION_ZP          "2.44.1(ZP)"        //1.0转盘
#define VERSION_GK          "2.44.1(GK)"        //1.0高空

本批对应 固件代码审计与优化报告_2026-09-28.md 的第二批(远程可达的输入面收口)。 核心思路:平台/RTU 下发的一切内容都是不可信的,统一在两个入口收口:

/* 新增于 dtu_uart2.c 顶部 */
static const char *cj_getstr(cJSON *obj, const char *key, const char *def); /* 按 key 取安全字符串 */
static const char *cj_str   (cJSON *it,  const char *def);                 /* 对已取到的节点取安全字符串 */
#define SET_STATUS_STR(dst, src)  rt_snprintf((dst), sizeof(dst), "%s", (src))  /* 定长字段限长写入 */

三条铁律:

  1. 绝不直接碰 X->valuestring —— 节点非 String 类型时它恒为 NULL;
  2. cJSON_GetObjectItem() 的结果必须判空 —— 平台少发一个字段就是空指针;
  3. 写入 device_status 的定长字符数组一律用 SET_STATUS_STR —— 用 sizeof 兜底。

一、P0-3 平台下发 JSON 字段判空(原先可远程打挂)

位置(改后行号) 原问题
dtu_uart2.c ext.type(ctrl / platform 两个分支) type = cJSON_GetObjectItem(item_ext,"type") 后直接 strstr(type->valuestring,…)。item_ext 为 NULL(平台发 {"cmd":"ctrl"} 不带 ext)或没有 type 即空指针解引用。改走 cj_getstr(item_ext,"type","")
synchronization 分支的 lat / lng LOG_I("参数同步:lat:%s lng:%s", lat->valuestring, …)、后续 strstr/写入 全部未判空。改走 cj_getstr(item_ext,"lat"/"lng","")
gps / csq / net / sim / volume / link_sta 只判了 !=NULL 就 atoi(X->valuestring);这些字段常被当成 Number 下发,而 Number 节点的 valuestring 是 NULL → atoi(NULL) 崩溃。改走 cj_str(X, "-1"),缺省值让范围判断自然落进 else 分支(与"字段缺失"行为一致)
photo_sta(value_commn) 同一字段上面按 Number 用 ->valueint、下面按 String 用 atoi(->valuestring),必崩。改成 Number 优先、否则跳过
cpu_tmp、link_ip、imei、iccid 同上,改走 cj_str 并限长写入
datetime 只判 !=NULL 就 sscanf(->valuestring,…);非 String 时崩溃,不足 14 位时 year..second 未初始化就被拿去校时。改为先取安全串、校验长度==14、并检查 sscanf 返回 6
new_hum / new_tem 改走 cj_getstr,strcmp(x->valuestring,"") 换成判断首字符
METHOD、item_cmd 只判 !=NULL 就 strcmp/strstr(->valuestring)。改为 method_s = cj_str(METHOD,"")、cmd_s = cj_str(item_cmd,"")
stamp_server、item_ext(color 分支)、vt 同上
hst / st 的 else 分支 原来 if(type==Number){…} else { atoi(->valuestring) },Array/Bool 时崩溃 → 改成 else if (type == cJSON_String)
coll_time 数组元素 ivalue rt_sprintf(ivalue,"%s",pSub->valuestring) + 数字元素 → 改 rt_snprintf + cj_str

二、P1-1 远端字符串改限长写入(SET_STATUS_STR)

覆盖字段:csq / net / sim / gps / gps_state(均只有 8 字节)、alarm_tg(12)、 photolink(128)、qianming(128)、imei(32)、iccid(32)、lat/lng(32)、 link_ip(32)、driver_4g(64)、project(32)、mqttcfg1/mqttcfg2(64)、 tempture/humidity(12)、deviceId(32)。

原来全是 rt_sprintf(dst,"%s",远端串) / sprintf(...),源串长度由平台决定 → 越界写会踩坏 Device_Status_typedef 里紧邻的字段。现统一 rt_snprintf(dst, sizeof(dst), "%s", src)。

三、P1-3 utos[5] → utos[12]

makeJson() 里 utos 只有 5 字节,而 dattim / shake_sec 是 uint16_t,十进制最长 "65535" = 5 字符 + '\0' = 6 字节。配合下面第四项的范围校验双重保险。

四、P1-5 driver[64] 不再被撑爆

  • 版本串拼接:rt_sprintf → rt_snprintf(..., sizeof(device_status.driver), ...);
  • strcat(device_status.driver,".485") → 先算剩余空间再 rt_strncpy 定长追加(原来无脑再溢 4 字节);
  • 根因 driver_4g 由平台下发,已在 synchronization 分支限长到 64。

五、P1-8 coll_time 悬垂指针根除

  • control.h:const char *coll_time[10] → char coll_time[10][16] (原来是 device_status.coll_time[0] = ct1; 把栈上局部数组地址存进全局,函数返回即悬垂);
  • dtu_uart2.c makeJson():改成拷值; ⚠️ cJSON_CreateStringArray() 要的是 const char *const *,二维数组不能强转, 用一个局部 const char *coll_time_ptr[2] 做适配。

附带影响:这条修掉之后,Device_Status_typedef 里就不再有指针成员了, "不能整体 memcpy 做持久化"的顾虑消失(但持久化仍然只用 param_persist_t,流程不变)。 结构体尺寸由 1592 增至约 1712 字节(全局量,不在栈上,无影响)。

六、P1-18 RTU 同步参数(sync_param)范围校验 + deviceId 字段修正

  1. BUG 修复:parse_param_to_mcu() 里 rt_snprintf(device_status.deviceId, sizeof(...), "%s", value->string) 用的是 value->string —— 那是 cJSON 里的 key 名(恒为 "deviceId"), 取字符串值必须用 value->valuestring。结果就是北大荒设备编码每次同步都被写成字面量 "deviceId"。
  2. 新增 sync_u8 / sync_i8 / sync_u16 三个 helper:取值 → 校验范围 → 写 RAM → 落 EasyFlash, 越界丢弃并 LOG_E。取值范围与 parseDtu() 的 paramconf 分支保持一致:
key 字段 env key 范围
ds ds ds 0~1
tt sunBar sunBar 1~10
st startBar startBar 0~23
et stopBar stopBar 0~23
ts timeSwitch timeSwitch 0~1
tpl tpl(有符号) tpl -50~50
tph tph tph 50~80
stime clt_time stime 1~60
jtime heattime jtime 1~30
hrt heatvalue jheat 10~150
shake_sec shake_sec shake_sec 1~1000
shake_ws shake_ws shake_ws 0~1
version_type version_type version_type 0~100
heat_sw heat_sw heat_sw 0~1
dattim dattim dattim 1~120
handle_bugger handle_bugger handle_bugger 0~1

⚠️ 行为变更:以前 RTU 同步下发越界值会被原样写进 flash(并被 uint16/uint8 静默截断); 现在会被丢弃并打日志。如果现场确实需要某个超出上表的取值,改上表即可。

七、改动文件清单

文件 改动
applications/dtu_uart2.c 新增 cj_getstr / cj_str / SET_STATUS_STR;P0-3 全域判空;P1-1 限长写入;utos[12];driver 拼接与 .485 定长追加;coll_time 拷值;parse_param_to_mcu 范围校验 + deviceId 字段修正
applications/control.h coll_time 改二维字符数组;版本号 2.43 → 2.44

八、验证与遗留

  • 本机无 arm-none-eabi 工具链,未编译。dtu_uart2.c 会拉进 CMSIS core_cm3.h, 在宿主 gcc(x86)上必然报一堆 vendor 头里的环境性错误,无法用它做语法校验; 已做的替代校验:全文件花括号配平(509/509,delta=0)、 对 hum/tmp/lat/lng/type 等旧变量做残留扫描(零残留)。
  • 上机必做:RT-Thread Studio 里 Refresh(F5) + Clean + Build。
  • 上机建议重点回归:① 平台下发 {"cmd":"ctrl"} 不带 ext(原来必崩,现在应被忽略); ② synchronization 同步经纬度 / 信号强度;③ RTU sync_param 同步后核对 deviceId 不再变成字面量 "deviceId";④ 孢子仪(dtype=7)上报的 coll_time 数组内容。
  • 编译踩坑记录(第二批实测):sync_u8/sync_i8/sync_u16 的形参一开始起名叫 p,编译报 error: 'cJSON {aka struct cJSON}' has no member named 'tm_year' 根因:rt-thread/include/rtdbg.h:136-137 在文件作用域定义了两个全局变量 c time_t timep; struct tm *p; LOG_* → dbg_log_line() 宏展开时用 p->tm_year / tm_mon / tm_mday / tm_hour / tm_min / tm_sec 打时间戳。函数里只要有同名的局部变量 p(或 timep),就把这个全局 p 屏蔽掉, p->tm_year 于是落到局部变量的类型上 → 报"某结构体没有 tm_year 成员"。 已把形参改名为 params。 > ⚠️ 本工程约定:凡是会调用 LOG_* 的函数,局部变量一律不要用 p / timep。
  • 第三批(稳定性/寿命)待办(见报告第七节):DTU_Write 未配对 free(P1-6)、 删线程前 reset mutex(P1-7)、驱动层临界区与返回值(P1-9~P1-12)、 system_status 五处重复定义(P2-1)、HMI_WRITE 无锁静态缓冲(P2-2)、 flash 落盘失败退避(P2-10)。

2026-09-28 更新说明(第一批代码改进:止住现场死机,只做静态分析已确认的项)

版本变更(control.h):

#define VERSION_HK          "2.43.41(HK)"       //4.0海康-1200W
#define VERSION_HK_2000W    "2.43.4(2000W)"     //4.0水稻
#define VERSION_ZP          "2.43.1(ZP)"        //1.0转盘
#define VERSION_GK          "2.43.1(GK)"        //1.0高空

本批全部来自 固件代码审计与优化报告_2026-09-28.md 的第一批(立即修)建议, 都是"改法在 1~3 行、能止住现场死机"的项,未触碰任何业务逻辑。

一、P0-1 自检拍照超时定时器:HARD_TIMER → SOFT_TIMER

  • selfcheck.c:337 rt_timer_create(..., RT_TIMER_FLAG_ONE_SHOT|RT_TIMER_FLAG_SOFT_TIMER)
  • 原因:t_takephoto_callback() 里调了 HMI_WRITE(),而 HMI_WRITE() 内部有 rt_thread_mdelay(1)(hmi.c:146)。HARD_TIMER 的回调是在 SysTick 中断里执行的, 在 ISR 里挂起线程会触发 RT-Thread 调度器断言或直接锁死 → 自检拍照阶段反复重启。
  • 配套:rtconfig.h RT_TIMER_THREAD_STACK_SIZE 512 → 1024。 回调改到 timer 线程后,HMI_WRITE() 里的 rt_vsnprintf 要吃几百字节栈,512 不够。
  • ⚠️ 注意:HMI_WRITE() 是无锁的共享 static 缓冲,且内含 rt_thread_mdelay, 任何 ISR / HARD_TIMER 回调都不许调它。

二、P0-2 主上传路径 UpLoad_Data() 的格式串 + 判空

  • dtu_uart2.c UpLoad_Data():原来 DTU_Write(updata),把 JSON 直接当格式串。 JSON 里出现 %(photolink / deviceId / project 等字段内容不完全可控)就会被 vsnprintf 当格式说明符解析;makeJson() 分配失败返回 NULL 时更会直接崩。
  • 改为 DTU_Write("%s", updata),并加 updata != RT_NULL 判空 + 失败打 LOG_E。
  • ⚠️ 同类写法尚未处理(留在第二批):dtu_uart2.c:1334 / 1344 / 1453 / 1962 / 1970 以及 UART_TEST_EN 分支的 :1846,都还是 DTU_Write(指针)。

三、P0-4 接收线程日志把 char 当 %s

  • dtu_uart2.c:311(uart2 接收线程)与 :362(uart5 接收线程)
  • 原来:LOG_W("invalid JSON byte:%s[%x]", ch, ch) —— ch 是 char,被 %s 当成地址 去读字符串。串口上只要出现任何非 JSON 首字符的字节(噪声 / RTU 非 JSON 打印 / 半帧) 就会走到这里 → 打印乱码或 Bus Fault。
  • 改为 LOG_W("invalid JSON byte: 0x%02x", (unsigned char)ch);

四、P1-2 res[30] 装不下 fuse_voltage[32]

  • dtu_uart2.c:550:static char res[30] → res[64],sprintf → rt_snprintf。 "Fuse is fusing:"(15)+ fuse_voltage[32] 最长 15+31+1 = 47 字节,原越界 17 字节。

五、P1-4 %-6s 不是截断,是最小宽度

  • control.c:2165:rt_sprintf(buf, "%-6s", alarm_tg) → rt_snprintf(buf, sizeof(buf), "%-6.6s", ...)
  • buf 只有 7 字节而 alarm_tg 是 char[12],%-6s 的 6 是最小宽度不是截断宽度 → 栈溢出。 必须写成 %-6.6s(精度 .6 才是截断)。

六、P1-15 / P1-16 beep.c:PWM 句柄判空 + ISR 回调去阻塞调用

  • ISR 回调只允许置标志:
    • timeout_cb()(hwtimer 中断回调):删掉 rt_kprintf×2 与 rt_device_close(dev)。 rt_kprintf 走 console 设备写可能阻塞,rt_device_close 内部有 RT_ASSERT 且属线程 上下文 API —— 在中断里调用会死锁在 ISR,5s 看门狗复位, 现象是"蜂鸣器响 / 电机走到位时随机死机"。现只置 g_beep_timer_fired 标志
    • rt_pwm_disable()(走 HAL,不取 IPC 锁)。
    • 新增 beep_timer_release()(线程上下文),在下次 init_tim2() 开头收尾关闭设备句柄。 顺带修掉 init_tim2() 里同名局部变量 hw_dev 屏蔽了文件作用域 hw_dev、 函数一返回句柄就丢失的问题。
  • stop_motor_86()(GPIO 中断回调):删掉 rt_kprintf,加 pwm_device 判空。 同时把形参由 void 改成 void *args —— rt_pin_attach_irq 要求的类型是 void (*)(void *),原声明属函数指针类型不匹配(UB,宿主 gcc 已报 -Wincompatible-pointer-types)。
  • PWM 句柄判空(原来 init_pwm3()/beep_init()/pwm8_init() 失败返回 -RT_ERROR 后 调用点全部忽略,紧接着把 NULL 传给 rt_pwm_set/enable → hard fault): hwtimer2_pwm3_output()、pwm_on()、pwm_off()、beep_on()、beep_off()、 beep_set()、Motor_Juandai()、Motor_Qingsao_R_PWM()、Motor_Qingsao_L_PWM()、 Motor_shake() 全部补上判空。

七、改动文件清单

文件 改动
applications/selfcheck.c 拍照超时定时器 HARD_TIMER → SOFT_TIMER + 注释
rtconfig.h RT_TIMER_THREAD_STACK_SIZE 512 → 1024
applications/dtu_uart2.c UpLoad_Data() 格式串 + 判空;%s→%02x ×2;res[30]→res[64] + rt_snprintf
applications/control.c %-6s → %-6.6s + rt_snprintf
applications/beep.c ISR 回调去阻塞调用;hwtimer 句柄收尾;PWM 句柄判空 ×10;stop_motor_86 形参修正
applications/control.h 版本号 2.42 → 2.43

八、验证与遗留

  • 本机无 arm-none-eabi 工具链。已用宿主 gcc(-fsyntax-only -Wall -Wextra + 工程 include 路径) 对 beep.c 做过语法检查:无 error,仅剩既有的 unused-parameter 警告。 control.c / dtu_uart2.c / selfcheck.c 因会拉进 x86 内联汇编头文件无法在宿主 gcc 上跑通, 改动点均为局部单行替换,已在源码中逐条复核。
  • 上机必做:RT-Thread Studio 里 Refresh(F5) + Clean + Build。
  • 下一批(第二批)待办(见报告第七节):平台下发 JSON 字段判空(P0-3)、 远端字符串改 rt_snprintf(P1-1)、utos[5]/driver[64] 越界(P1-3/P1-5)、 DTU_Write 未配对 free(P1-6)、删线程前 reset mutex(P1-7)、coll_time 悬垂指针(P1-8)。

2026-09-24 参数存储专题:EasyFlash 概率丢参数修复 + A/B 双分区备份

一、现象与结论

现场现象:设备重启后概率性丢参数,严重时被刷成出厂值,需要现场重新配置。

结论:是软件 bug,且是多个叠加,不是 flash 硬件损坏,也不是掉电玄学。

前提:EasyFlash 工作在 NG 模式,ef_save_env() 是空实现,ef_set_env_blob() 立即落 flash —— 所以每一次 set 都是一个真实的掉电窗口。

二、根因(按危害排序)

# 问题 位置 后果
1 每次开机无条件写 reboot_time hmi.c Check_ParamConfig 唯一必执行的写,正好落在上电/复位最不稳的时刻 —— 掉参最大单一来源
2 写在 ENV_PRE_WRITE 阶段被打断 ef_env.c 下次启动被判 ENV_ERR_HDR,该条永久丢失,回落到 default_env_set
3 GC 搬移被打断 ef_env.c check_sec_hdr_cb sector 头校验失败 → format_sector() 擦掉整个 4KB,参数成片丢失
4 iSave 是唯一哨兵 hmi.c iSave!=FLASH_FLAG 分支 它一丢就触发全量刷出厂值 —— "丢一条"被放大成"全丢"
5 "丢参数的处理"补丁只改 RAM 不落盘 hmi.c 读取块后的修正段 每重启重复丢、重复修,flash 里永远是错的
6 32 连写 / 24 连写无原子性 hmi.c 首次配置、ResetParamDefault 中途打断只写进去一半
7 heatvalue 双语义 hmi.c 孢子仪写 heatvalue、测报灯写 jheat,开机一律读 jheat → 孢子仪设的培养温度重启被顶掉
8 cold_sw 只写不读 hmi.c 孢子仪设置页 制冷开关设置完一重启就丢
9 default_env_set key 笔误 ef_fal_port.c workmode/shake_sw 名错、缺 cold_sw/heatvalue、run_sta 重复;EF_ENV_AUTO_UPDATE 未开 → 新 key 不补写

三、解决方案:A/B 双分区备份(新增 param_backup 模块)

新增 applications/param_backup.{h,c}:

  • A/B 两个 4KB 分区 ping-pong —— 写 A 时 B 保留上一版,写一半掉电不影响另一份
  • CRC32 校验 + seq 递增 —— 启动时取 seq 最大且 CRC 通过的那份
  • 写入后回读校验
  • 延迟落盘线程(prio 20,静默 500ms 合并写入)+ 两道节流(内容相同不写 / 最小间隔 10s), 否则屏幕每帧刷屏会把 4KB sector 几天写穿
  • msh 命令:param_dump / param_save_now / param_restore / param_save_ef

分区表 fal_cfg.h 调整:

"easyflash"    0      ~ 128KB     ENV 区仍在偏移 0,老设备升级参数不丢
"param_a"      128KB  + 4KB       新增,落在原本未使用的空白区
"param_b"      132KB  + 4KB       新增

开机流程改为双向仲裁:

  • EasyFlash 坏了 → 从快照恢复,并回写 EasyFlash 修好 flash 侧
  • 快照坏了 / 更旧 → 用 EasyFlash 重建快照
  • 删掉了开机写 reboot_time,开机计数改走快照延迟落盘

⚠️ 关键坑:不能 memcpy 整个 Device_Status_typedef —— 里面有 const char *coll_time[10] 指针数组,序列化指针值毫无意义,恢复后必然跑飞。所以单独定义了 param_persist_t 只存值字段。

四、顺手修掉的确定性 bug

  1. device_status 收敛为唯一定义:原本 10 个 .c 各写一行 Device_Status_typedef device_status;(applications 下 9 个 + packages/syswatch.c), 靠 -fcommon 合并成 1592 字节的 COMMON 符号。现改为 control.h 加 extern Device_Status_typedef device_status;,只保留 main.c 一处定义。 实测:原写法在 -fno-common 下直接 multiple definition 链接失败。
  2. heatvalue 按 dtype 分支读取:孢子仪(dtype==7)读 heatvalue,否则读 jheat; 老设备无该 key 时回退 jheat。
  3. cold_sw 补上读取。
  4. default_env_set 修 4 处:workmode→work_mode、shake_sw→shake_ws、 删重复的 run_sta、补 cold_sw/heatvalue。53 项 → 无重复、无缺失、无残留错误 key。
  5. control.h 头文件保护宏名不匹配(ifndef 与 define 两个不同名字)→ 统一为 CBD_CONTROL_H_。

更正:初版报告里"dtu_uart2.c 把 startBar 写进 sunBar"是误报(当时行号有位移)。 全量审计 239 个 ef_*_env_blob 调用点后确认,所有 key/字段映射都是读写成对的,不存在错位。

五、EasyFlash env key 别名表(改参数前必读)

key 名与 device_status 字段名故意不一致的历史别名,读写成对,别"顺手改成一致":

env key 字段 含义
reboot_time rebootcnt 启动次数
stime clt_time 收集时间
jtime heattime 加热时间
jheat heatvalue 加热温度(测报灯 dtype!=7)
heatvalue heatvalue 培养温度(孢子仪 dtype==7)
env_t / env_h tempture / humidity 环境温湿度
platform mqttcfg1 平台地址

六、改动文件清单

文件 改动
applications/param_backup.h / .c 新增,双分区备份模块
applications/fal_cfg.h 新增 param_a / param_b 分区
applications/hmi.c 开机双向恢复流程、删开机写 reboot_time、heatvalue 按 dtype 读、补 cold_sw 读、去重复定义
applications/control.h 加 extern 声明、修头文件保护宏
applications/main.c device_status 唯一定义处
applications/control.c / beep.c / dtu_uart2.c / selfcheck.c / sample_mb_master.c / sht30_collect.c / sys_monitor.c 删除各自的 device_status 重复定义
packages/syswatch-latest/src/syswatch.c 同上
packages/EasyFlash-v4.1.0/src/ef_fal_port.c default_env_set 修 4 处

七、上板前必做

  1. RT-Thread Studio 里 Refresh(F5) + Clean + Build(新增了 .c 文件;本机无 arm-none-eabi 未编译)
  2. 确认 norflash0 实际容量 ≥ 4MB(df_area 结束在 4MB 处)
  3. 现场用 msh 验证:param_dump 看快照、param_save_now 强制落盘、 param_restore 从快照恢复、param_save_ef 把快照回写 EasyFlash

八、已知未修(会改变行为,待确认)

  • wind_sw(风机开关):default_env_set 有默认值,但代码从未 ef_get/ef_set → 重启不保存
  • driver_compile(BL 编译时间):同样只写不读 → 屏幕永远显示空
  • heatvalue 默认值给的 "26"(孢子仪培养温度,校验范围 10~50),需按现场工艺确认

九、校验方式

本机无 arm-none-eabi 工具链,无法编译。用三个脚本在宿主 gcc 上做了等价验证:

  • .workbuddy/tools/param_syn_check.py —— 抽 control.h 真实结构体 + 最小桩, -fsyntax-only -Wall -Wextra,exit=0 无警告
  • .workbuddy/tools/ef_key_audit.py —— 全量 key 审计(错位 / 重复 / 缺失 / 未使用)
  • .workbuddy/tools/verify_fix.py —— 改动块语法 + default_env_set 语义 + device_status 在 -fno-common 下的对照链接实验 —— 三项全 PASS

十、上板实测:main 线程栈溢出 hard fault(第二轮修复)

上板后开机会 hard fault,日志停在这两句之间:

[Flash] (../packages/EasyFlash-v4.1.0/src/ef_env.c:1818) ENV start address is 0x00000000, size is 65536 bytes.
psr: 0x21000000 ... pc: 0x080415fa
hard fault on thread: main

结论:这是上一轮引入的新 bug(main 线程栈被撑爆),不是 EasyFlash 的问题。 那条 ENV 日志只是崩溃前最后一句正常输出,Check_ParamConfig() 就在 main() 里 (main.c:46),与 hard fault on thread: main 完全对上。

实测数据(.workbuddy/tools/sizeof_probe.py,宿主 gcc 编译运行):

sizeof(param_persist_t)      = 820 bytes
RT_MAIN_THREAD_STACK_SIZE    = 2048        (rtconfig.h)

Check_ParamConfig() 的栈峰值:

来源 栈占用
param_boot_snap(hmi.c 局部) 820
cur(hmi.c 局部,与上面同时存活) 820
param_backup_read() 内部 pa + pb 1640
rt_kprintf / vsnprintf 调用栈 数百
合计 > 3.2KB / 可用 2KB

另有一个独立必崩点:落盘线程栈只有 1024,而 param_flush_impl() 里有 820 字节的 snap。

修法(4 处)

  1. param_backup.c 新增 static param_persist_t g_work(820B 静态工作区,受 g_lock 保护), 模块内所有临时对象改用它:
    • param_backup_read():原本栈上同时放 pa + pb(1640B)→ 改为复用单个 g_work (先读 A 记 seq,再读 B 若 seq 更大才覆盖),逻辑等价
    • param_backup_init() 的 tmp、param_flush_impl() 的 snap、 三个 msh 命令(param_dump / param_restore / param_save_ef)→ 同样处理
  2. hmi.c 两处 param_persist_t 局部变量加 static
  3. RT_MAIN_THREAD_STACK_SIZE 2048 → 4096(RT-Thread 默认就是 4096,本项目被人改小过)
  4. 落盘线程栈 1024 → 2048

已验证:param_flush_impl 全程持锁,内部又调 param_backup_write()(自身也 take 锁)。 查 rt-thread/src/ipc.c:RT-Thread 的 mutex 对同线程递归 take 是 mutex->hold++, 不会死锁。

代价与后续

  • RAM 增加约 5.4KB(g_work 820 + hmi 两个 static 1640 + main 栈 +2048 + 落盘栈 +1024)。 编译后需看一眼 RAM 占用;若紧张,可把 Check_ParamConfig 整体挪到独立大栈线程, 把那 1640 字节还给栈。
  • 建议用 arm-none-eabi-addr2line -e rtthread.elf 0x080415fa 反查 pc,确认崩点确实在 param_backup_read(本轮是按栈用量推的,日志未给 map)。

本轮追加改动的文件

文件 改动
applications/param_backup.c g_work 静态工作区;read/init/flush/3 个 msh 命令改用它;落盘线程栈 1024→2048
applications/hmi.c 两处 param_persist_t 局部变量改 static
rtconfig.h RT_MAIN_THREAD_STACK_SIZE 2048 → 4096

十一、flash 物理损坏降级启动(场景 A 加固)

问题:SPI flash 整体失效时设备会变砖。原链路上有四处错误返回值被丢弃,故障一路被掩盖:

# 位置 被丢弃的错误
1 rt_hw_spi_flash_init(INIT_COMPONENT_EXPORT) rt_sfud_flash_probe 返回 NULL → -RT_ERROR,自动初始化不检查
2 rt_hw_on_chip_flash_init(INIT_APP_EXPORT) fal_init() 返回值直接丢弃
3 fal_flash.c:45 device_table[i]->ops.init() 返回值丢弃,仍置 init_ok=1;sfud_dev 始终是 NULL
4 fal_partition.c 分区校验 只查 offset >= len,而 len 仍是默认 8MB → 分区"合法"建出来

于是 easyflash_init() 返回成功、ENV 地址照常打印,第一次真正读 flash 时才炸: nor_flash0.ops.read() 里的 assert(sfud_dev) 在 FAL_DEBUG=0(默认)时被 fal_def.h:50 宏替换成 ((void)0),等于没有保护 → sfud_read(NULL, ...) → HardFault。

另一条更隐蔽:若 FAL 真没初始化成功,ef_fal_port.c 的 EF_ASSERT(part) 是 while(1) 死循环, 且 EF_DEBUG 未定义 PRINT_DEBUG 时不打印任何东西 —— 串口完全无输出,现场只能看到"通电没反应"。

加固(4 个文件)

  1. rt-thread/components/fal/samples/porting/fal_flash_sfud_port.c
    • 新增 nor_flash0_ready / nor_flash0_inited 标志与对外查询 nor_flash0_is_ready()
    • init() 失败时:置 ready=0 并把 nor_flash0.len 清 0 (让分区表越界校验失败 → fal_partition_find() 返回 NULL → 故障暴露到上层)
    • read / write / erase 全部改为显式判空返回 -1,不再依赖被宏吃掉的 assert
  2. packages/EasyFlash-v4.1.0/src/ef_fal_port.c
    • EF_ASSERT(part) → 改为返回 EF_ENV_INIT_FAILED(消除静默死循环)
    • ef_port_read / write / erase 加 part == RT_NULL 判空,返回对应错误码
  3. applications/fal_cfg.h —— 声明 extern int nor_flash0_is_ready(void);
  4. applications/hmi.c —— 开机最前面加门控:!nor_flash0_is_ready() 时 完全不调 easyflash_init(),跳过 32 连写(if (ef_ok)), 用 RAM 出厂参数继续运行,并三声短鸣报警
  5. applications/param_backup.c —— 新增 g_disabled 闸门:分区都找不到时 mark_dirty / flush 直接返回失败,避免落盘线程几秒重试一次刷爆串口

降级后的行为

  • 设备照常启动、照常工作,参数是出厂默认值
  • 开机三声短鸣,串口打印 !! SPI FLASH NOT READY - degraded boot, params live in RAM only
  • 所有 ef_set_env_blob 安全失败,不会触发 EasyFlash 内部 GC(GC 中途失败会 format 整个 sector)
  • 重启后仍是默认值 —— 这是"降级"而非"修复",flash 换了就好

现场诊断对照表

串口停在哪 说明
boot_flag:0x0000 之后全无输出 分区没建起来(现已改为返回错误 + 打印,不再死循环)
ENV start address... 之后 hard fault 栈溢出(已修)或 flash 空指针(本次已修)
!! SPI FLASH NOT READY 本次新增:flash 已损坏,正在降级启动
(init_ok) has assert failed at fal_partition_find FAL 没建表成功(见第十二节,已修)

⚠️ 注意

改到了 RT-Thread 公共组件 rt-thread/components/fal/samples/porting/fal_flash_sfud_port.c (属于移植层,本就是给用户改的,风险可控)。若用 RT-Thread Studio 更新/重生成 FAL 组件, 本文件可能被覆盖 —— 升级后请确认 nor_flash0_is_ready() 是否还在。

本轮改动文件

文件 改动
rt-thread/components/fal/samples/porting/fal_flash_sfud_port.c 可用性标志 + 空指针防护 + len 清 0(此条已于第十二节推翻)
packages/EasyFlash-v4.1.0/src/ef_fal_port.c 去掉死循环 EF_ASSERT(part),四处判空
applications/fal_cfg.h nor_flash0_is_ready() 声明
applications/hmi.c 开机降级门控 + 三声报警 + 32 连写跳过
applications/param_backup.c g_disabled 闸门

十二、上板实测:assert failed at fal_partition_find 死机(第三轮修复)

现场日志

msh >[E/hmi] 2026-09-24 16:27:22 !! SPI FLASH NOT READY - degraded boot, params live in RAM only
(init_ok) has assert failed at fal_partition_find.

降级提示打得很好,但紧接着整机卡死 —— 第十一节的加固有一条自己挖的坑。

根因:把 nor_flash0.len 清 0 反而拖垮了整个 FAL

sfud 探测失败(sfud_dev = NULL)
   ↓ 上一版在这里写 nor_flash0.len = 0
fal_partition.c: check_and_update_part_cache()
   ↓ 分区 offset(0) >= flash_dev->len(0) → return -1
fal_partition_init() 整体失败 → init_ok 永远是 0
   ↓
fal.c: fal_init() 的 init_ok = 0
   ↓
任何 fal_partition_find() → 第一行 assert(init_ok) → while(1) 死循环

fal_partition_find() 的 assert(init_ok)(fal_partition.c:324)是全局杀伤: 一旦 FAL 没建表成功,谁先调它谁死,连片内 flash 的 bl/app 分区也一起废掉。 本意是"让分区表越界、find 返回 NULL",实际是"让整条 FAL 崩掉"。

而触发它的正是降级分支自己:Check_ParamConfig() 里 param_backup_init() (hmi.c:1771)不在 ef_ok 门控内,flash 坏了也会照常执行 → 第一个撞上断言。

修法(5 处)

# 位置 改动
1 fal_flash_sfud_port.c init() 去掉 nor_flash0.len = 0。保留标称容量让 FAL 正常建表、init_ok 正常置 1;安全闸改为 nor_flash0_ready,read/write/erase 一律返回 -1
2 fal_flash_sfud_port.c init() 新增容量下限 NOR_FLASH0_TABLE_MIN_LEN(4MB,= 分区表末端)。芯片容量不足时置 ready=0 降级,但保持 len 足够大,不拖垮 FAL
3 param_backup.c param_backup_init() 加两道闸门:fal_init_check() != 1 → 直接 disabled;nor_flash0_is_ready() == 0 → 直接 disabled(否则落盘线程会周期性重试刷屏)
4 ef_fal_port.c ef_port_init() / hmi.c app_partion_backup() fal_partition_find() 之前一律先查 fal_init_check()
5 fal_flash_sfud_port.c 两处静默失败 rt_sfud_flash_probe 失败、fal_init() 返回值被丢弃 —— 都补上 log_e,并区分"spi10 没挂上"与"挂上了但芯片不响应"

fal_init_check() 定义在 fal.c 但fal.h 没导出,已在 applications/fal_cfg.h 补 extern 声明 (fal.h 会包含 fal_cfg.h,全工程可见)。

新增诊断命令

msh > param_stat
fal_init_check   : 1     (0 = 所有 fal_partition_find 都会断言死循环)
nor_flash0_ready : 0     (0 = SPI flash 没探测到,已走 RAM 降级参数)
param_a / param_b: param_a / param_b
g_disabled       : 1

现场报"起不来/丢参数"先敲这个,一眼定位到 FAL 层、flash 层还是快照层。

关于"为什么 flash 探测不到"

软件侧时序已核对无误,不是本轮改动引入:

  • rt_hw_spi_init 是 INIT_BOARD_EXPORT(level 1),sfud probe 是 INIT_COMPONENT_EXPORT(level 4),fal_init 是 INIT_APP_EXPORT(level 6)—— 总线注册早于探测早于建表,顺序正确
  • SPI 总线名 spi1(spi_config.h:26)与 rt_hw_spi_device_attach("spi1", "spi10", ...) 一致;sfud 探测名与 fal 查找名同为宏 FAL_USING_NOR_FLASH_DEV_NAME

所以落在硬件侧:芯片虚焊/击穿、CS(PA4)接触、flash 供电。开机日志现在会明确区分:

日志 含义
spi device 'spi10' is NOT attached 挂载/总线这一步就没成
'spi10' attached but sfud probe failed 总线通了,芯片不响应(读 JEDEC ID 失败)

修复后的降级链路

sfud 探测失败 → ready=0,len 保留 → FAL 正常建表(init_ok=1)
   → hmi 门控跳过 EasyFlash → param_backup 双闸门 disabled
   → 出厂默认值 + 三声报警 → 设备照常干活(参数只在 RAM,重启回默认)

本轮改动文件

文件 改动
rt-thread/components/fal/samples/porting/fal_flash_sfud_port.c 去掉 len 清 0;容量下限;三处诊断日志
applications/fal_cfg.h 补 fal_init_check() extern 声明
applications/param_backup.c param_backup_init 双闸门;新增 param_stat 命令
packages/EasyFlash-v4.1.0/src/ef_fal_port.c ef_port_init 加 fal_init_check 闸门
applications/hmi.c 固件备份的 fal_partition_find 加闸门

校验

.workbuddy/tools/degraded_boot_check.py(已同步更新断言,改为校验"不再清 0"):

[A] fal_flash_sfud_port.c 五个函数      gcc exit=0 PASS
[B] ef_port_* 四个函数                  gcc exit=0 PASS
[C] 5 个文件大括号配平                   OK
[D] 16 项关键符号/调用点核对             全 OK
总结: 全部通过

.workbuddy/tools/param_syn_check.py:gcc exit = 0,无警告无错误。 (顺手给它的桩补了 fal_init_check / nor_flash0_is_ready 声明,消除误报。)

上板前照旧:RT-Thread Studio Refresh(F5) + Clean + Build。


十三、触发升级后重启不执行升级(第四轮修复)

现场现象

触发升级(平台 {"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。


十四、升级改为"收到指令直接进 ymodem"(第五轮,不再置标志重启)

为什么又改一版

第十三节做的三通道持久化,本质上还是在修"标志存不住"这个症状。用户拍板: 标志这条路本身就该砍掉——收到升级指令就在当前线程直接进 ymodem,不写标志、不重启。

理由很硬:

  1. 只要经过重启,就必然要把标志过一遍 EasyFlash,而 EasyFlash 正是丢参数的重灾区, 等于把升级成败押在最不可靠的环节上;
  2. 多一次重启就多一次"卡在 ymodem 干等"的窗口;
  3. 直接进 ymodem 不需要任何持久化,请求丢了也不会"静默跳过"——因为根本没丢这个动作。

改后的流程

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)里有一句:

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 的做法遍历内核线程对象链表:

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 丢失分支)里还有一段开机裁决:

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. 重要参数丢失的参数重置;
2. 【修复】经济款三线电机状态机问题;
3. 【重构】参数存储加固:EasyFlash 概率丢参数修复 + A/B 双分区备份(详见本文档顶部专题第一节~第九节);
4. 【修复】main 线程栈溢出导致开机 hard fault(详见本文档顶部专题第十节);
5. 【修复】flash 损坏时死在 fal_partition_find 断言(详见本文档顶部专题第十一、十二节);
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. 修复丢参数导致无法启动
2. 更换三线电机;

2026-09-17

#define VERSION_HK_2000W    "2.46.4(jjk-5)"           //经济款
1. 经接款测报灯调整初始化过程清扫次数为5次,启动后和工作结束后;

2026-09-16

1. uartV2驱动更新,修复Bug;

2026-08-11

#define VERSION_HK_2000W    "2.13.4(TG111)"      //推杆结构
1、取消定时重启RTU;

2026-07-31

#if QINGSAO_YUGUAQI == 1
#define VERSION_HK_2000W    "2.42.4(y)"         //4.0水稻
适配中端款测报灯的雨刮器清扫结构,带限位;

2026-07-29

#define VERSION_HK_2000W    "2.43.4(jjk)"           //经济款
1、修复触发雨控把接口断电导致无法控制模块;

2026-07-28

#define VERSION_HK_2000W    "2.42.4(jjk)"           //经济款
1、适配DAM0808D数采控制器、用于3路球阀控制,替换上下仓门,增加雨控电机;
2、通过ctr_cold()控制模块的供电;

2026-07-13

#define VERSION_HK_2000W    "2.41.4(2000W)"         //4.0水稻
1、easyflash配置ENV_AREA_SIZE 调整为4096*256
2、检测到外部断电把电压设置为0,并上报最新数据;

2026-06-24 更新说明

#define VERSION_HK_2000W    "2.12.4(TG111)"         //推杆结构
1、修复不是别赛设备发送串口数据串口异常导致死机;

2026-06-12 更新说明

#define VERSION_HK_2000W    "2.40.4(2000W)"         //4.0水稻
1、每小时上传4张照片,修改默认参数收集6分钟,加热8分钟;

2026-06-10 更新说明

#define VERSION_HK_2000W    "2.39.000(2000W)"         //4.0水稻
1、增加485多通道电机驱动模块适配,用于控制地笼上的接虫盒;

2026-06-08 更新说明

#define VERSION_HK_2000W    "2.39.4(2000W-111)"         //4.0水稻
1、震动功能优化,100ms间隔停顿1000ms;

2026-06-05 更新说明

#define VERSION_HK_2000W    "2.38.4(2000W-111)"         //4.0水稻
1、uart2串口通信连续2个小时没有收到json数据,安全重启RTU电源;
2、增加安全关闭RTU电源,将UART的TX/RX引脚配置为GPIO_Mode_IN(高阻输入),关闭内部上拉

2026-06-05 更新说明

#define VERSION_HK_2000W    "2.37.4(2000W-111)"         //4.0水稻
1、比赛设备取消推杆结构;
2、取消定时重启RTU的硬件12V断电;

2026-06-03 更新说明

#if MATCH_DEVICE == 1
#define VERSION_HK_2000W    "3.2.4(TG)"             //推杆结构比赛设备
#else
#define VERSION_HK_2000W    "2.11.4(TG111)"             //推杆结构
#endif
1、MCU定时重启时间修改为8:10在RTU之前,这样出现参数异常时,RTU这时正常运行可以恢复参数;

2026-06-02 更新说明

#if MATCH_DEVICE == 1
#define VERSION_HK_2000W    "3.1.4(TG)"             //推杆结构比赛设备
#else
#define VERSION_HK_2000W    "2.10.4(TG111)"             //推杆结构
#endif
1、修复定时重启RTU软重启后继续触发硬重启,有概率导致RTU无法启动;
2、删除uart2_timer,改用线程超时;
3、RTU电源控制函数增加间隔限制30S;

2026-05-29 更新说明

"2.9.4(TG110)"
1. 增加远程设置触发时间;
{"jsonrpc":"2.0","method":"alarm","params":{"time":"230120"},"id":1}
2. 关闭欠压保护;

2026-05-14 更新说明

"2.8.4(TG)"
1. B模式下,根据工作状态字段开关灯管
2. 解决屏幕上网线接入状态闪烁问题

2026-04-23 更新说明

"2.7.4(TG)"
"2.36.4(2000W)"
拍照完成后执行清扫,不加工作状态判断!

2026-03-13 更新说明

"2.35.4(2000W)"
1. 修复测试加热开关,状态界面不更新
2. 修复未雨控时计数结束后标志位错误导致误触发;

2026-03-13 更新说明

"2.35.4(2000W)"
1. 增加系统状态监测
2. 增加imei和iccid同步的代码健壮性
3. 修复参数丢失thsp为0导致屏幕无法常亮

2026-02-02 更新说明

"2.34.4(2000W)"
增加MCU参数备份到RTU中

#define VERSION_HK_2000W "2.33.4(2000W)" //4.0水稻

20260122
1. 修改定时重启RTU的方式,修改为软重启,发送重启指令超时20S没有收到恢复后执行硬重启,硬断电时间由10S修改为30S;

#define VERSION_HK_2000W "2.32.4(2000W)" //4.0水稻 #define VERSION_HK_2000W "2.3.4(TG)" //推杆结构

引入LWjson

#define VERSION_HK_2000W "2.31.4(2000W)" //4.0水稻

修复中端款V43不上传vtype字段

#define VERSION_HK_2000W "2.30.4(2000W)" //4.0水稻

震动的模式修改,基准时间50s,间隔1000ms;

#define VERSION_HK_2000W "2.29.4(2000W)" //4.0水稻

中端款定制8位转仓;

#define VERSION_HK_2000W "2.28.4(2000W)" //4.0水稻

1. 修复在备用电池安装的情况下断电再重启,控制板串口发送数据异常;
2. 雨控处理逻辑调整:
    雨控触发后,解除的检测时间修改为5分钟,之后进行震动,开关上仓门,加热5分钟,开关下仓门,清扫;

#define VERSION_HK_2000W "2.27.4(2000W)" //4.0水稻

1. 修改清扫的默认方向!

#define VERSION_HK_2000W "2.26.4(2000W)" //4.0水稻

1. 修复两个问题;
    设定1分钟收集时间,工作结束会拍到刷子;
    雨控触发解除后灯管状态显示异常;

#define VERSION_HK_2000W "2.25.4(2000W)" //4.0水稻

1. 修复开关上下仓门出现的仓门未完全打开/关闭的现象;

#define VERSION_HK_2000W "2.24.4(2000W)" //4.0水稻 2025-07-18 修复收集时间为1分钟时,拍照完不执行清扫; 2025-07-07 上仓门打开和关闭的方向调整

2025-06-28 更新说明

针对比赛设备: 定时开关路由器供电可通过屏幕震动 开启; 远程可控制路由器 关闭时间;

2025-06-10 更新说明

#define VERSION_HK_2000W "2.22.4(2000W)" //4.0水稻

  1. 自检清扫电流检测阈值150降低为120

    2025-06-09 更新说明

  2. 定时重启时间改为12:20

    2025-06-05 更新说明

    #define VERSION_HK_2000W "2.21.4(2000W)" //4.0水稻

  3. 故障检测开发,初版完成;

  4. 解决清扫时间不够执行不到位问题;

  5. 比赛设备,重置后不能进入温控

    2025-06-05 更新说明

    #define VERSION_HK_2000W "2.20.4(2000W)" //4.0水稻

  6. 针对比赛设备的更新: 取消断网状态下切换光控定时 启用主板定时重启,8:30 dtu串口通信改为旧版; 故障检测开发;

    2025-06-05 更新说明

    #define VERSION_HK_2000W "2.19.4(2000W)" //4.0水稻

  7. DTU_Write 延时由20ms改为100ms;

  8. RT_DEVICE_FLAG_TX_NON_BLOCKING,串口发送改为非阻塞方式

    光控损坏的处理

    2025-06-03 更新说明

    #define VERSION_HK_2000W "2.18.4(2000W)" //4.0水稻

  9. 修复时控逻辑BUG,设置跨天工作到0点会结束工作问题;

2025-05-30 更新说明

#define VERSION_HK_2000W "2.17.4(2000W)" //4.0水稻

  1. 增加调试上报功能
  2. 修改时控定时逻辑

    2025-05-28 更新说明

    #define VERSION_HK_2000W "2.16.4(2000W)" //4.0水稻

  3. 修复RTC问题,取消设置时间

    2025-05-22 更新说明

    #define VERSION_HK_2000W "2.15.4(2000W)" //4.0水稻

  4. 修复偶发灯管状态显示异常问题,原因是和开关灯管状态的变量lamp_status冲突导致,解决:灯管状态使用单独的变量:lamp;

    2025-05-21 更新说明

    #define VERSION_HK_2000W "2.14.4(2000W)" //4.0水稻

  5. 改进灯管检测,增加检测次数及检测间隔,提高准确度; #define VERSION_HK_2000W "2.13.4(2000W)" //4.0水稻

  6. 修改温湿度设置时间方法

    2025-05-19 更新说明

    #define VERSION_HK "2.5.41(HK)" //4.0海康-1200W #define VERSION_HK_2000W "2.12.4(2000W)" //4.0水稻 #define VERSION_ZP "1.45.1(ZP)" //1.0转盘 #define VERSION_GK "1.41.1(GK)" //1.0高空 #define VERSION_V5 "2.0.5(HK)" //5.0

  7. 修复光控运行逻辑错误:在光控时间未结束提前天亮会导致第二天工作时间异常; 解决措施:持续超过1小时触发光控,清除光控计时

  8. 解析服务器下发的温湿度中的时间

    2025-05-16 更新说明

  9. 修复欠压状态并且RTU程序未运行时 会关断RTU电源问题

2025-04-30 更新说明

#define VERSION_HK "2.4.41(HK)" //4.0海康-1200W #define VERSION_HK_2000W "2.11.4(2000W)" //4.0水稻

  1. DTU串口通信异常处理修复;
  2. 清扫时间15S改为30S;

2025-04-15 更新说明

#define VERSION_HK "2.4.41(HK)" //4.0海康-1200W #define VERSION_HK_2000W "2.10.4(2000W)" //4.0水稻

  1. 消息队列满时清空消息队列;
  2. V4 清扫时间由40s降低为20s;
  3. 自检增加了更多的调试信息

    2025-04-10 更新说明

    #define VERSION_HK "2.4.41(HK)" //4.0海康-1200W #define VERSION_HK_2000W "2.9.4(2000W)" //4.0水稻

  4. 光控检测优化,采集ADC数值进行检测,如果为0表示故障;

  5. 增加加热电流数据上报,字段current_heat;

  6. 屏幕震动时间设置单位由秒改为毫秒

2025-03-18 更新说明

#define VERSION_HK "2.4.41(HK)" //4.0海康-1200W #define VERSION_HK_2000W "2.5.4(2000W)" //4.0水稻

  1. 灯管故障检测调整,电流值滤波;

2025-03-18 更新说明

#define VERSION_HK "2.3.41(HK)" //4.0海康-1200W #define VERSION_HK_2000W "2.4.4(2000W)" //4.0水稻

  1. 修复备用电池供电时,电流显示负值;
  2. 修复自检定位状态始终显示失败的问题,字段错误,使用了gps_state,正确是gps
  3. 修复自检过程中点击自检重新开始自检.

    2025-01-23 更新说明

  4. 项目重建,使用rtthread4.1.1版本;

  5. 串口驱动框架适配V2版本 开启串口2和串口4的DMA发送;

2024-11-09 更新说明

#define VERSION_HK "2.0.41(HK)" //4.0海康-1200W #define VERSION_HK_2000W "2.0.4(2000W)" //4.0水稻 #define VERSION_ZP "2.0.1(ZP)" //1.0转盘 #define VERSION_GK "2.0.1(GK)" //1.0高空

  1. 适配CBD_V2.0 控制板
  2. IO调整: 上仓门,PC4变为PC6 加热电流采集:PC4

2024-09-29 更新说明

#define VERSION_HK "1.54.41(HK)" //4.0海康-1200W #define VERSION_HK_2000W "1.53.40(2000W)" //4.0水稻 #define VERSION_ZP "1.46.1(ZP)" //1.0转盘 #define VERSION_GK "1.42.1(GK)" //1.0高空

  1. 增加一键自检功能及故障上报功能

2024-09-07 更新说明

#define VERSION_HK "1.53.41(HK)" //4.0海康-1200W #define VERSION_HK_2000W "1.52.40(2000W)" //4.0水稻 #define VERSION_ZP "1.45.1(ZP)" //1.0转盘 #define VERSION_GK "1.41.1(GK)" //1.0高空

  1. 增加相机调试
  2. 修复接入高空屏幕设置版本还是1.0的问题;

2024-07-10 更新说明

  1. 取消模拟RTC
  2. 增加相机状态发送到显示屏
  3. 欠压值22.0V,消抖10S,解除大于24.0V

    2024-06-19 更新说明 版本变更为:1.50.40(2000W)

  4. 增加485采集太阳能板电压;

  5. 增加重置RTU参数;

  6. 接虫模式实现方式调整,0-排虫,1收虫, 初始化过程执行

    2024-06-13 更新说明

  7. 增加北大荒设备编码录入功能,版本变更为:1.49.40(2000W)

    2024-05-20 更新说明

  8. 欠压检测消抖,10s

  9. 欠压保护电压设置为22V

    2024-03-21 更新说明

  10. 取消1.0开机初始化转仓;版本变更为1.44.1

    2024-1-25 更新说明

  11. 测报灯加热上传温度问题,上传最高温度

  12. 同步时间;

    2024-1-09 更新说明

    #define VERSION_BZY "2.6.A" //孢子仪

  13. 主版本号由2.6变更为2.6.A,设备类型版本:vtype 为1: 2.6为转盘结构版本,依次递增.A为胶带结构第一版本,依次递增 为实现新旧结构兼容,通过vtype变量判断运行逻辑; vtype通过屏幕更新(hmi.c)上传字段 增加vtype字段上传用于平台区分设备类型屏蔽不相关显示;

  14. 硬件结构更新由转盘更改为胶带,涉及工作流程变更: ①取消转盘功能、培养功能,涉及到具体的控制:转盘,涂凡士林,加热,制冷,滴葡萄糖 ②工作流程由收集,培养,拍照 改为 收集(打开风机),采集完成(关闭风机),推杆电机压住胶带,胶带运行到镜头下方,拍照;

2023-9-01 更新说明

#define VERSION_HK "1.50.41(HK)" //4.0海康-1200W #define VERSION_HK_2000W "1.47.4(2000W)" //4.0水稻 #define VERSION_ZP "1.42.1(ZP)" //1.0转盘 #define VERSION_GK "1.40.1(GK)" //1.0高空 #define VERSION_BZY "2.6" //孢子仪

  1. 修复json下发孢子仪多段定时错误问题;

2023-6-20 更新说明

#define VERSION_HK "1.49.41(HK)" //4.0海康-1200W #define VERSION_HK_2000W "1.46.4(2000W)" //4.0水稻 #define VERSION_ZP "1.41.1(ZP)" //1.0转盘 #define VERSION_GK "1.39.1(GK)" //1.0高空

  1. 修复概率性刷完程序屏幕登录密码无效的问题,将屏幕的密码写死为8888
  2. 备用电源功能完善,检测到外部断电后给RTU和路由器断电,外部电源恢复后路由器和RTU电源恢复
  3. 震动电机,上下仓门电机,清扫电机,相机,灯管增加电流检测上报;
  4. 触发雨控和温控立即上报最新数据(立即刷新定时上报时间);

    2023-5-10 更新说明

    #define VERSION_XCT "1.13.6(HK)" //吸虫塔-海康

  5. 拍照之后传送带转两次

    2023-4-6 更新说明:

    define VERSION_HK "1.(3ledv5).41(HK)" //4.0海康-三色光源

  6. 1.光控定时支持3的倍数设置,默认3小时

    2023-3-18 更新说明:

  7. 1.吸虫塔增加清扫功能;

    2023-1-07 更新说明:

  8. 1.优化电流芯片损坏时 平台显示和灯管状态显示异常问题;

    2022-11-19 更新说明:

    define VERSION_BZY "2.0"

  9. 1.适配孢子仪控制逻辑; vtype = ?

    2022-11-18 更新说明:

  10. 1.修复内存溢出问题,不能在json处理函数中退出,会导致cJSON_Delete函数未被执行,内存无法释放;

    2022-11-06更新说明:

    define VERSION_HK "1.47.41(HK)" //4.0海康-

    define VERSION_HK_2000W "1.44.4(2000W)" //4.0水稻

    define VERSION_ZP "1.39.1(ZP)" //1.0转盘

  11. 1.温湿度

  12. 2.恒温加热

    2022-09-07更新说明:

    #define VERSION_HK "1.46.41(HK)" //4.0海康-

    define VERSION_HK_2000W "1.43.4(2000W)" //4.0水稻

  13. 1.修复系统设置保存后导致时间设置失败问题,原因是重复使用数组未清零;

2022-07-15更新说明:

  • 1.调整雨控检测方式由脉冲改为ADC

    2022-06-24更细说明:

    #define VERSION_HK "1.45.41(HK)" //4.0海康-

    define VERSION_HK_2000W "1.42.4(2000W)" //4.0水稻

    #define VERSION_ZP "1.39.1(ZP)" //1.0转盘

  • 1.增加预警保存与查询功能;

2022-05-06更新说明:

#define VERSION_HK "1.44.41(HK)" //4.0海康-

define VERSION_HK_2000W "1.41.4(2000W)" //4.0水稻

  • 1.增加平台切换功能: 交互逻辑:屏幕 > stm32 <> RTU

    2022-04-22更新说明:

    #define VERSION_HK "1.43.41(HK)" //4.0海康-

    #define VERSION_HK_2000W "1.40.4(2000W)" //4.0水稻

  • 1.使能温湿度传感器-485

  • 2.修复温控逻辑不能触发

    2022-04-12更新说明:

    #define VERSION_HK "1.42.41(HK)" //4.0海康

  • 1.解决偶发出现屏幕温湿度不显示: 屏蔽sht30模拟i2c程序 过滤异常数据,将温湿度数据保存到flash中(本次获取的与现存的不一致在进行保存)

  • 2.解决偶发出现清扫后上仓门不打开: 取消上下仓仓门电流异常检测; 优化工作流程,加热完成后关闭下仓门的同时打开上仓门;

  • 3.解决偶发出现屏幕时间设置不成功:调整屏幕交互线程的优先级,24修改为5;

    2022-03-14更新说明:

    #define VERSION_HK "1.41.41(HK)" //4.0海康

  • 1.修复:电流检测芯片损坏导致上下仓门触发过流保护,无法动作;

  • 2.光控增加超时

    2022-03-11更新说明:

    #define VERSION_XCT "1.6.6(HK)" //吸虫塔-海康

  • 1.修复非工作不关闭风机

  • 2.修改最大上传时间为120分钟

    2022-03-03更新说明:

    #define VERSION_HK "1.(3ledv2).41(HK)" //4.0海康 #else #define VERSION_HK "1.40.41(HK)" //4.0海康

  • 1.修复光控工作触发保护不关灯

  • 2.使用模拟RTC

2022-02-28更新说明:

  • 恒温加热触发欠压增加消抖;

2022-02-25版本更新说明

#define VERSION_HK          "1.(3ledv1).41(HK)"     //4.0海康-3LED
#define VERSION_HK          "1.38.41(HK)"           //4.0海康
#define VERSION_HK_2000W    "1.38.4(2000W)"         //4.0水稻
#define VERSION_ZP          "1.38.1(ZP)"            //1.0转盘
#define VERSION_GK          "1.38.1(GK)"            //1.0高空
#define VERSION_XCT         "1.5.6(HK)"            //吸虫塔-海康
#define VERSION_V5          "1.2.5(HK)"
- 关闭温湿度TTL/485获取;

2022-02-17版本更新说明

#define VERSION_HK          "1.(3ledv0).41(HK)"     //4.0海康-3LED
#define VERSION_HK          "1.37.41(HK)"           //4.0海康
#define VERSION_HK_2000W    "1.37.4(2000W)"         //4.0水稻
#define VERSION_ZP          "1.37.1(ZP)"            //1.0转盘
#define VERSION_GK          "1.37.1(GK)"            //1.0高空
#define VERSION_XCT         "1.4.6(HK)"            //吸虫塔-海康
#define VERSION_V5          "1.1.5(HK)"
  • 关于屏幕信号显示的优化更新: 屏幕交互增加两个字段,csq和net整型

    2022-01-18版本更新说明

    #define VERSION_HK "1.(3-0).41(HK)" //4.0海康

  • 李新4.0定制软件:
    3种灯管,每种灯管轮流工作;

2021-12-24版本更新说明

#define VERSION_HK "1.36.41(HK)" //4.0海康 #define VERSION_HK_2000W "1.36.4(2000W)" //4.0水稻

  • 新增加线程用于清扫任务的执行;

2021-12-23版本更新说明:

#define VERSION_HK "1.35.41(HK)" //4.0海康 #define VERSION_HK_2000W "1.35.4(2000W)" //4.0水稻

  • 增加重置指令,解决屏幕密码配置丢失 {"cmd": "reset"}

    2021-12-22版本更新说明:

    #define VERSION_HK "1.33.41(HK)" //4.0海康 #define VERSION_HK_2000W "1.33.4(2000W)" //4.0水稻

  • 推杆电机的清扫时间350>400 #define VERSION_HK "1.34.41(HK)" //4.0海康 #define VERSION_HK_2000W "1.34.4(2000W)" //4.0水稻

  • 优化仓门的电流检测

    2021-11-23版本更新说明:

    #define VERSION_HK "1.32.41(HK)" //4.0海康 #define VERSION_HK_2000W "1.32.4(2000W)" //4.0水稻 #define VERSION_ZP "1.32.1(ZP)" //1.0转盘 #define VERSION_GK "1.30.1(GK)" //1.0高空 #define VERSION_XCT "1.32.6(HK)" //吸虫塔-海康 #define VERSION_V5 "1.29.5(HK)" #define CompileTime "20211123" //编译时间,每次更新代码修改

  • 减少雨控之后触发仓门关闭的时间

    2021-11-19版本更新说明:

  • 修复开启编译优化读写外部flash出错:fal_flash_sfud_port.c先初始化内部flash再进行spi的初始化

    2021-11-03版本更新说明:

    #define VERSION_HK "1.31.41(HK)" //4.0海康 #define VERSION_HK_2000W "1.31.4(2000W)" //4.0水稻

  • 增加接收平台设置温湿度功能;

    2021-11-01版本更新说明:

    #define VERSION_HK "1.31.41(HK)" //4.0海康 #define VERSION_HK_2000W "1.31.4(2000W)" //4.0水稻

  • 清扫使用PWM,占空比75%,进一步降低清扫的故障;

    2021-10-29版本更新说明:

    #define VERSION_HK "1.30.41(HK)" //4.0海康 #define VERSION_HK_2000W "1.30.4(2000W)" //4.0水稻 #define VERSION_ZP "1.30.1(ZP)" //1.0转盘

  • 1.0转仓电机驱动使用PWM

  • 修复ICCID上传错误

  • 上下仓门电机检测电流500改为1100

    2021-10-28版本更新说明:

  • 软件上检测到 异常之后启动重启倒计时任务,重启之后不能恢复则切换光控,光控计时不依赖RTC;

20211018:+

#define VERSION_HK "1.28.41(HK)" //4.0海康 #define VERSION_HK_2000W "1.28.4(2000W)" //4.0水稻 #define VERSION_ZP "1.28.1(ZP)" //1.0转盘 #define VERSION_GK "1.28.1(GK)" //1.0高空 #define VERSION_XCT "1.31.6(HK)" //吸虫塔-海康 #define VERSION_V5 "1.28.5(HK)" #define CompileTime "20211018" //编译时间,每次更新代码修改

更新说明

  • 修复经纬度为空的情况
  • 定时重启修改为6点20 #define VERSION_HK "1.28.41(HK)" //4.0海康 #define VERSION_HK_2000W "1.28.4(2000W)" //4.0水稻 #define VERSION_ZP "1.28.1(ZP)" //1.0转盘 #define VERSION_GK "1.28.1(GK)" //1.0高空 #define VERSION_XCT "1.31.6(HK)" //吸虫塔-海康 #define VERSION_V5 "1.28.5(HK)" #define CompileTime "20211012" //编译时间,每次更新代码修改

    更新说明

  • 联网成功的第一条经纬度和ICCID保存值Flash,如果联网模块重启获取经纬度失败,则从Flash种读取上传。

#define VERSION_V5 "1.27.5(HK)" //测报灯5.0-海康 #define CompileTime "20210930"

更新说明

  • 增加兼容5.0测报灯的代码 #define VERSION_XCT "1.30.6(HK)" //吸虫塔-海康 #define CompileTime "20210929"
  • 上传温湿度字段为空调整
  • 增加工作状态字段 #define VERSION_XCT "1.30.6(HK)" //吸虫塔-海康 #define CompileTime "20210928"
  • 增加时间段控制工作开关,默认全天工作
  • 上传下发字段增加开始结束时间 #define VERSION_XCT "1.29.6(HK)" //吸虫塔-海康 #define CompileTime "20210927"
  • 拍照前增加震动
  • 增加吸附电机控制
  • 屏幕震动时间设置优化
  • 下发设置的震动时长最大限制改为1000

    2021-09-24-版本:

    #define VERSION_HK "1.28.41(HK)" //4.0海康 #define VERSION_HK_2000W "1.28.4(2000W)" //4.0水稻 #define VERSION_ZP "1.27.1(ZP)" //1.0转盘 #define VERSION_GK "1.27.1(GK)" //1.0高空 #define VERSION_XCT "1.28.6(HK)" //吸虫塔-海康 #define CompileTime "20210926"

  • 修复吸虫塔开机初始化

  • 修复吸虫塔屏幕清扫

  • 海康相机的触发拍照补光时间改为15s

    2021-09-24-版本:

    #define VERSION_HK "1.28.41(HK)" //4.0海康 #define VERSION_HK_2000W "1.28.4(2000W)" //4.0水稻 #define VERSION_ZP "1.27.1(ZP)" //1.0转盘 #define VERSION_GK "1.27.1(GK)" //1.0高空 #define VERSION_XCT "1.27.6(HK)" //吸虫塔-海康 #define CompileTime "20210924"

  • 水稻清扫取消限位检测预警的上传

  • 增加打开关闭上下仓门的异常检测,上报预警信息.(如果打开仓门1S后检测不到电流增大,则判定为异常)

  • 取消freemodbus线程

    2021-09-24-版本:

    #define VERSION_HK "1.27.41(HK)" //4.0海康 #define VERSION_HK_2000W "1.27.4(2000W)" //4.0水稻 #define VERSION_ZP "1.27.1(ZP)" //1.0转盘 #define VERSION_GK "1.27.1(GK)" //1.0高空 #define VERSION_XCT "1.27.6(HK)" //吸虫塔-海康 #define CompileTime "20210924"

  • 修复版本号与版本类型匹配上传的问题

  • 远程修改版本类型

    {"cmd": "paramconf", "ext": {"vt": "4"}}

    2021-09-23-版本:

    #define VERSION_HK "1.27.41(HK)" //4.0海康 #define VERSION_HK_2000W "1.27.4(2000W)" //4.0水稻 #define VERSION_ZP "1.27.1(ZP)" //1.0转盘 #define VERSION_GK "1.27.1(GK)" //1.0高空 #define VERSION_XCT "1.27.6(HK)" //吸虫塔-海康 #define CompileTime "20210923"

  • 增加对吸虫塔的兼容;

  • 关于各版本兼容的适配;

  • 屏幕切换版本和下发设置版本;

  • !!!对旧版本的兼容;

  • 取消开机3分钟联网超时切换光控保存

2021-09-22-版本:

define VERSION_HK "1.26.41(HK)"         //版本
define VERSION_ZP "1.26.1(ZP)"         //版本
CompileTime "20210922"
  • 针对水稻测报灯增加字段的修改; vtype: 1-(1.0转盘) 11-(1.0高空) 4-(4.0水稻) 5-(5.0测报灯) 6-(吸虫塔)

2021-09-18-版本:

define VERSION_HK "1.26.41(HK)"         //版本
define VERSION_ZP "1.26.1(ZP)"         //版本
CompileTime "20210918"
  • 屏幕增加远程升级按钮的修改;

    2021-09-17-版本:

    define VERSION_HK "1.26.41(HK)" //版本 define VERSION_ZP "1.26.1(ZP)" //版本 CompileTime "20210914"

  • 修复屏幕加热温度显示为0;

  • 屏幕增加立即上传数据按钮

    2021-09-14-版本:

    define VERSION_HK "1.26.41(HK)" //版本 define VERSION_ZP "1.26.1(ZP)" //版本 CompileTime "20210914"

  • 修复加热时间和实时加热时间变量冲突问题;

    2021-09-13-版本:

    define VERSION_HK "1.25.41(HK)" //版本 define VERSION_ZP "1.25.1(ZP)" //版本 CompileTime "20210913"

  • 针对加热温度平台展示的修改: 恒温加热函数:加热开始时上传,加热到设定温度时上传,加热每到两分钟时上传。

    2021-07-28-版本:

    define VERSION_HK "1.25.41(HK)" //版本 define VERSION_ZP "1.25.1(ZP)" //版本 CompileTime "20210716"

  • 修复新板子刷完程序后因判断升级的字段未初始化导致直接从flash读出来的数值与判断的不一致引起的工作线程未执行.

    2021-07-16-版本:

    define VERSION_HK "1.24.41(HK)" //版本 define VERSION_ZP "1.24.1(ZP)" //版本 define CompileTime "20210716"

  • 停止上下仓门使用刹车功能.

  • 下仓门打开到关闭的间隔由1S改为3S.

  • 屏幕操作上下仓门时先执行关闭电机输出,电机停转时增加1S延时,目的是保护电机驱动防止频繁正反转损坏电机驱动。

    2021-07-13-版本:

    define VERSION_HK "1.24.41(HK)" //版本 define VERSION_ZP "1.24.1(ZP)" //版本 define CompileTime "20210713"

  • 针对PCB改动的清扫修改,推杆清扫的时间增加10S: ctr_TG_Clear(250); ctr_TG_Clear(350);

    版本说明

    #define VERSION_HK "1.1.4-(HK)" //版本 #define VERSION_ZP "1.1.1-(ZP)" //版本

  • 数据字段的修改 datt > dat_f turnon > rcnt 2021-03-16: Flash16m改为4m 分区表调整: #define FAL_PART_TABLE \ { \ {FAL_PART_MAGIC_WORD, "bl", "onchip_flash", 0, 200*1024, 0}, \ {FAL_PART_MAGIC_WORD, "app", "onchip_flash", 200*1024, 312*1024, 0}, \ {FAL_PART_MAGIC_WORD, "easyflash", FAL_USING_NOR_FLASH_DEV_NAME, 0, 3*1024*1024, 0}, \ {FAL_PART_MAGIC_WORD, "fm_area", FAL_USING_NOR_FLASH_DEV_NAME, 3*1024*1024, 512*1024, 0}, \ {FAL_PART_MAGIC_WORD, "df_area", FAL_USING_NOR_FLASH_DEV_NAME, 3*1024*1024 + 512*1024, 512*1024, 0}, \ }

    2021-03-17:

    屏幕增加水稻2000万像素的串口拍照指令(给RTU发): {"cmd":"ctrl","ext":{"takephoto":"2"}}

    2021-03-18:

  • 修复路由器接口供电的BUG. 路由器供电会在上电初始化中打开,如果电压跌落至12V以下则不会再打开.

  • 注意:如果切换至备用电源,远程拍照将无法上传,在进入工作流程时/解除欠压保护时会再次打开.

  • 远程升级ymodem: void ymodem_ota(uint8_t argc, char **argv) { rt_console_set_device("uart2"); //缺少这句话!!! }

    2021-03-19-版本:1.1.41(HK)

  • 最新2000万像素测报灯结构修改,清扫电机改为推杆电机.

  • 拍照增加发送 {"cmd":"takephoto"}

  • 增加补光时间60s

    2021-03-20-版本:1.2.41(HK)

  • 清扫-一个流程时间20s

  • 流程

  • 温湿度

    2021-03-22-版本:1.3.41(HK)

  • 修复灯管状态显示问题: 标志位未清零

  • 温湿度屏幕不显示:优先级调整

    2021-03-23-版本:1.4.41(HK)

  • 修复开机操作屏幕启动异常,解决办法: 使用INIT_BOARD_EXPORT(fn)初始化屏幕串口,非常早期的初始化,此时调度器还未启动

    2021-03-24-版本:1.5.41(HK)

  • 工作过程触发雨控流程优化,触发雨控关闭上下仓门,灯管,加热带,响应时间1s.

    2021-03-25-版本:1.5.41(HK)

  • HMI_THREAD_PRIORITY 26>24 //线程优先级

    2021-03-26-版本:1.5.41(HK)

  • 屏幕串口4波特率修改,9600>115200

    2021-04-02-版本:1.5.41(HK)

  • 定时重启增加关闭DTU供电,开机初始化打开供电

  • 增加远程断电: {"ext": {"type": "rtu_off_on"}, "cmd": "ctrl"}

    2021-04-06-版本:1.6.41(HK)

  • 数据参数设置模块: 增加开始时间和结束时间整形数值的解析.

    2021-04-07-版本:1.6.41(HK)

  • 屏幕参数设置本部分修改.

    2021-04-08-版本:1.8.41(HK)

    ###版本更新:

  • 1.apm32在flash操作,解锁前需要手动关闭中断,上锁后手动打开中断,这一点在差异文件内没写。 对应文件:drv_flash_f1.c

    __disable_irq();

    __enable_irq();

  • 2.board.c时钟初始化: PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_RTC|RCC_PERIPHCLK_ADC; PeriphClkInit.RTCClockSelection = RCC_RTCCLKSOURCE_LSE; PeriphClkInit.AdcClockSelection = RCC_ADCPCLK2_DIV6; if (HAL_RCCEx_PeriphCLKConfig(&PeriphClkInit) != HAL_OK) { Error_Handler(); }

  • 3.DTU串口协议优化: {"cmd": "GetInfo"}>>>>={"uart": "getinfo"} 同步消息: csq->valueint-----csq->valuestring net->valueint-----net->valuestring sim->valueint-----sim->valuestring

    2021-04-09-版本:1.9.41(HK)

  • 数据上传下发字段改为字符串

    2021-04-12-版本:1.9.41(HK)

  • 开机上传数据时间改为60s static int num_updata = 0; static int num_updata = 60;

    2021-04-14-版本:1.10.41(HK)

  • 屏幕刷新联网状态和CSQ,SIM卡信息等增加超时,30s

  • 开机判断时间增加等待RTU联网成功,超时3分钟,超时切换光控

    2021-04-25-版本:1.11.41(HK)

  • 修复开机上电的第一条数据灯管状态为异常; 原因:已经进入工作状态但是灯管还未启动.

  • 修复485温湿度

    2021-05-13-版本:1.11.41(HK)

  • 光控测试优化

    2021-05-14-版本:1.12.41(HK)

  • 数据上传优化

    2021-05-20-版本:1.12.41(HK)

  • 屏幕增加版本切换

  • 增加RTC时间设置

    2021-05-24-版本:1.13.41(HK)

  • 数据定时上传优化

#define VERSION_HK "1.14.41(HK)" //版本 #define VERSION_ZP "1.14.1(ZP)" //版本 #define CompileTime "20210525"

更新说明

  • 删减代码,缩小固件大小,固件为243kb会导致固件搬运报错. text data bss dec hex filename 240020 2584 16488 259092 3f414 rtthread.elf Used Size(B) Used Size(KB) Flash: 242604 B 236.92 KB RAM: 19072 B 18.62 KB

======= #define VERSION_HK "1.16.41(HK)" //版本 #define VERSION_ZP "1.16.1(ZP)" //版本 #define CompileTime "20210527"

  • 1.修复恢复出厂设置震动状态和关机状态被关闭
  • 2.时控模式下测试光控测试灯管
  • 3.出发雨控立即关灯 ============================================================================ [2021-05-27 16:54:35.338] [I]-[testHttp.cbFncFile] true 200 rtthread.rbl [2021-05-27 16:54:35.338] [I]-[audio.play] 30 FILE /lua/fdsuccess.mp3 nil nil nil nil [2021-05-27 16:54:35.338] [I]-[testHttp.cbFncFile] Connection: close [2021-05-27 16:54:35.364] [I]-[testHttp.cbFncFile] Content-Type: application/octet-stream [2021-05-27 16:54:35.376] [I]-[testHttp.cbFncFile] Date: Thu, 27 May 2021 08:54:35 GMT [2021-05-27 16:54:35.376] [I]-[testHttp.cbFncFile] Accept-Ranges: bytes [2021-05-27 16:54:35.376] [I]-[testHttp.cbFncFile] content_Length: 160064 [2021-05-27 16:54:35.376] [I]-[testHttp.cbFncFile] Server: nginx/1.13.10 [2021-05-27 16:54:35.376] [I]-[testHttp.cbFncFile] fileSize=160064 [2021-05-27 16:54:35.376] [W]-[update file size:] 160064 [2021-05-27 16:54:35.376] [W]-[free system filesize:] 1154500 [2021-05-27 16:54:35.376] [I]-[socket:sock_close] 1 ========================================================================== [2021-05-27 16:47:15.885] [I]-[testHttp.cbFncFile] true 200 rtthread.rbl [2021-05-27 16:47:15.885] [I]-[audio.play] 30 FILE /lua/fdsuccess.mp3 nil nil nil nil [2021-05-27 16:47:15.885] [I]-[testHttp.cbFncFile] Connection: close [2021-05-27 16:47:15.885] [I]-[testHttp.cbFncFile] Content-Type: application/octet-stream [2021-05-27 16:47:15.885] [I]-[testHttp.cbFncFile] Date: Thu, 27 May 2021 08:47:15 GMT [2021-05-27 16:47:15.885] [I]-[testHttp.cbFncFile] Accept-Ranges: bytes [2021-05-27 16:47:15.885] [I]-[testHttp.cbFncFile] content_Length: 160064 [2021-05-27 16:47:15.885] [I]-[testHttp.cbFncFile] Server: nginx/1.13.10 [2021-05-27 16:47:15.885] [I]-[testHttp.cbFncFile] fileSize=800336 [2021-05-27 16:47:15.885] [W]-[update file size:] 800336 [2021-05-27 16:47:15.885] [W]-[free system filesize:] 507000

#define VERSION_HK "1.17.41(HK)" //版本 #define VERSION_ZP "1.17.1(ZP)" //版本 #define CompileTime "20210602"

更新说明

  • 1.0转盘增加延时消抖 #define VERSION_HK "1.18.41(HK)" //版本 #define VERSION_ZP "1.18.1(ZP)" //版本 #define CompileTime "20210605"

    更新说明

  • 1.开启编译优化

  • 2.清扫外接模块 #define VERSION_HK "1.19.41(HK)" //版本 #define VERSION_ZP "1.19.1(ZP)" //版本 #define CompileTime "20210611"

    更新说明

  • 1.开机光控优化 开机未检测光照的等待时间200s改为320s #define VERSION_HK "1.20.41(HK)" //版本 #define VERSION_ZP "1.20.1(ZP)" //版本 #define CompileTime "20210617"

  • 1.时控工作时下发参数设置导致工作流程异常 原因是数据解析中版本vt字段判断问题导致 #define VERSION_HK "1.21.41(HK)" //版本 #define VERSION_ZP "1.21.1(ZP)" //版本 #define CompileTime "20210618"

  • 1.电机停止刹车 https://item.szlcsc.com/114902.html 插件电阻 > 1Ω(1R00) ±1%
    https://item.szlcsc.com/754502.html 100欧姆插件电阻,金属膜,功率3W https://item.szlcsc.com/245499.html 直插瓷片电容 > 470pF ±10% 500V #define VERSION_HK "1.22.41(HK)" //版本 #define VERSION_ZP "1.22.1(ZP)" //版本 #define CompileTime "20210621"

  • 1.清扫完毕震动 #define VERSION_HK "1.23.41(HK)" //版本 #define VERSION_ZP "1.23.1(ZP)" //版本 #define CompileTime "20210701"

  • 修复定时重启12V电源未断开的问题。

  • 针对FLASH硬件失效的修改:

    改动位置packages中的fal包fal_def.h

    #define assert(EXPR) \ if (!(EXPR)) \ { \ FAL_PRINTF("(%s) bootloader fal_def.h has assert failed at %s.\n", #EXPR, FUNCTION); \ while(1);

    }

    #define assert(EXPR) \ if (!(EXPR)) \ { \ FAL_PRINTF("(%s) bootloader fal_def.h has assert failed at %s.\n", #EXPR, FUNCTION); \ return 1; \ } #define CompileTime "20210701"

  • 路由器增加24V供电的接口。

  • 修复RTU接网线CSQ为0导致的屏幕联网状态显示不正确问题。