Files
STM32F4-Base/App/task
wandering1 ed25fc5a4d perf(iec104): 删死仿真数组并按类型分表存变化检测基线,省 816 B RAM
104 的内存大头不在协议栈本身,而在两处「每层各留一份、且按最宽类型统一
存储」的静态数组。本次按实测逐项瘦身,行为等价有证:

一、iec104_source.c 删掉 5 个无写者的模拟注入数组(ZI -288 B)
   singles / single_set / doubles / measurements / measurement_set 的唯一
   写入点是 init() 的 memset,全仓无 setter、无导出写 API、simulator 与
   test 也无人写。故 single_set/measurement_set 恒 0 使对应 if 分支永假、
   doubles 恒 0 使 type3 分支恒返回零值+NO_SOURCE_QUALITY。
   保留 steps/bits:iec104_source_find() 用它们响应 IOA 0x1201..0x1208 与
   0x1301..0x1308,删掉会把「返回 0+品质」变成「未知地址」,属协议行为变化。
   实测 ZI 5912 -> 5624,比数组名义总和 284 多 4 B,因两处 2 字节对齐空隙
   一并消失。

二、iec104_core.c 变化检测基线按点类型分表(ZI -528 B)
   原 core_previous_t previous[105] 每点 8 字节(uint32 value + quality +
   bool,对齐补到 8),840 B。改为按点表顺序分三段:单点 u8 x59、双点
   u8 x16、测量值 u32 x30,品质按原索引逐点存,initialized 改位图 14 B。
   测量值仍按 32 位位模式比较,不是浮点比较,NaN/-0 判等语义不变。
   加两道防护:编译期断言「SP+DP+ME == 105 且段边界为 0/59/75」;启动期
   逐点校验 type_id 必须依次为 1/3/13,错序即启动失败——否则会静默把一种
   类型的值当另一种比较。校验在每次 core_start 跑 105 次,刻意不缓存成
   静态标志:重连后点表若被改坏,这一次就是唯一防线。

等价性证据(独立审查员复算,非自述):
  iec104_source_point() 225 点全表 x 回调三态 x 边界 4089 条轨迹逐字节一致;
  变化检测 133,560 次判定/读回零差异;4 个位置的变异体各自红在埋点行,
  证明这几条判据不是恒真摆设;去掉启动校验后乱序点表在主机用例里静默通过。

实测(权威构建,同一台机器前后对比):
  RW_IRAM1   118,120 -> 117,304 B(-816,90.1% -> 89.5%)
  ER_IROM1   413,416 -> 413,392 B(-24)
  iec104_source.o ZI 5912 -> 5624;iec104_core.o ZI 3192 -> 2664
  s_core 2928 -> 2400 B

顺带把 App/task/iec104_serv.c 两处写死的源码行号改为「文件路径+函数名」
锚点,重构后不会漂移。
2026-11-19 12:51:45 +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 的任务表由 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