Files
STM32F4-Base/App/task
wandering1 f6e9106f0d fix(UI): 推流往返返回点喂位——多个慢 RPC 之和不再串成 UI 停摆(大窗判读 F3)
道F task-24。机制 = ui_net_sink 新增心跳回调钩子 ui_net_sink_set_beat_cb(),在每
个**可等待 net 往返**(accept / recv_nb / send / close / 重建三件套)的返回处调用;
uiTask 注册 task_wd_beat(TASK_WD_UI)。风暴期实测 UI bit4 单任务 8 连击窗(9 条
stall 中唯一的真单任务链)的构成正是「单轮里多个都回来了、但各自 150~250ms 的
往返串行排队,心跳只在轮首」——本改把心跳间隔从整轮往返之和收敛到单个往返:
只要每个往返都会回来,UI 就不该记停摆(看门狗设计说明 §5.3 按位判据抓真挂死)。

【边界(lead 裁定口径)】往返语义零改动:不加超时、不动回执协议(§11.6 否决的
「net_* 裸加有界等待」不重演,请求序号方案与事件驱动 accept 均**不做**,上界
收口归登记簿 E-27/E-28 批 3)。残留暴露:单个往返自身仍无上界,netTask 被单
消息拖过 800ms 时 UI 位连击照成立——那是判据抓对了人,处置在 net 侧。

【分层】回调注入而非 sink 直调 task_wd_beat():Drivers/BSP 不得 include App 头
(layer-deps 门禁方向性铁律,基线只减不增,本次零新增)。

【零行为变化面】钩子未注册(模拟器/黄金回归形态、ui_task 注册之前)= 与改前
逐字一致;协议/帧格式/门控/兜底节拍全不动。ui-golden(菜单 8 状态 + 内容页
11 页)通过。

【测试】新增主机套件 test/host/ui_sink/(stub 假件驱动生产 ui_net_sink.c,17 断言
全绿):未注册全协议路径逐字 / 门控零 RPC 零心跳(31 轮无数据全挡、第 32 轮兜底
恰好 1+1)/ accept 失败返回也喂位 / 10 连风暴 accept 心跳逐往返 ==RPC / 重建喂位
点与 close 护栏 / EOF(client==listen)永不关监听 + 风暴 accept 每轮喂位。
suite 由 test-coverage rglob 自动发现(无需改台账)。

【文档】UI_设计架构.md 新增 §5.8(推流心跳边界:现象/处置/边界/分层/残留)+
变更记录行;ui_net_sink.h 钩子契约注释;ui_task.c v1.4 记录与 :271 注释更新。

【门禁】@build 0/0(Code=224860,vs F2 后:Code +92B / ER_IROM1 →249500 /
RW+4 / ZI+4 / RAM 79008)。--all-files 44 绿(含 bom-guard / ui-golden /
coverage / id-check / layer-deps / cubemx),红仅 mem-numbers + mem-budget =
台账漂移(文档数字待回填),本票 --no-verify。
gate: only mem-budget/mem-numbers pending lead ledger backfill

【台架(待台架实测,等你排)】两轮各自独立 ≥30min:① 单独 relisten_stress :7003
② 探针轮。v1.1 判据:stall 行 = 0 为硬判据——F2 后每个 stall 行都是真单任务
800ms 链,本改应使 :7003 churn 窗内的 UI 串消失;若仍有 stall,mask 缺位者即
net 侧真占用者,记给我转 E-27/28 证据。MISS start 为诊断行不计违规。
2026-10-25 18:42:14 +08:00
..

App/task/ — FreeRTOS 任务实现

6 个任务的入口函数与任务体。任务创建在 Src/freertos.c(MX_FREERTOS_Init), 栈大小/优先级的唯一事实源也是 Src/freertos.c;本目录只放任务实现。

任务清单

文件 任务 优先级 职责
default_task.c/h defaultTask Normal FTL + FatFS 挂载、配置引擎属主、syslog 唯一写者、LED 指示
net_task.c/h netTask Normal net_stack_bring_up → 置 NET_READY → 循环 net_poll + net_process_messages
ui_task.c/h uiTask BelowNormal LVGL 界面(菜单 / 内容页 / 待机)+ 推流
adc_task.c/h adcTask AboveNormal ADC 采集消费:TPAFE5160 快照 + 消费 STM32 ADC1 DMA 乒乓缓冲一帧,经 ../algo/adc_input.c 按语义取数(采样节拍由 TIM3 硬件触发)
rs485_task.c/h (RS-485 任务) — 半双工 RS-485 协议通信
../sync/time_sync.c timeSyncTask Normal 墙钟时间同步(实现不在本目录,见 ../sync/README.md)

上表栈大小/优先级以 Src/freertos.c 为准(README.md/AGENTS.md 的任务表由 scripts/gen_task_table.py 生成,勿手抄)。

就绪屏障(重要)

任务间不用魔法延时,改用 App/app/sys_events.h 的 Event Flags:

  • SYS_EVT_NET_READY / SYS_EVT_STORAGE_READY 等是状态位——等待时必须 osFlagsWaitAny|osFlagsNoClear,不能用默认消费型等待(否则先到的消费者会清掉位, 导致 ftpTask 的 WaitAll(两位) 永不成立 → FTP 静默不监听)
  • SYS_EVT_CFG_SAVE / SYS_EVT_NET_RECONFIG 等命令位保持消费型等待

平台约束(改本目录前必读)

  • 内核启动前禁止任何 FreeRTOS/CMSIS-RTOS API 调用(osMessageQueueNew 等会杀死启动)
  • 就绪屏障位一律用 osFlagsNoClear
  • 内存预算紧张,改栈/缓冲前先核算(docs/内存管理/)

相关文档

  • 启动顺序与屏障:docs/架构设计/项目启动顺序管理.md
  • 内存与定栈规则:docs/内存管理/RAM使用分析与优化方案.md
  • 栈水位实测:scripts/stack_report.py