refactor(adc): 最小二乘拟合移出固件,只留 PC 侧唯一实现

用户裁定(2026-11-13):设备本体只需要校正后的参数,不需要自己拟合
标定曲线,故固件侧最小二乘拟合整体移出,拟合的唯一实现留在 PC 侧
test/host/cal_fit.py。

删除的死代码(生产零调用、上一轮 map 里已被 linker 标 Removing):
- adc_cal.h:adc_cal_fit() 声明、8 个拒绝码、5 个常量
- adc_cal.c:s_div_round() / s_fit_accum() / adc_cal_fit() 共 224 行
- adc_cal_test.c:tc_00b_fit 226 行(184 -> 150 条)

原样保留的设备侧安全闸:
- adc_cal_apply() 折算、adc_cal_set() / adc_cal_set_ratio() 参数合法
  带拦截(防工具写坏参数)、adc_cal_flags() / adc_cal_prot_blocked() /
  adc_cal_rail_ths()。设备不「算」,但必须「用」和「验」。

测试面:
- cal_fit.py 转为唯一实现,新增 --selftest:承接原 C 侧金标向量
  (r_q16=39322000 / b=12)与 4 条拒绝路径,共 11 条断言;已做变异
  测试证明它会红(改坏圆整口径 -> 2 条 FAIL)
- cal_two_point.py 删除,两点工具由多点拟合取代

文档口径统一为「求参在 PC、设备只做折算与合法带校验」,6 篇 docs 同步;
执行卡改名 ADC多点标定执行流程.md(正文同步 5 点最小二乘口径)。

cfg 热重载吞段缺陷的解析器契约与 TC-CONFIG-063 机器钉一并入库。
Program Size 不变(Code=256196):删掉的是从未链接进镜像的死代码。

验证:Keil 0 errors 0 warnings;adc_cal 150/150;selftest 11/11;
ci_local.py RC=0(static 48/48、manual 三根、size-gate、host-unit
4341/4341);doc-links / mermaid / mojibake 全 0。
This commit is contained in:
2026-11-13 08:09:09 +08:00
parent 1355dbe1b1
commit 7c505b2457
27 changed files with 945 additions and 608 deletions
+3 -3
View File
@@ -112,7 +112,7 @@ docs/
| [`采集与算法层设计说明.md`](算法/采集与算法层设计说明.md) | **`App/algo/` 的现状设计说明**:语义取数与有效性判定、全周傅氏相量采样环/相量/测频、保护判据定值模型与元件框架的契约、关键机制(双区原子切换、乒乓半区、自适应测频窗、定值封存-自检-闭锁)、精度判据 J1~J6 与资源足迹;**§13 = 标定折算**(码值→工程量、三态可用性、未标定即闭锁、遥测快照、六轮动态验证判据、已定案的前置决策) |
| [`继电保护功能复现规划.md`](算法/继电保护功能复现规划.md) | **保护功能复现规划**:把参考系统(CLS100)保护链路映射到本项目(STM32F4)的分层功能/性能/参数清单、平台适配(「双转换器无共同采样触发」等)与分阶段路线图 |
| [`采样有效性校验设计说明.md`](算法/采样有效性校验设计说明.md) | **`App/algo/adc_health.c` 单文件深设计**:四类判据(静默 / 丢帧 / 序号倒退 / 错误计数增量)的判据推导与 100 ms 门限依据、电平-锁存-事件三种位语义与位号对齐、闭锁与看门狗兜底的责任划分、观测盲区、主机侧验证分工与现场判读手册(含三张配图生成器) |
| [`采样数据校正全流程.md`](算法/采样数据校正全流程.md) | **读者入口**:按一帧数据的真实流向,把端子→码值→三维折算(k/b/r)→相量/测频/遥测快照→104·UI·保护·录波串成一条线;含整定落盘、两点标定现状(板上无一键标定、台架手工路径见 `docs/测试说明/专项验证/ADC两点标定执行流程.md`)、三个判定(VALID/CLIPPED/eng 互不派生);细节归各属主文档 |
| [`采样数据校正全流程.md`](算法/采样数据校正全流程.md) | **读者入口**:按一帧数据的真实流向,把端子→码值→三维折算(k/b/r)→相量/测频/遥测快照→104·UI·保护·录波串成一条线;含整定落盘、多点标定现状(板上无一键标定、**拟合跑在 PC 侧 `test/host/cal_fit.py`、固件只做折算与参数合法带校验**,台架手工路径见 `docs/测试说明/专项验证/ADC多点标定执行流程.md`)、三个判定(VALID/CLIPPED/eng 互不派生);细节归各属主文档 |
---
@@ -157,8 +157,8 @@ docs/
| 文档 | 内容 |
|---|---|
| [`ADC前端注入验证流程.md`](测试说明/专项验证/ADC前端注入验证流程.md) | **ADC 前端与两片转换器的台架注入验证**(已知电压注入验证的执行侧,实测证据 → `docs/硬件平台/ADC通道映射说明.md` §8.1):两轮——直流轮(注入点清单 / 期望码值表 / 零点·线性·映射·极性·节奏五步,每步自带现场记录表,**一块万用表即可**)、交流轮(幅值/波形/相位/测频/削顶/谐波六轮执行卡);**两点标定轮已独立成篇** → `docs/测试说明/专项验证/ADC两点标定执行流程.md` |
| [`ADC两点标定执行流程.md`](测试说明/专项验证/ADC两点标定执行流程.md) | **UA/UN/IA 两点标定的执行卡**:开工拍板(保护口径 ≤3~5 %、量级 5 V/50 V 与 0.5 A/2 A 安全裁定、继保仪 ≥0.1 级)→ `meas:` 行三点读数填进文档内 `CALDATA` 标记表 → `test/host/cal_two_point.py --from-doc` 批量求解(`cal_two_point.py` 亦支持单路手填)→ `test/host/cal_write.py` 经 104 定值段 0x8050~/0x8048~ 写入置 VALID 自动落盘 → 三路齐解除保护闭锁(解卡时序红线与回写位置都在卡里);判据属主 `docs/算法/采集与算法层设计说明.md` §13.13 与 `docs/硬件平台/ADC通道映射说明.md` §7.2;**2026-11-12 实跑结果**(UA / IA 已标定、UN 未标 → 保护仍闭锁)登记在 `docs/硬件平台/ADC通道映射说明.md` §7.3 |
| [`ADC前端注入验证流程.md`](测试说明/专项验证/ADC前端注入验证流程.md) | **ADC 前端与两片转换器的台架注入验证**(已知电压注入验证的执行侧,实测证据 → `docs/硬件平台/ADC通道映射说明.md` §8.1):两轮——直流轮(注入点清单 / 期望码值表 / 零点·线性·映射·极性·节奏五步,每步自带现场记录表,**一块万用表即可**)、交流轮(幅值/波形/相位/测频/削顶/谐波六轮执行卡);**标定轮已独立成篇** → `docs/测试说明/专项验证/ADC多点标定执行流程.md` |
| [`ADC多点标定执行流程.md`](测试说明/专项验证/ADC多点标定执行流程.md) | **UA/UN/IA 多点(5 点)最小二乘标定的执行卡**:开工拍板(保护口径 ≤3~5 %、5 点档位 5/10/25/50/100 V 与 0.5/1/1.25/1.5/2 A、抬压逐点确认纪律、继保仪 ≥0.1 级)→ `meas:` 行读数按「每行一个点」填进文档内 `CALDATA` 长表(5 点 × 3 路)→ `test/host/cal_fit.py --from-doc` 在 **PC 侧**批量做最小二乘求解(亦支持 `--sem/--x/--y` 单路手填;**固件里没有拟合代码**,设备只做折算与写入参数合法带校验)→ `test/host/cal_write.py` 经 104 定值段 0x8050~/0x8048~ 写入置 VALID 自动落盘 → 三路齐解除保护闭锁(解卡时序红线与回写位置都在卡里);判据属主 `docs/算法/采集与算法层设计说明.md` §13.13 与 `docs/硬件平台/ADC通道映射说明.md` §7.2;**2026-11-12 实跑结果**(两点算法那一轮:UA / IA 已标定、UN 未标 → 保护仍闭锁)登记在 `docs/硬件平台/ADC通道映射说明.md` §7.3 |
| [`启动日志原子性复验流程.md`](测试说明/专项验证/启动日志原子性复验流程.md) | **控制台整行独占 / 崩溃遗言原子性**这类**行级完整性**判据的固定动作与口径(`docs/子系统设计/控制台单写者日志设计说明.md` 的验收侧:那边讲怎么修,这边讲怎么证明修好了、以及为什么"标记全中"不等于"日志没坏") |
| [`故障录波板级到场轮执行手册.md`](测试说明/专项验证/故障录波板级到场轮执行手册.md) | **录波剩余台架判据的执行手册**(判据属主是 `docs/子系统设计/故障录波设计说明.md` §10,这里只写"人做什么、说哪句话、会看到什么"):四幕(枚举埋点修复 / 注量对表 / 保护触发对时刻(src=P)含两个用户决定 / bench 自抓占卷)各自标清到场与否,配到场检查清单、现场记录表与收工还原清单 |
| [`链路延迟测试说明.md`](测试说明/专项验证/链路延迟测试说明.md) | 网络链路时延分段定义、判定基线、执行流程 |
+1 -1
View File
@@ -179,7 +179,7 @@ typedef struct {
**要点**:
- **`eng` 字段是诚实性的关键**(【2026-10-25 落地注】本条原写"0 = 原始码值(未标定)、`val` 是 ADC 码值(千级)",那是标定落地前的旧口径,已按现场改真值语义):标定层 `adc_cal` 的 ROM 默认系数按**引脚侧 LSB**定死(TPAFE 152.59 µV/码、STM32 805.66 µV/码),采样环折算出来的 `val` 现在是 **ADC 引脚电压 V**——既不是千级码值,也不是端子二次值。承诺边界的依据是 `docs/算法/采集与算法层设计说明.md §13.5`:这一波只承诺到"引脚电压","端子二次值"要等变比确认与两点标定。所以页面文案是 `eng=0` → "未标定"、`eng=1` → "二次值",而不是"码值";升档条件写在 `App/app/ui_data_feed.c` 的 `feed_eng()`——**电气 8 路 `adc_cal_flags()` 的 VALID 全置位才升**(整帧共用一个 `eng`,只要还有一路是引脚电压就不能给整帧贴"二次值"标签,宁可整体保守)。TEMP 不参与线性标定 → 该路恒带 `UI_DATA_Q_RAW`,页面据此不挂单位、不与其他路互比。
- **`eng` 字段是诚实性的关键**(【2026-10-25 落地注】本条原写"0 = 原始码值(未标定)、`val` 是 ADC 码值(千级)",那是标定落地前的旧口径,已按现场改真值语义):标定层 `adc_cal` 的 ROM 默认系数按**引脚侧 LSB**定死(TPAFE 152.59 µV/码、STM32 805.66 µV/码),采样环折算出来的 `val` 现在是 **ADC 引脚电压 V**——既不是千级码值,也不是端子二次值。承诺边界的依据是 `docs/算法/采集与算法层设计说明.md §13.5`:这一波只承诺到"引脚电压","端子二次值"要等变比确认与多点标定。所以页面文案是 `eng=0` → "未标定"、`eng=1` → "二次值",而不是"码值";升档条件写在 `App/app/ui_data_feed.c` 的 `feed_eng()`——**电气 8 路 `adc_cal_flags()` 的 VALID 全置位才升**(整帧共用一个 `eng`,只要还有一路是引脚电压就不能给整帧贴"二次值"标签,宁可整体保守)。TEMP 不参与线性标定 → 该路恒带 `UI_DATA_Q_RAW`,页面据此不挂单位、不与其他路互比。
- **字符串只用定长数组**:`clock[20]` 在结构体内,无指针、无生命周期问题(跨层传指针是经典事故源)。
- **`yx_valid` 与 `yx_bits` 分开**:无效点不参与显示、不参与变位判断(沿用 104 点表的既有做法,避免"IV 通道抖动成变位")。
- **`yx_dp`(2026-10-25 批 4 追加)**:单点还是双点是 **104 点表事实**(`iec104_pts.c` 的 `YX_DP_N`
@@ -99,7 +99,7 @@
> **产品现状一句话**:平台能力(网络 / 存储 / 时间 / UI / 日志 / 看门狗 / FTP / 配置)
> **已实现并台架验收**;采集主线(语义取数与有效性采集 → 标定折算 → 全周傅氏相量 → 测频与遥测快照 → 保护判据
> → 出口与记录 SOE → IEC 60870-5-104 上送)**软件链路已全线贯通并台架闭环**;与参考产品的差距
> 集中在三处:① 保护判据处于**未标定闭锁**态(等标准源两点标定)、② **点表规模**远小于参考
> 集中在三处:① 保护判据处于**未标定闭锁**态(等标准源多点标定)、② **点表规模**远小于参考
> (定值 40 vs 249 项、遥测 9 vs 31 点、开入开出 0 vs 138/31 点)、③ **独立子系统未立项**
> (故障录波、电度、多规约、SNTP)。即:**"数"与"判据"已可信到引脚电压口径,
> 缺的是标定、点表铺开与一次设备接口**(明细见 复刻明细 §1.2、§9)。
@@ -192,7 +192,7 @@ flowchart LR
| 平台能力台架验收 | 网络/存储/时间/UI/日志/看门狗/FTP/配置 全部闭环 | ✅ 已达成(§10.4) |
| 采集主线到业务出口 | 采样→相量→测频→遥测快照→判据→104/UI 全链路数据同源 | ✅ 软件链路闭环;判据等标定(§9.1.1) |
| 屏板独立带屏 | 串口通道交付并台架验收 | ✅ 主机侧交付(§5.16;尾巴见屏板链路设计说明 §9.2) |
| 送检就绪 | 两点标定 → 保护解卡 → 第三方主站验收 | ⬜ 等标准源与端子变比(§9.2 第 4/5 步) |
| 送检就绪 | 多点标定 → 保护解卡 → 第三方主站验收 | ⬜ 等标准源与端子变比(§9.2 第 4/5 步) |
| 复刻完成 | 复刻明细各项达"做完了"口径 | 🔶 见 [`参考产品复刻明细.md`](参考产品复刻明细.md) §1.2 |
@@ -255,7 +255,7 @@ flowchart LR
| P0 | FR-CFG 配置引擎(§5.4) | ✅ | INI 段键表 + 外科保存 + 免重启生效 |
| P0 | FR-LOG 记录与日志(§5.5) | ✅ | 定长记录 + 控制台单写者 |
| P0 | FR-WD 看门狗(§5.7) | ✅ | 心跳位图 + 复位原因 + Fault 现场 |
| P0 | FR-ADC 采集与标定(§5.9) | ✅ | 1 kHz 同源节拍;两点标定后解卡 |
| P0 | FR-ADC 采集与标定(§5.9) | ✅ | 1 kHz 同源节拍;多点标定后解卡 |
| P0 | FR-MEAS 遥测与相量(§5.11) | ✅ | 全周傅氏 + 测频 + 200 ms 快照单源 |
| P0 | FR-IEC104 上行(§5.15) | ✅ | 被控站;无效点入表置 IV |
| P0 | FR-PROT 保护(§5.12) | 🔶 | 软件就绪;**未标定闭锁**(用户裁定走标准源) |
@@ -557,7 +557,7 @@ flowchart LR
| 闭锁源 | 判据 | 行为 |
|---|---|---|
| **未标定** | `UA`/`UN`/`IA` 的 `ADC_CAL_F_VALID` 未全部置位 | 整条判据链停走(产品构建默认态,等两点标定) |
| **未标定** | `UA`/`UN`/`IA` 的 `ADC_CAL_F_VALID` 未全部置位 | 整条判据链停走(产品构建默认态,等多点标定) |
| **采样故障** | `adc_health_flags()` 电平位(TPAFE/STM32 静默、序号倒退) | 元件全部复位 + 本拍不判据,自愈后自动恢复 |
| **定值非法** | 定值校验和(sum32 正/反码)复核失败 | 闭锁相关保护并告警,需重写定值解除 |
| **全局软压板退出** | `PS_GLOBAL_EN` = OFF(104 遥控 `YK12`) | 元件复位 + 停判据,压板恢复即重返联 |
@@ -1663,7 +1663,7 @@ pre-commit run --all-files
| 条目 | 对应 复刻明细 §1.2 | 现状 | 缺的是 | 解除条件 |
|---|---|---|---|---|
| **标定闭锁** | 1~3 | 9 个元件、定值、闭锁链、SOE、104 上送全部就绪,但 `ADC_CAL_F_VALID` 未置位 → 判据整体停走 | **外部资源**:子板/端子板变比 + 标准源 | 端子变比确认 → 8 通道两点标定 → VALID 置位(届时自动解卡,无需改代码) |
| **标定闭锁** | 1~3 | 9 个元件、定值、闭锁链、SOE、104 上送全部就绪,但 `ADC_CAL_F_VALID` 未置位 → 判据整体停走 | **外部资源**:子板/端子板变比 + 标准源 | 端子变比确认 → 8 通道多点标定 → VALID 置位(届时自动解卡,无需改代码) |
| **出口与开入** | 7、8 | 无硬件;保护动作只体现为遥信 + SOE;遥控开关量否定确认 | **硬件 + 立项**:出口继电器、开入回路、回读自检 | 开入开出作为独立模块立项(不可移植项 X3 解除) |
| **三相与同期** | 4、12 | 建接口不使能(B/C 相与 `IN` 削顶、跨转换器无同刻) | **V0.2 硬件** | 8 路电气量全接 TPAFE + 中点偏置 |
| **电度计量** | 6 | 未实现(功率积分需跨转换器同刻) | **V0.2 硬件** | 同上(不可移植项 X4 解除) |
@@ -1704,7 +1704,7 @@ pre-commit run --all-files
| 1 | UI 补齐(记录 5 页 → 运行报告) | 规模型 | **✅ 2026-10-28 落地并绑页;2026-11-06 台架判据复核完成,整体销项** | 六页已落地;余 3 叶属不做项(遥信 3,无开入硬件),重开条件见 `docs/架构设计/硬件规格与能力边界.md` H3 |
| 2 | net 层跨上下文收口 | 平台 | **下一顺位(未开工)** | UI 清单已清空,切换条件已满足;**开工待用户点头** |
| 3 | 其余结构与可靠性评估 | 平台 | 排队 | net 收口后 |
| 4 | 端子/子板变比确认 → 两点标定 | 阻塞型 | 等外部资源 | 子板实物/原理图、标准源到位可插入 |
| 4 | 端子/子板变比确认 → 多点标定 | 阻塞型 | 等外部资源 | 子板实物/原理图、标准源到位可插入 |
| 5 | 标准源送检与第三方 104 主站验收 | 阻塞型 | 等标定 | 保护 VALID 置位;送检窗口前 2 日冻结特性 |
| 6 | 定值铺开 / 映射铺开 / 遥测铺开 / 软压板铺开 | 规模型 | 等排期 | 标定后(工程量才有意义) |
| 7 | 元件铺开与遥测增强 | 规模型 | 等标准源/硬件 | 先解除未标定闭锁;三相类等 V0.2 |
@@ -1712,7 +1712,7 @@ pre-commit run --all-files
| 9 | 验证窗口事项(CI 远端、PC peer、负向注入) | 平台 | 逢条件顺带 | 条件到位即执行 |
| 10 | 出口与开入 / 三相与同期 / 电度计量 / 对下采集 | 阻塞型 | 不排 | V0.2 硬件 / 用户决策 |
> **不可颠倒的顺序(一)**:变比确认 → 两点标定 → 保护解卡 → 送检。未完成标定就送检,
> **不可颠倒的顺序(一)**:变比确认 → 多点标定 → 保护解卡 → 送检。未完成标定就送检,
> 保护表现为**不动作**;保持该闭锁,不用非标准源走捷径(用户裁定,2026-10-25)。
>
> **不可颠倒的顺序(二)**:**点表铺开必须晚于标定**——否则铺出去的全是 IV 点,
@@ -162,7 +162,7 @@ tTimer_NoUI 无压无流判据(CN_
| 归因 | 涉及条目 | 解除方式 |
|---|---|---|
| **外部资源**(标准源、端子变比) | 定值标定、保护判据解卡 | 两点标定(需求档 §9.2 第 4 步) |
| **外部资源**(标准源、端子变比) | 定值标定、保护判据解卡 | 多点标定(需求档 §9.2 第 4 步) |
| **硬件缺失**(X3 / X4) | 开入 138、开出 31、电度 8、同期、三相通道 | V0.2 硬件 |
| **立项未排** | 多规约、SNTP、定值铺开 | 按需求档 §9.2 顺序。**录波最小闭环已交付代码面**(2026-10-29,设计与板级判据 `docs/子系统设计/故障录波设计说明.md` §10;原卡片 2026-10-30 销项并入后删除;1 kHz 起步与本文 80 点/周波口径的偏离在该设计文档 §2 显式登记);**4 kHz 全速、多段、COMTRADE、104 文件传输仍未排**,属二期范围 |
| **算力 / 形态**(X1 / X2) | 双核分工、VxWorks | 不解除。**屏板链路已从范围外项移入范围内**(规格见需求档 §5.16,主机侧实现 `docs/子系统设计/屏板链路设计说明.md`;串口通道已实现,网络通道未做):主机侧链路与参考 1:1 同构,不属"替代方案" |
@@ -722,7 +722,7 @@ tTimer_NoUI 无压无流判据(CN_
| 国密 | SM2 签名验签、SM3 摘要与标准测试向量一致 |
| 软压板 | 9 面全部可投退且行为可观测(投退后对应功能确实停走/恢复) |
| 出口与开入 | 保护动作 → 出口继电器动作 → 开入回读确认,全链路 ≤ 120 ms |
| 标定解卡 | 8 通道两点标定后 `ADC_CAL_F_VALID` 全置位;注入标准源,保护动作值与定值误差 ≤ 3 % |
| 标定解卡 | 8 通道多点标定后 `ADC_CAL_F_VALID` 全置位;注入标准源,保护动作值与定值误差 ≤ 3 % |
| 屏板链路 | **串口通道**:屏板 280 ms 召唤、主机 ≤200 ms 内**发完** **4208 B**(整帧无 2 个字符时间以上的间隙),连续 10 min **主机侧**零超时、零 CRC 错帧;显存 3200 B 与 `g_ui_fbuf` 逐字节一致;7 个物理键(`1/2/3/4/7/8/9`)动作正确;**状态灯位掩码逐位一致、LED 0 恒亮**;屏板 ≈5000 s 自复位不误判离线;LOGO 下发出局(不实现);**网络通道**:INIT 应答 **16 B** 逐字段一致且无颜色字段、`LCDMEM` 偏移 0 得 3204 B、重复召唤无应答、偏移 ≥3200 无应答、`KEEPLIVE` 无应答且 1 分钟不掉链、8 键(含 `F1\|ENT` 组合)动作正确(需求档 §5.16.10 十四条,第 15 条 LOGO 出局) |
---
+3 -3
View File
@@ -41,8 +41,8 @@
| 顺序 | 工作 | 当前状态 | 开始或切换条件 |
|---|---|---|---|
| **1** | **端子 / 子板变比确认 → 两点标定** | 变比已按参数算定;标定未开工 | 缺标准源。开工前必须先拍板三件事(精度目标、变比来源、`eng=0` 期测频门处置),见 `docs/算法/采集与算法层设计说明.md` §13.13 |
| **2** | 标准源送检与第三方 104 主站验收 | 等待标定 | 两点标定完成且保护 `VALID` 已置位;送检窗口前 2 日冻结特性 |
| **1** | **端子 / 子板变比确认 → 多点标定** | 变比已按参数算定;标定未开工 | 缺标准源。开工前必须先拍板四件事(精度目标、变比来源、`eng=0` 期测频门处置、标定点数与分布),见 `docs/算法/采集与算法层设计说明.md` §13.13 |
| **2** | 标准源送检与第三方 104 主站验收 | 等待标定 | 多点标定完成且保护 `VALID` 已置位;送检窗口前 2 日冻结特性 |
| **3** | 定值 / 映射 / 遥测 / 软压板铺开 | 等排期 | 必须晚于标定,否则铺出去的全是 IV 点(两条不可颠倒的顺序见 `docs/产品需求/产品需求设计文档.md` §9.2) |
| **4** | 保护元件与采集增强 | 等待标准源或硬件改版 | 先解除未标定闭锁;跨转换器相位 / 功率 / 对称分量类功能等 V0.2 硬件(缺陷见 `docs/任务规划/登记簿.md` §1) |
| **5** | 其余结构与可靠性评估 | 排队 | 观察项的归属是各模块文档的「已知限制」节,不为清清单强做 |
@@ -52,7 +52,7 @@
### 2.1 关键依赖
- **送检链不可颠倒**:变比确认 → 两点标定 → 保护解卡 → 送检。顺序反了保护表现为不动作,不许用非标准源走捷径(红线见 `docs/产品需求/产品需求设计文档.md` §9.2)。
- **送检链不可颠倒**:变比确认 → 多点标定 → 保护解卡 → 送检。顺序反了保护表现为不动作,不许用非标准源走捷径(红线见 `docs/产品需求/产品需求设计文档.md` §9.2)。
- **保护扩展**:标准源未到位前不新增无法验证的判据;跨转换器相位、功率、对称分量类功能等 V0.2 硬件。
- **观察项不抢道**:内存优化、仓库体积等观察项不抢占当前编码道。
@@ -46,7 +46,7 @@
- **数据源 = 测频与遥测快照**(`App/algo/meas.h`,「数据可信」遥测快照发布与 104 消费):200 ms 基波有效值
+ 每点品质,104 与 UI 共用同一份上游;读数单位 = ADC 引脚电压(eng=0,`App/algo/adc_cal`
折算层 2026-10-25 落地;二次值等两点标定置 VALID)。槽位值/品质整体透传,本层
折算层 2026-10-25 落地;二次值等多点标定置 VALID)。槽位值/品质整体透传,本层
**不再自行判新旧**(快照 `seq` 仅供 COV 去重)。
- 品质映射:快照 `MEAS_QDS_*` 低字节与线上 QDS 同值直传;**CLIPPED → IV**(「削顶通道
恒 IV」口径不变、改由品质驱动,`docs/算法/采集与算法层设计说明.md §13.3` 三态可用性表 +
@@ -57,7 +57,7 @@
基准恒为**上次上送值**,非上次读值——防慢漂移把基准吃掉,参考系统同款);品质翻转
当拍直报、不计数。死区数值 = 运行时副本(`iec104_pts_yc_set_deadband`,ROM 默认沿
下游常数按工程量重定的额定 0.5% 档:0.5 V / 0.005 A / 0.5 Hz;运行参数段接 8020H 段后主站可读写);
标准源注入复核(两点标定)待台架。
标准源注入复核(多点标定)待台架。
### 3.2 遥信 YX(IOA 1~33)
@@ -91,7 +91,7 @@
| 理由 | 说明 |
|---|---|
| 现在根本没有工程量 | 两点标定未做,`adc_cal_flags()` 的 `ADC_CAL_F_VALID` 未置位 → `adc_cal_prot_blocked()` 返 1,帧值仍是引脚域电压(`docs/算法/采集与算法层设计说明.md §13.4`)。「录波必须先有工程量」这条旧前提被本条推翻 |
| 现在根本没有工程量 | 标定未做,`adc_cal_flags()` 的 `ADC_CAL_F_VALID` 未置位 → `adc_cal_prot_blocked()` 返 1,帧值仍是引脚域电压(`docs/算法/采集与算法层设计说明.md §13.4`)。「录波必须先有工程量」这条旧前提被本条推翻 |
| 绕开测频幅值门 | `App/algo/freq.h` 的 `FREQ_AMP_MIN 50.0f` 以二次值 V 为口径,`eng=0` 期间帧值远小于它恒不过门 → `freq_valid()=0`。**录波取的是这道门之前的原始帧**,所以不受影响,动态验证才有样本可对 |
| 最省且可追溯 | int16 码值 2 B/点;标定完成后不必重录,PC 端拿头里的 `k` / `b` 就能把老文件重算成工程量 |
| 诚实 | 文件里装的是「板子看见的东西」,不是「我们希望它看见的东西」 |
@@ -220,9 +220,9 @@ flowchart TD
| 折算算式与防溢出 | PC 与板端同一条定点算式:`t = (code + b_codes) × k_q16`;`r_q16 = 0` → `m = 圆整(t / 65536000)`(引脚域 mV,与 v1 逐位一致);`r_q16 ≠ 0` → `m = 圆整(t × r_q16 / (65536000 × 65536))`(录波域毫单位)。**只允许在最后圆整一次**:先圆整成整数 mV 再乘变比,会让 `r_q16 = 65536`(比值 1.0)的输出与引脚域差 ±1 LSB,而「r = 1.0 等同引脚域」正是两份实现对齐的锚点。**一次乘完会溢出 int64**(t ≈ 4.3e12、r_q16 ≤ 2.147e9,乘积 9e21 > 9.2e18)→ 板端用余数分解换等价单次圆整(`App/algo/wave_store.c` 的 `wave_store_code_to_milli`,注释里写明分解式与各项上界);PC 侧 Python 用大整数直接算同一个值。输出是**录波域毫单位**:eng=1 时二次 mV/mA、eng=0 时引脚 mV,两端口径一致 |
| 变比为什么不并进 `k_q16` | `k_q16` 是**板级前端斜率**(µV/码 × 65536,TPAFE `10000000` / 片内 ADC `52800000`),`r_q16` 是**端子变比**(PT/CT 变比 × 65536)。若把 r 折进 k,电压族 = `10000000 × 65536000 / 65536 = 1.0e10`,已超 int32 上限 2.147e9 → Q16 定标下无法在同一个 int32 里同时表达两个量纲,故必须独立成字段 |
| `flags_seq` 位义 | bit s = 语义通道 s 的 `ADC_CAL_F_VALID`;本波 `ch_count` 固定 8 |
| 可用性字段真值表 | 两行,实现期按 `App/algo/adc_cal.c` 280 到 298 行核出(VALID 需文件位图与 k 合法带**同时**成立;CLIPPED 纯由来源派生——该路 ROM 系数属片内 ADC 侧即置位,与样本内容无关):① **未标定**(产品构建,两点标定未做)逐路 availability = UA / UN / IA 取 `0x00`,UB / UC / IB / IC / IN 取 `0x02`,`flags_seq` = `0x00`,`clip_mask` = 0xE6;② **已标定**(电气 8 路系数全部写入且落合法带)逐路 = `0x01`(TPAFE 三路)/ `0x03`(片内 ADC 五路,VALID 与 CLIPPED 同时为真),`flags_seq` = `0xFF`,`clip_mask` 仍是 0xE6。**VALID 与 CLIPPED 是两件独立事实**:写侧如实透传 `adc_cal_flags()` 逐路原值(`App/task/adc_task.c` 548 行),读侧不得据任何品质组合判废,PC 与回放页只给软告警(见下面「判废面与软告警面」一行) |
| 可用性字段真值表 | 两行,实现期按 `App/algo/adc_cal.c` 280 到 298 行核出(VALID 需文件位图与 k 合法带**同时**成立;CLIPPED 纯由来源派生——该路 ROM 系数属片内 ADC 侧即置位,与样本内容无关):① **未标定**(产品构建,标定未做)逐路 availability = UA / UN / IA 取 `0x00`,UB / UC / IB / IC / IN 取 `0x02`,`flags_seq` = `0x00`,`clip_mask` = 0xE6;② **已标定**(电气 8 路系数全部写入且落合法带)逐路 = `0x01`(TPAFE 三路)/ `0x03`(片内 ADC 五路,VALID 与 CLIPPED 同时为真),`flags_seq` = `0xFF`,`clip_mask` 仍是 0xE6。**VALID 与 CLIPPED 是两件独立事实**:写侧如实透传 `adc_cal_flags()` 逐路原值(`App/task/adc_task.c` 548 行),读侧不得据任何品质组合判废,PC 与回放页只给软告警(见下面「判废面与软告警面」一行) |
| eng 派生式 | `eng` 不是独立事实,是**逐路变比配置状态**的派生量:**每一路电气量「要么已配变比、要么削顶(页面本来就显 `-`,不参与整帧量纲断言)」,八路全满足 → 二次值(1),缺任意一路 → 引脚域(0)**。判据本体 `App/app/ui_data_feed.c` 的 `feed_eng()`(屏显侧),段头字段填写在 `App/task/adc_task.c` 的封存交棒块里现算。**v2 起判据换成变比配置,不再看 `flags_seq`**:`ADC_CAL_F_VALID` 回答「准不准」、`r_q16` 回答「什么单位」,两件事;V0.1 五路片内 ADC 削顶永远拿不到 VALID,用 VALID 当量纲判据会让档位永不解除。两处分布在**不同任务里现算**,理论上会撞上配置重载的毫秒级沉降窗而不一致——这是允许态,见下一行 |
| 判废面与软告警面 | **完整性判废面自始至终只有这些**:精确尺寸等式、`magic` 与 `ver`(含 `ver` 须等于魔数第三字节)、头 CRC 与数据 CRC、表序 `sem` 等于下标、`ch_count` 上限、`pts_per_cycle` / `pts_per_ch` / `pre_pts` 下限、长度为零、文件短读。**品质组合与单位标签永远不进这道门**。软告警面:`avail` 同时带 VALID 与 CLIPPED 时 PC 在 NOTE 列打「同时为真,两点标定完成后属正常,非故障」;`eng` 与逐路变比配置违反上一条派生式时打 WARN。两者都**不改退出码、不影响出图、不拒渲染**。理由:把「单位标签不一致」当数据损坏,等于让一次改标定文件的沉降窗销毁故障证据 |
| 判废面与软告警面 | **完整性判废面自始至终只有这些**:精确尺寸等式、`magic` 与 `ver`(含 `ver` 须等于魔数第三字节)、头 CRC 与数据 CRC、表序 `sem` 等于下标、`ch_count` 上限、`pts_per_cycle` / `pts_per_ch` / `pre_pts` 下限、长度为零、文件短读。**品质组合与单位标签永远不进这道门**。软告警面:`avail` 同时带 VALID 与 CLIPPED 时 PC 在 NOTE 列打「同时为真,标定完成后属正常,非故障」;`eng` 与逐路变比配置违反上一条派生式时打 WARN。两者都**不改退出码、不影响出图、不拒渲染**。理由:把「单位标签不一致」当数据损坏,等于让一次改标定文件的沉降窗销毁故障证据 |
| v1 旧段兼容 | **不做**:`ver` 与 magic 第三字节必须都等于 2,v1 段(`ver` = 1)一律按「该段不可读」处理。理由:v1 没有 `r_q16`,同一份 code 在 v1 里只能解释成引脚域;让读侧按版本分支去猜「这一路到底折没折算」会把「格式已知」降级成「推断已知」,而旧段的有效寿命只到下一次清 `/wave`。升版时全部旧段作废是可接受的代价(`/wave` 是 100 槽轮转,本波不清库) |
| 通道表序与列序 | 第 i 个通道表项 ↔ 数据区第 i 列,按语义号**升序**:UA=0 UB=1 UC=2 UN=3 IA=4 IB=5 IC=6 IN=7(`App/algo/adc_input.h` 的 `adc_semantic_t`)。PC 必须校验表内语义号等于下标,不等即整段作废。交叉验证:`clip_mask` 恒 0xE6 = 2+4+32+64+128,恰好是 UB/UC/IB/IC/IN 五个语义号位,这份算术就是这个顺序的证据 |
| 样本编码 | int16 小端;TPAFE 侧 16 位补码双极性;STM32 侧 0..4095 原样存正数,**不加中点偏置**——V0.1 单极性无偏置是硬件现状,加偏置等于伪造双极性(`docs/算法/采集与算法层设计说明.md §13.5`) |
@@ -76,7 +76,7 @@
| H4 | **无本地屏与按键** | 160×160 单色屏仅存在于远端客户端 | UI 以 TCP :7003 推流 + 远端按键回注(`../产品需求/产品需求设计文档.md` §8) | 产品形态即如此,不解除 |
| H5 | **无 SDIO** | SDIO 固定引脚组被 TPAFE/UART 占用 | FatFs 卷只能落 SPI NAND(当前设计不受影响) | 不解除 |
> **量纲口径**(由 H1/H2 派生):在端子/子板变比确认与两点标定完成前,遥测与保护读数的单位是
> **量纲口径**(由 H1/H2 派生):在端子/子板变比确认与多点标定完成前,遥测与保护读数的单位是
> **ADC 引脚电压**(`eng=0`),不是二次值;此时 `ADC_CAL_F_VALID` 未置位,
> **保护判据整体停走**(`../产品需求/产品需求设计文档.md` §5.12)。这是刻意设计,不是"保护不动作"的缺陷。
+1 -1
View File
@@ -75,7 +75,7 @@
| `timeSyncTask` | 2560 | Normal | 等网络 → 200 ms 校时节拍 `time_sntp_run()`(SNTP 客户端,UDP 出向;写 RTC 经 `sys_clock_set_unix`。:8888 推送监听已退役 2026-11-04) | `time_sync_task` |
| `adcTask` | 2560 | AboveNormal | 纯消费者 + **唯一发布者**:`osThreadFlagsWait` 等 TIM3 1kHz 唤醒(ISR 内 `adc_tick_irq_notify` 置位)→ `adc_input_poll()`(TPAFE 原子快照 + STM32 ADC1 DMA 双缓冲)→ 标定折算 → 相量 → 测频;录波支路 `wave_ring_push()/tick()`;**每 200ms `meas_tick()` 发布遥测快照**(双区无锁,104 与 UI 共用同一份上游) | `adc_task_func` |
| `iec104Task` | 2560 | Normal | 等网络 → IEC 60870-5-104 上行(工厂默认 :2404 监听 + link 状态机;遥测读 meas 快照、遥信读 `prot_elm` 元件态,COV 死区/变位上送;`[comm]`/`[run_par]` 配置;IEC 104 上行/第二轮)。任何构建都创建,纳入 IWDG `required_mask` | `iec104_serv_task` |
| `protectTask` | 2048 | Normal | 保护判据 20ms 节拍:`prot_elm_run()` + 「自检失败闭锁」采样故障闭锁 + 定值校验和巡检 + 动作/复归边沿 SOE 投递(保护任务);⚠ **当前处于「未标定闭锁」态**——`adc_cal_flags()` 无 VALID 时判据停走,两点标定写入 `[adc_cal]` 后自动解卡(用户裁定 2026-10-25:保持闭锁,不用万用表走捷径);纳入 IWDG `required_mask`(产品 `0x1F7`) | `protect_task` |
| `protectTask` | 2048 | Normal | 保护判据 20ms 节拍:`prot_elm_run()` + 「自检失败闭锁」采样故障闭锁 + 定值校验和巡检 + 动作/复归边沿 SOE 投递(保护任务);⚠ **当前处于「未标定闭锁」态**——`adc_cal_flags()` 无 VALID 时判据停走,多点标定写入 `[adc_cal]` 后自动解卡(用户裁定 2026-10-25:保持闭锁,不用万用表走捷径);纳入 IWDG `required_mask`(产品 `0x1F7`) | `protect_task` |
> `idle`(128 words)/ `timer`(256 words)由 FreeRTOS 内核创建。所有任务栈从 FreeRTOS `heap_4` 堆分配(**已迁 CCM**,2026-10-12 保护任务 由 48KB 扩容至 56KB,见 `docs/内存管理/RAM使用分析与优化方案.md` §4.1.2/§2.3)。
> **栈台账**:权威逐任务数字在内存方案 §2.3;`stack_report.py` 9/9 PASS(2026-10-22 静态最坏链 + 同日真机 `[STACK]` 水位;defaultTask 最坏 3024B/5120B 余 40%、protectTask 静态 872B/2048B 余 57%)。⚠ 改栈或加大栈内局部变量前后**必须**重跑该脚本——静态分析低估含递归/间接调用的链(优化前 ftpTask:静态 2528B vs 实测 3480B)。
@@ -1,134 +0,0 @@
# ADC 两点标定执行流程(台架)
给 `UA/UN/IA` 各加两个已知量,解出变比 `r` 与零点 `b`,经 104 定值段写入;三路 `VALID` 齐
## 1. 开工核对
| 项 | 判据 |
|---|---|
| 量级 | 电压族 **5 V / 50 V**、电流族 **0.5 A / 2 A** 误差代价 ≈0.7 % / 0.6 %,在保护 3~5 % 内;0.5 级计量日后另跑高点轮,不混用) |
| 仪器 | 继保仪 **≥0.1 级** |
| 网络 | PC 与板同网段(192.168.31.100),:2404 可达、FTP :21(admin)可用 |
| 接线 | PT 一次侧按下表接;CT 二次**全程不开路**;注入源与板**共地**、先接线后加压 |
**PT 一次侧接线表**(电压采集板 8 端子 → 继保仪输出):
| 板端子 | 接继保仪 | 说明 |
|---|---|---|
| `UA` | `UA` | 相 A 电压 |
| `UAN` | `UN` | 中性参考 |
| `UB` | `UB` | 相 B 电压 |
| `UBN` | `UN` | 中性参考 |
| `UC` | `UC` | 相 C 电压 |
| `UCN` | `UN` | 中性参考 |
| `U0` | `UZ` | 零序电压(N-GND) |
| `U0N` | `UN` | 中性参考 |
要点:每个 `U*N` **各自直接接**继保仪 `UN` 端子,**不要四个连一起**(连一起会经各 200 KΩ 串阻分压,PT 一次侧只拿一半电压)。`U0` 接继保仪 `UZ`(零序电压输出,对应 N-GND),`U0N` 接 `UN`——这样 U0 PT 一次侧跨 `UZ-UN`,台架上能读到零序信号。
**CT 一次侧接线表**(电流采集板 8 端子 → 继保仪输出):
| 板端子 | 接继保仪 | 说明 |
|---|---|---|
| `IA` | `IA` | 相 A 电流 |
| `IAN` | `IBN` | 中性参考 |
| `IB` | `IB` | 相 B 电流 |
| `IBN` | `ICN` | 中性参考 |
| `IC` | `IC` | 相 C 电流 |
| `ICN` | `I0N` | 中性参考 |
| `I0` | `IN` | 零序电流(N) |
| `I0N` | `IAN` | 中性参考 |
要点:`IA`/`IB`/`IC` 各自接对应相输出;`IAN`→`IBN`→`ICN`→`I0N`→`IAN` 串联链,`I0` 接继保仪 `IN`——I0 CT 跨 `IN` 到链上,能读到 IN 电流。**CT 二次全程不开路**;回路中**不得串额外电阻**(串电阻会分压削顶)。
## 2. 读数
**读哪行、怎么读**:串口每 10 s 打一行 `meas: seq=… v=… ua_mv=… un_mv=… ia_mv=… f=… fv=…`。电压格单位 mV、电流格单位 mA。每工况稳定后**连读 3 拍取中间值**(第一拍是切换瞬态,最后一拍防漂移;3 拍 ≈ 30 s)。
**实际案例**:
```text
# 未注入(零点)——连续多拍都是 0:
meas: seq=1400 v=1 ua_mv=0 un_mv=0 ia_mv=0 f=0 fv=0
# 继保仪出 1.000 V(UA + UN 同注)后稳定,连续多拍:
meas: seq=1450 v=1 ua_mv=995 un_mv=996 ia_mv=0 f=0 fv=0
meas: seq=1500 v=1 ua_mv=995 un_mv=996 ia_mv=0 f=0 fv=0
meas: seq=1550 v=1 ua_mv=995 un_mv=996 ia_mv=0 f=0 fv=0
```
解读:注入 1.000 V → `ua_mv` 显示 995 mV(差 5 mV = 零点偏移,正常);`un_mv` 显示 996 mV;`ia_mv` 仍 0(没注电流)。**你填进 CALDATA 表的就是 `995` / `996` 这些数**——脚本内部会换算回码值再解 r/b,你不需要算码值。
**两点标定实际操作**(继保仪输出按 §1 拍板的 5 V / 50 V / 0.5 A / 2 A):
| 步骤 | 继保仪输出 | 串口 `meas:` 行读哪格 | 填入 CALDATA 表 |
|---|---|---|---|
| ① 零点 | 0 V / 0 A | 稳定 3 拍 `ua_mv` / `ia_mv` 取中(预期个位数 mV/mA) | 零点 meas |
| ② 低点 | 5.000 V / 0.5 A | 稳定 3 拍取中(预期 ≈ 5000 mV / 500 mA) | 低点 meas |
| ③ 高点 | 50.000 V / 2.0 A | 稳定 3 拍取中(预期 ≈ 50000 mV / 2000 mA) | 高点 meas |
**零点越带怎么办**:如果零点 `meas:` 格绝对值 > 1250(电压路 mV、电流路 mA,对应码值 ±8192),说明前端有偏压——先查共地/接线,**不得用系数凑**(`docs/硬件平台/ADC通道映射说明.md` §7.2 禁则)。
## 3. 求解:`test/host/cal_two_point.py`
把每路三个读数填进下表(`CALDATA` 注释标记供 `--from-doc` 提取,勿删改标记;空格=未填会被跳过):
<!-- CALDATA:BEGIN -->
| 路 | 零点 meas | 低点 meas | 高点 meas | 已知低点 | 已知高点 |
|---|---|---|---|---|---|
| ua | 50 | 9049.7 | 90176.4 | 5 | 50 |
| un | 70 | | | 5 | 50 |
| ia | 2 | 496.75 | 1985.49 | 0.5 | 2 |
<!-- CALDATA:END -->
> 上表是 **2026-11-12 台架那一轮的实际读数**(留作样例:真实数据长这样、量级对不对可以照此眼校)。
> 下次重新标定**先把 meas 三列清空**,填你这次读到的数;`un` 那行留空即代表本轮不测该路。
> 那一轮解出 **UA `r = 554.687914` / `b = 0`、IA `r = 29.634259` / `b = 0`**,
> 已写入设备(结果登记 → `docs/硬件平台/ADC通道映射说明.md` §7.3)。
meas 列 = `meas:` 行读数(`ua`/`un` 为 mV、`ia` 为 mA,即 ×1000 那格);已知列 = 继保仪实际输出(伏/安)。填完跑:
```powershell
& '.venv\Scripts\python.exe' test/host/cal_two_point.py --from-doc docs/测试说明/专项验证/ADC两点标定执行流程.md
```
脚本对每路已填行解出新的变比 `r` 与零点偏移 `b`,最后打出一条合并写入命令(`WRITE-ALL:` 开头,直接接给 `cal_write.py`)。
**怎么判断结果能不能用**(按顺序看):
| 看什么 | 合格 | 不合格怎么办 |
|---|---|---|
| 每路 `OK r=…` 行里的 **dev**(新 r 相对旧 r 的偏差) | 在 **±10 %** 内 | 超了 = 读数单位填错或接线有问题,**先排查,不要写** |
| 有没有 `REJECT` 行 | 没有 | 有 `REJECT` = 两点填反了(高点比低点还低)或零点超出 ±8192 码,**修正表里对应格再跑** |
| 填了零点列时的 `ZERO CHECK` 行 | 独立算出的 b 与求解 b **量级一致**(比如都是个位数) | 量级差很多 = 零点读数来源可疑(共地/接线),先排查 |
| 末尾 `WRITE-ALL:` 行 | 存在且包含你填的所有路 | 只包含部分路 = 有路被跳过(看上面的 INCOMPLETE 提示),补齐后重跑 |
全部路都 OK 才进 §4 写入。
## 4. 写入:`test/host/cal_write.py`
| 路 | `r` | `b` |
|---|---|---|
| `UA` | `0x8050` | `0x8048` |
| `UN` | `0x8053` | `0x804B` |
| `IA` | `0x8054` | `0x804C` |
```powershell
& '.venv\Scripts\python.exe' test/host/cal_write.py --r 0x8050=995.99 --b 0x8048=-1 --read 0x8050,0x8048 --expect 995.99,-1
```
每路**先 `r` 后 `b`**(`b` 经 `adc_cal_set()` 置 `VALID`;`b` 必须整数码值);`SUMMARY PASS` + C_RD 读回差 <0.1 才进下一路。收到 PN → 看串口 `[ERR] set ch=... rejected`(`r < 1.0` 或 `|b| > 8192`)。
## 5. 验收与解卡
1. **每路完成**:`cal:` 行 `vl` 位图对位点亮(`UA` bit0、`UN` bit3、`IA` bit4,三路齐 `0x19`);低/高点复注对表;FTP 取 `/config.ini` 核 `[adc_cal]`/`[adc_cal_ofs]`/`[adc_cal_sec]`;断电重启后 `vl` 与读回不变。
2. **解卡(最后一路 `b` 前)**:先把各通道置 **50 V / 0.5 A 附近**——**别留 0**(零压解锁会被判低电压);跳闸回路若接真断路器先确认不驱动。最后一笔 `b` 后应打 `calibration VALID -> protection unlocked` + SOE。**严禁伪造 `valid` 位**。
3. **回写**:结果登记进 `docs/硬件平台/ADC通道映射说明.md` §7.3(变比与零点实测表),
§9 台阶第 4 级按已标定路数标 🟡/✅(第 5 级留送检);日志按 `docs/测试说明/测试数据/boot_log_data/` 命名归档。
> **2026-11-12 那一轮的结果与遗留**(照抄现状,别当成"全标完了"):UA / IA 两路标定并落盘,
> 断电重启后读回不变;`vl=0x11`(UA bit0 + IA bit4),`cl=0xe6`。**UN 未标**(台架无有效信号),
> 三路不齐 → 保护判据仍打 `[PROT] uncalibrated -> protection blocked` 并停走,**属预期**。
> 补完 UN 才是"三路齐、自动解卡"的完整验证。**另外**:那一轮暴露出配置引擎热重载吞段的缺陷
> (写进去的 `r`/`b` 约 8 s 被打回出厂值并覆写文件),已修复并加机器钉,
> 见 `docs/子系统设计/配置文件设计说明.md` §4-(3)。
@@ -2,7 +2,7 @@
> **这篇是什么**:已知电压注入验证的**执行侧**——怎么写表笔、读哪行日志、填哪张表、结果往哪回写。判据与实测记录在属主文档:直流轮 `docs/硬件平台/ADC通道映射说明.md` §8.1、交流轮 `docs/算法/采集与算法层设计说明.md §13.10`;**本文只写怎么跑**,分叉时判据从属主。证不到什么见 `docs/硬件平台/ADC通道映射说明.md` 的 §8.1 结论与「边界」段,本文不重抄。
>
> **两个轮次**:§1~§7 = **直流轮次**(2026-10-27 六项 PASS,只需万用表 + 电位器 + 串口日志);§8 = **交流轮次**(幅值 / 波形 / 相位 / 测频 / 削顶 / 谐波),一台信号发生器接 §3 同一批注入点就能跑,等标准源的只有**精度等级**。V0.1 五路单极性削顶(`UB/UC/IB/IC/IN`)在交流轮次只作"预期削顶"负向用例。**两点标定轮已独立成篇**:`docs/测试说明/专项验证/ADC两点标定执行流程.md`(标准源两点 → 求 r/b → 104 定值段写入置 VALID 落盘 → 三路齐了解除保护闭锁;工具 `test/host/cal_two_point.py` / `test/host/cal_write.py`)。
> **两个轮次**:§1~§7 = **直流轮次**(2026-10-27 六项 PASS,只需万用表 + 电位器 + 串口日志);§8 = **交流轮次**(幅值 / 波形 / 相位 / 测频 / 削顶 / 谐波),一台信号发生器接 §3 同一批注入点就能跑,等标准源的只有**精度等级**。V0.1 五路单极性削顶(`UB/UC/IB/IC/IN`)在交流轮次只作"预期削顶"负向用例。**标定轮已独立成篇**:`docs/测试说明/专项验证/ADC多点标定执行流程.md`(标准源多点(N 点最小二乘)→ 求 r/b → 104 定值段写入置 VALID 落盘 → 三路齐了解除保护闭锁;工具 `test/host/cal_fit.py` / `test/host/cal_write.py`)。
## 1. 为什么非做不可
@@ -0,0 +1,183 @@
# ADC 多点标定执行流程(台架,5 点最小二乘)
给 `UA/UN/IA` 各加 **5 个**已知量,用普通最小二乘解出变比 `r` 与零点 `b`,经 104 定值段写入;三路 `VALID` 齐
> **本文是本轮(5 点最小二乘)的执行卡**;2026-11-12 那轮的实测值(`r = 554.687914` 等)是**两点算法下的结果**,保留作历史对照,见 §3 末与 §5 末——不要与本轮新填的读数混用。
## 1. 开工核对
| 项 | 判据 |
|---|---|
| **标定点数** | **每路 5 个点**(算法接受 3~8 点,少于 3 点直接拒绝)。为什么从 2 个点改成 5 个:两点时两个读数各自的误差**原封不动**进结果,单点读歪多少、结果就偏多少;点数多了最小二乘会把单点的偏差摊平,个别点抖一下不再决定整条线 |
| **点位分布** | 5 个点**均匀铺开、含两个端点与一个中点**,且彼此拉开(算法会拒绝「点位不拉开」的输入)。具体档位见下一行「量级」;可按继保仪能力调整(算法吃 **3~8** 个点),但必须满足「拉开、覆盖端点」——没有端点就只能外推,区间边缘不可信 |
| 量级 | 电压 **5 / 10 / 25 / 50 / 100 V**,电流 **0.5 / 1 / 1.25 / 1.5 / 2 A**(5 点,含端点与中点) |
| 仪器 | 继保仪 **≥0.1 级** |
| 网络 | PC 与板同网段(192.168.31.100),:2404 可达、FTP :21(admin)可用 |
| 接线 | PT 一次侧按下表接;CT 二次**全程不开路**;注入源与板**共地**、先接线后加压 |
> ⚠ **抬压必须逐点确认**:2026-11-12 裁定「宁低勿高」仍然有效——每上一个量级先看 `meas:` 行有没有削顶(`rail` / `cl` 位)、确认前端未饱和再继续。100 V 已于 2026-11-13 实测未饱和(见 `docs/硬件平台/ADC通道映射说明.md` §7.4)。0.5 级计量要另跑高点轮、两轮结果不混用,口径见 `docs/硬件平台/ADC通道映射说明.md` §7.2。
**PT 一次侧接线表**(电压采集板 8 端子 → 继保仪输出):
| 板端子 | 接继保仪 | 说明 |
|---|---|---|
| `UA` | `UA` | 相 A 电压 |
| `UAN` | `UN` | 中性参考 |
| `UB` | `UB` | 相 B 电压 |
| `UBN` | `UN` | 中性参考 |
| `UC` | `UC` | 相 C 电压 |
| `UCN` | `UN` | 中性参考 |
| `U0` | `UZ` | 零序电压(N-GND) |
| `U0N` | `UN` | 中性参考 |
要点:每个 `U*N` **各自直接接**继保仪 `UN` 端子,**不要四个连一起**(连一起会经各 200 KΩ 串阻分压,PT 一次侧只拿一半电压)。`U0` 接继保仪 `UZ`(零序电压输出,对应 N-GND),`U0N` 接 `UN`——这样 U0 PT 一次侧跨 `UZ-UN`,台架上能读到零序信号。
**CT 一次侧接线表**(电流采集板 8 端子 → 继保仪输出):
| 板端子 | 接继保仪 | 说明 |
|---|---|---|
| `IA` | `IA` | 相 A 电流 |
| `IAN` | `IBN` | 中性参考 |
| `IB` | `IB` | 相 B 电流 |
| `IBN` | `ICN` | 中性参考 |
| `IC` | `IC` | 相 C 电流 |
| `ICN` | `I0N` | 中性参考 |
| `I0` | `IN` | 零序电流(N) |
| `I0N` | `IAN` | 中性参考 |
要点:`IA`/`IB`/`IC` 各自接对应相输出;`IAN`→`IBN`→`ICN`→`I0N`→`IAN` 串联链,`I0` 接继保仪 `IN`——I0 CT 跨 `IN` 到链上,能读到 IN 电流。**CT 二次全程不开路**;回路中**不得串额外电阻**(串电阻会分压削顶)。
## 2. 读数
**读哪行、怎么读**:串口每 10 s 打一行 `meas: seq=… v=… ua_mv=… un_mv=… ia_mv=… f=… fv=…`。电压格单位 mV、电流格单位 mA。每工况稳定后**连读 3 拍取中间值**(第一拍是切换瞬态,最后一拍防漂移;3 拍 ≈ 30 s)。
**实际案例**:
```text
# 未注入(零点)——连续多拍都是 0:
meas: seq=1400 v=1 ua_mv=0 un_mv=0 ia_mv=0 f=0 fv=0
# 继保仪出 1.000 V(UA + UN 同注)后稳定,连续多拍:
meas: seq=1450 v=1 ua_mv=995 un_mv=996 ia_mv=0 f=0 fv=0
meas: seq=1500 v=1 ua_mv=995 un_mv=996 ia_mv=0 f=0 fv=0
meas: seq=1550 v=1 ua_mv=995 un_mv=996 ia_mv=0 f=0 fv=0
```
解读:注入 1.000 V → `ua_mv` 显示 995 mV(差 5 mV = 零点偏移,正常);`un_mv` 显示 996 mV;`ia_mv` 仍 0(没注电流)。**你填进 CALDATA 表的就是 `995` / `996` 这些数**——脚本内部按你填的这两列做最小二乘,你不需要算码值、也不需要自己算 `r`。
**实际怎么注、注几个点**(按 §1 拍板的 5 点方案;下表是电压路的建议档位,电流路把 V 换成 A、把 5/10/25/50/100 换成 0.5/1/1.25/1.5/2):
| 步骤 | 继保仪输出(电压路) | 串口 `meas:` 行读哪格 | 填入 CALDATA 表 |
|---|---|---|---|
| ① 第 1 点(下限端点) | 5.000 V | 稳定 3 拍 `ua_mv` 取中(预期 ≈ 5000 mV) | 读数列第 1 行 |
| ② 第 2 点 | 10.000 V | 同上(预期 ≈ 10000 mV) | 读数列第 2 行 |
| ③ 第 3 点(中点) | 25.000 V | 同上(预期 ≈ 25000 mV) | 读数列第 3 行 |
| ④ 第 4 点 | 50.000 V | 同上(预期 ≈ 50000 mV) | 读数列第 4 行 |
| ⑤ 第 5 点(上限端点) | 100.000 V | 同上(预期 ≈ 100000 mV) | 读数列第 5 行 |
**零点不再单独作为标定点填表**:多点最小二乘的截距项本身就把零点解出来了,零点靠「5 个点的读数与注入量的整体位置」定,比单读一次 0 V 更稳。但**开工仍建议先看一眼零压读数**:`meas:` 行的绝对值若远超零点带(电压路 mV、电流路 mA,对应码值 ±8192),说明前端有偏压——先查共地/接线,**不得用系数凑**(`docs/硬件平台/ADC通道映射说明.md` §7.2 禁则)。
## 3. 求解:`test/host/cal_fit.py`(最小二乘)
**这一节要你干什么**:把 §2 读到的每路 5 个点填进下面这张长表,跑一条命令让脚本用最小二乘解出 `r` 与 `b`,再判断解出来的结果能不能写进设备。
**边界先说明白(别指望设备自己算)**:拟合**只在 PC 上跑**(`test/host/cal_fit.py` 是唯一实现,固件里没有拟合代码)。设备侧只做两件事——用 `r`/`b` 折算(`adc_cal_apply()`),以及对你要写进去的参数做合法带校验(`adc_cal_set()` / `adc_cal_set_ratio()`)。所以这条命令跑不通时,问题一定在 PC 侧的输入(表填错、量纲错),不在板子上。
**开工前先自检工具本身**(一次就够,10 秒):跑 `& '.venv\Scripts\python.exe' test/host/cal_fit.py --selftest`,期望末行 `=== cal_fit selftest: 11/11 PASSED (failed=0) ===`、exit 0(有任何失败 exit 1)。它跑的是金标向量回归(已知一组点,核对解出的 `r_q16` 与 `b` 是否逐位相等)加 4 条拒绝路径(点数不足、点位没拉开、单调反转、`r` 越带)——**固件里没有拟合实现之后,这是"解出来的 `r` 对不对"唯一的机器验证**,别跳过。
表在 `CALDATA` 注释标记之间(`--from-doc` 靠它提取,**勿删改标记**)。**每行一个点**:15 行 = `ua`/`un`/`ia` 三路 × 5 点。已知量列已按 §1 的建议档位填好,**读数格留空等你填**——两格都空的整行 = 本轮不测该点(某路有至少 3 个实点仍可解);只填一格 = 半填错误,脚本报 `INCOMPLETE` 并拒绝。**所以这张表刚拿到手时直接跑 `--from-doc` 必定 exit 2**(注入量已预填、读数为空 = 15 行全是半填)——那不是脚本坏了,是在提示你「读数还没填」。
<!-- CALDATA:BEGIN -->
| 路 | 序号 | 屏上读数 mV/mA | 注入已知量 V/A |
|---|---|---|---|
| ua | 1 | | 5 |
| ua | 2 | | 10 |
| ua | 3 | | 25 |
| ua | 4 | | 50 |
| ua | 5 | | 100 |
| un | 1 | | 5 |
| un | 2 | | 10 |
| un | 3 | | 25 |
| un | 4 | | 50 |
| un | 5 | | 100 |
| ia | 1 | | 0.5 |
| ia | 2 | | 1 |
| ia | 3 | | 1.25 |
| ia | 4 | | 1.5 |
| ia | 5 | | 2 |
<!-- CALDATA:END -->
前两列只是身份(路 + 序号,序号仅作行标识、不参与计算),后两列才是数据:**屏上读数**照抄 `meas:` 行那格(`ua`/`un` 是 mV、`ia` 是 mA,即 ×1000 那格,**别自己换算**);**注入已知量**填继保仪实际输出的伏/安。换量级时两列都要跟着改,别只改一边。
> ⚠ **同一路的 N 个点必须在同一个 `r` 下采集**(这是最容易踩、也最难一眼看出来的坑):屏上读数是**按下发到设备的变比 `r` 折算后**的显示值,所以只要中途改过 `r`,前后的读数就不是同一个标尺,混在一起拟合等于拿两把尺子量一条线。做法:**重新标定前先把该路读数清零重来**——不要拿"上一轮 `r=1000` 时读的 5 V / 50 V"和"这一轮 `r=554.69` 时读的 10 V / 100 V"拼成一路。这种混采的典型症状正是残差判据拦住你(`residual > 2% of y span`)——**看到这条拒绝先想"是不是跨了两个 r 时代采的",别急着怀疑前端非线性**。
> ⚠ **本轮不测的那一路,两列都要清空**(不只是清读数):只清读数、留注入量 = 半填行,脚本会为那一路打 5 行 `INCOMPLETE` 并以 **exit 2** 结束——即使另外两路全 OK,你也拿不到可用的 `WRITE-ALL`。整路两格都空才会被安静跳过(`SKIP: no filled points`)。台架现状是 **UN 无有效信号**,所以要跑 UA / IA 两路时,**先把 `un` 那 5 行的后两格全清掉**。
> **2026-11-12 台架那一轮的历史读数**——**那是两点算法下的结果**,留作样例(真实数据长这样、量级对不对可以照此眼校)。点位数与列结构已不适用新表,**别照抄**:
>
> | 路 | 零点 meas | 低点 meas | 高点 meas | 已知低点 | 已知高点 |
> |---|---|---|---|---|---|
> | ua | 50 | 9049.7 | 90176.4 | 5 | 50 |
> | un | 70 | | | 5 | 50 |
> | ia | 2 | 496.75 | 1985.49 | 0.5 | 2 |
>
> 那一轮解出 **UA `r = 554.687914` / `b = 0`、IA `r = 29.634259` / `b = 0`**,已写入设备
> (结果登记 → `docs/硬件平台/ADC通道映射说明.md` §7.3)。**新一轮 5 点最小二乘会解出不同的值**,
> 两组数不要混着用。
```powershell
& '.venv\Scripts\python.exe' test/host/cal_fit.py --from-doc docs/测试说明/专项验证/ADC多点标定执行流程.md
```
只想单解一路、不填文档时也可手填(`--x` = 读数序列 mV/mA,`--y` = 注入序列 V/A,逗号分隔、点数 3~8):
```powershell
& '.venv\Scripts\python.exe' test/host/cal_fit.py --sem ua --x 5021.5,10041.8,25024.1,50024.1,99933.0 --y 5,10,25,50,100
```
脚本对每路已填点做普通最小二乘,解出新的变比 `r` 与零点 `b`,最后打出一条合并写入命令(`WRITE-ALL:` 开头,**先全部 `--r` 再全部 `--b`**,直接接给 `cal_write.py`)。默认旧值 `ua`/`un` 取 1000.0、`ia` 取 29.4118、`b` 取 0;要覆盖时用 `--r-old` / `--b-old`。
**怎么判断结果能不能用**(按顺序看):
| 看什么 | 合格 | 不合格怎么办 |
|---|---|---|
| 每路 `OK` 行里的 **`res%`**(最大残差占已知量跨度的百分比) | **≤ 2 %** | 超了 = 有读数脱离直线(接线松动、读错格、该点工况没稳)。把 5 点读数与注入量对一眼,哪个点明显偏就复测那个点,**不要直接写** |
| 有没有 `REJECT` 行 | 没有 | 原因字符串就在 `REJECT` 后面,照字面读。**最先该看的是 `bad argument (|x|,|y| < 200000, k_q16 in (0,1e8], r_old in band)`**——它在拟合之前就拦,覆盖三类:① x/y 超出 ±200 V / ±200 A(成因是把 V 当 mV **多乘**了 1000,如 y 填 10000 而非 10);② `--r-old` 越带(填成比值如 0.5547 而非 554.69,或填 0);③ `k_q16` 非法(走文档表时基本不可能)。<br>**反向的单位错——x 列漏乘 1000(把 mV 填成 V,如填 10 而非 10000)不会在这里报**:漏乘后的 x 仍在合法值域内,只是一路走到拟合后把 `a` 放大 1000 倍,最后报 **`r_new out of band [1.0, 32767.99]`**。所以看到 `r_new out of band` **先排一下「x 列是不是少乘了 1000」**,别只往「变比真的越带」或「前端非线性」上想。<br>其余拟合类:`n outside [3,8]` 点数不在 3~8、`x span collapsed` 点位没拉开、`non-monotonic` 读数与注入量方向相反、`slope <= 0` 斜率非正、`\|b_new\| beyond 8192 codes` 零点越带、`residual > 2% of y span` 残差超限(非线性或削顶)。除 `bad argument` 外上面这些都是原文前缀,脚本还在半句后补具体说明(如 `x span collapsed (den<=0): readings not spread`)。另有 `BAD-TABLE` = 表还是旧的 6 列形态、`INCOMPLETE` = 半填行。按原因改表里对应格再跑 |
| 每路 `OK` 行里的 **`R2`**(决定系数) | 越接近 **1** 越好(0.9999 以上说明 5 个点几乎在一条直线上) | 明显偏低 = 点与点之间不成线性(前端非线性,或混进了不同工况的读数)。先查接线与工况稳定,**别用系数凑** |
| 末尾 `WRITE-ALL:` 行 | 存在且**含你填的全部路** | 只含部分路 = 有路被 `REJECT` 或实点不足 3 个(往上看那一路的提示),补齐后重跑 |
**不再看「新 r 相对旧 r 的偏差」**:那项是两点算法时代拿两个读数直接比出来的;多点方案里数值本身就会变,改用上面的 `res%` / `R2` 判拟合质量,写入后再按 §5 复注对表。
**「`OK` 行全绿、`WRITE-ALL` 也在,但 exit 2」几乎总是同一个原因**:某一路有半填行(只填了读数、或只填了注入量)。那是**错误**不是"跳过"——脚本用 exit 2 拦住你,正因为半填的点无法判断是"漏填"还是"本次不测"。本轮不测的整路,两格都要空。
脚本 **exit 0 = 可写、exit 2 = 有拒绝或半填行**(`REJECT` 一定大写,每行以 `OK ` 或 `REJECT ` 开头)。全部路都 `OK` 才进 §4 写入,别在 exit 2 的时候往下走。
## 4. 写入:`test/host/cal_write.py`
| 路 | `r` | `b` |
|---|---|---|
| `UA` | `0x8050` | `0x8048` |
| `UN` | `0x8053` | `0x804B` |
| `IA` | `0x8054` | `0x804C` |
```powershell
& '.venv\Scripts\python.exe' test/host/cal_write.py --r 0x8050=995.99 --b 0x8048=-1 --read 0x8050,0x8048 --expect 995.99,-1
```
每路**先 `r` 后 `b`**(`b` 经 `adc_cal_set()` 置 `VALID`;`b` 必须整数码值);`SUMMARY PASS` + C_RD 读回差 <0.1 才进下一路。收到 PN → 看串口 `[ERR] set ch=... rejected`(`r < 1.0` 或 `|b| > 8192`)。
**为什么 `WRITE-ALL` 坚持「先全部 `r` 再全部 `b`」而不是一路一路成对写**:`VALID` 是写 `b` 时置的,而置 `VALID` 的前提是**该路的 `r` 已经配置好**(`r = 0` 时 `VALID` 必为 0)。所以顺序必须是 `r` 先落地、`b` 再落——反过来会出现「`VALID` 亮了但变比还是出厂值」的中间态,读数当场是错的量级,而保护恰好在那一刻解卡。`cal_write.py` 也是按这个顺序收参数的:全 `r` → 全 `b`。
## 5. 验收与解卡
1. **每路完成**:`cal:` 行 `vl` 位图对位点亮(`UA` bit0、`UN` bit3、`IA` bit4,三路齐 `0x19`);**复注 2~3 个点对表**(首末两点必查,中间挑一个);FTP 取 `/config.ini` 核 `[adc_cal]`/`[adc_cal_ofs]`/`[adc_cal_sec]`;断电重启后 `vl` 与读回不变。
2. **解卡(最后一路 `b` 前)**:先把各通道置 **50 V / 0.5 A 附近**——**别留 0**(零压解锁会被判低电压);跳闸回路若接真断路器先确认不驱动。最后一笔 `b` 后应打 `calibration VALID -> protection unlocked` + SOE。**严禁伪造 `valid` 位**。
3. **回写**:结果登记进 `docs/硬件平台/ADC通道映射说明.md` §7.3(变比与零点实测表,注明本轮是 5 点最小二乘),
§9 台阶第 4 级按已标定路数标 🟡/✅(第 5 级留送检);日志按 `docs/测试说明/测试数据/boot_log_data/` 命名归档。
> **2026-11-12 那一轮的结果与遗留**(照抄现状,别当成"全标完了";**那一轮用的是两点算法**):UA / IA 两路标定并落盘,
> 断电重启后读回不变;`vl=0x11`(UA bit0 + IA bit4),`cl=0xe6`。**UN 未标**(台架无有效信号),
> 三路不齐 → 保护判据仍打 `[PROT] uncalibrated -> protection blocked` 并停走,**属预期**。
> 补完 UN 才是"三路齐、自动解卡"的完整验证。**另外**:那一轮暴露出配置引擎热重载吞段的缺陷
> (写进去的 `r`/`b` 约 8 s 被打回出厂值并覆写文件),已修复并加机器钉,
> 见 `docs/子系统设计/配置文件设计说明.md` §4-(3)。
@@ -13,7 +13,7 @@
|---|---|---|---|---|---|
| 第一幕 | 枚举埋点与修复上板 | **已完成(2026-11-02,远程)** | 无 | 改码加埋点 → 构建 → 烧录回读 → 远程开回放页 → 读 FR 码定性 → 修复重烧 | `docs/子系统设计/故障录波设计说明.md` §10「回放页枚举恒空缺陷修复记录」 |
| 第二幕 | 注量对表 | **已闭环(2026-11-06)**——注量对表 2026-11-04 由 #40 交流轮跑完;坏段/空态画面 2026-11-06 台架远程轮拍毕,本幕现场无需重做 | ~~接 UA 发生器线 1 次、拔 1 次;面板按 2 次键(或让 agent 远程注键)~~ 已由远程轮与 #40 消化 | 记心跳基准 → FTP 拉段 → `wave_read` 量四样 → `meas:`/104 YC 对表 → 削顶注大一遍 → 坏段上板看回放页绝不平线 | `docs/子系统设计/故障录波设计说明.md` §10「板级」行 +「板级·回放页」行后半 +「回放页坏段/空态画面闭环记录」 |
| 第三幕 | 保护触发对时刻(src=P) | **要到场**,还含**两个由你拍板的决定** | IA 两点标定各接一次线 + 过流加大到 UI 见数值过 2 A | 读码算 k/b → 写配置生效 → 验证解锁 → 触发后对 start.log 时刻/段号/src=P | `docs/子系统设计/故障录波设计说明.md` §10「板级·触发来路」行 |
| 第三幕 | 保护触发对时刻(src=P) | **要到场**,还含**两个由你拍板的决定** | IA 多点标定各接一次线 + 过流加大到 UI 见数值过 2 A | 读码算 k/b → 写配置生效 → 验证解锁 → 触发后对 start.log 时刻/段号/src=P | `docs/子系统设计/故障录波设计说明.md` §10「板级·触发来路」行 |
| 第四幕 | bench 自抓与卷占用 | **已完成(2026-11-07,远程)**——三判据逐条对上,且顺手修掉 bench 定时器判据缺陷一枚(F0,见闭环记录);无需重做 | ~~烧 bench 构建 → 造占卷 ≥2 s → 看 `err`+1、**一条** `ring abandoned`、同号重写 → 还原产品构建~~ 已由远程轮消化 | 同左(已全部执行:长占卷 72.6 s 静默自弃 err 1→15 零留痕 + 临界命中唯一留痕 err 恰 +1 同号重写 + 104/UI 占卷中照常) | `docs/子系统设计/故障录波设计说明.md` §10「bench 定时自抓与占卷弃段观察闭环记录」 |
幕间依赖:**第二幕的"坏段上板看回放页"一步已不再被阻塞**(第一幕 2026-11-02 已修好并板级闭环);其余各幕互相独立,可以先做不用等的。
@@ -103,13 +103,13 @@ flowchart LR
**先讲人话**:过流启动录波的代码路已接在 `protect_task.c` 的启动边沿上(判据一 picked,录波同拍请求),但**保护判据现在整机闭锁**——`adc_cal_flags()` 的 VALID 位对 UA/UN/IA 三路都没置位,`protect_task` 直接停走判据。要让保护真出口,**必须先把这三路标定**;这正是 2026-10-25 你裁定"保持闭锁、不用万用表走捷径"守着的那道门。
- **决定一(解锁)**:这一幕要不要用**发生器为参考**给 UA/UN/IA 做两点标定换保护触发路(src=P)验证?它**不是送检级标定**(端子变比是按参数算定的标称值,见 `docs/硬件平台/ADC通道映射说明.md` §7.2),做出来的工程量是"发生器刻度下的近似值"。**点头 → 往下走;摇头 → 第三幕整体顺延到标准源轮,本文其余各幕照做。**
- **决定一(解锁)**:这一幕要不要用**发生器为参考**给 UA/UN/IA 做多点标定换保护触发路(src=P)验证?它**不是送检级标定**(端子变比是按参数算定的标称值,见 `docs/硬件平台/ADC通道映射说明.md` §7.2),做出来的工程量是"发生器刻度下的近似值"。**点头 → 往下走;摇头 → 第三幕整体顺延到标准源轮,本文其余各幕照做。**
- **决定二(还锁)**:这一幕验完,把标定清回闭锁(还原出厂系数)还是**留着 valid** 让保护继续在线(此后 UI 显示与 104 遥测的二次值都按这份近似标定出数——**留着就要在台账注明非送检级**)。
步骤(决定一通过后):
1. **到你接线**:UA 两点——近零(发生器 0 V 或最低档)与满度附近(如 8 V)各录一次;UN、IA 同法(IA 的注入端子与换算照 `docs/测试说明/专项验证/ADC前端注入验证流程.md` §8.3 同款接线,通道与量程归属看 `docs/硬件平台/ADC通道映射说明.md`)。每次换点说一句"点了",agent 抓该点码值。
2. **[agent]** 两点公式(算术核 `App/algo/adc_cal.c` 的 `adc_cal_two_point()`)算各路 k/b → 经 **[run_par] 写者链**落配置(`App/algo/run_par.c` 会同步回写 `[adc_cal]` 并置 valid)→ 上传 `/config.ini` → 复位生效。
1. **到你接线**:UA 多点(**≥3 个,建议 5 个**:近零一档、满度附近一档、中间再铺 1~3 档)各录一次;UN、IA 同法(IA 的注入端子与换算照 `docs/测试说明/专项验证/ADC前端注入验证流程.md` §8.3 同款接线,通道与量程归属看 `docs/硬件平台/ADC通道映射说明.md`)。**只录近零 + 满度两个点解不出来**——多点最小二乘要求 ≥3 点,少于 3 点直接被拒。每次换点说一句"点了",agent 抓该点码值。
2. **[agent]** 多点最小二乘拟合(算术核 PC 侧的 `test/host/cal_fit.py`——**固件里没有拟合代码**)算各路 r/b → 经 **[run_par] 写者链**落配置(`App/algo/run_par.c` 会同步回写 `[adc_cal]` 并置 valid)→ 上传 `/config.ini` → 复位生效。
3. **[agent]** 验证解锁:串口 `protect` 心跳恢复判据走数、UI 实时数据"未标定"徽标消失、104 YC 开始出浮点量。
4. **到你加注**:给 **IA** 慢慢加(定值基准 1 A:OC3 段 = 2×Ir = **2 A 二次**最灵敏;OC1/OC2 是 10/5 A——**加到 UI 遥测 IA 显示刚过 2 A 即可**,不必真到一次侧大电流)。
5. **[agent]** 30 s 内收证据四连:`wave:` 心跳 **src=P** 且 seg+1;`/log/start.log` 新增一条过流启动;两者**时刻对齐**(段头 t0 与 start.log 时刻差在秒级内,同时看 `armed`——只盯 ovf/计数有已知容差,`docs/子系统设计/故障录波设计说明.md` §9);104 遥信该元件变位上送。
+87 -26
View File
@@ -125,14 +125,14 @@ STM32(U17)为 LQFP144 脚号。
### 7.1 从端子到码值:链路四段口径
要把「端子上的电压」换算成「屏上的读数」,得先知道这条链路上**哪一段会改数值**。这里把链路切成四段(一段 = 信号经过的一节),逐段给口径与状态;**下表是本节主表**,后面的内容按同样的段名展开。③ 段已有台架实测——变比 **1:1**(斜率实测见 §8.1);④ 段(子板/端子板变比)出厂按子板参数登记为电压族 606.06 : 1、电流族 29.4118 A/V,**2026-11-12 已由两点标定在 UA / IA 上实测覆盖**(§7.3);子板原理图仍不在仓库内。
要把「端子上的电压」换算成「屏上的读数」,得先知道这条链路上**哪一段会改数值**。这里把链路切成四段(一段 = 信号经过的一节),逐段给口径与状态;**下表是本节主表**,后面的内容按同样的段名展开。③ 段已有台架实测——变比 **1:1**(斜率实测见 §8.1);④ 段(子板/端子板变比)出厂按子板参数登记为电压族 606.06 : 1、电流族 29.4118 A/V,**2026-11-12 已由标定实测覆盖 UA / IA**(那一轮是两点算法,§7.3);子板原理图仍不在仓库内。
| 段 | 这一段在问什么 | 关系 | 状态 |
|---|---|---|---|
| ① 语义 ↔ 网名 ↔ 板级网名 ↔ 转换器代码通道 | “UA 到底是哪个通道号” | §2/§3/§4/§5 的 17 路映射表 | **定死**(本文件为唯一权威) |
| ② 转换器引脚电压 ↔ 码值 | “脚上是 1 V,读出来几个码” | TPAFE `U_pin = code × 152.59 µV`(code 带符号);STM32 `U_pin = code × 805.66 µV` | **定死**(纯转换器事实,见下表) |
| ③ `AINn` ↔ `ADCn` / 转换器引脚(板内串联电阻那一节) | “串在中间的电阻有没有把电压分掉” | **变比 = 1:1**:`ADCn` 节点只有 {串阻.2, 滤波 C, 转换器引脚},无对地元件 | **定死**(网表 + 台架实测,见 §8.1:端子侧注入斜率 6544.2 码/V vs 引脚侧理论 6553.6,差 0.14 %,不存在分压) |
| ④ 语义端子(二次端子)↔ `AINn`(子板/端子板那一节) | “端子上的电压,进到板内还是同一个数值吗” | 子板/端子板变比:出厂登记 电压族 UA/UB/UC/UN **606.06 : 1(V/V)**、电流族 IA/IB/IC/IN **29.4118 A/V**(按子板参数算定,算式见 §7.2);**UA 实测 554.69、IA 实测 29.634**(两点标定,见 §7.3) | **UA / IA 已实测定死**(2026-11-12 台架)+ **UN 待标**(台架无有效信号,用户裁定本轮不测)——屏上已显端子二次值(`eng = 1`),保护判据因 UN 缺 VALID 仍停走 |
| ④ 语义端子(二次端子)↔ `AINn`(子板/端子板那一节) | “端子上的电压,进到板内还是同一个数值吗” | 子板/端子板变比:出厂登记 电压族 UA/UB/UC/UN **606.06 : 1(V/V)**、电流族 IA/IB/IC/IN **29.4118 A/V**(按子板参数算定,算式见 §7.2);**UA 实测 554.69、IA 实测 29.634**(2026-11-12 两点算法那一轮,见 §7.3) | **UA / IA 已实测定死**(2026-11-12 台架)+ **UN 待标**(台架无有效信号,用户裁定本轮不测)——屏上已显端子二次值(`eng = 1`),保护判据因 UN 缺 VALID 仍停走 |
**芯片级口径**(② 段,与前端网络无关):
@@ -154,7 +154,7 @@ STM32(U17)为 LQFP144 脚号。
1. **ROM 默认系数按 ② 段(引脚电压 ↔ 码值)冻结**:TPAFE 通道 `k = 152.59 µV/码`、STM32 通道 `k = 805.66 µV/码`;没有配变比的通道,折算输出 = **ADC 引脚电压 V**(`eng = 0`)。该口径与 ③④ 变比何时定死无关,冻结当日即成立且此后不因 ④ 到手而改动——这是 M4 承诺边界止于"引脚电压"的依据(`docs/算法/采集与算法层设计说明.md §13.5`)。
2. **板级系数 = 引脚侧系数**(152.59 / 805.66)。305.18 / 1611.3 µV/码 只属 ±10 V 档的 LSB(芯片手册口径),**不是本板系数**,不得当板级系数用。
3. **满量程必须写明参考点**:TPAFE 通道满量程 = ±5 V **@ 引脚**(跨度 10 V);③④ 均已定死(④ 值见 §7.2 / §7.3),端子侧换算允许写"引脚侧数值 × ④ 段变比";但某一路 `VALID` 未置位之前**严禁**把"码 × 152.59 µV × 变比"当**已验收的**端子二次值写进精度承诺——`VALID` 回答的是"准不准",变比回答的是"什么单位",两者互不派生(`docs/算法/采集与算法层设计说明.md` §13.3)。
4. **仍待实测的只有 UN 一路的两点标定与精度等级送检**(前者决定保护能否解卡、后者决定能报几级)。实测斜率与 ② 段理论值偏差 >2 % 时**先查前端**(分压/变比/焊接),**不得用系数凑错斜率**——那会把硬件的错固化成"标定值"。
4. **仍待实测的只有 UN 一路的多点标定与精度等级送检**(前者决定保护能否解卡、后者决定能报几级)。实测斜率与 ② 段理论值偏差 >2 % 时**先查前端**(分压/变比/焊接),**不得用系数凑错斜率**——那会把硬件的错固化成"标定值"。
### 7.2 ④ 段变比登记(2026-11-11 台架实测修正)
@@ -168,7 +168,7 @@ STM32(U17)为 LQFP144 脚号。
> 供后来者判断"是不是又算错了一遍")。子板原理图仍不在仓库内,所以这条比值目前只有实测证据、
> 没有图纸旁证。
>
> ⚠ **本节 1000.0 也已被推翻**:2026-11-12 两点标定实测 UA = **554.69 V/V**
> ⚠ **本节 1000.0 也已被推翻**:2026-11-12 那一轮标定(两点算法)实测 UA = **554.69 V/V**
> (见 §7.3)。那次单点粗测的接线让 UA 的 PT 一次侧只拿到一半电压,反算比值正好翻倍。
> 本节保留原样是为了留证"单点粗测为什么不可信",**当前有效值一律以 §7.3 为准**。
@@ -183,7 +183,7 @@ STM32(U17)为 LQFP144 脚号。
(参数算定 + 实测反算)互证,可信度最高。
- **电压族 1000.0 V/V 只有单点粗测**:5 V 注入时引脚侧只有约 5 mV ≈ 33 码,1 LSB = 3 % 读数,
所以 3 位小数给出的比值区间是 **909 ~ 1111**。这个数是"量级对、精度未定",
**不是**可以写进铭牌的精度指标——送检前必须用标准源两点标定重写(见本节末「精度从哪来」)。
**不是**可以写进铭牌的精度指标——送检前必须用标准源多点标定重写(见本节末「精度从哪来」)。
- 若真值是 606.06,5 V 注入应显 0.008 V(差 60 %),而屏面实际给 0.005——分辨率完全够分辨这两个值,
所以这不是"测量误差",是原参数算定假设与实物不符(最可能是分压电阻实际值≠报参数,
或子板型号与报参不是同一款)。
@@ -198,13 +198,19 @@ STM32(U17)为 LQFP144 脚号。
| 100 V | 100 mV | 655 | 0.15 % |
| 120 V | 120 mV | 786 | 0.13 % |
故两点标定**不要用 5 V 这种小注入**:建议取 20 V 与 120 V 两点(都在 TPAFE ±5 V 引脚量程内,
且码值足够大)。这也是本节的 1000.0 只能算"粗测"的原因。
故标定**不要用 5 V 这种小注入单点定斜率**:建议在 20 V 以上铺点(都在 TPAFE ±5 V 引脚量程内,且码值足够大)。这也是本节的 1000.0 只能算"粗测"的原因。
> **但 5 V 作为多点里的一个端点是可以用的**:上表的 3.05 % 是"**只**拿 5 V 一个点当整条线的斜率"时的账;放进 5 点最小二乘里,5 V 那点只是五个约束之一,它的量化误差被权重摊薄(端点权重最高的是"位置",不是"单个读数")。真正要避开的是"用 5 V 单点反算整条变比"——那正是 2026-11-11 得到 1000.0 的做法。
> **实际执行时降了量级**(用户裁定 2026-11-12,安全优先):台架改注 **5 V / 50 V**、
> **0.5 A / 2 A**。跨度缩小后每点 1 LSB 摊到结果里约 0.7 %(电压族)/ 0.6 %(电流族),
> 仍在保护判据 3~5 % 的口径内,够用;但**够不上 0.5 级计量**——那要日后另跑高点轮,
> 两轮结果不混用。执行卡 → `docs/测试说明/专项验证/ADC两点标定执行流程.md`。
> 两轮结果不混用。执行卡 → `docs/测试说明/专项验证/ADC多点标定执行流程.md`。
> **标定点数与算法在那之后又改了一版**(2026-11-13):从"两个点直接连线"改为
> **N 点普通最小二乘(3 ≤ N ≤ 8,台架按 5 点执行)**,点位铺开在 5–100 V / 0.5–2 A。
> 为什么改:两点时单个读数的误差**原封不动**变成结果误差;点数多了最小二乘把单点偏差摊平,
> 且能顺手给出残差与 `R²` 两个"这条线到底直不直"的判据——两点连线在数学上永远完美,
> 你没有任何独立证据说它对。上面 0.7 % / 0.6 % 是**两点跨度**的账,多点方案的实测数字等台架跑完再填。
**变比进固件的形式(为什么是独立一维,不并进 `k`)**:`r` 存 int32 Q16 比值,
电压族 `ADC_CAL_R_Q16_VOLT = 65 536 000`(= 1000.0 × 65536,无舍入)、
@@ -213,27 +219,31 @@ STM32(U17)为 LQFP144 脚号。
Q16 后是 1.0e10,而 int32 上限只有 2.147e9;UB/UC 走 STM32 更到 5.28e10。折算模型见
`docs/算法/采集与算法层设计说明.md` §13.2。
**精度从哪来**:出厂默认值只保证量纲与量级;**精度**必须靠标准源两点标定:
在端子上加两个已知量、读两点的示值(串口 `meas:` 行,二次值域),代进
`adc_cal_two_point()` 算出该路的 `r` 与 `b`,经 `adc_cal_set_ratio()` / `adc_cal_set()` 写入
并落盘。这一步做完才有 `ADC_CAL_F_VALID`,保护判据才会解卡
(`docs/算法/采集与算法层设计说明.md` §13.3 / §13.4)。台架把整条流程做完了两路,
求解与写入都已工具化(`test/host/cal_two_point.py` / `test/host/cal_write.py`),
执行步骤属主 `docs/测试说明/专项验证/ADC两点标定执行流程.md`,实测结果见 §7.3。
**精度从哪来**:出厂默认值只保证量纲与量级;**精度**必须靠标准源多点标定:
在端子上加 N 个(3 ≤ N ≤ 8,台架按 5 个)已知量、读每点的示值(串口 `meas:` 行,二次值域),
把这组点喂给 `test/host/cal_fit.py`(**PC 侧,拟合的唯一实现**——固件里没有拟合代码)做普通最小二乘,解出该路的 `r` 与 `b`,经
`adc_cal_set_ratio()` / `adc_cal_set()` 写入并落盘。这一步做完才有 `ADC_CAL_F_VALID`,
保护判据才会解卡(`docs/算法/采集与算法层设计说明.md` §13.3 / §13.4)。
台架把整条流程做完了两路(**那一轮是两点算法**),
求解与写入都已工具化(`test/host/cal_fit.py` / `test/host/cal_write.py`),
执行步骤属主 `docs/测试说明/专项验证/ADC多点标定执行流程.md`,实测结果见 §7.3。
**历史值与作废依据**(别照着旧数算):原按"子板 PT 2 mA/2 mA、输入侧 200 kΩ、输出侧 330 Ω"算得
变比 = 200000 ÷ 330 = 606.0606…。算术没问题(复核过两遍),**错在前提**:这组参数与实物不符。
同一组参数推出的"额定点端子 ≈400 V → `AINn` 侧 0.66 V"也因此不再成立。若将来拿到子板原理图,
正确的做法是**用图纸复核实测量级**、而不是用图纸替换实测——两者冲突时以实测为准。
### 7.3 两点标定实测结果(2026-11-12 台架)
### 7.3 标定实测结果(2026-11-12 台架,两点算法那一轮)
> **这一节要你干什么**:给出**当前这台设备实际在用的**变比与零点,以及 2026-11-11 那个 1000.0 为什么错。
> 这是 `[adc_cal_sec]` / `[adc_cal_ofs]` 段里现在值的来源;执行步骤属主是
> `docs/测试说明/专项验证/ADC两点标定执行流程.md`。
> `docs/测试说明/专项验证/ADC多点标定执行流程.md`。
>
> ⚠ **本节整表是两点算法(两个点直接连线)下的历史实测**,保留原值不动。标定算法已改为
> **N 点(≥3,台架按 5 点)普通最小二乘**,新一轮重标的结果待填(见本节末段)。
按执行卡流程在端子上注标准量、读串口 `meas:` 行、用 `test/host/cal_two_point.py` 求解、
经 104 定值段写入并落盘,实测结果:
按执行卡流程在端子上注标准量、读串口 `meas:` 行、用**当时的两点求解脚本**求解、经 104 定值段写入并落盘,
实测结果(此后这条链已换成多点求解器 `test/host/cal_fit.py`):
| 通道 | 状态 | `r`(变比) | `b`(零点,码) | 相对出厂值 |
|---|---|---|---|---|
@@ -242,7 +252,7 @@ Q16 后是 1.0e10,而 int32 上限只有 2.147e9;UB/UC 走 STM32 更到 5.28
| UN | ⬜ 未标定 | 出厂 1000.0 | 0 | 台架 UN 通道无有效信号,用户裁定本轮不测 |
- **IA 与出厂值只差 0.76 %**:电流族出厂值本来就准,标定只是把它压到小数级——这也验证了
"两点标定链路本身没算错"。
"那一轮的两点标定链路本身没算错"(链路可信,与算法该用几点无关)。
- **UA 554.69 与按子板参数算定的 606.06 同量级(差 8.5 %)**,而 2026-11-11 单点粗测给的 1000.0
偏大 1.8 倍。原因已定位:那次测量的接线把 `UAN`/`UBN`/`UCN` 并在一起、各串 200 kΩ 后回到
继保仪 `UN`,形成一个分压网络,**UA 的 PT 一次侧只拿到一半电压** → 引脚侧读数减半 →
@@ -255,6 +265,57 @@ Q16 后是 1.0e10,而 int32 上限只有 2.147e9;UB/UC 走 STM32 更到 5.28
保护判据保持停走(`cal:` 行 `vl=0x11`、`cl=0xe6`;`[PROT] uncalibrated -> protection blocked`)。
这是预期行为,不是缺陷;UN 标定完成前**不得**绕过。
**那一轮用的是两点算法;新一轮改用 5 点最小二乘重标,结果待填**(2026-11-13):
| 项 | 2026-11-12 那一轮 | 新一轮 |
|---|---|---|
| 算法 | 两点连线,`r`/`b` 由两个读数直接解出 | N 点(≥3)普通最小二乘,台架按 **5 点** 执行 |
| 点数 / 跨度 | 2 点(电压 5 V / 50 V、电流 0.5 A / 2 A) | 5 点,铺在 **5–100 V / 0.5–2 A**,含端点与中点 |
| 凭什么说这条线对 | 说不出来——两点连线在数学上永远完美,没有任何独立证据 | 每次求解额外给出**最大残差占跨度的百分比**与 **`R²`**,可直接看出点是否偏离直线 |
| 本轮 `r` / `b` | UA `554.687914` / 0、IA `29.634259` / 0(上表,历史值) | **待填**(台架跑完后登记在此) |
**为什么改**:两点标定时单点读数误差 100 % 传进结果——5 V 点抖 0.5 %,整条变比就跟着偏 0.5 %,且没有任何
办法发现它抖了;点数多了最小二乘把单点偏差摊平,个别点抖一下不再决定整条线。更实际的理由是**可判读**:
两点解出的 `r`/`b` 无论接线对不对都"算得出来",只能靠外部旁证(比如与参数算定值比)判断好坏;
多点拟合自带残差与 `R²`,一条不直的线当场暴露。判据与执行步骤见
`docs/测试说明/专项验证/ADC多点标定执行流程.md` §3。
### 7.4 标定区间内外的独立核验(2026-11-13)
> **这一节要你干什么**:回答"标定完之后,这套折算在**标定点之外**还准不准"。
> 做法是注几个**压根没参与求 `r` 的**电压/电流,看屏上读数偏多少——这是标定结果唯一的外部检验,
> 与"拟合残差好不好看"是两回事(残差只说明点与自身拟合线的贴合度,说明不了真值)。
**核验读数**(继保仪注入,串口 `meas:` 行读数,多拍取中位数):
| 通道 | 注入已知量 | 屏上读数 | 偏差 | 拍数 / 抖动 |
|---|---|---|---|---|
| UA | **10.000 V**(非标定点) | 10 041.77 mV | **+0.42 %** | 11 拍中位数,抖动 0.17 % |
| UA | **100.000 V**(非标定点,区间上限) | 99 933.02 mV | **−0.067 %** | 9 拍,抖动 0.02 % |
| IA | **0.500 A**(非标定点,区间下限) | 501.58 mA | **+0.32 %** | 11 拍中位数,抖动 0.27 % |
| UN | 全程注入 | 无有效信号 | — | 噪声底 86~93 mV,保护闭锁 |
- **UN 仍然测不出来**:注了量也只有噪声底(86~93 mV),与 §7.3 那条"台架 UN 通道无有效信号"是同一个现象,
所以 UN 依旧未标、保护依旧闭锁。**这不是新缺陷**,是同一件事的再次确认。
- **10 V 与 100 V 两个点都落在 ±0.5 % 内**,100 V 端点更准(−0.067 %)——标定区间的边缘没有翘边。
**四点统一折算回引脚电压后的斜率**(同一路不同注量,斜率应当是一个常数;它抖多少就是这条链的非线性有多少):
| 端子注入 | 折算回引脚电压的斜率 |
|---|---|
| 5 V | 1.8106 mV/V |
| 10 V | 1.8103 mV/V |
| 50 V | 1.8037 mV/V |
| 100 V | 1.8016 mV/V |
极差 **0.497 %**。结论:**100 V 未饱和、前端在线性区**——若前端在高压段开始压缩,100 V 那点的斜率会明显小于
5 V 那点(分压器/运放输出被削),而实测四点斜率单调微降 0.5 %,属于分压电阻容差与读数抖动同量级,
不是饱和特征。
⚠ **边界口径(别误读这张表)**:这两点(以及上表的 5 V / 50 V)**都不是标定点、不参与求 `r`**,
它们只作"线性证据"——证明已有的 `r`/`b` 在标定点之外仍然成立。要改 `r`/`b` 必须回到
`docs/测试说明/专项验证/ADC多点标定执行流程.md` 的 N 点流程重跑,**不许拿核验点反推系数**。
---
## 8. 逐通道验证方法(上板自检口径)
@@ -262,7 +323,7 @@ Q16 后是 1.0e10,而 int32 上限只有 2.147e9;UB/UC 走 STM32 更到 5.28
1. **TPAFE 侧**:对目标 `AIN` 注入 1 V DC,观察对应 `buf[i]` 变化(UA→`buf[6]`、UN→`buf[5]`、IA→`buf[2]`);**语义与下标不符即映射错**。判据不需要示波器:① 用固件帧计数替代"`BUSY` 有脉冲"——注入前后 `tpafe5160_frame_seq()` 仍严格 1000 Hz 递增即等价;② 幅值判据用万用表读注入点实际电压 + 同时读 `adc_input_raw()` 码值,三点线性拟合(R² ≥ 0.999)。
2. **STM32 侧**:对目标引脚(如 PC4=UB)注入 0.5 V,读 `ADC_CHANNEL_14` 应变化;若不变而相邻通道变化 → 通道宏写错(见 §5 警告)。映射的**代码侧**一致性有两道保证:① `App/algo/adc_input.c` 的 `k_adc_map[]` 与 CubeMX 标签(`ADC17_UB`=PC4 等)逐条对齐;② 开机自检 `adc_input_init()` 校验每个 STM32 语义通道都落在 `k_stm32_rank_ch[]` 扫描序列内(挡"映射到不扫描的通道 → 恒读陈旧值")。
3. **备用通道**:RESERVED 路不接入任何语义,UI 与上报里不得出现;若实测有读数漂移,只记录不消费。
4. **端子侧变比**:上面 1/2 两条都只到 **ADC 引脚**。③ 段(`AINn` ↔ 转换器引脚)已由网表追线定死为 **1:1**(`ADCn` 节点无对地元件,拓扑图见 §7.1),**板内没有未知比值**;④ 子板/端子板变比出厂按子板参数登记(电压族 606.06 : 1、电流族 29.4118 A/V),**已由 2026-11-12 两点标定在 UA / IA 上实测覆盖**(554.69 V/V、29.634 A/V,见 §7.3;UN 未标)。故**不得**用"2:1 分压"换算出二次值;端子口径一律按 §7.1 分段表与 §7.2 / §7.3 登记写。
4. **端子侧变比**:上面 1/2 两条都只到 **ADC 引脚**。③ 段(`AINn` ↔ 转换器引脚)已由网表追线定死为 **1:1**(`ADCn` 节点无对地元件,拓扑图见 §7.1),**板内没有未知比值**;④ 子板/端子板变比出厂按子板参数登记(电压族 606.06 : 1、电流族 29.4118 A/V),**已由 2026-11-12 标定实测覆盖 UA / IA**(那一轮是两点算法;554.69 V/V、29.634 A/V,见 §7.3;UN 未标)。故**不得**用"2:1 分压"换算出二次值;端子口径一律按 §7.1 分段表与 §7.2 / §7.3 登记写。
### 8.1 静态注入实测记录
@@ -298,7 +359,7 @@ Q16 后是 1.0e10,而 int32 上限只有 2.147e9;UB/UC 走 STM32 更到 5.28
**IA 前端差分滤波 = 低通 fc ≈ 796 Hz**:C35 = 100 nF 跨接差分对,与 R19/R21 各 1 k([`V0.1.tel`](V0.1.tel):49)构成一阶低通;拓扑为 1 k 串联 + 1 k 接差分负端、不分压(`docs/产品需求/产品需求设计文档.md` FR-ADC-5)。**250 Hz 的 −4.4 % 就是这颗电容在该频点的真实衰减,板端读数忠实**,工频 50 Hz 仅 −0.2 % 不受影响。谐波测量不够用——同拓扑外推:5 次 ≈ −4.6 %(出 ±2 % 判据)、7 次 −8.5 %、9 次 −13.0 %、11 次 −17.7 %、13 次 −22.6 %、15 次 −27.2 %、21 次(1050 Hz)−39.6 %;C35 改 10 nF 则 fc ≈ 8 kHz、21 次仅 −0.9 %。**谐波功能产品化的硬件前置 = 板改小 C35 + 清点其余各路差分滤波电容容值**(登记 `docs/任务规划/登记簿.md` §1)。**为什么改板而不是软件逐阶修正**:修正系数依赖这颗电容的实际容值,而它有容差、随温度漂,每块板、每个温度都不一样,修正表跟不上;二次谐波制动这类“拿某次谐波幅值与基波比值”的判据,比值被前端畸变后判定就不可信。换 10 nF 后测量带内是平的,板端读数直接可信。证伪条件(有示波器再复核):该低通预测 250 Hz 差分分量额外滞后 ≈17°;模型与三点拟合 `docs/测试说明/测试数据/boot_log_data/20261104_ac_ia_rc_model.txt`。
**边界**:本节不证端子二次值(④ 段变比已算定、两点标定未做,`eng` 仍为 0,见 §7.2)/ 精度等级(要标准源)/ 跨转换器相位(V0.1 硬件缺陷)/ THD。
**边界**:本节不证端子二次值(④ 段变比已算定、标定未做,`eng` 仍为 0,见 §7.2)/ 精度等级(要标准源)/ 跨转换器相位(V0.1 硬件缺陷)/ THD。
---
@@ -320,7 +381,7 @@ Q16 后是 1.0e10,而 int32 上限只有 2.147e9;UB/UC 走 STM32 更到 5.28
| 1 通路活 | 9 路都在转换、没串道、极性没反? | ✅ 2026-10-27 已证 |
| 2 静态引脚电压 | 注 1 V 直流,读数是不是 1 V? | ✅ 2026-10-27 已证(六项判据全 PASS,§8.1) |
| **3 动态引脚波形** | **注 Vpp 2.828 V 正弦(板上读数 ≈1 V),算出来还是不是 1 V?** | **✅ 2026-11-02 / 11-04 已跑两轮、六轮全部闭合**(削顶 2 Hz 档与复位复核经用户裁定 2026-11-04 关闭;谐波 B 行超差已归因板端前端 RC fc≈796 Hz → §8.2;实测结论 §8.2) |
| 4 端子二次值 | 引脚上这 1 V 对应端子侧几 V? | 🟡 **UA / IA 已由两点标定落地**(2026-11-12,见 §7.3;屏上已显二次值、`eng = 1`);UN 台架无有效信号未标,保护仍闭锁 |
| 4 端子二次值 | 引脚上这 1 V 对应端子侧几 V? | 🟡 **UA / IA 已由标定落地**(2026-11-12 两点算法那一轮,见 §7.3;屏上已显二次值、`eng = 1`);UN 台架无有效信号未标,保护仍闭锁 |
| 5 精度等级验收 | 额定工况下整条链误差够几级? | 🟡 等标准源(本轮继保仪标定只到保护口径 3~5 %,够不上 0.5 级计量) |
**三条结论**:
@@ -330,7 +391,7 @@ Q16 后是 1.0e10,而 int32 上限只有 2.147e9;UB/UC 走 STM32 更到 5.28
2. **第 3 级已于 2026-11-02 / 11-04 台架闭环,全程没用到任何外部资源**:一台能出 50 Hz 正弦的交流信号发生器,
接在**已经验证过的那个注入点**上就行。它比第 4、5 级安全一个量级——只需 ±2 V 以内的正弦,
而端子级验证要上 100 V / 220 V 二次值。
3. **第 4 级已部分落地、第 5 级在等外部**:④ 端子变比已由 2026-11-12 两点标定**实测得出**
3. **第 4 级已部分落地、第 5 级在等外部**:④ 端子变比已由 2026-11-12 标定**实测得出**(两点算法那一轮)
(UA / IA,见 §7.3),屏上显的已是二次值、`eng = 1`;UN 台架无有效信号未标,
三路齐不了 → 保护判据仍停走。⑤ 精度等级要等标准源送检。开工前置见
`docs/算法/采集与算法层设计说明.md` §13.13。
@@ -349,9 +410,9 @@ Q16 后是 1.0e10,而 int32 上限只有 2.147e9;UB/UC 走 STM32 更到 5.28
| ⑥ 量纲回归用例(不该动作时不动作)通过 | ✅ | `test/host/prot_dim/`,口径 `docs/算法/采集与算法层设计说明.md` §13.6 |
**所以差的是"台架面",它分两半**:动态这半已于 2026-11-02 / 11-04 台架闭环(§8.2);
端子这半 2026-11-12 已由两点标定拿到 UA / IA 的实测变比(§7.3),剩 UN 一路与精度等级送检
端子这半 2026-11-12 已由标定拿到 UA / IA 的实测变比(§7.3,那一轮是两点算法),剩 UN 一路与精度等级送检
(开工前置见 `docs/算法/采集与算法层设计说明.md` §13.13)。
遥测链(快照发布)与运行参数/点表均已达成,口径沉淀在 `App/algo/meas.h`、`App/algo/run_par.h`
头注释与 `docs/算法/采集与算法层设计说明.md` §13.9;其中"104 上送值与**工程量**一致"仍挂在
变比确认与两点标定上(注入验证只证到引脚电压口径)。
变比确认与多点标定上(注入验证只证到引脚电压口径)。
@@ -240,7 +240,7 @@
| --- | --- | --- | --- |
| 周期 CONVST 重触发 | 1000 Hz(与保护节拍同源) | 示波器见 U3 `BUSY` 连续脉冲;`tpafe5160_frame_seq()` 持续递增 | ✅ 2026-10-10:**TIM3 更新事件(1 kHz)硬件触发**(ISR 内 `tpafe5160_start_conv_irq()`;方案 A,零引脚/零驱动改动。⚠ 节拍源**不能**是 TIM6/TIM7——F4 上 ADC1 收不到它们的 TRGO,见 `docs/子系统设计/ADC采样节拍设计说明.md` §3.2);台架 `/serial-boot-test` PASS——`seq` 每 10 s 精确 +10000 = 1000.0 Hz、`frst_err=0`(早期证据 `docs/测试说明/测试数据/boot_log_data/20261010_prod_adc_tim6_boot_log.txt`,节拍源当时为 TIM6) |
| TPAFE 快照消费 | 8 通道 / 帧 | `adc_task` 每拍调 `tpafe5160_snapshot()`,返回 1/0/-1 有处理 | ✅ ADC 采集链路 已实现并 `/serial-boot-test` 闭环(`adc_task.c`;台架 `idle=0`、`frst_err=0`) |
| STM32 ADC1 启动与扫描 | 9 通道、144 cycles、**TIM3 TRGO 硬件触发 + DMA** | 全库出现 `HAL_ADC_Start_DMA`;9 通道码值随注入变化 | ✅ 2026-10-10(v2.0):`App/algo/adc_input.c` 的 `stm32_take()`——ADC1 由 TIM3 更新事件经 TRGO 触发一轮 9 通道,`HAL_ADC_Start_DMA(&hadc1, buf, 18)` + DMA2_Stream4 循环模式把码值自动搬进**乒乓双缓冲**,任务侧只消费刚完成的半区(**零忙等**,实测单拍 `adcp` 122 µs → **8 µs**);台架 `/serial-boot-test` PASS——`adc1_seq` 每拍 +1、`adc1_err=0`、`adc1_hw=0`。⚠ 「9 通道码值随注入变化」已由 2026-10-27 台架已知电压注入直接证实(六项判据全 PASS,实测记录 `docs/硬件平台/ADC通道映射说明.md` §8.1);两点标定与端子/子板变比确认仍待做 |
| STM32 ADC1 启动与扫描 | 9 通道、144 cycles、**TIM3 TRGO 硬件触发 + DMA** | 全库出现 `HAL_ADC_Start_DMA`;9 通道码值随注入变化 | ✅ 2026-10-10(v2.0):`App/algo/adc_input.c` 的 `stm32_take()`——ADC1 由 TIM3 更新事件经 TRGO 触发一轮 9 通道,`HAL_ADC_Start_DMA(&hadc1, buf, 18)` + DMA2_Stream4 循环模式把码值自动搬进**乒乓双缓冲**,任务侧只消费刚完成的半区(**零忙等**,实测单拍 `adcp` 122 µs → **8 µs**);台架 `/serial-boot-test` PASS——`adc1_seq` 每拍 +1、`adc1_err=0`、`adc1_hw=0`。⚠ 「9 通道码值随注入变化」已由 2026-10-27 台架已知电压注入直接证实(六项判据全 PASS,实测记录 `docs/硬件平台/ADC通道映射说明.md` §8.1);多点标定与端子/子板变比确认仍待做 |
| 通道语义映射 | 见 `docs/硬件平台/ADC通道映射说明.md`(**按语义取数,不写死下标**) | `UA→buf[6]`、`UN→buf[5]`、`IA→buf[2]`;STM32 侧 `UB→ADC_CHANNEL_14` | ✅ 2026-10-10:`App/algo/adc_input.c` 的 `k_adc_map[]` 语义表(`UA/UN/IA`→TPAFE `buf[6]/[5]/[2]`,`UB/UC/IB/IC/IN/TEMP`→ADC1 `CH14/3/6/1/2/5`)+ `adc_input_raw()` 按语义取数;开机**映射自检**(`adc_input_init()` 校验 STM32 映射通道必落在扫描序列内 → 挡住"映射到不扫描的通道"静默错)通过(`ADC input layer init: OK`)。台架首帧日志 8 路 + 温度全部读出:`UA=11429 UN=11454 IA=11452`(与 TIM3 轮次一致)、`UB=1018 UC=1044 IB=943 IC=1069 IN=1052 T=850`(互异、非饱和;**两次开机读数不同** → 确为实时转换而非常量) |
| 通道标定(一次系数 + 零漂) | 每通道 `k`、`b`;系数定点 `2^10` | 注入标准源,读数误差 ≤ 目标精度 | ⬜ |
| 采样有效性校验 | FRSTDATA 跳变、帧序号单调、丢帧计数 | 芯片静默/丢帧被检出并置告警 | ✅ 2026-10-11:新增 `App/algo/adc_health.c/h`(纯逻辑判定层:静默 100 ms 门限 / 丢帧边沿 / 序号倒退锁存 / FRSTDATA·HAL 错误·STM32 停摆计数增量)+ `adc_task.c` 告警编排(严重事件与故障上升沿 `DBG_ERROR` + 每类每次开机一次 `SYSLOG_SELFTEST`,恢复 `DBG_INFO`;gap 不告警只计数,心跳增 `tgap`);主机单测 `test/host/adc_health/` **31 用例全绿**(`adc-health-unit-test` 钩子);台架 `/serial-boot-test` PASS 零 `[ERR]`(健康不误报,`docs/测试说明/测试数据/boot_log_data/20261011_prod_adc_health_boot_log.txt`)。⚠ 抬栈:判定链 `adc_health_report`→`syslog_post` 回显尾使 adcTask 静态最坏链 832→**1080 B** → 栈 512→**640 words**(余 1480 B / 57%) |
+14 -11
View File
@@ -2,7 +2,7 @@
> **读这篇干什么**:按一帧数据的真实流向,把采样校正串成一条线——从端子码值到 104 上送、UI、保护,说清每步在哪个文件、用哪些系数、谁决定这数能不能信。本文是读者入口,推导、判据与实测表归各属主文档,这里只给「去哪查」。
>
> **一句话现状**:三维折算已上线、出厂变比已由 2026-11-11 台架实测写进固件(屏上直接显二次值);但两点标定尚未接到生产流程,`VALID` 未置位、保护判据仍闭锁、精度未验收。**「能显示二次值」≠「读数已达精度」**。
> **一句话现状**:三维折算已上线、出厂变比已由 2026-11-11 台架实测写进固件(屏上直接显二次值);但**多点标定(N 点最小二乘)尚未接到生产流程**,`VALID` 未置位、保护判据仍闭锁、精度未验收。**「能显示二次值」≠「读数已达精度」**。
>
> **术语**:PT/CT = 电压/电流互感器(一次侧 → 端子二次值);104 = IEC 60870-5-104 上行规约;UI = 人机界面;Q16 = 16 位定点(整数 ÷ 65536 才是真值);eng = 本帧量纲标志;ROM / RAM = 固件出厂值 / 运行时内存副本。
@@ -68,7 +68,7 @@ flowchart TD
| 系数 | 管什么 | 出厂值 | 合法带 |
|---|---|---|---|
| `k` | 引脚电压 ↔ 码值(µV/码,Q16) | TPAFE `10000000L`(152.59)、STM32 `52800000L`(805.66) | ROM ×[0.5, 2.0] |
| `b` | 零点(码值) | 两点标定得到,出厂 0 | ±8192 |
| `b` | 零点(码值) | 多点标定得到,出厂 0 | ±8192 |
| `r` | 端子二次值 ÷ 引脚电压(Q16) | 电压族 `65536000L`(1000.0 V/V)、电流族 `1927532L`(29.4118 A/V) | 0 或 ≥1.0 |
定义在 `App/algo/adc_cal.h`,ROM 出厂表(`k` 与 `r`)在 `App/algo/adc_cal.c`;推导见 `docs/算法/采集与算法层设计说明.md` §13.2。要点:
@@ -76,7 +76,7 @@ flowchart TD
- 先算引脚电压再乘 `r`(并成一个大系数会溢出 int32、丢 float 精度);`r=0` 合法 = 本路不折算、停在引脚电压;越带不回退 ROM;TEMP 原样透传。
- 出厂变比来自 2026-11-11 继保仪端子注入反算,取代被实测推翻的 606.06;电压族 5 V 注入仅约 33 码(真值区间 909~1111),是单点粗测、**不是铭牌精度**。见 `docs/硬件平台/ADC通道映射说明.md` §7.2。
`frame[]` 随即 → `sample_ring_push_frame()` → `phasor_run()` → `freq_run()`;每 200 ms `meas_tick()` 取一次遥测快照。精度目前只到引脚层约 ±2%,两点标定写完 `r` 并置 `VALID` 后才谈二次值精度(`docs/算法/采集与算法层设计说明.md` §13.5)。
`frame[]` 随即 → `sample_ring_push_frame()` → `phasor_run()` → `freq_run()`;每 200 ms `meas_tick()` 取一次遥测快照。精度目前只到引脚层约 ±2%,标定写完 `r` 并置 `VALID` 后才谈二次值精度(`docs/算法/采集与算法层设计说明.md` §13.5)。
---
@@ -109,22 +109,25 @@ flowchart TD
---
## 6. 两点标定:公式就绪、生产整定未接线
## 6. 多点标定(N 点最小二乘):解法就绪在 PC 侧、生产整定未接线
**这一节要你干什么**:别误以为两点标定已经在跑——这正是保护还闭锁的原因。
**这一节要你干什么**:别误以为标定已经在生产流程里跑——这正是保护还闭锁的原因。
`adc_cal_two_point()`(`App/algo/adc_cal.c`)以 ROM 的 `k` 为入参,解出 `r` 与 `b`:
**求参在 PC 上做,不在设备上做**:`test/host/cal_fit.py` 以 ROM 的 `k` 为入参,对 N 个标定点(**3 ≤ N ≤ 8**)做普通最小二乘,解出 `r` 与 `b`——这是**离线台架动作,固件里没有拟合代码**。设备只需要「用」和「验」:用 `r`/`b` 折算(`adc_cal_apply()`)、对写入参数做合法带校验(`adc_cal_set()` / `adc_cal_set_ratio()`)。设备不需要自己算,所以不值得为它单养一份第二实现。
```
r = (v_hi − v_lo) / [(c_hi − c_lo) × k]
b = v_lo / (k × r) − c_lo
先拟合 注入 = a·示值 + c (普通最小二乘;横轴读表、纵轴注入)
再取 r_new = a · r_old
并把截距 c 折回引脚域求 b
```
标定点要跨度足够大——点太近会按 1/跨度放大读数误差(量化表属主 `docs/硬件平台/ADC通道映射说明.md` §7.2);本轮台架按安全优先裁定为电压族 5 V/50 V、电流族 0.5 A/2 A,误差代价与执行细节见 `docs/测试说明/专项验证/ADC两点标定执行流程.md` §2。
**为什么不用两点**:两点只吃两个读数,单点误差原封不动变成结果偏差,而且拟合结果没有任何自检面(两点连线在数学上永远完美)。点数多了最小二乘把单点偏差摊平,还顺带给出残差与 `R²` 两个"这条线直不直"的判据。标定点要**拉开、覆盖端点、3~8 个点**(台架推荐 5 点:点位太近会按 1/跨度放大读数误差,量化表属主 `docs/硬件平台/ADC通道映射说明.md` §7.2);本轮台架按安全优先裁定电压族 5–100 V、电流族 0.5–2 A 的区间取点,执行细节见 `docs/测试说明/专项验证/ADC多点标定执行流程.md` §1。
**⚠ 现状(两件不同的事,别混)**:**板上没有一键标定**——全仓 `adc_cal_two_point(` 只出现在定义、声明与 `test/host/adc_cal/` 单测里,生产代码零调用;**但台架手工路径是通的,且已经跑过**——端子加两个已知量、读 `meas:` 行相量读数、`test/host/cal_two_point.py` 离线解出 `r`/`b`、`test/host/cal_write.py` 经 104 定值段写入(`adc_cal_set()` 落 `b` 时置 `VALID`,脏→落盘→重启保持)。完整执行卡见 `docs/测试说明/专项验证/ADC两点标定执行流程.md`,开工前置与送检顺序见 `docs/算法/采集与算法层设计说明.md` §13.13。
**⚠ 现状(两件不同的事,别混)**:**板上没有一键标定**——固件**不含**拟合代码(2026-11-13 裁定移出,生产零调用、被 linker 移除),拟合的唯一实现是 PC 侧的 `test/host/cal_fit.py`;设备侧只有折算与合法带校验两个入口。**但台架手工路径是通的,且已经跑过一轮**——端子加一组成比例的已知量、读 `meas:` 行相量读数、`test/host/cal_fit.py` 离线做最小二乘解出 `r`/`b`、`test/host/cal_write.py` 经 104 定值段写入(`adc_cal_set()` 落 `b` 时置 `VALID`,脏→落盘→重启保持)。完整执行卡见 `docs/测试说明/专项验证/ADC多点标定执行流程.md`,开工前置与送检顺序见 `docs/算法/采集与算法层设计说明.md` §13.13。
**2026-11-12 台架结果**:UA(`r = 554.69`)与 IA(`r = 29.63`)已标定并落盘,`VALID` 位图 `0x11`;**UN 未标**(台架该通道无有效信号)。保护判据要求 UA/UN/IA 三路齐,所以**现在仍然是闭锁态**——只差 UN 一路。实测数据与「2026-11-11 那个 1000.0 为什么错」的归因见 `docs/硬件平台/ADC通道映射说明.md` §7.3。
**为什么拟合不留在固件里**:整条标定链是「注入 → 读 `meas:` → PC 上解 `r`/`b` → 104 写入」,没有任何一步需要设备参与计算;把拟合留在固件只会多出一份与 PC 工具互为镜像的第二实现(改一处忘一处就是两个口径),而设备真正需要守的是**写入参数合法**与**折算正确**。删掉固件实现后,"解出的 `r` 对不对"由工具自带的金标向量回归守着——`test/host/cal_fit.py --selftest` 用一组已知点核对解出的 `r_q16` 与 `b` 是否逐位相等,外加 4 条拒绝路径(点数不足 / 点位没拉开 / 单调反转 / `r` 越带),11 项全过才 exit 0。**这条自检是替代品不是补充**:固件里没有第二实现了,它是算法正确性唯一的机器验证。
**2026-11-12 台架结果**(**那一轮用的是两点算法,不是现在的最小二乘**):UA(`r = 554.69`)与 IA(`r = 29.63`)已标定并落盘,`VALID` 位图 `0x11`;**UN 未标**(台架该通道无有效信号)。保护判据要求 UA/UN/IA 三路齐,所以**现在仍然是闭锁态**——只差 UN 一路。新一轮改用 **5 点最小二乘**重标,结果待填;实测数据与「2026-11-11 那个 1000.0 为什么错」的归因见 `docs/硬件平台/ADC通道映射说明.md` §7.3,标定区间内外的独立核验见 `docs/硬件平台/ADC通道映射说明.md` §7.4。
---
+35 -23
View File
@@ -6,7 +6,7 @@
> 本文不重复其内容;本文不写历史演进、门禁复测记录与修订日志(需要时查 git 历史)。
> **状态**:语义取数与有效性 → 全周傅氏相量 → 保护判据主线已闭环到板端消费者(`protectTask`,20 ms 判据节拍);
> 标定折算层 `App/algo/adc_cal` 已于 2026-10-25 落地(标定折算与落盘整定,§13.2,
> 引脚电压量纲 + 系数落盘 + 未标定闭锁);**幅值精度判据**仍待标准源两点注入复核(§13 状态段;
> 引脚电压量纲 + 系数落盘 + 未标定闭锁);**幅值精度判据**仍待标准源多点注入复核(§13 状态段;
> 推进顺序与等待的外部资源见 `docs/任务规划/README.md` §2)。
> **相关文档**:
> 分层与功能项(语义取数与有效性~动作留痕)的唯一属主登记处:`docs/算法/继电保护功能复现规划.md` §2.1(分层)、§3(功能清单)、§4.2(精度)、§7(路线图)
@@ -417,7 +417,7 @@ UA 无幅值落 IA → 0.0020 Hz。
2. **禁止跨转换器运算**(V0.1 硬件缺陷**双转换器无共同采样触发**):`UA/UN/IA` 在 TPAFE、`UB/UC/IB/IC/IN` 在
STM32 ADC1,两片转换器没有共同采样触发 → 无同一时刻性、相位不确定。故本层**不做**跨转换器的
相位 / 功率 / 功率因数 / 负序零序类矢量运算;**8 路全接 TPAFE(V0.2 硬件)后方可解禁**。
3. **标定折算已落地、精度复核未做**(2026-10-25 `App/algo/adc_cal`;两点标定怎么开工见 §13.13):
3. **标定折算已落地、精度复核未做**(2026-10-25 `App/algo/adc_cal`;多点标定怎么开工见 §13.13):
帧值现 = 引脚侧工程量(ROM 默认系数 = 转换器 LSB 事实值),
前端分压读法判别与端子变比仍待台架——**精度结论前不得把幅值当计量证据**(§13)。
4. **本层无副作用外溢**:不建任务、不等事件、不写日志(日志由调用侧打)、不碰寄存器
@@ -525,10 +525,12 @@ adcTask 静态最坏链与余量的**台账在** `docs/内存管理/RAM使用分
104 与 UI 拿到的数从哪来一份**。它是 `App/algo/adc_cal.*`、`meas.*`、`App/cfg/cfg_file.*`、
`App/task/protect_task.c`、`Drivers/BSP/UI/ui_data*` 这些模块头注释里引用的口径出处。
**当前状态**(2026-11-12 更新):折算链已落地,量纲由**每路变比 `r`** 决定——出厂默认已带台架
**当前状态**(2026-11-13 更新):折算链已落地,量纲由**每路变比 `r`** 决定——出厂默认已带台架
实测反算的变比(电压 1000 V/V、电流 29.4118 A/V),所以烧进新固件后屏上直接显**二次值**。
**两点标定已上板实跑**:UA(`r = 554.69`)与 IA(`r = 29.63`)标定并落盘、`VALID` 置位
**标定已上板实跑**:UA(`r = 554.69`)与 IA(`r = 29.63`)标定并落盘、`VALID` 置位
(`vl = 0x11`),实测值登记 → `docs/硬件平台/ADC通道映射说明.md` §7.3;UN 台架无有效信号未标。
⚠ 那两个 `r` 是**两点算法**下的历史实测值;算法已改为 **N 点(3 ≤ N ≤ 8,台架按 5 点)最小二乘**,
新一轮结果待填(`docs/硬件平台/ADC通道映射说明.md` §7.3 末表)。
保护判据仍处于**未标定闭锁**态(§13.3),因为 VALID 要求 **UA/UN/IA 三路齐**,现在只差 UN 一路——
这是预期行为,不是缺陷。
@@ -585,30 +587,37 @@ adcTask 静态最坏链与余量的**台账在** `docs/内存管理/RAM使用分
窄带没有意义;下界取 1.0(分压与负担电阻只会把端子值变小,比"比值 < 1"更可能的是把 mV 当 V 填错),
上界是 int32 能表达的 32767.99。**`r = 0` 是合法值**,语义 = "本路不折算,输出停在引脚电压",
这也是现场关掉某一路折算的正规手段(改成 1.0 反而会留下一个假变比)。
- **两点标定今后标的是 `r`,不是 `k`**(`adc_cal_two_point()` 已改签名,`k_q16` 变成入参):
`k` 是板级事实、现场不该改也改不动,真正未知的是"端子 ↔ 引脚"这一层。公式在公式核的注释里,
要点是分两步算(`t = dc × r` 先出来,再还原 Q16)——一次算 `dv×2^32/(dc×k_q16)` 会在
高压注入时把 long long 顶穿。
- **标定今后标的是 `r`,不是 `k`**(拟合工具的 `k_q16` 是入参):`k` 是板级事实、现场不该改也改不动,真正未知的是"端子 ↔ 引脚"这一层。
- **怎么从 N 个点解出 `r` 与 `b`**:这一步**在 PC 侧完成,固件只接收结果**——`test/host/cal_fit.py` 对 N 个点(**3 ≤ N ≤ 8**)做**普通最小二乘**,拟合
`注入 = a · 示值 + c` 这条直线(横轴是 `meas:` 读数、纵轴是注入已知量,`a` 是斜率、`c` 是截距);再由
`r_new = a · r_old` 得到新变比(注入正比于示值,比例偏差全由 `r` 吸收),
并把截距折回引脚域求零点 `b`。**定的是口径,不是实现**——数值在什么域里算(浮点还是定点)、
累加顺序、各条拒绝判据落在哪一步,都写在 `test/host/cal_fit.py` 里,本节不重复。设备侧只做两件事:
用 `r`/`b` 折算(`adc_cal_apply()`)、对写入的参数做合法带校验(`adc_cal_set()` / `adc_cal_set_ratio()`)。
- **为什么不再用两点**:两点解只用到两个读数,**单点误差 100 % 传进结果**且没有任何自检面;
最小二乘用全部点、把单点偏差摊平,还能顺手算出残差与 `R²`——前者回答"拟合线直不直",
后者回答"这些点到底像不像一条直线"。四点以上时,某一点读错(接线、读错格)会直接体现为残差超限,
而不是悄悄变成系数偏差。台架前的判据与执行步骤 → `docs/测试说明/专项验证/ADC多点标定执行流程.md` §3。
### 13.3 三态可用性:标定 ≠ 可测
`r` 的出厂默认值是**台架实测反算的变比**,所以出厂状态下每路的**量纲**就已经是二次值;
但"这个数准不准"要靠标准源两点标定才能回答。所以通道状态仍必须让消费者区分三档:
但"这个数准不准"要靠标准源多点标定才能回答。所以通道状态仍必须让消费者区分三档:
```c
#define ADC_CAL_F_VALID 0x01u /* 该路已两点标定确认(k/b 在带内 且 r 已配置)→ 读数可信 */
#define ADC_CAL_F_VALID 0x01u /* 该路已多点标定确认(k/b 在带内 且 r 已配置)→ 读数可信 */
#define ADC_CAL_F_CLIPPED 0x02u /* 硬件削顶(单极性无偏置)→ 交流量不可信 */
```
**两个事实互不派生、别互相反推**:`VALID` 回答"准不准",`r` 回答"什么单位"。
`r = 0` 时 `VALID` 必为 0(合法带要求 r 已配置),所以"VALID 未置位却有二次值读数"
这种组合不可能出现;反过来说,只配了变比、没做两点标定的通道,输出**确实是**二次值、
这种组合不可能出现;反过来说,只配了变比、没做过标定的通道,输出**确实是**二次值、
只是精度未定——量纲标签若跟着 VALID 走,屏上就会出现"数值是 5.000(二次)却标未标定 V"
这种自相矛盾。
| 通道 | `VALID` | `CLIPPED` | 消费者应如何对待 |
|---|---|---|---|
| UA / UN / IA | 两点标定后置位 | 0 | 可用于保护、计量、上送 |
| UA / UN / IA | 多点标定后置位 | 0 | 可用于保护、计量、上送 |
| UB / UC / IB / IC / IN | 永不置位(V0.2 硬件改版前) | **1,且是来源派生**(不是实测削顶,判据见 §13.5) | 只作码值监视;点表**已绑定**,靠品质位把 104 侧驱动成 IV、值清零 |
| TEMP | 0 | 0 | 不参与线性标定(`r` 恒 0),页面显示 `--` |
@@ -654,12 +663,13 @@ V0.1 恒命中 UB/UC/IB/IC/IN,位图 `0xE6`),它表示"这路不能测交
`cal:` 行的 `rail=` 位图与 `rail: edge=…` 那行 `[ERR]`——这条路径至今只在直流饱和里起过(判据见
`docs/测试说明/专项验证/ADC前端注入验证流程.md` §8.5 削顶卡)。
> **承诺边界**(2026-11-12 更新):**量纲**已到端子二次值(出厂默认变比已带硬件事实,
> **承诺边界**(2026-11-13 更新):**量纲**已到端子二次值(出厂默认变比已带硬件事实,
> `eng` 判据见 §13.3);**精度**分两档说清——① 引脚层 ±2 % 已由动态六轮证过;
> ② 端子二次值这一档,UA / IA 已用继保仪两点标定**实测落盘**(`r = 554.69` / `29.63`,
> 单台、标定点 5 V–50 V 与 0.5 A–2 A,1 LSB 摊入约 0.7 % / 0.6 %,够保护判据 3~5 %、
> **够不上 0.5 级计量**),UN 未标;**精度等级验收**仍等标准源送检。
> 两点标定怎么开工见 §13.13,实测值 → `docs/硬件平台/ADC通道映射说明.md` §7.3。
> ② 端子二次值这一档,UA / IA 已用继保仪标定**实测落盘**(`r = 554.69` / `29.63`,
> **那是两点算法下的结果**;单台、标定点 5 V–50 V 与 0.5 A–2 A,1 LSB 摊入约 0.7 % / 0.6 %,
> 够保护判据 3~5 %、**够不上 0.5 级计量**),UN 未标;**精度等级验收**仍等标准源送检。
> 算法已改为 **N 点(3 ≤ N ≤ 8,台架按 5 点)最小二乘**,新一轮重标结果待填 → `docs/硬件平台/ADC通道映射说明.md` §7.3 末表。
> 标定怎么开工见 §13.13,实测值 → `docs/硬件平台/ADC通道映射说明.md` §7.3。
**动态验证已跑两轮(2026-11-02 / 11-04),六轮全部闭合**——幅值 / 波形 / 相位 / 测频 / 谐波 /
削顶直流档都过了;实测数与逐轮结论只详述在 `docs/硬件平台/ADC通道映射说明.md` §8.2,本节不抄第二份。
@@ -667,7 +677,7 @@ V0.1 恒命中 UB/UC/IB/IC/IN,位图 `0xE6`),它表示"这路不能测交
| 下游 | 现在 | 为什么 |
|---|---|---|
| 基波有效值 | ✅ 引脚层过(±2 % 内,三档幅值两点复现) | 台架幅值轮 + 波形轮(基波分量口径)实证;**二次值这一档**:UA / IA 已由继保仪两点标定实测落盘(`r = 554.69` / `29.63`),旧结论"出厂变比是单点粗测(5 V 注入只有 33 码、1 LSB = 3 %、真值区间约 909~1111)"仍成立且已在 2026-11-12 被实测定量:实测 554.69 说明那次粗测接线分压把比值放大了一倍(`docs/硬件平台/ADC通道映射说明.md` §7.3);**精度等级**仍待标准源送检 |
| 基波有效值 | ✅ 引脚层过(±2 % 内,三档幅值两点复现) | 台架幅值轮 + 波形轮(基波分量口径)实证;**二次值这一档**:UA / IA 已由继保仪标定实测落盘(`r = 554.69` / `29.63`,**两点算法下的历史值**),旧结论"出厂变比是单点粗测(5 V 注入只有 33 码、1 LSB = 3 %、真值区间约 909~1111)"仍成立且已在 2026-11-12 被实测定量:实测 554.69 说明那次粗测接线分压把比值放大了一倍(`docs/硬件平台/ADC通道映射说明.md` §7.3);2026-11-13 又用**非标定的 10 V / 100 V** 做了区间外核验(+0.42 % / −0.067 %,`docs/硬件平台/ADC通道映射说明.md` §7.4);**精度等级**仍待标准源送检 |
| 相位 | ✅ 同片内过(录波档 ≤2° 判据) | 同段 UA/UN 两路实测(0° 与 90° 两工况);**跨转换器仍禁比**——两片转换器无共同采样触发,是 V0.1 硬件边界(`docs/硬件平台/ADC通道映射说明.md` §7 通道归属行),不是待修缺陷 |
| 频率 | ✅ 「如实报不可测」成立(这就是现状判据) | 含满幅注入段全不可测、UI 恒 `--`;**45~55 Hz 精度仍未验**——要验须降 `FREQ_AMP_MIN` 单跑一轮 |
| 削顶 / 品质 | ✅ DC −1.00 V 档锁存 + sticky 实证;2.0 Hz 低频档与复位复核经用户裁定 2026-11-04 关闭 | `[ERR] rail: edge=0x2 sticky=0x2` 唯一一条、撤注恒持 |
@@ -723,7 +733,7 @@ V0.1 恒命中 UB/UC/IB/IC/IN,位图 `0xE6`),它表示"这路不能测交
`run_par` **不存第二份**;落盘链走 `SYS_EVT_RUN_PAR_SAVE`(iec104Task peek 投递 →
defaultTask 整档 save),`p_cb` 依旧未用。谁写 RAM / 谁落盘 / 什么时机的完整链条见 §10.1。
- ⚠ **变比段的 ROM 默认不是 0**:烧进新固件后屏上立刻显二次值。这与"没标定过"不矛盾——
变比是硬件事实(出厂就该带着),`VALID`(准不准)仍然要求两点标定,两者互不代替(§13.3)。
变比是硬件事实(出厂就该带着),`VALID`(准不准)仍然要求实际标定,两者互不代替(§13.3)。
- ⚠ **负零点**:零点偏移是带符号量,引擎只有 `CFG_VAL_UINT`(`strtoul` + 上界校验)时 −5 会落成
`4294967291`。所以 `[adc_cal_ofs]` 走 `CFG_VAL_INT`(定案口径见 §13.12)。
- **一次变比不新开段**:PT/CT 一次额定已在 `prot_set` 里(`PS_PT_PRI` / `PS_PT_SEC` / `PS_CT_PRI` /
@@ -816,7 +826,8 @@ typedef struct {
| 变比 `r` 存哪 | **新开一段 `[adc_cal_sec]`,int32 Q16 比值**,不并进 `k` | 并进 `k` 直接溢出 int32(UA 端子域 k 的 Q16 = 1.0e10 > 2.147e9);且变比是硬件事实、`k` 是前端斜率,混一起就是"用系数凑硬件" |
| `r` 的合法带 | **绝对带**:`0`(不折算)或 `≥ 1.0`,上界 int32 能表达的 32767.99 | `r` 是现场标定量,不同 CT/PT 差几个数量级,用 ROM×[0.5,2.0] 那种窄带没有意义 |
| `r` 的出厂默认 | **非 0**:电压族 1000 V/V、电流族 29.4118 A/V | 变比是硬件事实,出厂就该带着;"准不准"由 VALID 回答,两者互不代替(§13.3) |
| 两点标定标谁 | **标 `r`**,`k` 由 ROM 固化 | `k` 是板级事实、现场不该改也改不动;真正未知的是"端子 ↔ 引脚"这一层 |
| 标定标谁 | **标 `r`**,`k` 由 ROM 固化 | `k` 是板级事实、现场不该改也改不动;真正未知的是"端子 ↔ 引脚"这一层 |
| 标定用什么算法 | **N 点(3 ≤ N ≤ 8)普通最小二乘**,台架按 5 点执行,不再用两点连线 | 两点解只吃两个读数、单点误差 100 % 传进结果,且拟合结果没有任何自检面;最小二乘摊平单点偏差,并额外产出残差与 `R²` 两个可判读量。拒绝判据(点数越界 / 点位不拉开 / `r`·`b` 越带 / 非单调 / 残差超跨度 2 %)随拟合一起落在 PC 侧工具 `test/host/cal_fit.py`(固件只做写入参数的合法带校验) |
| 整帧量纲标签 `eng` 的判据 | **每路要么已配变比、要么削顶不显示** | 削顶通道页面本来就显 `--`、不进读数;拿它们卡标签会让 V0.1 五路削顶把徽标永久钉在"未标定" |
| 一次变比(PT/CT 一次额定)存哪 | **复用 `prot_set` 已有四项**,不新开段 | 已经在册(`PS_PT_PRI` / `PS_PT_SEC` / `PS_CT_PRI` / `PS_CT_SEC`),再开一段就是同一事实两个真源 |
| 遥测快照的字段布局 | 由协议侧定、单测按偏移钉死(72 B × 双区) | 布局漂移只能靠"读侧按名字取"掩盖,抓不到真正的错位 |
@@ -827,15 +838,16 @@ typedef struct {
新增决策照上表格式往下加:一行一个问题、一行定成了什么、一行为什么。
### 13.13 两点标定开工前必须先拍板的三件事
### 13.13 多点标定开工前必须先拍板的四件事
拍板前,相应验收判据无法判定——这是**开跑的前置**,不是排期问题。
| 待定 | 备选 | 为什么必须先定 |
|---|---|---|
| **精度目标** | 0.5 级 / 1 级 | 决定两点标定的判据,否则"误差 ≤ 目标精度"这条无法判定。保护判据本身只需 3~5 %,0.5 级是计量口径 |
| **端子 / 子板变比从哪来** | ① 有原理图(直接算)② 只有实物(万用表同时量端子与引脚)③ 都没有 | 决定变比登记的**可信度**(注意:量纲已不依赖它——出厂默认变比已按台架实测反算写进 `[adc_cal_sec]`,`eng` 能升 1;缺的是精度)。2026-11-11 用继保仪单点注入反算得 1000.0 / 29.4118,推翻了原先按子板参数算定的 606.06(详见 `docs/硬件平台/ADC通道映射说明.md` §7.2);**2026-11-12 两点标定又把 1000.0 推翻**——接线分压使 PT 一次侧只拿到一半电压,实测 UA = 554.69,与参数算定值 606.06 只差 8.5 %(`docs/硬件平台/ADC通道映射说明.md` §7.3)|
| **精度目标** | 0.5 级 / 1 级 | 决定标定的判据,否则"误差 ≤ 目标精度"这条无法判定。保护判据本身只需 3~5 %,0.5 级是计量口径 |
| **端子 / 子板变比从哪来** | ① 有原理图(直接算)② 只有实物(万用表同时量端子与引脚)③ 都没有 | 决定变比登记的**可信度**(注意:量纲已不依赖它——出厂默认变比已按台架实测反算写进 `[adc_cal_sec]`,`eng` 能升 1;缺的是精度)。2026-11-11 用继保仪单点注入反算得 1000.0 / 29.4118,推翻了原先按子板参数算定的 606.06(详见 `docs/硬件平台/ADC通道映射说明.md` §7.2);**2026-11-12 那轮两点标定又把 1000.0 推翻**——接线分压使 PT 一次侧只拿到一半电压,实测 UA = 554.69,与参数算定值 606.06 只差 8.5 %(`docs/硬件平台/ADC通道映射说明.md` §7.3)|
| **`eng = 0` 期间测频幅值门怎么处置** | 保持恒失效(现状,UI 恒 `--`)/ 台架临时把 `FREQ_AMP_MIN` 降到引脚域量级跑一轮再还原 / 换成相对量门限 | 建议**常态保持恒失效 + 需要时临时降门跑一轮**;换相对量门限要先重新论证,别在过渡期改。临时降门会改产品头文件,收尾必须还原到 `git diff` 为空并重跑构建 |
| **标定点数与分布怎么定** | 3 点(算法下限)~ 8 点(算法上限)/ **5 点(推荐)** | 点数与位置直接决定拟合结果对不对:少于 3 点或超过 8 点都无法解(算法直接拒绝);点挤在一小段里,斜率被 1/跨度放大成噪声;不覆盖端点就只能外推,区间边缘没有锚点。推荐 **5 点铺在量程端点与中点**(电压 5 / 10 / 25 / 50 / 100 V,电流 0.5 / 1 / 1.25 / 1.5 / 2 A),可继保仪能力调整但必须满足「拉开、覆盖端点」。执行细则 → `docs/测试说明/专项验证/ADC多点标定执行流程.md` §1 |
**送检顺序不可倒过来**:产品构建当前要求 UA/UN/IA 的标定 `VALID` 全部置位才走保护判据。
未完成标准源标定就送检,保护会表现为不动作。保持该闭锁,不用非标准源标定走捷径。