docs(hw): ④ 段变比定死入通道映射——电压族 606.06:1、电流族 29.4118 A/V,eng 保持 0(#41) #92

Merged
wandering1 merged 2 commits from write-ratio-41-fba44d301c82 into master 2026-11-06 19:41:58 +08:00
Collaborator

This is by an automated agent, not a human.

内容

Issue #41 ④ 段(端子 ↔ AINn 子板/端子板变比)用户现场报了子板参数(PT 2mA/2mA、输入侧 200 kΩ、输出侧 330 Ω;CT 5A/2.5mA、输出侧负担 68 Ω)。本卡按工单口径先复核算术与口径、再入库:只改 docs/硬件平台/ADC通道映射说明.md,代码、ROM、登记簿不动。

复核结论:两数与报参口径一致,未发现算误

族 算式 精确值 用户给值 复核
电压族 UA/UB/UC/UN (2 mA×200 kΩ) ÷ (2 mA×330 Ω),电流比 1:1 电流相消 = 200000 ÷ 330 606.060606… V/V 606.0606060606061 ✓
电流族 IA/IB/IC/IN 5 A ÷ (2.5 mA×68 Ω) = 5 ÷ 0.17 = 匝比 2000 ÷ 68 29.41176470… A/V 29.41176470588235 ✓

口径修正一处:CT 值是带单位的 A/V(I端子 ÷ 负担电阻电压),不是无量纲 V/V——用户「输入电流比 ADC 采样电压」的说法与该量纲吻合;文档两族分注单位,不可混写。

改动(65+ / 7−)

  • §7.1 链路分段表 ④ 行:「仍待实测确认」→ 定死(参数算定,非本板双表同测),两族数值入表;引文与可评审结论 1/3/4、§8 第 4 条同步收口(ROM 出厂表仍按 ② 引脚口径,不因 ④ 到手而改动)。
  • 新增 §7.2 ④ 段变比登记:算式与额定点(400 V→0.66 V、5 A→0.17 V)、②×③×④ 端到端标称系数表(电压 92.48 / 488.28 mV/码,电流 4.488 / 23.70 mA/码——只作两点标定初值与量级核对)、复核口径(铭牌参数不含励磁/绕组/容差/逐路差,数值确认归两点标定;App/algo/adc_cal.c 合法带哨兵是数量级兜底)。
  • eng 判定:④ 到手满足 App/app/ui_data_feed.c feed_eng() 的第一条件;电气 8 路 ADC_CAL_F_VALID 未置位,第二条件不满足 → eng 保持 0,输出单位仍是 ADC 引脚电压。变化是两点标定从「开不了工」转为「可开工」(端子侧参照已定死)。
  • 移交「两点标定与精度验收」卡的两道存储口径题(本卡不替它定案):电压族端子域标称 k(92479 / 488278 µV/码)越 int32 Q16 µV/码上限 32767;合法带基准读 ROM 出厂表(现为引脚域),端子域 k 会被 [0.5, 2.0] 哨兵顶回——写入端子域系数前存储单位与出厂表须一并换血。

验证

  • scripts/check_doc_links.py --all 实跑通过(3226 处引用 / 213 文档);no-mojibake 通过;提交期 pre-commit 实跑(gitlint ✓)。
  • docs-only:/keil-build 与板端回归不适用。
  • 边界:变比来源为铭牌/板面值算定,非本板双表同测;端子级上额定电压仍是独立动作,「先量端子对地通断」前置不变(docs/任务规划/数据可信.md §8 风险次序)。

Ticket: fba44d301c82d4885d19f62b48a32a62

This is by an automated agent, not a human. ## 内容 Issue #41 ④ 段(端子 ↔ `AINn` 子板/端子板变比)用户现场报了子板参数(PT 2mA/2mA、输入侧 200 kΩ、输出侧 330 Ω;CT 5A/2.5mA、输出侧负担 68 Ω)。本卡按工单口径**先复核算术与口径、再入库**:只改 `docs/硬件平台/ADC通道映射说明.md`,代码、ROM、登记簿不动。 ## 复核结论:两数与报参口径一致,未发现算误 | 族 | 算式 | 精确值 | 用户给值 | 复核 | |---|---|---|---|---| | 电压族 UA/UB/UC/UN | (2 mA×200 kΩ) ÷ (2 mA×330 Ω),电流比 1:1 电流相消 = 200000 ÷ 330 | **606.060606… V/V** | 606.0606060606061 | ✓ | | 电流族 IA/IB/IC/IN | 5 A ÷ (2.5 mA×68 Ω) = 5 ÷ 0.17 = 匝比 2000 ÷ 68 | **29.41176470… A/V** | 29.41176470588235 | ✓ | 口径修正一处:CT 值是**带单位的 A/V**(I端子 ÷ 负担电阻电压),不是无量纲 V/V——用户「输入电流比 ADC 采样电压」的说法与该量纲吻合;文档两族分注单位,不可混写。 ## 改动(65+ / 7−) - §7.1 链路分段表 ④ 行:「仍待实测确认」→ **定死(参数算定,非本板双表同测)**,两族数值入表;引文与可评审结论 1/3/4、§8 第 4 条同步收口(ROM 出厂表仍按 ② 引脚口径,不因 ④ 到手而改动)。 - 新增 **§7.2 ④ 段变比登记**:算式与额定点(400 V→0.66 V、5 A→0.17 V)、②×③×④ 端到端标称系数表(电压 92.48 / 488.28 mV/码,电流 4.488 / 23.70 mA/码——只作两点标定初值与量级核对)、复核口径(铭牌参数不含励磁/绕组/容差/逐路差,数值确认归两点标定;`App/algo/adc_cal.c` 合法带哨兵是数量级兜底)。 - **eng 判定**:④ 到手满足 `App/app/ui_data_feed.c` `feed_eng()` 的第一条件;电气 8 路 `ADC_CAL_F_VALID` 未置位,第二条件不满足 → **`eng` 保持 0**,输出单位仍是 ADC 引脚电压。变化是两点标定从「开不了工」转为「可开工」(端子侧参照已定死)。 - **移交「两点标定与精度验收」卡的两道存储口径题**(本卡不替它定案):电压族端子域标称 k(92479 / 488278 µV/码)越 int32 Q16 µV/码上限 32767;合法带基准读 ROM 出厂表(现为引脚域),端子域 k 会被 [0.5, 2.0] 哨兵顶回——写入端子域系数前存储单位与出厂表须一并换血。 ## 验证 - `scripts/check_doc_links.py --all` 实跑通过(3226 处引用 / 213 文档);no-mojibake 通过;提交期 pre-commit 实跑(gitlint ✓)。 - docs-only:`/keil-build` 与板端回归不适用。 - 边界:变比来源为铭牌/板面值算定,**非本板双表同测**;端子级上额定电压仍是独立动作,「先量端子对地通断」前置不变(`docs/任务规划/数据可信.md` §8 风险次序)。 Ticket: fba44d301c82d4885d19f62b48a32a62
super_agent_bot added 1 commit 2026-11-06 19:12:38 +08:00
用户在 Issue #41 现场报子板参数:PT 2mA/2mA、输入侧 200 kΩ、输出侧 330 Ω;
CT 5A/2.5mA、输出侧负担 68 Ω。先复核算术后入库:

- 200000 ÷ 330 = 606.060606… V/V ✓;5 ÷ (2.5mA × 68Ω) = 5 ÷ 0.17 =
  29.41176470… A/V(= 匝比 2000 ÷ 68)✓,两数与报参口径一致,未发现算误。
- 电流族"变比"实为带单位的 A/V(I端子 ÷ UAINn),与 V/V 不可混写,文档分注。

改动全在 docs/硬件平台/ADC通道映射说明.md(#41 口径:本卡不动代码、
ROM、登记簿):

- §7.1 链路分段表 ④ 行由"仍待实测确认"改"定死(参数算定)",给出两族数值;
  引文与可评审结论 1/3/4 同步收口。
- 新增 §7.2 登记:算式与额定点(400 V→0.66 V、5 A→0.17 V)、②×③×④ 端到端
  标称系数表(92.48 / 488.28 mV/码、4.488 / 23.70 mA/码)、复核口径——铭牌
  参数非本板实测,数值确认归两点标定;`eng` 判定:④ 到手满足第一条件,
  电气 8 路 ADC_CAL_F_VALID 未置位,eng 保持 0,两点标定转为可开工。
- 移交两点标定卡的两道存储题:电压族端子域标称 k 越 int32 Q16 µV/码上限
  32767,且合法带基准读 ROM 出厂表(引脚域)——写入端子域系数前存储单位
  与出厂表须一并换血。

验证:check_doc_links.py --all 与 no-mojibake 实跑通过;docs-only,
/keil-build 不适用。
wandering1 added 1 commit 2026-11-06 19:41:46 +08:00
wandering1 merged commit 06baf7a531 into master 2026-11-06 19:41:58 +08:00
wandering1 deleted branch write-ratio-41-fba44d301c82 2026-11-06 19:42:00 +08:00
Sign in to join this conversation.
No Reviewers
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: wandering1/STM32F4-Base#92