wandering1
343305b433
背景：ADC 采集的软件链路已全部打通（节拍、语义取数、折算、相量、 200 ms 快照、104/UI 消费），但"读数对不对"从未验证过——卡 0 的 已知电压注入一直挂账。挂账的直接原因之一是读数出口不够用： 固件只有 cal: 行（UA/UN/IA 三路，mV）与 first: 行（9 路码值，仅 开机一次），验 8 个通道 × 3 个注入点要复位二十余次。 改动一（App/task/adc_task.c，v3.3） - 心跳新增 adc: 行，每 10 s 输出 9 路原始码值，与 first: 行同序 同格式，台架"改电压 → 读一行"即可对表，全程免复位。 - 不并入 cal: 行：9 个码值会把该行推到 168 字符，撞 DBG_CON_LINE_MAX(192) 的静默截断边界（截断不报错，只会少打几路， 是最难发现的台架假数据来源）。 - 无新增跨任务状态、无新增外设访问；栈 +36 B（局部码值数组）， adcTask 静态最坏 1400 B / 余量 1160 B（底线 1024 B），stack_report PASS；静态 RAM 不变，Flash +188 B。 改动二（新增 docs/测试说明/ADC前端注入验证流程.md） - 卡 0 的执行侧：注入点清单、期望码值表、零点/线性/映射/极性/节奏 五步、现场记录表、安全红线、已知坑。 - 固化 2026-10-27 的网表结论：逐通道追 V0.1.tel 确认 ADCn 节点上 只有"串阻 2 脚 + 滤波电容 + 转换器引脚"，没有对地分流电阻；所谓 "1k 到地"是 TPAFE 负输入脚 AIN_nGND 经 1k 拴到 AGND 的差分滤波。 故本板不存在 2:1 分压，端子侧斜率 = 引脚侧斜率 = 6553.6 / 1241.2 码/V。数据可信.md §2.1 的 305.18 / 1611.3 µV/码 确认不成立。 - 不验交流：台架无信号源，且五路单极性削顶。 改动三（索引与指针） - docs/README.md 测试说明索引、测试文档模板规范.md 的 ADC 缩写行 （原"待立"）同步。 - 数据可信.md 卡 0 增加指向该流程的指针（本表只写判据，不写怎么 接表笔）。 门禁：Keil 构建 0 错误 0 警告；check_ids --strict 通过； check_doc_links --all --sections-strict 通过（193 文档 / 2871 处引用）； pre-commit 全过（含 cppcheck、编码规范、体积档、标定层与量纲回归 单测）；两处内存台账已按 --write / --update 刷新。
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 解析 + 原子持久化（旧二进制档已废弃，2026-10-10） |
cfg/README.md |
sync/ |
时间同步任务：time_sync.c/h |
sync/README.md |
algo/ |
采集与算法层（L1/L2/L3）：语义取数 + 有效性判定 + 采样环/相量/测频 + 定值模型 + 保护元件框架 | algo/README.md（索引）；设计 → docs/算法/采集与算法层设计说明.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