Files
STM32F4-Base/App/task
wandering1 fd767d1dcd feat(ioboard): 开入开出板驱动、去抖快照与主机侧单测接入
74HC165 开入 + 光耦继电器开出的完整硬件抽象层,接进 defaultTask
的 50ms 节拍。开入 8 路(第二块 165 数据线板上未接,故只有 8 位),
开出 4 路(高电平吸合)。

驱动 BSP drivers:
- IOBOARD/ioboard.c 装载与移位时序,每步注明数据手册依据;
  SH/LD 拉高前先拉低 CLK,否则装载瞬间多移一位;
  单次读取上界 26us(延时按最慢列 VCC 2V 全温区取值)。
- IOBOARD/ioboard_bits.c 位序组装纯函数,只依赖 stdint.h,
  主机侧可直接 include 做单测:读 8 次为 H,G,F,E,D,C,B,A,
  A 放 bit0(bit(7-i) = reads[i])。
- 极性集中在 IOBOARD_DO_LEVEL_ACTIVE 一处,接口语义统一为
  mask 的 1 = 吸合。

业务接线:
- App/util/ioboard_di.c 通道去抖与双区快照,纯逻辑;
  刻意不 include ioboard.h(其引脚宏会牵入 main.h),
  两处路数常量由测试的编译期静态断言钉住。
- default_task.c 的 default_task_di_poll():读失败不喂去抖、
  不写发布值,只把上一有效值加 valid=0 发布出去,
  避免"全 0"被现场读成开入全部复归。
- 去抖实际粒度 50ms(每个轮询周期喂一拍),最坏上报约 100ms;
  想要真 20ms 需另建定时器,本次不做。
- Src/main.c 在 app_main_init 之前调 ioboard_init(),
  上电即把 4 路出口钉在全释放并确认 165 静止态。

测试:
- test/host/ioboard/ 100 条断言。位序主判据为单比特两端
  (只有 A 得 0x01、只有 H 得 0x80)加八点双射穷举;
  混合图样降级为辅助,因该图样曾先后被算成 0xA5、0x5A、0xAA。
- 去抖覆盖 20ms 边界、抖动不翻、跨 49.7 天回绕。
- 失败语义覆盖"失败保留上次有效值"与"失败窗口内的真实变位不丢"。

文档:
- 新增 docs/硬件平台/开入开出实施说明.md。
- 硬件规格与能力边界 §5 的能力边界现状改写:出口继电器与
  开入回路已具备、业务层未接入;4 路开出只可台架验证,
  不得用于真实跳闸。
- 修正 docs/文档规范.md §3.1:原文要求所有互链用仓库根相对,
  与 check_doc_links.py 的实际解析基准矛盾(markdown 链接按
  当前文档目录解析,反引号路径才按仓库根)。改为区分两类,
  并补 §3.1b 写明对应校验器。
- 清理 docs/任务规划/登记簿.md 改名为硬件改版登记.md 后
  遗留的 9 处旧名引用。

门禁: keil-build 0 Error 0 Warning;主机侧单测 ioboard 100/100、
sb_proto 45/45;pre-commit 48 根钩子全通过。
2026-11-16 18:30:31 +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