docs: 数据可信与 ADC 通道映射只留现状，清历史与悬空引用
数据可信.md 与 ADC通道映射说明.md 按「只写现状」口径重写： 删历史沿革、推理过程与已删小节的残留指针，保留现行判据。 - 数据可信：§2.7 删「当时的证据」六行表；§4.6.1 标题改「范围与 幅度上限」、四行改现状陈述；§4.6.2 删轮次名历史映射注；§4.6.3 段文件行去过程语；删节尾孤立排程段；§4.4 负零点段收成现状结论。 - 数据可信：把「系数合法带」从已删的 §8 风险表搬回 §4.1（代码头注释 仍指向它，属搬回不是新发明）。 - 数据可信：行号纠错 adc_task.c:382 -> :425、protect_task.c:245 -> :268，逐个 grep 核对。 - 跨文档与代码：12 处指向已删 §4.6.4/§4.6.5/§8/§9/§10 的悬空引用改到 现存小节或内联结论，涉 6 处 App 源文件头注释与 6 篇文档。 - 两个 SVG 生成器文案同步重跑，产物同笔提交。 check_doc_links --all 通过（221 篇）；pre-commit 全绿。
This commit is contained in:
@@ -1,12 +1,11 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""生成 docs/images/ADC直流标定与交流验证.svg —— 上下两条泳道讲清"同一个针脚、两种证法"：
|
||||
上排 = 已做完的直流静态标定（一条水平线的高度），下排 = 本文新增的交流正弦验证
|
||||
上排 = 直流静态标定（一条水平线的高度），下排 = 交流正弦验证
|
||||
（整条时间轴的形状与节拍），底部 = 只有正弦能证的六件事 + 安全红线（纯标准库）。
|
||||
|
||||
为什么不用 Mermaid：本图要的是"两条流水线一一对齐 + 波形示意"，Mermaid 画不出
|
||||
20 点/周的正弦采样点，也无法把上下一一对齐。谁挡谁的顺序拓扑仍是 Mermaid，
|
||||
见 docs/任务规划/数据可信.md §6。
|
||||
20 点/周的正弦采样点，也无法把上下一一对齐。
|
||||
|
||||
用法（仓库根目录，任意 python3）：
|
||||
python tools/arch_diagram/gen_data_trust_dc_ac_svg.py
|
||||
@@ -67,13 +66,13 @@ BG_AMBER = "#fffbeb"
|
||||
|
||||
# ----------------------------- 数据（改这里）-----------------------------
|
||||
TITLE = "同一个针脚，两种证法 —— 直流只证「高度」，正弦才证「形状与节拍」"
|
||||
SUB1 = ("上排已做完（2026-10-27 静态注入六项判据全 PASS）；下排一次也没做过：正弦波从没进过这条链，"
|
||||
"所以后面的相量、测频、削顶、谐波对不对，现在无人能答")
|
||||
SUB1 = ("上排 2026-10-27 静态注入六项判据全 PASS；下排 2026-11-02 / 11-04 台架两轮跑完六轮，"
|
||||
"幅值 / 波形 / 相位 / 测频 / 削顶 / 谐波全部闭合")
|
||||
SUB2 = ("两排共用同一个注入点、同一套前端、同一份折算代码 —— 差别只在信号源是「平的」还是「会走 20 点/周的正弦」")
|
||||
|
||||
LANE_A_LABEL = "上排 · 直流静态标定（已做）"
|
||||
LANE_A_GLYPH = "flat"
|
||||
LANE_B_LABEL = "下排 · 交流正弦验证（本文新增 · 待做）"
|
||||
LANE_B_LABEL = "下排 · 交流正弦验证（已做两轮）"
|
||||
LANE_B_GLYPH = "sine"
|
||||
|
||||
# 每条泳道 6 个环节：(标题, 说明 1, 说明 2)
|
||||
@@ -86,12 +85,12 @@ BOXES_A = [
|
||||
("三点线性拟合", "0 / 0.5 / 1.0 V", "R² = 0.9999997，斜率差 −0.14 %"),
|
||||
]
|
||||
BOXES_B = [
|
||||
("信号发生器", "50 Hz 正弦", "幅度按峰值算，见底部红线"),
|
||||
("注入点 R31", "同上排同一个点", "外串 10 k、与板共地"),
|
||||
("前端 + 转换器", "同上排同一条链", "STM32 五路负半周必削顶"),
|
||||
("信号发生器", "50 Hz 正弦", "幅度按 Vpp 设定，见底部红线"),
|
||||
("注入点 R31", "同一条注入点", "外串 10 k、与板共地"),
|
||||
("前端 + 转换器", "同一套前端", "STM32 五路负半周必削顶"),
|
||||
("1 kHz 采样点", "TIM3 TRGO 同时触发", "50 Hz → 20 点/整周"),
|
||||
("全周傅氏", "phasor_run()：√2/N 预乘", "直接得有效值与相位"),
|
||||
("读数出口", "meas 200 ms → 104 YC 0x4011", "幅值 + 品质 + 频率（或 UI）"),
|
||||
("读数出口", "meas 200 ms + 录波段文件", "幅值 + 品质 + 频率"),
|
||||
]
|
||||
|
||||
CHIPS_TITLE = "只有正弦能证的六件事（直流在构造上就证不到）"
|
||||
@@ -101,7 +100,7 @@ CHIPS = [
|
||||
("相位", "φ = atan2(fIm, fRe) 全靠正弦才有意义"),
|
||||
("测频 freq_run", "共轭乘积取相位增量；直流相位不前进 → 恒无效"),
|
||||
("削顶路由 CLIPPED", "UB/UC/IB/IC/IN 单极性 0~3.3 V，负半周必削顶 → 该报 IV 就得报 IV"),
|
||||
("谐波实例 C04 / C05", "二次 / 五次相量已建但无消费者：发生器给含谐波信号才能验"),
|
||||
("谐波实例 C04 / C05", "二次 / 五次相量：单注 100 / 250 Hz 已验各认各的次，叠加工况待标准源"),
|
||||
]
|
||||
|
||||
NOTES = [
|
||||
@@ -115,8 +114,8 @@ NOTES = [
|
||||
"跨转换器相位：UB/UC 与 UA 分属两片转换器、无共同采样触发（V0.1 硬件缺陷），任何相位比较都不作数。"]),
|
||||
]
|
||||
|
||||
FOOTNOTE = ("读数出口现在就有：104 YC（test/host/iec104_master.py，浮点无量化）+ 串口每 10 s 的 phasor(hb) / freq(hb) / meas: 行；"
|
||||
"但板上没有「把窗里 20 个点导出来」的出口，正弦只能靠派生标量证，而 phasor 行是 ×0.1 定点（注 1 V 只剩 10 格）。")
|
||||
FOOTNOTE = ("读数出口：串口每 10 s 的 phasor(hb) / freq(hb) / meas: 行，加上录波段文件（一次 320 点 / 8 路，PC 侧 wave_read.py 可 dump / fft / shape / plot）；"
|
||||
"心跳行是 ×0.1 定点（注 1 V 只剩 10 格），定量判据一律走段文件重算。")
|
||||
|
||||
# ----------------------------- 布局 -----------------------------
|
||||
LANE_TOP_A = 108
|
||||
|
||||
@@ -1,11 +1,10 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""生成 docs/images/数据可信台阶.svg —— 「数据可信」的五级台阶：现在踩在第 2 级，
|
||||
第 3 级（动态正弦波形）用手边设备就能跨（纯标准库）。
|
||||
"""生成 docs/images/数据可信台阶.svg —— 「数据可信」的五级台阶：现在踩在第 3 级，
|
||||
第 4、5 级（端子二次值 / 精度验收）在等外部资源（纯标准库）。
|
||||
|
||||
为什么不用 Mermaid：本图要读的是"台阶的高度差 + 每一级踩没踩上去"——Mermaid 会把
|
||||
五级压成同一高度，"还差一级"这件事就看不出来了。谁挡谁的顺序拓扑另有一张 Mermaid
|
||||
图，在 docs/任务规划/数据可信.md §6（本图刻意不重复那张的语义）。
|
||||
五级压成同一高度，"还差一级"这件事就看不出来了。
|
||||
|
||||
用法（仓库根目录，任意 python3）：
|
||||
python tools/arch_diagram/gen_data_trust_ladder_svg.py
|
||||
@@ -60,11 +59,11 @@ C_BLUE = "#2563eb"
|
||||
BG_BLUE = "#eff6ff"
|
||||
|
||||
# ----------------------------- 数据（改这里） -----------------------------
|
||||
TITLE = "「数据可信」是五级台阶 —— 现在踩在第 2 级"
|
||||
TITLE = "「数据可信」是五级台阶 —— 现在踩在第 3 级"
|
||||
SUB1 = ("每升一级只多答一个问题：通路活 → 静态读数对 → 动态波形对 → 换算到端子 → 精度达标；"
|
||||
"台阶的高度差 = 下游能多信多少")
|
||||
SUB2 = ("第 3 级不要标准源、也不要往端子加压：一台信号发生器 + 已有的注入点就能做"
|
||||
"（判据见 docs/任务规划/数据可信.md §4.6）")
|
||||
SUB2 = ("第 3 级已台架闭环（2026-11-02 / 11-04 两轮），用的是手边发生器 + 已有的注入点；"
|
||||
"第 4、5 级在等子板变比与标准源")
|
||||
|
||||
# 每列：(编号, 台阶名, 状态, 主色, 底色, 这一级多答的问题, 用什么证 / 什么挡路)
|
||||
STEPS = [
|
||||
@@ -74,10 +73,9 @@ STEPS = [
|
||||
("2", "静态引脚电压", "已证 · 2026-10-27", C_GREEN, BG_GREEN,
|
||||
"注 1 V 直流，读数是不是 1 V？",
|
||||
"万用表 + 电位器三点线性：斜率 6544.2 vs 理论 6553.6 码/V，差 −0.14 %"),
|
||||
("3", "动态引脚波形", "待做 · 本文新增", C_ROSE, BG_ROSE,
|
||||
("3", "动态引脚波形", "已证 · 2026-11-04", C_GREEN, BG_GREEN,
|
||||
"注 1 V 正弦，算出来还是不是 1 V？",
|
||||
"注正弦验全周傅氏幅值 / 相位 / 测频 / 削顶 / 谐波抑制。"
|
||||
"挡路：FREQ_AMP_MIN = 50 V 在引脚域恒不过 → 测频只能读到 IV"),
|
||||
"幅值 / 波形 / 相位 / 测频 / 削顶 / 谐波六轮全跑；测频轮以「如实报不可测」通过"),
|
||||
("4", "端子二次值", "等外部资源", C_AMBER, BG_AMBER,
|
||||
"引脚上这 1 V 对应端子侧几 V？",
|
||||
"④ 子板 / 端子板变比：仓内无原理图，须拿图纸或万用表实测"),
|
||||
|
||||
Reference in New Issue
Block a user