wandering1
0f7b5a87fb
登记簿、文档与代码注释里的存量字母加数字编号（N-x / S-x / T-x / E-x / A-x / 卡号） 一律改写为语义短语，净删 2,028 处引用；删除基线与待确认、并行分道方案、排期详述、 采集保护收尾 4 篇（内容已并入 docs/任务规划/README 与登记簿）。 门禁机器与三张账同批重打：check_ids.py 新增变更记录行豁免与第二根护栏 undecidable_total_ceiling；check_test_traceability.py 只加 stdout/stderr UTF-8 reconfigure（TC_RE 未动）；check_cubemx_survival.py 的 --write 固定 newline=LF； id_registry / id_aliases（+19 条 retired-to-phrase）/ id_known_backlog 重打。 test/ 56 个文件同步 TC 标签语义化，其中 18 个 TU 改了 CHECK / printf 里的标签文字， 是本批唯一改变构建产物的文件集合。 为什么合成一笔、不拆四笔（实测撞闸，非偏好）：pre-commit 跑钩子前会 stash 未 staged 部分，拆开后中间提交必然是「新规则 + 旧语料」——实跑可判定 85.15% < 基线 86.00%、 不可判定 1,453 > 上限 1,166，编号门禁直接拦下。编号识别面与它描述的语料只能同码移动。 实跑基线（工作区全量）：754 文件 / 8,230 处编号字面量 / 可判定 7,079 = 86.01% （基线 86.0%，容差 0.1pp）/ 不可判定绝对数 1,151（上限 1,166）/ 校验 1-6 错误级 0 / 告警 = 悬空 2（App/algo/freq.c 的 S2，属 §4.4 同号不同义）+ 孤儿 50。 基线从 84.0 抬到 86.0 的理由见 docs/门禁说明/id-check.md §7.6：本批真删了 2,028 处 引用，可判定面随真实内容上升，不是把分母做小。同批新增排除 docs/硬件平台/ 语料，使 识别面少 264 处——芯片手册位号与网表料号不属编号空间（registry 有 excluded_paths_note）。 ⚠ 余量只剩 0.11pp（约 10 处）与绝对数 15 处：把「可判定的引用」改成散文会立刻撞第二 根护栏。另遗留一项：id_aliases 里 retired 的 N / S / T / A 别名没有 scope（U1~U5 有）， 今后有人新写一个 A-4，校验 3 不会响，只能靠人，建议下批补 scope。 固件不变证据：115 个 .c/.h 剥注释并归一字符串后与 HEAD 逐字节全等，残留代码差异 0； App / Src / Drivers 的字符串字面量零改动。@build 0 错误 0 警告；40/40 主机套件、2,889 断言全通过；覆盖率 line 89.2% / func 92.6%；pre-commit 48 钩子 --all-files 全绿； check_doc_links --all 通过（176 文档，章节引用无法判定 0）；逐字节卫生核过：14 个带 BOM 文件与 HEAD 一致、0 个 CR、0 个 U+FFFD，字符串字面量纯 ASCII。 .cubemx_survival_baseline.json 的 watchdog-module 哈希 56bf27 变 2bb051 属合法： Src/freertos.c 的 USER CODE 区内只有注释文字随编号改写，代码未变。 同批带上体积同码凭证与 RAM 台账行（@build 之后盖戳）：RW_IRAM1 79,008 B / 60.3%， RW_CCM 57,376 B / 87.9%，阈值 92%。
Drivers/BSP/TPAFE5160/ — TPAFE5160 高精度 ADC 驱动
TPAFE5160 是并行 16 位接口的高精度 ADC。本目录为寄存器级驱动： 转换启动（CONVST）、忙信号（BUSY）、数据读取（RD）时序管理。
文件一览
| 文件 | 作用 |
|---|---|
tpafe5160.c/h |
ADC 初始化、转换启动（轮询 + 中断）、16 位并行数据读取 |
硬件接口
- 并行 16 位：PG0–PG15 数据总线 / PC8 RD（读选通）/ PC9 CONVST（转换启动）/ PC7 BUSY（转换中）/ PC6 FRSTDATA（首通道标记，板上 R24 4.7k 上拉）/ PA12·PA11·PA8 = OS0·OS1·OS2（过采样选择）——V0.1 网表口径（V0.0 曾为 PD3/PD4/PD7，已作废）
- 部分引脚为 GPIO 模拟时序（非硬件 SPI/FSMC）
关键点
- 周期重触发由 TIM3 更新事件（1 kHz）驱动（2026-10-10）：
app_main_init末尾HAL_TIM_Base_Start_IT(&htim3)启动节拍，Src/main.c的HAL_TIM_PeriodElapsedCallback在 TIM3 分支内调tpafe5160_start_conv_irq()（ISR 内仅两次 GPIO 写）。B1 阶段曾由adcTask每 1 ms 软触发（已改）。⚠ 节拍源必须是 TIM3 而非 TIM6：TIM3 的同一个更新事件还经 TRGO 硬件触发 STM32 ADC1，两片转换器由此同源对齐；F4 上 TIM6/TIM7 的 TRGO 只接 DAC，喂不到 ADC1 - 取数只用
tpafe5160_snapshot(int16_t *dst, uint8_t count)（仅任务上下文，内部临界区原子拷贝；返回 1=新帧 / 0=无新帧 / -1=参数无效）。配套的tpafe5160_frame_seq()给帧序号、tpafe5160_frstdata_err()给"FRSTDATA 无跳变"帧计数 - ⚠️ 不要用缓冲区指针取数：旧的
get_buf()/data_ready()/clear_ready()已于 2026-10-10 删除——get_buf只给指针、任务再逐通道拷，中间被 BUSY EXTI 抢占就拷回两帧混合数据；s_ready电平标志在start_conv_irq里被清 0，等于用重触发去丢帧。现由帧序号（只增不清）+ 临界区快照取代 tpafe5160_init()做首帧有效性自检：完整跑一帧转换+读取，若整帧读下来 FRSTDATA 没有发生任何跳变（芯片没在驱动并行总线；板上上拉会把它钉死为高）→ 返回BSP_ERR_NO_DEVICE（旧TPAFE5160_FRSTDATA_ERR(-3)，2026-10-23 收编）并打[ERR] Init FRSTDATA no-toggle。判据刻意不锁死"哪个 RD 边沿拉高/拉低"（手册只给"RD 下降沿 → FRSTDATA 高/低"两个跳变，本板未实测边沿次序），只要求"一帧内必须跳变" → 既抓死芯片，也不会因极性假设错误误杀好芯片- 采样数据的消费者
App/task/adc_task.c已实现（B1，2026-10-10：tpafe5160_snapshot()原子取数 + 帧统计；adcTask在Src/freertos.c的USER CODE区创建）。v2.2（2026-10-10）：采样节拍改由定时器更新中断硬件触发，本任务退化为纯消费者；v2.8（2026-10-10）：节拍源改 TIM3（同时经 TRGO 触发 ADC1 + DMA），STM32 侧改为消费 DMA 乒乓缓冲，单拍耗时 122 µs → 8 µs - CONVST→BUSY→RD 三段时序对建立/保持时间敏感，改动需对照芯片手册
- ⚠️ 本项目 ADC 相关功能新增任务/缓冲前须核算 RAM（见
docs/内存管理/）；接消费者前的强制门禁见根AGENTS.md「接 ADC / RS-485 消费者前的强制门禁」 - ⚠️ 通道语义不是通道号：
buf[i]对应哪个电气量必须查docs/硬件平台/ADC通道映射说明.md（buf[2]=IA、buf[5]=UN、buf[6]=UA）；V0.1 上 8 路电气量分属两片转换器属硬件缺陷（登记簿条目「双转换器无共同采样触发」）→ 禁止跨转换器做相位/功率/功率因数类运算
已知问题
docs/问题记录/TPAFE5160.md有 16 张图片断链（文档引用了但图从未入库）——已登记，暂缓处理
相关文档
- 芯片手册转录：
docs/芯片手册/TPAFE5160.md（注：其配图有断链） - 任务实现：
App/task/adc_task.c - 硬件引脚：根
README.md「外设接口」