feat: HDMI-Tool 启动时强制扩展显示拓扑 + 收录波形/注入脚本

2026-09-10 19:47:39 +08:00
parent 65c85c2844
commit 1f7e697558
8 changed files with 749 additions and 18 deletions
@@ -19,6 +19,7 @@ HDMI EDID 查看器 + 测试图案投屏工具
 命令行模式(自动化测试用):
  python hdmi_gui.py                        启动 GUI
  python hdmi_gui.py --dump                 控制台输出 EDID 解算结果
+  python hdmi_gui.py --edid-fields          控制台输出 EDID 逐字节字段解析表
  python hdmi_gui.py --test-pattern Checker --seconds 3
                                            直接出图案, 3 秒自动退出
  python hdmi_gui.py --test-pattern Blue --area 800x600
@@ -319,6 +320,24 @@ def apply_mode(device, dm):
    return r == 0, r          # DISP_CHANGE_SUCCESSFUL == 0


+def ensure_display_extend():
+    """把 Windows 显示拓扑强制为"扩展"。
+
+    LT8619C 转接板热插拔后, 若 Windows 停留在"仅电脑屏幕"拓扑(会记住上次
+    Win+P 的选择), 板卡的 EDID 虽已安装、GPU 也在按首选时序输出, 但桌面
+    并未扩展过去, get_displays() 就枚举不到这块"显示器"。
+
+    返回 SetDisplayConfig 的返回码(0=成功); 任何异常静默, 不影响工具启动。
+    """
+    try:
+        SDC_TOPOLOGY_EXTEND = 0x00000004
+        SDC_APPLY = 0x00000080
+        return ctypes.windll.user32.SetDisplayConfig(
+            0, None, 0, None, SDC_TOPOLOGY_EXTEND | SDC_APPLY)
+    except Exception:
+        return -1
+
+
 # ============================================================
 #  EDID 1.4 / CEA-861 解析
 # ============================================================
@@ -439,8 +458,8 @@ def parse_edid(raw):
    if raw[24] & 0x80: feats.append('DPMS 待机')
    if raw[24] & 0x40: feats.append('DPMS 挂起')
    if raw[24] & 0x20: feats.append('DPMS 关闭')
-    if raw[24] & 0x08: feats.append('sRGB 特性')
-    if raw[24] & 0x04: feats.append('首选时序=原生')
+    if raw[24] & 0x04: feats.append('sRGB 特性')
+    if raw[24] & 0x02: feats.append('首选时序=原生')
    e['features'] = ', '.join(feats)

    # 已建立时序位域
@@ -600,9 +619,258 @@ def hex_dump(b):
    for row in range((len(b) + 15) // 16):
        off = row * 16
        chunk = b[off:off + 16]
-        hx = ' '.join(f'{v:02X}' for v in chunk)
+        # 8+8 分组, 组间双空格: 同步头/厂商段一眼分开
+        hx = ' '.join(f'{v:02X}' for v in chunk[:8]) + '  ' + \
+            ' '.join(f'{v:02X}' for v in chunk[8:])
        asc = ''.join(chr(v) if 32 <= v < 127 else '.' for v in chunk)
-        out.append(f'{off:04X}:  {hx:<48}  {asc}')
+        out.append(f'{off:04X}:  {hx:<50}  {asc}')
+    return '\n'.join(out)
+
+
+# ============================================================
+#  EDID 逐字节字段解析(调试视图): 基础块 + CTA-861 扩展块
+#  每个字段一行: [偏移] 原始字节 | 含义 | 解码值 | 备注
+# ============================================================
+B_HEAD = '同步头 00 FF FF FF FF FF FF 00'
+
+
+def _range_limits(d):
+    """FD 频率范围描述符(18 字节常规布局) -> V/H 范围与像素时钟上限"""
+    try:
+        return (f"V {d[5]}~{d[6]}Hz, H {d[7]}~{d[8]}kHz, "
+                f"像素时钟上限 {d[9] * 10}MHz")
+    except (IndexError, ValueError):
+        return ''
+
+
+def _bits(b, on, off=None):
+    return f'{b:02X}: ' + ('; '.join(on) if on else (off or '无置位'))
+
+
+def edid_field_rows(raw):
+    """把 EDID(128/256 字节)逐字段解成 [(偏移, 原始字节, 含义, 解码值, 备注), ...]"""
+    rows = []
+    n = len(raw)
+
+    def add(off, ln, meaning, val, note=''):
+        hx = raw[off:off + ln].hex(' ').upper()
+        if ln > 18:                      # 超长区域(如零填充)截断, 完整数据看 hex dump
+            hx = raw[off:off + 18].hex(' ').upper() + f' …(共 {ln} 字节)'
+        rows.append((f'0x{off:02X}-{off + ln - 1:02X}' if ln > 1 else f'0x{off:02X}',
+                     hx, meaning, str(val), note))
+
+    add(0, 8, B_HEAD, 'OK' if raw[0:8] == bytes.fromhex('00FFFFFFFFFFFF00') else '不匹配!',
+        '不许改, 用于同步识别')
+    # 8-9 厂商 ID: 16 位大端, 3 组 5bit 压缩大写字母(块内唯一大端字段)
+    mfr = ''.join([chr(((raw[8] & 0x7C) >> 2) + 64),
+                   chr((((raw[8] & 0x03) << 3) | ((raw[9] & 0xE0) >> 5)) + 64),
+                   chr((raw[9] & 0x1F) + 64)])
+    add(8, 2, '厂商 ID(大端)', mfr,
+        f"3×5bit 压缩字母, 原始 0x{(raw[8] << 8) | raw[9]:04X}; 正式产品应使用注册的 PNP ID")
+    add(10, 2, '产品码(小端)', f"0x{struct.unpack_from('<H', raw, 10)[0]:04X} ({struct.unpack_from('<H', raw, 10)[0]})",
+        '厂商自定')
+    add(12, 4, '序列号(小端)', f"0x{struct.unpack_from('<I', raw, 12)[0]:08X}",
+        '厂商自定')
+    add(16, 1, '生产周', f"第 {raw[16]} 周", '0 = 不指定')
+    add(17, 1, '生产年', f"{1990 + raw[17]} 年", '字节值 + 1990')
+    add(18, 2, 'EDID 版本号', f"{raw[18]}.{raw[19]}", '常用 1.4 / 1.3(即字节 01 04 / 01 03)')
+
+    # 字节 0x14 输入类型
+    if raw[20] & 0x80:
+        itf, bpc = INTERFACES[raw[20] & 0x7], DEPTHS[(raw[20] >> 4) & 0x7]
+        val = f'数字 / {itf}' + (f' / {bpc}bpc' if bpc else ' / 色深未定义')
+    else:
+        val = '模拟输入'
+    add(20, 1, '输入类型', val,
+        'bit7=1 数字; 低 4 位: 1=HDMI-A 2=HDMI-B 4=DP 5=eDP')
+
+    add(21, 1, '最大画面宽(cm)', raw[21], '0 = 未知(横竖比由 DTD 图像尺寸给出)')
+    add(22, 1, '最大画面高(cm)', raw[22], '0 = 未知')
+    add(23, 1, 'Gamma', f"{(raw[23] + 100) / 100:.2f}" if raw[23] else '(未提供)',
+        '存储值 = gamma×100 − 100(如 0x78 → 2.20); 0xFF = 不提供')
+    add(24, 1, '特性位', _bits(raw[24], [
+        *(['DPMS 待机'] if raw[24] & 0x80 else []),
+        *(['DPMS 挂起'] if raw[24] & 0x40 else []),
+        *(['DPMS 关闭'] if raw[24] & 0x20 else []),
+        *([f"显示色彩 {['RGB 4:4:4', 'RGB+YCrCb 4:4:4', 'RGB+YCrCb 4:2:2', '未定义'][(raw[24] >> 3) & 3]}"]
+           if raw[24] & 0x80 else []),
+        *(['sRGB 默认'] if raw[24] & 0x04 else []),
+        *(['首选时序=原生分辨率'] if raw[24] & 0x02 else []),
+        *(['连续频率/GTF'] if raw[24] & 0x01 else []),
+    ]), 'bit2 sRGB / bit1 首选时序有效 / bit0 连续频率')
+    add(25, 10, '色度坐标(CIE xy)', '默认 sRGB 模板' if raw[25:35] == bytes.fromhex(
+        '78EE95A3554D9EA6544C') else '(打包位段)', '红绿蓝白四点 xy 各 10bit 打包, 通常照抄模板')
+    est = []
+    est_bits = 0
+    for i in range(24):
+        bit = 7 - (i % 8)
+        if (raw[35 + i // 8] >> bit) & 1:
+            est_bits |= 1 << (23 - i)
+            if EST_TABLE[i] != '-':
+                est.append(EST_TABLE[i])
+    if est:
+        add(35, 3, 'Established Timing 位图', ', '.join(est),
+            'VESA 老 VGA 时序; 数字屏常写 FF FF 00=全支持')
+    else:
+        add(35, 3, 'Established Timing 位图',
+            '无有效声明' + ('(仅保留位置位)' if est_bits else ''),
+            'VESA 老 VGA 时序; 数字屏常写 FF FF 00=全支持')
+    stds = []
+    for i in range(38, 54, 2):
+        a, b = raw[i], raw[i + 1]
+        if (a == 1 and b == 1) or (a == 0 and b == 0):
+            continue
+        h = (a + 31) * 8
+        ar = STD_ASPECT[(a >> 6) & 3][1]
+        stds.append(f"{h}x{round(h * STD_ASPECT[(a >> 6) & 3][0])}@{b + 60} {ar}")
+    add(38, 16, '标准时序 ×8', '; '.join(stds) if stds else '8 槽全部未用(01 01)',
+        '2 字节/槽: 6bit 宽 + 2bit 比例 + 刷新率−60; 未用槽填 01 01')
+
+    # 0x36-0x7D: 4 × 18 字节描述符
+    for k, d in enumerate(range(54, 126, 18)):
+        grp = raw[d:d + 18]
+        if grp[0] or grp[1]:
+            t = parse_dtd(raw, d)
+            note = (f"{'(隔行)' if t['interlaced'] else '(逐行)'} "
+                    f"{t['sync_type']} {'/'.join(t['polarity'].split())}; "
+                    f"消隐 H{t['hblank']}/V{t['vblank']}, "
+                    f"前/同/后 H{t['hfront']}/{t['hsync']}/{t['htotal'] - t['hact'] - t['hfront'] - t['hsync']} "
+                    f"V{t['vfront']}/{t['vsync']}/{t['vtotal'] - t['vact'] - t['vfront'] - t['vsync']}")
+            add(d, 18, f'描述符{k + 1}: DTD(详细时序)',
+                f"{t['hact']}×{t['vact']}@{t['refresh']}Hz  "
+                f"总 {t['htotal']}×{t['vtotal']}  {t['clk_khz'] / 1000:.3f}MHz"
+                + (' [首选时序]' if k == 0 else ''),
+                note + ('; 图像尺寸 %dx%d mm' % (t['him_mm'], t['vim_mm']) if t['him_mm'] else ''))
+        else:
+            tag = grp[3]
+            txt = _ascii(raw, d + 5, 13)
+            if tag == 0xFF:
+                add(d, 18, f'描述符{k + 1}: 序列号串(0xFF)', repr(txt), 'ASCII, 上限 13 字节')
+            elif tag == 0xFC:
+                add(d, 18, f'描述符{k + 1}: 显示器名(0xFC)', repr(txt), 'ASCII, 上限 13 字节')
+            elif tag == 0xFD:
+                add(d, 18, f'描述符{k + 1}: 范围限制(0xFD)', _range_limits(grp), '频率范围描述符')
+            elif tag == 0xFE:
+                add(d, 18, f'描述符{k + 1}: 无界文本(0xFE)', repr(txt), '')
+            elif tag == 0x10:
+                add(d, 18, f'描述符{k + 1}: 数据串(0x10)', grp[5:18].hex(' ').upper(), '二进制用途')
+            elif tag == 0 and not any(grp):
+                add(d, 18, f'描述符{k + 1}: 空', '(全 00)', '')
+            else:
+                add(d, 18, f'描述符{k + 1}: 未知类型 0x{tag:02X}', grp[5:18].hex(' ').upper(), '')
+
+    add(126, 1, '扩展块数量', raw[126], '必须与实际扩展块数一致')
+    cksum = (256 - sum(raw[0:127])) & 0xFF
+    add(127, 1, '基础块校验和', f"0x{raw[127]:02X} → " + ('正确' if (sum(raw[0:128]) & 0xFF) == 0 else '错误!'),
+        f"整块 128 字节和 ≡ 0 (mod 256); 期望 0x{cksum:02X} = 256 − 前 127 字节和")
+
+    # ---- CTA-861 扩展块 ----
+    n_ext = raw[126] if n > 126 else 0
+    for bi in range(n_ext):
+        base = 128 + bi * 128
+        if base + 128 > n:
+            add(base, 0, f'扩展块{bi + 1}', '(数据不完整)', '')
+            break
+        blk = raw[base:base + 128]
+        add(base, 1, f'扩展块{bi + 1} @0x{base:02X} Tag',
+            'CTA-861' if blk[0] == 0x02 else f'0x{blk[0]:02X}(非 CTA)',
+            '固定 0x02 = CTA 扩展; HDMI 必须有')
+        if blk[0] != 0x02:
+            add(base + 1, 127, '扩展块数据', blk[1:128].hex(' ').upper(), '未知扩展类型, 跳过')
+            continue
+        add(base + 1, 1, '版本', f"rev {blk[1]}", '常用 03')
+        add(base + 2, 1, 'DTD 起始偏移', f"0x{blk[2]:02X} (= 块内 {blk[2]} 字节处)", '数据块链结束、DTD 区开始的偏移')
+        add(base + 3, 1, '标志位', _bits(blk[3], [
+            *(['bit7 支持 YCbCr 4:2:0'] if blk[3] & 0x80 else []),
+            *(['bit6 支持基础音频'] if blk[3] & 0x40 else []),
+            *(['bit5 支持 YCbCr 4:2:2'] if blk[3] & 0x20 else []),
+            *(['bit4 支持 YCbCr 4:4:4'] if blk[3] & 0x10 else []),
+            *(['bit0 支持欠扫描'] if blk[3] & 0x01 else []),
+        ]), 'bit6=基础音频, bit5=4:2:2, bit7=4:2:0, bit0=欠扫描')
+
+        # 数据块链: 每块 1 字节头(高 3 位 tag + 低 5 位长度) + payload
+        TAG_NAMES = {1: '音频', 2: '视频 VIC', 3: '厂商专用 VSDB', 4: '扬声器分配',
+                     5: 'VESA DTC', 6: '视频格式 VFDB', 7: '扩展 tag'}
+        p, first = 4, True
+        while base + p < base + 128 and p < blk[2] and p + 1 < 128:
+            tag, length = (blk[p] >> 5) & 7, blk[p] & 0x1F
+            payload = blk[p + 1:p + 1 + length]
+            if first and blk[p] == 0:
+                add(base + p, 1, '数据块链', '(无数据块, 直接进 DTD 区)', '4 至 DTD 区前为数据块链')
+                break
+            first = False
+            if tag == 2:
+                vics = []
+                for v in payload:
+                    vi = v & 0x7F
+                    name = (VIC_TABLE[vi - 1] if 1 <= vi <= len(VIC_TABLE) else None) or f'VIC#{vi}'
+                    vics.append(name + ('(原生)' if v & 0x80 else ''))
+                add(base + p, 1 + length, '数据块: 视频', '  '.join(vics) or '(空)', f"tag 2, {length} 字节")
+            elif tag == 1:
+                fmts = []
+                codes = ['保留', 'LPCM', 'AAC', 'AC-3', 'MPEG1', 'MP3', 'MPEG2', 'AAC LC',
+                         'DTS', 'ATRAC', 'DSD', 'E-AC-3', 'DTS-HD', 'MLP', 'DST', 'WMAPro']
+                for si in range(length // 3):
+                    sad = payload[si * 3:(si + 1) * 3]
+                    ch = (sad[0] & 7) + 1
+                    rates = '/'.join(str(r) for r, b in ((32, 1), (44, 2), (48, 4)) if sad[2] & b) or '?'
+                    mults = ''.join(f'×{m}' for m, b in ((2, 8), (3, 16), (4, 32)) if sad[2] & b)
+                    if (sad[0] >> 3) & 0xF == 1:      # LPCM: 位宽在字节1低3位(位图)
+                        bits = '/'.join(str(v) for v, b in ((16, 1), (20, 2), (24, 4)) if sad[1] & b) or '?'
+                        fmts.append(f'LPCM {ch}ch {bits}bit {rates}kHz{mults}')
+                    else:                              # 压缩格式: 字节1高4位=最高采样率档
+                        fmts.append(f"{codes[(sad[0] >> 3) & 0xF]} {ch}ch {rates}kHz{mults}")
+                add(base + p, 1 + length, '数据块: 音频', '; '.join(fmts), f"tag 1, {length // 3} × 3 字节 SAD")
+            elif tag == 3:
+                oui = bytes(payload[0:3])
+                names = {b'\x03\x0c\x00': 'HDMI 1.x VSDB', b'\xd8\x5d\xc4': 'HDMI 2.0 HF-VSDB'}
+                val = names.get(oui, f'OUI={oui.hex(" ").upper()}')
+                if oui == b'\x03\x0c\x00' and length >= 7:
+                    val += f", 物理地址 {'.'.join(str(b) for b in payload[3:7])}"
+                add(base + p, 1 + length, '数据块: 厂商专用', val,
+                    f"tag 3, 头 3 字节 IEEE OUI(小端){'; HDMI 2.0 需 HF-VSDB' if oui == b'\x03\x0c\x00' else ''}")
+            else:
+                name = TAG_NAMES.get(tag, f'tag{tag}')
+                add(base + p, 1 + length, f'数据块: {name}',
+                    payload.hex(' ').upper() if length else '(空)', f"{length} 字节 payload")
+            if length == 0:
+                break
+            p += 1 + length
+
+        # DTD 区
+        if blk[2] >= 4:
+            q, cnt = blk[2], 0
+            while q + 18 <= 128 and any(blk[q:q + 2]):
+                t = parse_dtd(blk, q)
+                add(base + q, 18, f'扩展块 DTD{cnt + 1}',
+                    f"{t['hact']}×{t['vact']}@{t['refresh']}Hz  总 {t['htotal']}×{t['vtotal']}  "
+                    f"{t['clk_khz'] / 1000:.3f}MHz",
+                    "前/同/后 H%d/%d/%d V%d/%d/%d %s" % (
+                        t['hfront'], t['hsync'], t['htotal'] - t['hact'] - t['hfront'] - t['hsync'],
+                        t['vfront'], t['vsync'], t['vtotal'] - t['vact'] - t['vfront'] - t['vsync'],
+                        '(隔行)' if t['interlaced'] else '(逐行)'))
+                cnt += 1
+                q += 18
+            if not cnt:
+                add(base + blk[2], 0, '扩展块 DTD 区', '(空)', '未用空间填 0')
+        rem = 128 - max(blk[2], 4) - 18 * cnt if blk[2] >= 4 else 0
+        if blk[2] >= 4 and rem > 0 and not any(blk[128 - rem:128 - 1]):
+            add(base + 128 - rem, rem - 1, '未用空间', '0 填充', '')
+        add(base + 127, 1, f'扩展块{bi + 1} 校验和',
+            f"0x{blk[127]:02X} → " + ('正确' if (sum(blk) & 0xFF) == 0 else '错误!'),
+            f"期望 0x{(256 - sum(blk[0:127])) & 0xFF:02X} (同基础块规则)")
+    return rows
+
+
+def edid_field_text(raw):
+    """逐字段解析 -> 多行文本(命令行 / 文本框共用)"""
+    w = (7, 26, 20)
+    out = ['%-*s  %-*s %-*s %s' % (w[0], '偏移', w[1], '含义', w[2], '解码值', '备注 / 原始字节')]
+    for off, hx, meaning, val, note in edid_field_rows(raw):
+        line = '%-*s  %-*s %-*s %s' % (w[0], off, w[1], meaning, w[2], val, note)
+        out.append(line.rstrip())
+        if hx:
+            out.append('%-*s  %-*s %s %s' % (w[0], '', w[1], '', '原始', hx))
    return '\n'.join(out)


@@ -815,10 +1083,10 @@ def run_gui(auto_close=0):
            for key in ('Red', 'Green', 'Blue', 'Checker', 'Grid'):
                ttk.Button(row1, text=PATTERN_NAMES[key], width=12,
                           command=lambda k=key: self._show_pattern(k)).pack(side='left', padx=5)
-            # 纯色测试值三行(R/G/B 按通道分组, 位交换测试用)
+            # 纯色测试值: 保持"通道标签 + 55/AA/FF 按钮"形式, 三组横向一行排布
+            rowf = ttk.Frame(grp)
+            rowf.pack(fill='x', pady=(3, 0))
            for ch, items in SOLID_ROWS:
-                rowf = ttk.Frame(grp)
-                rowf.pack(fill='x', pady=(3, 0))
                ttk.Label(rowf, text=f'{ch}: 0x', width=4).pack(side='left')
                for label, color in items:
                    ttk.Button(rowf, text=label, width=5,
@@ -845,9 +1113,13 @@ def run_gui(auto_close=0):
            ttk.Label(row2, text='自定义: 点击投图, ⚙ 配置名称与图片(图片保存在脚本目录)',
                      foreground='#666666').pack(side='left', padx=10)

-            # --- 底部: EDID hex dump ---
+            # --- 底部: EDID hex dump + 逐字节解析按钮 ---
            bot = ttk.LabelFrame(self, text='EDID 原始数据', padding=4)
            bot.pack(fill='both', expand=False, padx=8, pady=(6, 8))
+            side = ttk.Frame(bot)
+            side.pack(side='right', fill='y')
+            ttk.Button(side, text='逐字节解析', width=10, command=self._show_edid_fields
+                       ).pack(side='top', pady=(2, 4))
            self.txt_hex = tk.Text(bot, height=8, font=('Consolas', 9),
                                   state='disabled', wrap='none', background='#101010',
                                   foreground='#C8C8C8')
@@ -909,6 +1181,41 @@ def run_gui(auto_close=0):
            self.area = self.area_var.get()
            save_slots(self.slots, self.area)

+        def _show_edid_fields(self):
+            """逐字节字段解析弹窗(当前所选显示器), 自动换行文本视图"""
+            from tkinter import messagebox
+            idx = self.cbo.current()
+            if idx < 0 or idx >= len(self.displays):
+                return
+            raw = self.displays[idx]['edid']
+            if not raw:
+                messagebox.showinfo('无 EDID', '该显示器注册表中没有 EDID 数据, 无法逐字节解析')
+                return
+            dlg = tk.Toplevel(self)
+            dlg.title(f'EDID 逐字节解析 — {self.displays[idx]["device"]}  '
+                      f'[{self.displays[idx]["mon_name"]}]')
+            dlg.geometry('1180x720')
+            txt = tk.Text(dlg, font=('Microsoft YaHei UI', 9), wrap='char',
+                          background='#101010', foreground='#C8C8C8',
+                          padx=10, pady=8)
+            sb = ttk.Scrollbar(dlg, orient='vertical', command=txt.yview)
+            txt.configure(yscrollcommand=sb.set)
+            txt.pack(side='left', fill='both', expand=True)
+            sb.pack(side='right', fill='y')
+            # 字段行加亮, 原始字节补充行暗色, 换行内容自动缩进可读
+            for off, hx, meaning, val, note in edid_field_rows(raw):
+                txt.insert('end', f'{off}  {meaning}  {val}\n', 'field')
+                if hx:
+                    txt.insert('end', f'        原始: {hx}\n', 'raw')
+                if note:
+                    txt.insert('end', f'        {note}\n', 'note')
+            txt.tag_configure('field', foreground='#E8E8E8')
+            txt.tag_configure('raw', foreground='#7F7F7F')
+            txt.tag_configure('note', foreground='#9FB8CC')
+            txt.configure(state='disabled')
+            ttk.Button(dlg, text='关闭', command=dlg.destroy).pack(pady=(0, 6))
+            dlg.grab_set()
+
        def _show_solid(self, color):
            idx = self.cbo.current()
            if idx < 0 or idx >= len(self.displays):
@@ -1041,7 +1348,7 @@ def run_gui(auto_close=0):
 # ============================================================
 #  入口
 # ============================================================
-def run_dump():
+def run_dump(edid_fields=False):
    displays = get_displays()
    if not displays:
        print('未找到活动显示器')
@@ -1053,6 +1360,9 @@ def run_dump():
        if not d['edid']:
            print('   EDID 读取失败(注册表无 EDID 数据)')
            continue
+        if edid_fields:
+            print(edid_field_text(d['edid']))
+            continue
        e = parse_edid(d['edid'])
        for k, v in edid_info_lines(e):
            print(f'   {k:<14}: {v}')
@@ -1077,6 +1387,8 @@ def run_dump():
 def main():
    ap = argparse.ArgumentParser(description='HDMI EDID 查看器 + 测试图案')
    ap.add_argument('--dump', action='store_true', help='控制台输出 EDID 解算结果, 不开 GUI')
+    ap.add_argument('--edid-fields', action='store_true',
+                    help='控制台输出 EDID 逐字节字段解析表(配合 --dump 风格, 不开 GUI); exe 版不支持')
    ap.add_argument('--test-pattern',
                    choices=list(PATTERN_NAMES) + [f'Custom{i + 1}' for i in range(SLOT_COUNT)],
                    default=None, help='直接全屏出测试图案(不开主窗口; CustomN 为自定义栏位)')
@@ -1086,16 +1398,21 @@ def main():
    ap.add_argument('--seconds', type=int, default=0, help='自动退出秒数(GUI/图案冒烟测试)')
    args = ap.parse_args()

-    if args.dump:
+    # LT8619C 板卡热插拔后可能停留在"仅电脑屏幕"拓扑, 先强制扩展,
+    # 否则 get_displays() 枚举不到板卡的"显示器"(失败静默)
+    ensure_display_extend()
+
+    if args.dump or args.edid_fields:
        if getattr(sys, 'frozen', False):
            # --noconsole 打包的 exe 没有控制台可写, 引导用户用源码方式
            import tkinter as tk
            from tkinter import messagebox
            r = tk.Tk()
            r.withdraw()
-            messagebox.showinfo('不支持', 'exe 版本无控制台输出。\n请用源码方式运行:\npython hdmi_gui.py --dump')
+            messagebox.showinfo('不支持', 'exe 版本无控制台输出。\n请用源码方式运行:\n'
+                                'python hdmi_gui.py --edid-fields')
            sys.exit(1)
-        sys.exit(run_dump())
+        sys.exit(run_dump(edid_fields=args.edid_fields))
    if args.test_pattern:
        displays = get_displays()
        if not displays: