wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 29 Pull Requests 1 Actions Packages Projects 2 Releases Wiki Activity

docs(注入验证): 交流轮次按已落地的录波样本出口改成两档跑

Browse Source 
录波数据面 2026-10-29 并入主干后，本文 §4 的出口表已写"已落地"，而 §8 仍写着"主干尚无 /
等段文件 / 样本出口未落地"——同一份文件自相矛盾，本轮全部对齐（19 处改写）。

- §8.1：每条用例分成两个档（周期行标量档 / 段文件定量档）；段文件那一行去掉
  [计划] 与"主干尚无"，D3 与 D6 升入定量档，"临时抬 log_phasors 倍数"降为退路
- §8.5 D3：新增七步定量档动作——UI「手动录波」触发 → 等 wave: 的 seg+1 → FTP 取段 →
  wave_read.py fft --all → 比同段内 UA(表序 0) 与 UN(表序 3) 的相对相位，容差 2°；
  段与发生器无绝对相位锁定（触发点在段内点 159），跨段比相位或拿发生器当绝对基准都不成立
- §8.5 D5：加三把尺子——shape --strict（DC 改法 A）、再加 --clip-superset（极小注入 /
  未驱动通道）、不带 strict 只读游程（50 Hz 正弦档）；段头 CLIPPED 位来自通道来源、
  从不实测，--min-run 的 4 点与固件"连续 20 拍"是两把尺子，不得互相换算
- §8.5 D6：加 fft 谐波定量档（--ch 4 = IA；表序 UA..IN、TEMP 不录），UI 目检降为旁证
- §8.2：设备表加 FTP 取段与触发路径两行（产品构建免改代码只有 UI 手动页；保护启动处
  未标定闭锁态；bench 定时自抓在 DTU_BENCH 与 WAVE_BENCH_AUTOCAP 双层编译门内、默认 0）；
  开机前置门加 wave: 行基线（armed / err / ovf / drop 全 0，每段核 seg+1）
- §8.4 抬头加段文件与脚本两行；§8.6 顺序表重排，新增末尾统一取段与跑脚本一步，
  合计耗时 110 → 135 min；§8.8 加三行分诊（脚本拒收是正确行为、--strict 先分清尺子、
  seg 不涨先查落盘道）；§8.9 加"开过 bench 编译门必须还原"一行
- §8.10 归档加段原件与脚本产物（段原件被覆盖就再也拿不回来，先改名再触发下一段），
  第 4 条的"被在飞工作树占着"改为"单写者阻塞已解除，仍等用户点头才改判据文档"
- §8.11 现状三条改写：出口已成立 / 板级对表本身还没跑过 / 只 320 ms 快照不等于长时间稳定

段文件名一律写 `WAVE<NN>.BIN`（NN = 00~99）：新增行里出现字面量 `WAVE00` 会被
编号门禁·新增行拦下（字母+数字形态），而它确是固件生成的文件名，不值得为此扩白名单。

纯文档改动，未跑 @build（无可编译内容）。门禁：doc-links --sections-strict rc=0
（104 处引用 / 94% 可判定）、编号门禁 rc=0、表格列数 0 处不一致、无 BOM 与 CR 与乱码。
This commit is contained in:
Wanderingss
2026-10-29 19:46:40 +08:00
parent 6e436117dd
commit fa371bcf11
1 changed files with 88 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/测试说明/ADC前端注入验证流程.md
+88 -25
View File
@@ -13,8 +13,8 @@
> **判据的属主是 `docs/任务规划/数据可信.md` §4.6.2**（D1~D6 验什么、过判据是多少），本文 §8 只写**怎么跑**。
> 两处不一致时分两类裁定：**「验什么、算不算过」从 `docs/任务规划/数据可信.md` §4.6.2**；**「期望值怎么算」从本文**。
> 后者不是抬杠：那边有三处与代码算不拢（D2 的三角系数、D5 的「注 50 Hz 正弦就能造出锁存」、D3 与 D6 在 ×0.1 定点
> 出口下的分辨率），照它的数字跑会把好板子判成失败。本轮按本文数值跑，更正清单与回写路径见 §8.10 第 4 条；那个
> 文件正被在飞工作树改（`docs/任务规划/` 是单写者目录），**要不要现在一并改它，等用户裁定**。
> 出口下的分辨率），照它的数字跑会把好板子判成失败。本轮按本文数值跑，更正清单与回写路径见 §8.10 第 4 条——那个
> 文件的单写者阻塞已随录波并入解除（2026-10-29），但改判据文档是另一个动作面，**要不要现在改它仍等用户裁定**。
---
@@ -295,8 +295,11 @@ TPAFE 是双极性、二进制补码，可以注负压；STM32 是单极性，
### 8.1 动手前先把出口分辨率算清楚（决定今天能判到哪一档）
这一轮和直流轮次一样**没有样本出口**：板上没有任何"把窗里的点导出来"的通道（§4 那张表就是全部可读的东西），
所有判据都得从**已经算好的标量**读。各出口的实际分辨率如下——这张表决定哪几条今天能判到位：
这一轮和直流轮次**不一样：样本出口已经有了**。2026-10-29 故障录波的数据面并入主干，一次触发就是一段
`/wave/WAVE<NN>.BIN`（`NN` = 00~99 轮转号；8 路 × 320 点原始码值 + 封存瞬间的标定与品质快照），PC 侧 `test/host/wave_read.py` 把它还原成
周波数、幅值、**相位**、谐波与削顶判定。所以本轮每条用例都有两个档：**周期行标量档**（只读串口 / 104 / UI，
快，不用 FTP）与**段文件对表档**（多一次触发 + 一次取段 + 跑脚本，判得到位）。各出口的实际分辨率如下——
这张表决定每条用例走哪个档：
| 出口 | 打印处 | 分辨率 | 能判 | 判不动 |
|---|---|---|---|---|
@@ -305,16 +308,16 @@ TPAFE 是双极性、二进制补码，可以注负压；STM32 是单极性，
| `phasor(hb) C0x-…-F1: Re=.. Im=.. rms=.. (x0.1)` | `App/task/adc_task.c:209` | **0.1 V，且向下截断** | 有数没数、量级、象限 | ⚠ **D3 的 ≤2° 与 D6 的 ±2 %**：注 1.000 Vrms 时 `rms` 只有 10 格，20 % 的谐波只有 2 格 |
| `freq(hb): f=.. valid=.. (x0.01)` | `App/task/adc_task.c:224` | 0.01 Hz | D4 的读数与新鲜度 | — |
| UI 交流量页 `Ua/U0/Ia/Ia2/Ia5`（3 位小数）、`Hz`（2 位） | `Drivers/BSP/UI/ui_page_ac.c:47` | **1 mV**（人工目检 + 拍照留证） | D6 谐波幅值、D1 交叉旁证、D4 的 `Hz` 显 `--` | 相位（页面上没有角度） |
| 录波段文件 `/wave/WAVE00.BIN` + [计划] `test/host/wave_read.py` | **主干尚无**（在飞工作树 `task/wave-record` 已做到代码侧） | 原始码值全样本 | 合入后 D3、D6 升级为「PC 独立重算 vs 板上读数」对表 | — |
| 录波段文件 `/wave/WAVE<NN>.BIN`（`NN` = 00~99，100 个号轮转；FTP 根下，与 `/log` 平级）+ `test/host/wave_read.py`（`dump` / `fft` / `shape` / `plot`，纯标准库） | **已落地**（2026-10-29 并入 `v2-on-ui`；格式属主 `docs/子系统设计/故障录波设计说明.md` §6.2 与 §6.3） | 一次触发 8 路 × 320 点原始码值；`fft` 给基波 RMS、相位、2 次与 5 次谐波 RMS（mV） | **D3 的 ≤2° 与 D6 的 ±2 % 现在判得动**：PC 独立重算 vs 板上读数对表 | 段与发生器**无绝对相位锁定**（触发点在段内点 159）→ 只能比同段内相对相位；320 ms 快照不等于长时间稳定性 |
**所以这一轮分三档跑**（排序理由见 `docs/任务规划/故障录波.md` §2 末：动态验证真正缺的不是信号源，是**样本出口**；
判据升级口径见 `docs/子系统设计/故障录波设计说明.md` §11）：
**所以每条用例按两个档摆**（出口从"缺样本"变成"有段文件"的经过与口径变更，见 `docs/任务规划/故障录波.md` §2 末
与 `docs/子系统设计/故障录波设计说明.md` §11）：
| 档 | 条目 | 说明 |
|---|---|---|
| **今天判得动** | D1、D2、D4、D5（D5 的接法要按 §8.5 改，原因写在那张卡里） | 判据在 `meas:` / 104 / `freq(hb)` / `rail:` 上分辨率都够 |
| **判得动但要换出口** | D6 | 走 UI 目检档（1 mV），`phasor` 行只作旁证；没有谐波叠加功能就用同一张卡里的分次注入档 |
| **建议等段文件** | D3 | ×0.1 的定点出口判不了 2°：要么接受"90° 跟随"的定性档，要么等 `task/wave-record` 合入后一次判到位。硬要今天判只剩第三条路——临时把 `log_phasors()` 的 `* 10.0f` 改成 `* 1000.0f` 并同处改掉行尾 `(x0.1)`（不改标记会把读数误读 10 倍），跑完按 §8.9 还原。**这条路要不要走，先问用户。** |
| **周期行就判得动** | D1、D2、D4、D5（D5 的接法要按 §8.5 改，原因写在那张卡里） | 判据在 `meas:` / 104 / `freq(hb)` / `rail:` 上分辨率都够，不取段也能收工 |
| **段文件档才判到位** | D3、D6 | 段文件已落地 → 浮点重算，≤2° 与 ±2 % 都是**定量**判据；周期行退为旁证，只在没取到段时走定性档。触发动作与命令写在 §8.5 的 D3 / D6 卡 |
| **要改代码的退路** | D3 抬倍数、D4 B 档 | 段文件落地后 D3 这条基本不必走；D4 B 档（放宽 `FREQ_AMP_MIN`）仍是唯一路子。两者都要重编 + 烧录 + 按 §8.9 还原，**动手前先问用户** |
### 8.2 设备清单与开机前置门
@@ -325,8 +328,10 @@ TPAFE 是双极性、二进制补码，可以注负压；STM32 是单极性，
| 万用表 AC 档 | 能读到 mV；**记明型号与响应类型**（真 RMS / 均值响应） | 基准就是它；D2 那一步两种表的读数都与基波期望差很多，不记响应类型就说不清是谁错 |
| 板子 | 产品构建（`test/board/test_config.h` 四个 `TEST_SUITE_*` 全注释）+ `@build` 0 错误 0 警告 + 烧录 `-Rst -Run` 与回读校验 | → `stlink-flash` skill 与 AGENTS.md「构建与验证」 |
| `[adc_cal]` 状态 | **保持未标定**（`eng=0`），别为"读数好看"先写标定值 | 现在 `meas:` / `phasor` 的量纲是 **ADC 引脚电压 V**（`App/algo/meas.h` 文件头的 A-lite 口径）；标定一生效就换成二次值，本节全部期望值作废 |
| 串口 | 全程抓 RX 落盘：用 `serial-assistant` skill（`open` → `clear` → 跑 → 读日志文件或 `log --tail`） | 日志文件就是证据本体，§8.10 归档归档的就是它；**长跑别用 `@test`**——它绑定一轮启动语义（静默 8 s、总超时 30 s、`max_boot_count` = 1，且 forbidden 含 `[ERR]`，而 D5 故意造 `[ERR]`），110 min 的 session 必然超时或误判；daemon 全量写 `state/serial.log`（20 MB 上限自动截头保尾 10 MB）→ `docs/测试说明/自动化测试流程.md` 长时间采集一节 |
| 串口 | 全程抓 RX 落盘：用 `serial-assistant` skill（`open` → `clear` → 跑 → 读日志文件或 `log --tail`） | 日志文件就是证据本体，§8.10 归档归档的就是它；**长跑别用 `@test`**——它绑定一轮启动语义（静默 8 s、总超时 30 s、`max_boot_count` = 1，且 forbidden 含 `[ERR]`，而 D5 故意造 `[ERR]`），约 135 min 的 session 必然超时或误判；daemon 全量写 `state/serial.log`（20 MB 上限自动截头保尾 10 MB）→ `docs/测试说明/自动化测试流程.md` 长时间采集一节 |
| 网口（可选） | 要读 104 那一路就插网线、PC 与板同网段（出厂 192.168.1.100），跑现成主站 `test/host/iec104_master.py`（`--ip` / `--port` / `--addr`） | 104 是浮点无量化 + 带品质，是 `meas:` 之外的第二条腿 |
| FTP 客户端 | 走现成 21 端口取段文件（出厂 `[ftp]` 账号，连续 5 次失败锁 60 s） | 段文件是 D3 / D6 定量档的样本出口；段文件名 `/wave/WAVE<NN>.BIN`（00~99 轮转），**取完立刻改名归档**，否则下一次触发把它盖掉 |
| 录波触发路径 | 产品构建里唯一**免改代码**的路径 = UI 菜单第 26 叶「手动录波」确认页（`Drivers/BSP/UI/ui_page_wave_manual.c` → `App/task/ui_task.c:605`） | 保护启动上升沿也算一次触发，但保护判据现处**未标定闭锁**态（AGENTS.md「现状」），别指望它自动来段；bench 定时自抓在双层编译门 `DTU_BENCH` 且 `WAVE_BENCH_AUTOCAP` 非 0 之内（默认 0，`App/task/adc_task.c:153`），开它就走 §8.9 的还原判据 |
| 共地 | 发生器 LO/GND 与板 AGND **单点**相连 | 不共地量到的是两地之差；现象见 §8.8 |
**开机前置门**——接发生器**之前**日志就该长这样，不满足先回 §5 步骤 5.5 查节奏，别往下做：
@@ -344,6 +349,8 @@ TPAFE 是双极性、二进制补码，可以注负压；STM32 是单极性，
「phasor 有数」既不说明标定可用、也不说明这一路没在削顶，判读必须配 `vl` / `cl` / `rail` 三个位图一起看；
- 注入正弦**不会**点亮 `health:` 或 `sampling fault:` 那几行：`adc_health` 的位只吃序号差、错误计数增量与 tick 差
（`App/algo/adc_health.c:91-189`），与波形幅值无关；它们若亮是节拍 / 丢帧问题，别归因给发生器（§8.8 同一条）。
- `wave:` 行（`App/task/adc_task.c:782`）基线：`armed=0`、`err=0`、`ovf=0`、`drop=0`，`seg=` 是本开机以来的成段数（**可以是 0**）。
本轮每触发一段就核 `seg` +1 且那三个计数不涨；涨了先按 §8.8 的落盘行分诊，别接着往上下注入。
### 8.3 接线的四条（与直流轮次比，差别只在第 2、3 条）
@@ -374,6 +381,8 @@ TPAFE 是双极性、二进制补码，可以注负压；STM32 是单极性，
注入点：路名 ____（端子侧 U5 / 引脚侧外串 ____ Ω）
[adc_cal] = 未标定（eng=0）—— 必须是这个状态
基线（未注时）：meas: ua_mv=____ un_mv=____ ia_mv=____ rail=0x____ cl=0x____
段文件（走定量档的用例）：文件名 ________ 触发方式 = 手动 / 保护 / bench 取回时刻 ________
脚本：test/host/wave_read.py（先跑 --selftest：通过 / 否） fft / shape / dump 输出与 plot 图归档在 ________
```
### 8.5 逐条执行卡
@@ -440,16 +449,31 @@ TPAFE 是双极性、二进制补码，可以注负压；STM32 是单极性，
| 读数 | `phasor(hb) C02-UA-F1: Re=.. Im=..` 与 `C03-UN-F1: Re=.. Im=..`，各取 `atan2(Im, Re)` 再比差值 |
| 判据（§4.6.2） | 同相时差值 ≤2°；把发生器（或 B 通道）改 90°，差值跟着走到 ≈90° |
| ⚠ 分辨率 | 出口只有 ×0.1 且向下截断：1.000 Vrms 时 Re/Im 各只有 ±10 格，**一格就是 0.1 V** → 角度量化误差最坏 ≈ atan(0.1 / 0.707) ≈ 8°，**≤2° 今天用串口判不出来** |
| 三个选择 | ① 今天只判**定性档**：同相 ≈0°、改 90° 后差值落进 80°~100° 即算跟随，容差写进记录表；② 等录波段文件合入后 PC 独立重算一次判到位（首选，§8.1）；③ 临时改 `log_phasors()` 倍数为 ×1000 并改掉行尾 `(x0.1)`，跑完按 §8.9 还原——**先问用户** |
| 三个档 | ① **段文件定量档（首选，零改代码）**：同一次注入触发一段，`test/host/wave_read.py fft` 重算基波相位，比**同段内** `UA`（表序 0）与 `UN`（表序 3）的相位差——浮点重算，不受 ×0.1 量化限制，≤2° 判得动，动作见下面第 2 段；② **定性档**：没取到段时退而用，同相 ≈0°、改 90° 后差值落进 80°~100° 即算跟随，容差写进记录表；③ **抬倍数退路**：临时把 `log_phasors()` 的倍数改成 ×1000 并改掉行尾 `(x0.1)`，跑完按 §8.9 还原——段文件档已落地，这条基本不必走，要走仍**先问用户** |
| 红线 | **只许比同片内**：跨转换器无同刻性（V0.1 硬件缺陷）+ STM32 那五路另有 1 拍乒乓滞后 → `docs/硬件平台/ADC通道映射说明.md` §7 |
记录表（定性档）：
记录表（定性档；定量档记脚本输出，归档口径见 §8.10 第 1 条）：
| 发生器相位设定 | C02-UA `Re` / `Im` | C03-UN `Re` / `Im` | 两路 `atan2` 之差 | 结论 |
|---|---|---|---|---|
| 0° / 0° | | | | |
| 0° / 90° | | | | |
**段文件定量档的具体动作（D3 首选，零改代码）**
1. `UA`（R31）与 `UN`（R28）两路接同一发生器输出（同相），注 **1.000 Vrms / 50.000 Hz**；
2. 稳定 ≥30 s 后，在 UI「手动录波」确认页触发一次；成段有**秒级**延迟（落盘在 defaultTask，卷空闲后一次心跳搬完整段）
→ 等串口 `wave:` 行的 `seg=` +1、`armed` 回 0 再去取文件；
3. FTP 取 `/wave/WAVE<NN>.BIN`（本轮那一段的确切号），**取完立刻改名**——100 个号轮转会被覆盖；
4. 主机侧跑：`& '.venv\Scripts\python.exe' test/host/wave_read.py fft WAVE<NN>.BIN --all`
—— 每个整周波给一行：基波 RMS、相位、2 次与 5 次谐波 RMS（单位 mV，系数镜像 `App/algo/phasor.c`）；
5. 判据：`UA`（`--ch 0`）与 `UN`（`--ch 3`）在**同一周波**内的相位差——同相注入应 ≈0°，把发生器（或 B 通道）改 90° 后应 ≈90°，
容差 ±2°（`docs/任务规划/数据可信.md` §4.6.2 D3）；
6. ⚠ 段的**绝对**相位与发生器没有锁定关系（触发瞬间固定落在段内点 159），所以**只能比同段内两路的相对差**；
跨段比相位、或拿发生器相位当绝对基准都不成立（段内点序见 `docs/子系统设计/故障录波设计说明.md` §6.2）；
7. 交叉旁证：同一段先 `dump`（逐字段 + 双 CRC16，看封存瞬间的标定与品质快照），再 `plot --ch 0`（CRC 不符或零长度它
**必须拒收**而不是画出半张图）；板上 `phasor(hb)` 的 `Re` / `Im` 象限应与脚本给的象限一致（×0.1 只够核象限）。
#### D4 测频（默认 A 档 = 判"如实报不可测"）
| 项 | 内容 |
@@ -499,7 +523,21 @@ TPAFE 是双极性、二进制补码，可以注负压；STM32 是单极性，
| 2 | DC −1.00 V（改法 A） | | | | | | |
| 3 | 2.0 Hz / 1.000 Vrms（改法 B） | | | | | | |
#### D6 谐波轨（**用 UI 目检档**）
**段文件档的两把尺子（现在能把"来源派生 vs 实测"一次核清）**
`shape` 拿**实测**贴轨判定与段头 `clip_mask` 对表；而段头那一位**来自通道来源、从不实测**（`test/host/wave_read.py`
文件头的实证与本卡上面的 `cl=0xE6` 同源，两处互证）→ 三种注入分别配三把尺子：
| 注入 | 命令 | 期望 |
|---|---|---|
| 改法 A（`UB` 注 DC −1.00 V 保持 ≥5 s） | `shape WAVE<NN>.BIN --strict` | 实测贴底落进 bit1；段头静态已含 bit1 → 等式成立。**实测冒出段头没有的位**才算失败 = 有别的路被推到轨上，先查接线 |
| 极小注入 / 未驱动通道 | 同上再加 `--clip-superset` | 换成"段头覆盖实测"这把尺子：容忍"封存了但本轮没贴轨"；实测有、段头没有仍然失败 |
| 原接法（50 Hz 正弦注 `UB`） | `shape WAVE<NN>.BIN`（不带 `--strict`） | 只读逐通道贴轨游程：正弦过零必回中带，`--min-run` 默认 4 也可能判不出贴轨——**别把"没判"读成 bug** |
`--min-run`（连续几点算贴轨）与固件的"连续 20 拍"是**两把不同的尺子**，别互相换算；固件侧结论仍以 `rail:` / `edge=`
位图为准（本卡上半段）。
#### D6 谐波轨（**段文件 `fft` 定量档 + UI 目检旁证**）
| 项 | 内容 |
|---|---|
@@ -518,6 +556,19 @@ TPAFE 是双极性、二进制补码，可以注负压；STM32 是单极性，
|---|---|---|---|---|---|---|
| 基波 0.800 Vrms + 二次 0.160 + 五次 0.160 | | `Ia2=` / `Ia5=` | 0.160 / 0.160 | | | |
**段文件定量档（D6 的谐波现在判得到位）**
同一次注入（基波 0.800 Vrms + 二次 0.160 + 五次 0.160，峰值预算见上表）触发一段、FTP 取回后跑：
```text
& '.venv\Scripts\python.exe' test/host/wave_read.py fft WAVE<NN>.BIN --ch 4 --all
```
`fft` 逐整周波给**基波 RMS + 2 次与 5 次谐波 RMS**（mV，浮点重算），±2 % 在这条档是定量判据；`--ch` 是段内通道表序，
`IA` = 4（表序 `UA UB UC UN IA IB IC IN`，TEMP 不录，`App/algo/wave_ring.h:216`）。UI 目检与 7003 截图降为**旁证**——
它证的是"板上 `Ia2` / `Ia5` 与脚本算的是同一件事"（差值应在显示位数之内），不是替代判据。THD 与方和根仍不在本轮，
口径见 `docs/任务规划/数据可信.md` §4.6.5。
### 8.6 顺序与耗时（一次台架 session 跑完）
| 序 | 做什么 | 预计 | 备注 |
@@ -525,12 +576,16 @@ TPAFE 是双极性、二进制补码，可以注负压；STM32 是单极性，
| 0 | 前置门 + 基线 30 s | 10 min | §8.2，不满足就停 |
| 1 | D1（含 0.5 / 0.2 Vrms 加做） | 15 min | 主用例 |
| 2 | D2（方波 / 三角，峰值对齐） | 15 min | 抬头里记万用表响应类型 |
| 3 | D6（含无谐波叠加功能时的三段退路） | 20 min | UI 目检 + 拍照 |
| 4 | D3 定性档（或整条等段文件） | 10 min | 三个选择见 §8.5 |
| 3 | D6：段文件 `fft` 定量档 + UI 目检旁证（同一次注入触发一段） | 25 min | 命令见 §8.5 的 D6 卡 |
| 4 | D3：段文件相对相位档（`UA` / `UN` 同源，再移 90°） | 20 min | 定性档只在没取到段时退用 |
| 5 | D4 A 档 | 5 min | 判"如实报不可测" |
| 6 | D5：50 Hz 档 + 改法 A + 改法 B + 复位复观 | 25 min | **单独一份日志**，判读规则见 §8.7 |
| 6 | D5：50 Hz 档 + 改法 A + 改法 B + 复位复观（每档各触发一段） | 30 min | **单独一份日志**，判读规则见 §8.7 |
| 7 | 同一份接线下把 104 交叉读数复跑一遍 | 15 min | `test/host/iec104_master.py` |
| — | （需用户点头）D4 B 档 / D3 改倍数档 | +40 min | 各含一次重编、烧录与还原 |
| 8 | 取段与脚本产物归档（FTP `get` + `dump` / `fft` / `shape` / `plot`） | 15 min | 每段取完立刻改名，100 号轮转会覆盖 |
| — | （需用户点头）D4 B 档 / D3 抬倍数档 | +40 min | 各含一次重编、烧录与还原；段文件落地后 D3 这条基本不必走 |
合计约 **135 min**（不含"需用户点头"那两档）。取段与跑脚本集中在末尾第 8 行统一做，中间各条只负责"触发 + 让
`seg=` +1"，免得一次 session 里反复插拔网线。
### 8.7 `[ERR]` 的判读规则（D5 单独跑、单独归档）
@@ -558,6 +613,9 @@ TPAFE 是双极性、二进制补码，可以注负压；STM32 是单极性，
| `meas: seq` 不涨 | 发布闸门停 → 先查采集链，别判交流 | §8.2 前置门 |
| `health:` 或 `sampling fault:` 亮 | 与注入的波形无关：`adc_health` 的位只吃序号差、错误计数增量与 tick 差（`App/algo/adc_health.c:91-189`）→ 查节拍 / 丢帧，别查发生器 | §8.2 前置门 |
| 9 路全 0 | 读作"没数据"，不是"输入为零" | §4 尾注 |
| `wave_read.py` 报错退出 / 拒绝出图 | **这是正确行为**：CRC 不符或零长度它必须拒收而不是画出东西 → 重取一份、核对是不是搬到一半的半成品；仍拒收就 `dump` 看两处 CRC16 哪个不符 | `test/host/wave_read.py` 文件头 |
| `shape --strict` 说实测与段头不等 | 先分清尺子：段头 `CLIPPED` 位来自**通道来源、从不实测**；DC 偏置 / 极小注入 / 未驱动通道应改用 `--clip-superset` | §8.5 的 D5 段文件档 |
| 触发后 `seg=` 不涨或 `drop` / `ovf` 涨 | 落盘道在 defaultTask 卷空闲后才搬段，先等几秒；仍不涨查 `wave:` 行三计数与 `/wave` 目录可写（`[ftp]` 写权限） | `App/task/adc_task.c:782` |
### 8.9 收尾判据（走过临时改动的一条都不许留）
@@ -565,6 +623,7 @@ TPAFE 是双极性、二进制补码，可以注负压；STM32 是单极性，
|---|---|
| D4 B 档：`FREQ_AMP_MIN` 50.0f → 0.5f（`App/algo/freq.h:62`） | 还原 + `@build` 0 错误 0 警告 + **`git diff` 里 `App/algo/freq.h` 必须为空** + 在 `docs/任务规划/数据可信.md` §7 #8 那行留一句"本轮台架已还原" |
| D3 改倍数：`log_phasors()` 的 `* 10.0f` → `* 1000.0f`（`App/task/adc_task.c:209`） | 同上，`git diff` 里 `App/task/adc_task.c` 必须为空 |
| 为 bench 定时自抓开过编译门（`DTU_BENCH` + `WAVE_BENCH_AUTOCAP` 非 0，`App/task/adc_task.c:153`） | 还原成默认 0 + `@build` 0 错误 0 警告 + `git diff` 里 `App/task/adc_task.c` 必须为空（产品镜像里这段必须零存在） |
| 只动接线与发生器、没动代码 | `git status` 除归档目录外干净 |
| 全程 | `test/board/test_config.h` 四个套件宏保持全注释（产品构建）；烧录仍须 `-Rst -Run` + 回读校验 |
@@ -572,25 +631,29 @@ TPAFE 是双极性、二进制补码，可以注负压；STM32 是单极性，
1. **证据归档** → `docs/测试说明/boot_log_data/`，沿用现有命名惯例（日期_主题_类型.txt）：
`20261104_ac_d1_meas_log.txt`、`20261104_ac_d5_rail_log.txt`、`20261104_ac_iec104_log.txt`；UI 目检照片同目录
（该目录若不收图，就在抬头里写清照片存放位置）。
（该目录若不收图，就在抬头里写清照片存放位置）。**走段文件定量档的用例另加两样**：取回的段原件（原始字节，
`20261104_ac_d3_wave<nn>.BIN`）与脚本输出（`fft` / `shape` / `dump` 三份文本 + `plot` 的图）——定量档的证据本体是
**那一段原始码值**，日志只是旁证；段原件一旦覆盖就再也拿不回来，先改名再触发下一段。
2. **实测结论回写** → `docs/硬件平台/ADC通道映射说明.md`，在 §8.1（直流轮次）之后**新开一节**——
任务卡 `docs/任务规划/数据可信.md` §5 的 DoD 就是这么分的。本文只留"怎么跑"，**不抄实测数**。
3. **本文回写** → 只在 §8.1 那张表下加一行指针级别的句子（"YYYY-MM-DD 已按本节跑通，实测见 …"）；
不在本文建第二份结论表，否则两份必然漂移（`docs/文档规范.md` 同一事实只在一处详述）。
4. **三处要更正 `docs/任务规划/数据可信.md`**（本轮**没动**那个文件：它正被在飞工作树 `task/wave-record` 修改，
而 `docs/任务规划/` 是单写者目录；等它合入后一次性改）：
4. **三处要更正 `docs/任务规划/数据可信.md`**（那个文件本轮仍**没动**：`task/wave-record` 已于 2026-10-29 并入
`v2-on-ui`，单写者目录的阻塞条件已消失；但改判据文档是另一个动作面，仍等用户点头再动）：
- §4.6.2 D2 的三角期望值「峰值 / √6」→ 0.573 ~ 0.578（§8.5 的 D2 卡）；
- §4.6.2 D5 的"注 50 Hz 正弦 → 连续 20 拍锁存"按代码做不到，改法 A / B 见 §8.5；
- §4.6.2 D3 / D6 的判据在 ×0.1 定点出口下分辨率不足 → 要么挂到录波段文件，要么在判据里明写"定性档"。
- §4.6.2 D3 / D6 的判据在 ×0.1 定点出口下分辨率不足 → 段文件出口现已落地，判据应明写"定量档走段文件、定性档走 `phasor(hb)`"（本文 §8.5 的 D3 / D6 卡已按此写）；
5. **销项** → `docs/任务规划/数据可信.md` §2.7 与 §6 卡片表里这一条按登记簿「完成即销项」处理，属 Ask first，
须用户明确指示后再做。
### 8.11 这一轮证不到（别让读数长得像证据）
`docs/任务规划/数据可信.md` §4.6.5 那张五行表整条适用（端子二次值 / 精度等级 / 跨转换器相位与功率与对称分量 /
THD 与谐波方和根 / 温升 EMC 长时间漂移），本节只补一句现状：**样本出口未落地**（录波在飞）→ 本轮所有"波形"
结论都是**标量级**的、不是形状级；要看形状现在只能拿示波器直接看注入点，那只用于确认发生器输出干净与否，
**不进判据**。
THD 与谐波方和根 / 温升 EMC 长时间漂移）只适用，本节按出口已落地改三条现状（2026-10-29 录波数据面并入主干之后）：
**样本出口已成立**（`/wave/WAVE<NN>.BIN` + `test/host/wave_read.py`）→ D3 / D6 走定量档时结论是**形状级**，不再只是标量级；
但**板级那一轮对表本身还没跑过**（卡片判据见 `docs/任务规划/故障录波.md`），本轮跑出来的就是第一批实测；
段与发生器**没有绝对相位锁定**（触发瞬间只钉在段内点 159）→ 能核的是同段内两路的**相对**相位与极性，
全局相角基准仍证不到；一次触发只有 320 点 = 320 ms，**不等于长时间稳定性**。示波器仍旧只作旁证、不进判据。
再补一条「别把台架做成功能性重复」的边界：**算法本体的精度已经在纯数字域钉住了**——`test/host/phasor/phasor_test.c`
的 TC-PHASOR-003 与 TC-PHASOR-004（基波 = 峰值 / √2 容差 1 %、注入相角容差 0.5°）和 TC-PHASOR-006（2 / 3 / 5 次