HW-Debug-Tools/HDMI-Tool

HDMI-Tool — HDMI 源端测试工具（LT8619C/DLPC3421 转接板调试）

更新：2026-09-04。单文件 Python GUI（hdmi_gui.py），另附命令行分辨率/图案工具 hdmi_source.bat。已打包版直接双击 HDMI-Tool.exe，无需安装 Python。

---

1. 功能总览

功能	说明
EDID 查看	枚举各显示输出口，从注册表读取 EDID 原始数据，按 EDID 1.4/CEA-861 解算：厂商/型号/尺寸/支持模式（DTD/已建立/标准/CEA-VIC）/首选时序完整参数/校验和
EDID 逐字节解析	"EDID 原始数据"框右上"逐字节解析"按钮：按偏移逐字段展开基础块（同步头/厂商/产品/序列/版本/输入类型/尺寸/Gamma/特性位/色度/已建立+标准时序/4×描述符/扩展块数/校验和）与 CTA-861 扩展块（tag/版本/DTD 偏移/标志位/数据块链/扩展 DTD 区/校验和），每字段附原始字节 hex，自动换行；命令行等价 --edid-fields
分辨率切换	第二行"分辨率"下拉列出显卡按该屏 EDID 提供的全部模式；应用=临时切换（不写注册表，重启还原），恢复=回到本次会话切改前的模式
测试图案	全屏投到所选显示器，测试卡区域可选 640x360 / 800x600 / full 铺满；内置 纯红/纯绿/纯蓝/棋盘格/网格线 + R/G/B 三行纯色值按钮（55/AA/FF，与 dist 下 solid_*.png 对应）+ 3 个自定义图片栏位
命令行模式	自动化测试脚本可直接调用（见 §4）

2. 快速上手（GUI）

1. 双击 HDMI-Tool.exe（或 python hdmi_gui.py，需 Python ≥3.10 + pyserial 不需要，纯标准库；自定义图片 JPG/BMP 需 Pillow）
2. 顶部显示器下拉选择目标屏（多屏时注意别选成主屏），"刷新"重新枚举
3. 切分辨率：第二行选模式 → 点"应用"；测完点"恢复"
4. 投测试图：
   • 先在图案按钮行右侧选测试卡区域（640x360 / 800x600 / full）
   • 点图案按钮即全屏投放；按 ESC 退出
   • R/G/B 三行纯色按钮（55/AA/FF）用于位交换类测试：55 与 AA 互为字节镜像对，FF 为全高基准
   • 自定义图片：点"⚙"配置名称与图片文件（图片会复制到本目录），点栏位名投放
5. 区域与自定义栏位配置自动保存在本目录 pattern_slots.json

3. 典型场景（LT8619C demo 板测试）

1. HDMI 接 demo 板 → 启动 HDMI-Tool → 刷新 → 选中 demo 板显示器
2. 分辨率切 800x600@60（demo 板 shadow EDID 首选）→ 测试卡区域选 800x600
3. 点 R/G/B 行的纯色按钮投图 → 配合逻辑分析仪/万用表测 RGB 输出
4. 测完"恢复"分辨率

4. 命令行模式

python hdmi_gui.py --dump                          控制台输出 EDID 解算（exe 版不支持）
python hdmi_gui.py --edid-fields                   控制台输出 EDID 逐字节字段解析表（exe 版不支持）
python hdmi_gui.py --test-pattern Blue --area 800x600 --seconds 5
                                                   出图 5 秒自动退出
python hdmi_gui.py --test-pattern Custom1          投自定义栏位 1
  --area {640x360,800x600,full}  --monitor N  --seconds S

hdmi_source.bat（PowerShell 源端工具，功能与 GUI 互补）：

tools\hdmi_source.bat -List                        枚举显示器与支持分辨率（验证 EDID）
tools\hdmi_source.bat -Monitor 1 -Mode 800x600     切模式
tools\hdmi_source.bat -Mode 800x600 -Pattern -Restore
                                                   切模式→出图案→退出后自动恢复

5. 目录内容

文件	用途
HDMI-Tool.exe	打包好的单文件版（--noconsole；--dump 请用源码方式跑）
hdmi_gui.py	主程序源码
build_exe.py	打包脚本（python build_exe.py，自动装 PyInstaller；--debug 额外出带控制台版）
hdmi_source.ps1 / .bat	源端分辨率/图案命令行工具
gen_bw_patterns.py / gen_solid_colors.py	测试图生成脚本（bw 黑白系列 640x360 / solid 纯色系列 800x600）
solid_*.png	9 张 800x600 纯色图（R/G/B 各 55/AA/FF，供自定义栏位或脚本使用）
bw_*.png	5 张 640x360 黑白测试图（西门子星/频率条纹/渐变棋盘/波带/综合卡）
logos/	图标源文件与 make_ico.py（改 logo 后重跑再打包）
pattern_slots.json	自定义栏位 + 测试卡区域配置（运行后自动生成/更新）

6. 注意事项

• 测试卡区域与自定义栏位配置按 exe/脚本所在目录各自保存，两份安装互不影响
• 重打包后 Windows 图标缓存可能仍显示旧图标：ie4uinit -show 或改名即可
• 多屏环境切分辨率前先确认显示器序号（下拉框中名称与 -List 输出一致）
• 修改源码后重新打包前，先结束残留的 HDMI-Tool 进程（build_exe.py 会自动处理）