docs(adc): 修 §5.2 表格渲染,讲清零点这步怎么填

原表单元格里写了未转义的竖线(绝对值符号),被 GFM 当成列分隔符,
整张表渲染成乱码,看不出要填什么。§6 判据汇总同病同修。

同时把这一步的操作讲清楚:
- §5.2 补"做什么"四步:断电短接 → 上电读 adc: → 抄进 §9.1 → 断电换下一路
- 明确本节只给判据,要填的表在 §9.1(原表看着像表单,实际是参考值)
- §9.1 记录表加"空载码值(浮空)"列与填法说明,让空载与短接两个数都留痕

表格列数已用脚本复检三份相关文档,全部对齐。
This commit is contained in:
2026-10-27 17:17:03 +08:00
parent dc9ae01f50
commit c92d503851
@@ -94,26 +94,21 @@
| **注入点 ↔ AGND**(TPAFE 侧,UA/UN/IA) | **≈ 1 MΩ 量级** | 无意外短路;**不是 1 kΩ** |
| **注入点 ↔ AGND**(STM32 侧,UB/UC/IB/IC/IN) | 高阻,不定量 | 无设计直流通路,只作短路排查 |
**为什么端子对 AGND 不是 1 kΩ**:端子到 AGND 是一条**串联**通路,不是串阻与输入阻抗并联——
R31(1 kΩ) → TPAFE `AIN_7P` →(芯片内部 **1 MΩ** 恒定输入阻抗)→ `AIN_7GND` → R32(1 kΩ) → AGND,
合计 ≈ **1.002 MΩ**。1 kΩ 只在**串阻两端**成立。
TPAFE 手册 "Analog Input Impedance" 节原文:*"Each analog input channel in the device presents a
constant resistive impedance of 1 MΩ"*,并要求 *"Matching the external source impedance on the
AIN_nP input pin with an equivalent resistance on the AIN_nGND pin"*——R31 与 R32 各 1 kΩ 就是这条
匹配要求,用来抵消外部电阻引入的失调误差。**它同时解释了 R32 的存在理由:匹配,不是分压。**
⚠ 任一路量到 **0 Ω 或几十 Ω** → 停,先查焊接/短路,不要通电。这一条才是本步的真正用途:
绝对阻值还受万用表测试电压与芯片未上电状态影响,**只用来排除短路,不用来验收正确性**。
### 5.2 步骤 1:零点(这一步是整套测试的分水岭)
把注入点**短接到 AGND**(短接点先用 0 Ω 档确认与 AGND 直通),读 `adc:` 行。
**做什么**(8 路逐个重复,每路约 1 分钟):
| 通道 | 判据 | 当前空载实测(浮空) |
| ---------------------- | -------- | ----------- |
| UA / UN / IA | |码| ≤ 10 | **≈ 11430** |
| UB / UC / IB / IC / IN | |码| ≤ 5 | **≈ 1000** |
1. 断电,把该路**注入点短接到 AGND**(短接线之前先用 0 Ω 档确认该点与 AGND 直通);
2. 上电,等 `adc:` 行出现(每 10 s 一行,9 路码值都在里面);
3. 把该路码值抄进 **§9.1 的零点记录表**;
4. 断电拆短接线,换下一路。
> 本节只给**判据**,要填的表在 §9.1。下表两列是参考值,不是待填字段。
| 通道 | 空载(浮空)当前实测 | 短接 AGND 后应满足 |
|---|---|---|
| UA / UN / IA(TPAFE) | ≈ 11430 码 | 码值绝对值 ≤ 10 |
| UB / UC / IB / IC / IN(STM32) | ≈ 1000 码 | 码值绝对值 ≤ 5 |
**为什么这一步最关键**:空载(输入浮空)读数比判据高两个数量级,最可能的解释是输入悬空后
漏电流在滤波电容上建立的平衡点——短接 AGND 后应塌回 0。但如果**短接后仍读 11430**,那就是
@@ -178,7 +173,7 @@ TPAFE 是双极性、二进制补码,可以注负压;STM32 是单极性,
| 项 | 判据 | 不通过意味着 |
| -- | ---------------------------- | --------------------------- |
| 零点 | TPAFE |码| ≤ 10;STM32 |码| ≤ 5 | 有真实偏置,需查前端;可能超出补偿上限 |
| 零点 | TPAFE 码值绝对值 ≤ 10;STM32 码值绝对值 ≤ 5 | 有真实偏置,需查前端;可能超出补偿上限 |
| 线性 | R² ≥ 0.999 | 前端非线性或注入源带载失真 |
| 斜率 | 偏差 ≤ 2 % | 前端有未识别元件,或转换器档位/参考错 |
| 映射 | 注入哪路只动哪路 | 语义表与物理通道不符(`k_adc_map[]` 错) |
@@ -210,16 +205,19 @@ TPAFE 是双极性、二进制补码,可以注负压;STM32 是单极性,
### 9.1 零点
| 通道 | 短接后码值 | 判据 | 结论 |
| -- | ----- | ---- | -- |
| UA | | ≤ 10 | |
| UN | | ≤ 10 | |
| IA | | ≤ 10 | |
| UB | | ≤ 5 | |
| UC | | ≤ 5 | |
| IB | | ≤ 5 | |
| IC | | ≤ 5 | |
| IN | | ≤ 5 | |
填法:`空载码值` = 不接任何东西时 `adc:` 行读到的数;`短接 AGND 后码值` = 把注入点短到 AGND
之后读到的数。判据只看后者。
| 通道 | 空载码值(浮空) | 短接 AGND 后码值 | 判据 | 结论 |
|---|---|---|---|---|
| UA | | | ≤ 10 | |
| UN | | | ≤ 10 | |
| IA | | | ≤ 10 | |
| UB | | | ≤ 5 | |
| UC | | | ≤ 5 | |
| IB | | | ≤ 5 | |
| IC | | | ≤ 5 | |
| IN | | | ≤ 5 | |
### 9.2 三点线性(UA)
@@ -261,3 +259,4 @@ TPAFE 是双极性、二进制补码,可以注负压;STM32 是单极性,
| 2026-10-27 | 建档。承接 `docs/任务规划/数据可信.md` 卡 0 的执行侧;固化"前端无分压"的网表结论、端子侧注入点清单、期望码值表与五步流程。同日 `App/task/adc_task.c` 心跳新增 `adc:` 行(9 路原始码值),使全程免复位 |
| 2026-10-27 | §2 的 ASCII 拓扑图换成 SVG(`docs/images/ADC前端电路.svg`,生成器 `tools/arch_diagram/gen_adc_frontend_svg.py`)。ASCII 版把 C44 / R32 画成挂在 ADC7 下的一根竖线,读起来像 2:1 分压——正是本节要否掉的结论;新图把 `ADC7` 与 `ADC7_GND` 画成两个节点,并加 STM32 侧对照面板 |
| 2026-10-27 | **§5.1 步骤 0 判据更正**:原写"端子侧应量到 1 kΩ 量级(串阻 + 转换器输入阻抗**并联**)"两处错——① 端子到 AGND 是**串联**通路(1k + 芯片 1 MΩ + 1k ≈ 1.002 MΩ),1 kΩ 只在**串阻两端**成立;② 芯片输入阻抗是 **1 MΩ 恒定**(`docs/芯片手册/TPAFE5160.md` "Analog Input Impedance" 节),不是可与 1 kΩ 并联出 1 kΩ 的量级。改为三行分测表(串阻两端 / TPAFE 侧对 AGND / STM32 侧对 AGND),并写明本步**只排除短路、不验收正确性**;§8 已知坑补对应一行。`docs/硬件平台/ADC通道映射说明.md` §7"前端偏置"行同步补 1 MΩ 与源阻抗匹配依据 |
| 2026-10-27 | **§5.2 表格可读性修正**:原表单元格里写了 `\|码\|`(未转义竖线),被 GFM 当成列分隔符,整表渲染成乱码;改为"码值绝对值 ≤ 10 / ≤ 5"(§6 判据汇总同病同修)。同时 §5.2 补"做什么"四步(断电短接 → 上电读 `adc:` → 抄进 §9.1 → 断电换下一路),并明确**本节只给判据、要填的表在 §9.1**;§9.1 记录表新增"空载码值(浮空)"列与填法说明,使空载与短接两个数都被记下来 |