Files
STM32F4-Base/App/util
wandering1 90cc9a7d99 feat(iec104): 把 104 骨架完整迁到 MCU 板端并在台架跑通总召
把 IEC104 从模拟器端整体搬到板端:协议栈原先由独立 iec104Task 驱动,
现在改为 netTask 单 owner 的 threadless 驱动,退役独立任务。

驱动与后端:
- 新增 iec104_net_mcu.c/.h,实现 IEC104_Net.h 的 11 个 ABI 函数,
  用槽表加单调句柄映射 net_socket 的单 fd 模型;CLIENT 拆除只走
  net_drop_conn_locked,绝不 net_close 监听 fd。
- net_socket 增 5 个 owner-only 接口(net_accept_locked、
  net_drop_conn_locked、net_pending_bytes、net_send_try、
  net_mono_now_ms)。
- iec104_serv.c 重写为 iec104_serv_net_tick(),在 netTask 1ms 主循环
  里驱动 core;无 osDelay/阻塞调用,喂狗是第一句。
- Src/freertos.c 删除 iec104Task 三件套,对应栈水位探针表项同步删除。

内存:目标板 192KB SRAM 装不下 vendor 默认容量档,按实测裁剪到
skeleton 档(TCP 缓冲、业务池、SOE 256->128、值槽密集化),
RW_IRAM1 118,408 B / 90.3%,留 2,178 B 余量。

台架修复(只在真硬件暴露):
- SNTP s_ctx.fd 零初始化后为 0,而 net fd 0 是合法槽位下标,
  首次代次变化时误 net_close(0) 关掉 ftpTask 的监听槽,导致 104
  连接被 FTP 的 220 banner 抢走;改为显式 .fd = -1。
- Accept 幂等:单 fd 模型下 vendor 每轮重试 Accept 会拿到同一 fd,
  后端改为会话在役时返 WOULD_BLOCK,Close 不再清槽。

验证:
- Keil 全量重建 0 error 0 warning,uvprojx 零抖动。
- 模拟器真实 TCP 13/13、transport 10/10。
- netmcu 后端单测 13/13(新增 N12)。
- 台架 serial-boot-test required 全中;板端 2404 总召 129 帧收到
  59 遥信(53 有源、全 IV)+ 16 双点 + 30 遥测(PT1 三相非零、
  UN/频率/温度按未标定置 IV)、遥控选择执行全否定、校时 COT 7。
- 期间顺带修正 UI 漂移自检文案、.serialtest required 陈旧项、
  coding-standard 对 vendor 与外部 ABI 名字的排除口径。
2026-11-18 10:29:18 +08:00
..

App/util/ — 通用工具函数

平台无关的纯工具模块(无 FreeRTOS 依赖、无硬件依赖),可在 MCU 与 PC 模拟器中共用。

文件一览

文件 作用
sys_clock.c/h 墙钟时间管理:RTC 基准、tick 回绕防护、每 30 天惰性再基准化
task_watchdog.c/h 独立看门狗(IWDG)判定状态机:任务心跳位图 + defaultTask 单一喂狗者

已删除(2026-10-02):crc.c/h(CRC-16 Modbus / CRC-8)与 ringbuf.c/h(SPSC 环形缓冲) 两模块零调用者且未编入任何构建——CRC 从未被链接使用:名义上的关联点 net_cfg_legacy.c (旧档迁移,该文件亦已于 2026-10-10 删除)自带静态 s_crc16_modbus(), 从不调用本模块;环形缓冲由 App/log/console_log.c 内联实现(s_con_ring)。 保留只会造成"有统一实现"的误导,故整体移除。

设计要点

sys_clock

  • 以 SD2506 RTC 为基准,HAL tick 计数补齐亚秒精度
  • 49.7 天 tick 回绕防护:每 30 天惰性再基准化(sys_clock_get 内部触发)
  • RTC 故障时降级到默认时间基准并返回 -1,触发"时钟芯片异常"自检上报
  • 设计详见 docs/子系统设计/系统墙钟时间维护说明.md

task_watchdog

  • 任务心跳位图:各任务只置位(task_wd_beat),校验者取走并清零(单字原子,无锁)
  • 单一喂狗者:defaultTask 每 100 ms 抽样判定,仅当位图等于必需掩码时才喂狗
  • 硬件访问收敛:IWDG 寄存器与 HAL_GetTick() 经 wd_platform_* 弱钩子访问 (声明在 task_watchdog.h 末段),MCU 端为 __weak 默认实现,主机侧单测以同名强符号覆盖 → 可在 PC 上跑纯逻辑回归
  • 设计详见 docs/子系统设计/看门狗设计说明.md;单测见 docs/测试说明/单元测试/看门狗单元测试说明.md

相关文档

  • docs/子系统设计/系统墙钟时间维护说明.md
  • docs/子系统设计/看门狗设计说明.md
  • docs/测试说明/单元测试/看门狗单元测试说明.md