f6e9106f0d
道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 为诊断行不计违规。
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