79 lines
4.8 KiB
Markdown
79 lines
4.8 KiB
Markdown
# 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 会自动处理）
|