wandering1
e0b02d397c
待办池 docs/待处理内容.md §3.2 的 10 个 P2 全部闭环；逐项落代码 + 注释说明。 P2-1 cfg_file: 受管键行超 CFG_LINE_TEST_MAX 拒绝保存（防重复键行） P2-2 ch395f: DMA 失败传播状态 + 锁存通道故障 + 读不拷不可信数据 P2-7 net_select: LISTENING 不再恒判可读（消除 select 忙轮询地雷） P2-8 time_sync: 核实 L3 pending 改写已闭环（net_recv_to 分片 + 总预算） P2-9 sys_log: 挂载改幂等 + 卷锁，defaultTask 2s 重试建 /log P2-10 sys_log: s_read_raw 纳入卷锁 try（读者/写者 unlink 互斥） P2-11 net_task: RECONFIG 改 osEventFlagsWait 原子取走 + 清除 P2-12 app_cfg: APP_*_ENABLE 如实标注为未接线占位，删“开关”说法 P2-13 freertos: 产品构建 vTaskDelete(testTask) 回收 8KB CCM 栈 P2-15 download.bat: 先删旧日志 + 增“未产出日志”判定 P2-13 用 USER CODE 区回收而非生成区 #if 门控：生成区改动会被 CubeMX 重生成覆盖，本方案重生成不丢。P2-12 因产品定义 B0 未定、APP_NET_ENABLE 无单一接线点，按修复建议备选（删“开关”说法）处理。 验证：@build 0 错 0 警；主机单测 watchdog 39/39 + sys_clock 100/100 + cfg_file 149/149（新增 TC-CFG-044）；pre-commit --all-files 17/17。
App/ — 应用层
自研代码（非 CubeMX 生成、非第三方库）。本目录是项目的应用层：任务编排、业务逻辑、 日志与配置引擎、工具函数。所有文件遵循
docs/代码规范/嵌入式C语言代码规范_V1.0.md。
职责
Src/main.c（CubeMX 初始化）→ app_main_init（本目录 app/app_main.c）→ osKernelStart →
6 个 FreeRTOS 任务（见 task/）。osKernelStart 之前全是内核启动前代码，禁止调用任何
FreeRTOS/CMSIS-RTOS API（见 AGENTS.md「平台约束」）。
目录结构（按职责分层）
| 目录 | 内容 | README |
|---|---|---|
app/ |
应用入口与全局：app_main.c/h（初始化入口）、app_cfg.h（编译开关）、sys_events.h（就绪事件） |
app/README.md |
cfg/ |
配置引擎：/config.ini 解析 + 持久化 + 旧档迁移 |
cfg/README.md |
sync/ |
时间同步任务：time_sync.c/h |
sync/README.md |
log/ |
日志子系统：syslog（NAND）+ 控制台单写者日志 | log/README.md |
task/ |
FreeRTOS 任务实现（6 个任务） | task/README.md |
util/ |
通用工具：CRC / 环形缓冲 / 墙钟时间 | util/README.md |
protocol/ |
通信协议（预留，当前为空） | protocol/README.md |
关键约束
- 配置引擎单任务收敛：
cfg/为静态态、属主是 defaultTask；UI 保存请求经SYS_EVT_CFG_SAVE事件唤醒，netTask/uiTask 不得直接触碰配置引擎 - syslog 唯一写者：
/log/*只由 defaultTask 写入 - 新增任务/缓冲/栈前必须先核算 RAM 余量（
docs/内存管理/）
相关文档
- 架构全景：
docs/架构设计/项目架构总览.md - 启动顺序：
docs/架构设计/项目启动顺序管理.md - 配置引擎：
docs/子系统设计/配置文件设计说明.md - 日志：
docs/子系统设计/控制台单写者日志设计说明.md、docs/子系统设计/运行与自检记录设计说明.md