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/log/ — 日志子系统
两类日志：持久化运行日志（
sys_log，落 NAND）与控制台日志（console_log，走串口）。 两者都遵循单写者模型，避免多任务交错输出。
文件一览
| 文件 | 作用 |
|---|---|
sys_log.h |
日志接口（平台无关）：定长 64B 记录写入 /log/run.log·selftest.log |
sys_log_mcu.c |
sys_log 的 MCU 端后端实现（NAND + FatFs） |
console_log.c/h |
控制台单写者日志：多任务日志经队列汇入唯一写者，避免串口输出交错 |
关键机制
syslog（运行/自检记录）
- 唯一写者 = defaultTask；其它任务只投递，不直接写盘
- 单记录定长 64 B，循环写；待机页可显示记录
- 内核启动前的日志走无锁静态缓冲
s_preboot[8]暂存（因为内核启动前不能建队列）， 内核启动后由syslog_drain惰性创建真队列并排空 - ⚠️ 写盘必须校验
f_write返回的字节数（该 FatFs 移植在簇分配失败时返回FR_OK+ 短写， 不报错误码）；追加写必须FA_WRITE|FA_OPEN_APPEND（FA_OPEN_APPEND单独用不含写位）
console_log（控制台单写者）
- 多任务的生产者 → 单写者消费者，消除任务间日志行交错
- 设计详见
docs/子系统设计/控制台单写者日志设计说明.md
相关文档
docs/子系统设计/控制台单写者日志设计说明.mddocs/子系统设计/运行与自检记录设计说明.md- FatFs 陷阱：
AGENTS.md「平台约束」