docs: 六轮验证文档剔除104读数通道+字母编号黑话清扫
注入流程/数据可信/故障录波设计说明三份文档与速查图 全部剔除104作为量测工具(YC交叉、0x401D/0x4012观察项、 §8.6第7步整行;总耗时150改135 min);104仍是固件消费者 与送检参照,架构表述保留。 注入流程全文清扫:A档/B档/定量档/定性档/段档/标量档等 字母编号与黑话清零;波形轮注简化为三句;通用动作段重写 为编号四步。 数据可信属主同步:§4.6前提表、§4.6.2三行判据、§4.6.3 读数点对比表、DoD证据归档口径。 内存内容分配策略.md:22修复编号改名事故(STM32L4被误替换 成「出口与记录」),按git原文恢复。 速查图生成器gen_ac_rounds_svg.py三处文案+脚注同步改并重跑, 脚本与产物同笔提交。
This commit is contained in:
@@ -1,10 +1,10 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""生成 docs/images/交流六轮速查.svg —— 交流(正弦)动态验证六轮:每一轮注什么信号、
|
||||
验什么、主读数走哪个出口,一张图先给全局轮廓,再进 §8.5 逐轮执行卡。
|
||||
验什么、数字从哪儿读,一张图先给全局轮廓,再进 §8.5 逐轮执行卡。
|
||||
|
||||
为什么不用 Mermaid:本图的语义重心是「每轮注入信号的波形形状」与「三块小面板里
|
||||
信号缩略图 + 判据 + 出口的固定排版对位」——Mermaid 画不出正弦/方波/三角/削顶/谐波
|
||||
信号缩略图 + 判据 + 读数的固定排版对位」——Mermaid 画不出正弦/方波/三角/削顶/谐波
|
||||
叠加这些波形,也无法把六格对齐成 3x2 卡片。它只适合关系拓扑(那部分另在
|
||||
docs/测试说明/专项验证/ADC前端注入验证流程.md §8.3 / §8.5 用 Mermaid 表达)。
|
||||
|
||||
@@ -12,7 +12,7 @@ docs/测试说明/专项验证/ADC前端注入验证流程.md §8.3 / §8.5 用
|
||||
python tools/arch_diagram/gen_ac_rounds_svg.py
|
||||
输出:
|
||||
docs/images/交流六轮速查.svg
|
||||
改内容:轮次事实(接法 / 判据 / 出口)变了才重画;调坐标 / 文案编辑下方常量后重跑。
|
||||
改内容:轮次事实(接法 / 判据 / 读数)变了才重画;调坐标 / 文案编辑下方常量后重跑。
|
||||
"""
|
||||
import html
|
||||
import math
|
||||
@@ -74,40 +74,40 @@ GAPY = 14
|
||||
X0 = PAD
|
||||
Y0 = 106
|
||||
THUMB_H = 86
|
||||
LABEL_W = 36 # 「注入 / 判据 / 出口」标签列宽
|
||||
LABEL_W = 36 # 「注入 / 判据 / 读数」标签列宽
|
||||
|
||||
# ----------------------------- 数据(改这里) -----------------------------
|
||||
TITLE = "交流动态验证六轮 —— 每一轮注什么信号、读哪个口"
|
||||
SUB1 = ("一卡一轮:注入信号缩略图 → 接法与设定 → 判据一句话 → 主读数出口。"
|
||||
SUB1 = ("一卡一轮:注入信号缩略图 → 接法与设定 → 判据一句话 → 数字从哪儿读。"
|
||||
"先看图建立全局轮廓,再按 §8.5 的对应执行卡逐轮跑")
|
||||
SUB2 = ("六轮共用同一套接线与通用动作;过判据的属主是 docs/任务规划/数据可信.md §4.6.2,"
|
||||
"本图只是导航,不含新判据")
|
||||
|
||||
# 每卡:(轮名, 角标, 主色, 底色, 波形类型, 注入, 判据, 出口)
|
||||
# 每卡:(轮名, 角标, 主色, 底色, 波形类型, 注入, 判据, 读数的地方)
|
||||
CARDS = [
|
||||
("幅值轮", "先做 · 主用例", C_BLUE, BG_BLUE, "amp",
|
||||
"UA(R31)端子侧,正弦 50.000 Hz、1.000 Vrms",
|
||||
"ua_mv 中位数 ≈ 万用表 × 1000,偏差 ≤2 %",
|
||||
"meas: ua_mv 为主;104 0x4011 只作交叉读数"),
|
||||
("波形轮", "真 RMS ≠ 基波", C_TEAL, BG_TEAL, "three",
|
||||
"同峰值 1.414 V 改方波 / 三角(面板有效值各异)",
|
||||
("幅值轮", "先做 · 三档幅度", C_BLUE, BG_BLUE, "amp",
|
||||
"UA(R31)端子侧,正弦 50.000 Hz,三档 Vpp 2.828 / 1.414 / 0.566",
|
||||
"每档 ua_mv ≈ 万用表 × 1000,偏差 ≤2 %",
|
||||
"meas: ua_mv 为主(1 mV 分辨率)"),
|
||||
("波形轮", "真有效值 ≠ 基波", C_TEAL, BG_TEAL, "three",
|
||||
"同设 Vpp 2.828 V 改方波 / 三角(面板有效值各异)",
|
||||
"读数只跟基波:方波 ≈1278、三角 ≈817,±2 %",
|
||||
"meas: ua_mv;抬头记万用表响应类型"),
|
||||
("相位轮", "定量 · 取段", C_GREEN, BG_GREEN, "phase",
|
||||
"UA(R31)与 UN(R28)同源同幅 1.000 Vrms",
|
||||
("相位轮", "定量 · 录波", C_GREEN, BG_GREEN, "phase",
|
||||
"UA(R31)与 UN(R28)同源同幅 Vpp 2.828 V",
|
||||
"同段内相位差 ≈0°,B 通道改 90° 应跟到 ≈90°,±2°",
|
||||
"wave_read.py fft 定量;phasor(hb) 只核象限"),
|
||||
("测频轮", "A 档无数 = 过", C_AMBER, BG_AMBER, "sweep",
|
||||
"UA 同幅值轮接法,扫 45 / 50 / 55 Hz",
|
||||
"A 档如实报不可测:valid=0、UI 显 --;报 50.00 反而是 bug",
|
||||
"freq(hb) 0.01 Hz;UI Hz、104 0x401D"),
|
||||
"freq(hb) 0.01 Hz;UI Hz"),
|
||||
("削顶轮", "负向 · 单独日志", C_ROSE, BG_ROSE, "clip",
|
||||
"UB(R52):DC −1.00 V 保持 ≥5 s,或 2.0 Hz 正弦",
|
||||
"连续 20 拍贴底 → rail / edge 锁存 + 104 该路 IV 清零;50 Hz 正弦不锁存 = 预期",
|
||||
"cal: rail / edge;取段再跑 shape 对表"),
|
||||
("谐波轮", "定量 · 取段", C_PURPLE, BG_PURPLE, "harm",
|
||||
"IA(R19):基波 0.800 + 二次 0.160 + 五次 0.160 Vrms",
|
||||
"Ia2 / Ia5 各 ≈0.160 Vrms,±2 %(最坏峰值 1.58 V 留余量)",
|
||||
"连续 20 拍贴底 → rail / edge 锁存;50 Hz 正弦不锁存 = 预期",
|
||||
"cal: rail / edge;录波再跑 shape 对表"),
|
||||
("谐波轮", "定量 · 录波", C_PURPLE, BG_PURPLE, "harm",
|
||||
"IA(R19):分三注,基波 Vpp 2.263、二五次各 Vpp 0.453",
|
||||
"Ia2 / Ia5 各读数 ≈0.160 V,±2 %(最坏峰值 1.58 V 留余量)",
|
||||
"wave_read.py fft --ch 4;UI Ia2 / Ia5 目检旁证"),
|
||||
]
|
||||
|
||||
@@ -203,7 +203,7 @@ def thumb(x, y, w, h, kind, c):
|
||||
out.append(line(x + pad, yc - amp, x + w - pad, yc - amp, c, 1.0, dash="5 4"))
|
||||
out.append(line(x + pad, yc + amp, x + w - pad, yc + amp, c, 1.0, dash="5 4"))
|
||||
out.append(poly(_sample(lambda t: math.sin(2 * math.pi * 2 * t), ix, y + pad, iw, ih), c))
|
||||
out.append(txt(x + pad, y + pad - 1, "峰 ±1.414 V · 基波 RMS 1.000 V", TINY_FONT, MUTED))
|
||||
out.append(txt(x + pad, y + pad - 1, "峰 ±1.414 V · 基波有效值 1.000 V", TINY_FONT, MUTED))
|
||||
elif kind == "three":
|
||||
yc = y + h / 2.0
|
||||
amp = ih * 0.36
|
||||
@@ -217,7 +217,7 @@ def thumb(x, y, w, h, kind, c):
|
||||
sx = ix + i * slot
|
||||
out.append(poly(_sample(fv, sx + 6, y + pad, slot - 12, ih, n=120), c, 1.8))
|
||||
out.append(txt(sx + slot / 2, y + h - 2, names[i], TINY_FONT, MUTED, anchor="middle"))
|
||||
out.append(txt(x + pad, y + pad - 1, "同峰值对齐(不是同 Vrms)", TINY_FONT, MUTED))
|
||||
out.append(txt(x + pad, y + pad - 1, "同设 Vpp 2.828 V(不是同有效值)", TINY_FONT, MUTED))
|
||||
elif kind == "phase":
|
||||
out.append(line(x + 4, y + h / 2, x + w - 4, y + h / 2, FAINT, 0.8, dash="3 3"))
|
||||
out.append(poly(_sample(lambda t: math.sin(2 * math.pi * 1.5 * t), ix, y + pad, iw, ih),
|
||||
@@ -290,7 +290,7 @@ def build():
|
||||
add(el)
|
||||
|
||||
ty = cy + 36 + THUMB_H + 16
|
||||
for label, s, mx in (("注入", inj, 2), ("判据", rule, 2), ("出口", ex, 2)):
|
||||
for label, s, mx in (("注入", inj, 2), ("判据", rule, 2), ("读数", ex, 2)):
|
||||
add(txt(cx + 12, ty, label, LABEL_FONT, c, weight=700))
|
||||
for ln in wrap(s, BODY_FONT, body_avail, mx, "card %s %s" % (name, label)):
|
||||
add(txt(body_x, ty, ln, BODY_FONT, INK if label == "判据" else MUTED))
|
||||
|
||||
Reference in New Issue
Block a user