hulk/LT8619C_Debug_Tools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 4 Wiki Activity

feat(HDMI-Tool): v0.2.0 集成光机控制(RS485→GD32网关→DLPC3421) — 本地提交, 待验证后再推送发布

Browse Source
This commit is contained in:
hulk
2026-09-11 00:25:28 +08:00
parent efaf4d658f
commit 2459b33162
8 changed files with 732 additions and 82 deletions
Download Patch File Download Diff File Expand all files Collapse all files
HDMI-Tool/README.md
+95 -52
View File
@@ -1,13 +1,14 @@
# HDMI-Tool — HDMI 源端调试工具
# HDMI-Tool — HDMI 源端调试 + 光机控制工具
> LT8619C（HDMI→RGB888）→ DLPC3421 投影转接板调试配套的 PC 端工具：
> 在 HDMI **源端**（电脑显卡输出）完成 EDID 查看、分辨率切换、纯色/测试图案全屏投屏。
> HDMI **源端**（EDID 查看、分辨率切换、纯色/测试图案投屏）+ **光机控制**
> （RS485 直连板上 GD32 网关，开关光机/设光强/查温度电流）。
>
> - **只想用工具**：到 [Gitea Releases](https://gitea.hulk.wang/hulk/LT8619C_Debug_Tools/releases)
> 下载 `HDMI-Tool-vX.Y.Z-win64.zip`，解压双击 `HDMI-Tool.exe` 即可（Windows 10/11 x64，免安装、无需 Python）。
> - **要改代码/重新打包**：见 §7、§8。
> - **要改代码/重新打包**：见 §8、§9。
>
> 更新：2026-09-10
> 更新：2026-09-11
---
@@ -19,9 +20,10 @@
| EDID 逐字节解析 | "EDID 原始数据"框右上"逐字节解析"按钮：按偏移逐字段展开基础块与 CTA-861 扩展块，每字段附原始字节 hex；命令行等价 `--edid-fields` |
| 分辨率切换 | "分辨率"下拉列出显卡按该屏 EDID 提供的全部模式；**应用**=临时切换（不写注册表，重启/恢复即还原），**恢复**=回到本次会话切改前的模式 |
| 测试图案投屏 | 全屏投到所选显示器，测试卡区域可选 `640x360 / 800x600 / full 铺满`；内置 纯红/纯绿/纯蓝/黑白棋盘格/网格线 + R/G/B 三行 55/AA/FF 纯色值按钮 + 3 个自定义图片栏位 |
| 光机控制 | RS485 → 板载 GD32E230 网关 → DLPC3421：开关光机（可定时）、设光强、查电流/温度/版本、TEC 控制、软件重启；收发日志带协议译码（见 §5） |
| 显示拓扑控制 | 启动时强制扩展显示拓扑（复制/仅第二屏等模式下保证 demo 板屏幕独立可控） |
| 命令行模式 | 全部功能可脚本化调用，供自动化测试（见 §5、§6） |
| 波形分析脚本 | 逻辑分析仪 CSV 波形按占空比签名分段，输出行结构/占空比/消隐明细（见 §6.3） |
| 命令行模式 | 全部功能可脚本化调用，供自动化测试（见 §6、§7） |
| 波形分析脚本 | 逻辑分析仪 CSV 波形按占空比签名分段，输出行结构/占空比/消隐明细（见 §7.3） |
## 2. 下载与安装
@@ -34,8 +36,8 @@
```
HDMI-Tool/
├── HDMI-Tool.exe 主程序（单文件，自包含）
├── pattern_slots.json 预置自定义栏位（指向下面的 bw 图案）
├── HDMI-Tool.exe 主程序（单文件自包含, 光机控制的 pyserial 已内置）
├── pattern_slots.json 预置自定义栏位 + 串口记忆
├── bw_*.png ×5 640x360 黑白测试图
├── solid_*.png ×10 800x600 纯色测试图
└── README.md 本说明
@@ -43,49 +45,77 @@ HDMI-Tool/
## 3. GUI 使用
主窗口自上而下三块区域：
主窗口自上而下四块区域：
```
┌ 显示器: [GDI ... ▼] [刷新] [拓扑: 扩展 ▼] ┐
├ 分辨率: [800x600@60 ▼] [应用] [恢复] ┐
├ ── EDID 原始数据 ──────────── [逐字节解析] ─┤
│ (hex 文本框) │
├ 测试卡区域: (○640x360 ○800x600 ○full) ┤
├ [纯红][纯绿][纯蓝][棋盘格][网格线] │ ← 图案按钮
├ R: [55][AA][FF] G: [55][AA][FF] B: [55][AA][FF] │ ← 纯色值按钮
├ [自定义1][自定义2][自定义3] [⚙] │ ← 自定义栏位
└─────────────────────────────────────────────┘
┌ 显示器: [ ... ▼] [刷新] ┐
├ 分辨率: [800x600@60 ▼] [应用] [恢复] ├ 显示器/EDID
│ 支持的模式(EDID 解算) | EDID 信息 ┘
├ 测试图案 — 图案按钮 / R,G,B 0x55,0xAA,0xFF / 测试卡区域 / 自定义栏位 ┐
├ 光机控制 — 串口 [连接] / 开关光机 / 光强 / 命令下拉 / 自定义命令 ┘ 投屏+光机
│ └ 收发日志(带协议译码与原始 hex)
└ EDID 原始数据 — hex dump [逐字节解析] ┘
```
1. 顶部显示器下拉选择目标屏（多屏时注意别选成主屏），"刷新"重新枚举；
2. **切分辨率**：第二行选模式 → "应用"；测完点"恢复"；
3. **投测试图**：
- 先在图案按钮行上方选**测试卡区域**（640x360 / 800x600 / full）；
- 点任意图案按钮即全屏投放；按 **ESC** 或点击退出；
- R/G/B 三行纯色按钮（55/AA/FF）用于 RGB 位交换类测试：55(01010101) 与
AA(10101010) 互为字节镜像对，FF(11111111) 为全高基准；
- 自定义图片：点"⚙"配置名称与图片文件（图片会自动复制到 exe 旁边），点栏位名投放；
4. 测试卡区域与自定义栏位配置自动保存在 exe 旁的 `pattern_slots.json`。
2. **切分辨率**：选模式 → "应用"；测完点"恢复"；
3. **投测试图**：先选**测试卡区域**（640x360 / 800x600 / full）→ 点图案按钮全屏投放，
按 **ESC** 或点击退出；R/G/B 三行纯色按钮（55/AA/FF）用于 RGB 位交换类测试
（55 与 AA 互为字节镜像对，FF 全高基准）；自定义图片点"⚙"配置（图片自动复制到 exe 旁）；
4. 区域与自定义栏位配置自动保存在 exe 旁的 `pattern_slots.json`。
## 4. 典型测试场景
```
1. HDMI 接 demo 板 → 启动 HDMI-Tool → 刷新 → 选中 demo 板显示器
2. 分辨率切 800x600@60（demo 板 shadow EDID 首选）→ 测试卡区域选 800x600
3. 点 R/G/B 行纯色按钮投图 → 配合逻辑分析仪/万用表测转接板 RGB888 输出
1. HDMI 接转接板 → 启动 HDMI-Tool → 刷新 → 选中板卡显示器
2. 板卡 shadow EDID 首选 640x360@60 → 测试卡区域选 640x360(与光机面板原生 1:1)
3. "光机控制"连接串口 → M999 查版本确认链路通 → M730S0 开光机
4. 点 R/G/B 行纯色按钮投图 → 目视/逻辑分析仪核对 RGB888 输出
- 纯红/绿/蓝：验证通道映射（R=D[23:16], G=D[15:8], B=D[7:0]）
- 55/AA 对：验证位交换（0x606E）——图像应为 50% 灰阶占空比
4. 换 bw 图案（西门子星/波带片）看极限分辨率与混叠
5. 测完"恢复"分辨率
5. M731S100 设光强 → M732 查电流读回复核 → M730S1 关光机
```
寄存器语义（0x606E 位交换 / 0x606D 整组顺序）的判读基线见上游主仓库
[LT8619C_DLPC3421_HDMI](https://gitea.hulk.wang/hulk/LT8619C_DLPC3421_HDMI) 的
`doc/architecture/`。
寄存器语义（0x606E 位交换 / 0x606D 整组顺序）与光机协议的判读基线见上游主仓库
[LT8619C_DLPC3421_HDMI](https://gitea.hulk.wang/hulk/LT8619C_DLPC3421_HDMI) 的 `doc/architecture/`。
## 5. 命令行模式（hdmi_gui.py）
## 5. 光机控制（RS485 → GD32 网关 → DLPC3421）
exe 版不支持 `--dump/--edid-fields`（noconsole 无控制台输出），请用源码方式跑：
物理链路：PC 经 **USB-RS485 转换器**接板卡 A/B 端子，板上 GD32E230 做 RS485→I2C 网关
控制 DLPC3421（I2C 地址 0x1B）。串口参数 **115200, 8N1**，协议细节以上游固件仓
`protocols.md` 为准：命令帧 `D5 01 LEN <ASCII命令> CRC`、响应帧 `B5 TYPE LEN <payload> CRC`，
CRC 为第 2 字节起累加和取低 8 位。
GUI"光机控制"区：选串口 → 连接 → 点快捷按钮或命令下拉/自定义输入发送；日志区实时显示
`→ 命令` / `← 译码结果 (原始 hex)`，错误自动附释义（如 `err:3（I2C NACK）`）。
| 命令 | 功能 | 响应示例 |
|---|---|---|
| `M730S0` / `M730S1` | 开 / 关光机 | `ok` |
| `M730S0T2000` | 开光机并定时 2000ms 自动关（≤32700） | `ok`（期间 M737 延迟应答） |
| `M731S100` | 设光强 54-800（RGB 同值，写后读回复核） | `ok` / `err:R..G..B..` |
| `M732` | 查三路电流设置值（0-65535） | `okR110G110B110` |
| `M201` / `M202` | 查 DMD / LAMP 温度（0.1°C） | `okTL:246` = 24.6°C |
| `M999` | 查固件版本 | `okv20.0.0.1` |
| `M737` | 查投光是否结束（投光中延迟应答） | `ok` |
| `M7S0` / `M7S1` | TEC 自动控温开 / 关（注意 S0=开） | `ok` |
| `M8S330` | TEC 凝露点 33.0°C（200-350，0.1°C） | `ok` / `err:OL` |
| `M1` | 协议握手 | `ok` |
| `M888` | 软件重启 | `ok` 后 100ms 复位 |
注意：**DLPC3421 启动完成前 M730/M731/M732 被就绪门禁拒绝**（回 0xFF），上电后稍等几秒再发。
命令行等价（源码方式）：
```
python hdmi_gui.py --port COM9 --dlpc-cmd M730S0 --dlpc-cmd M999
逐条发送并打印译码响应
```
## 6. 命令行模式（hdmi_gui.py）
exe 版无控制台，`--dump/--edid-fields` 的输出不可见（`--dlpc-cmd` 仍可执行，靠退出码判断），
调试请用源码方式：
```
python hdmi_gui.py --dump 控制台输出 EDID 解算
@@ -93,14 +123,16 @@ python hdmi_gui.py --edid-fields 控制台输出 EDID 逐字
python hdmi_gui.py --test-pattern Blue --area 800x600 --seconds 5
出图 5 秒自动退出
python hdmi_gui.py --test-pattern Custom1 投自定义栏位 1
python hdmi_gui.py --port COM9 --dlpc-cmd M730S0 RS485 发光机命令(可多次)
python hdmi_gui.py --seconds 5 GUI 冒烟测试, 5 秒自动关
--test-pattern {Red,Green,Blue,Checker,Grid,Custom1..3}
--area {640x360,800x600,full} --monitor N --seconds S
--port COMx --baud 115200 --dlpc-cmd CMD(可重复; 任一命令失败退出码 1)
```
## 6. 辅助脚本（src/ 下）
## 7. 辅助脚本（src/ 下）
### 6.1 hdmi_source.bat / .ps1 — 源端命令行工具
### 7.1 hdmi_source.bat / .ps1 — 源端命令行工具
与 GUI 互补，适合脚本串联：
@@ -111,7 +143,7 @@ tools\hdmi_source.bat -Mode 800x600 -Pattern -Restore
切模式→出图案→退出后自动恢复
```
### 6.2 gen_bw_patterns.py / gen_solid_colors.py — 测试图生成
### 7.2 gen_bw_patterns.py / gen_solid_colors.py — 测试图生成
需 Pillow（`py -m pip install pillow`）。重新生成 `assets/` 下全部图案：
@@ -122,7 +154,7 @@ tools\hdmi_source.bat -Mode 800x600 -Pattern -Restore
- `gen_solid_colors.py` → 800x600 纯色图 ×10（R/G/B 各 55/AA/FF + 三原色），
与 GUI 内置纯色按钮同源，供自定义栏位或其他工具加载。
### 6.3 la_wave_analyzer.py / la_wave_analyzer3.py — 逻辑分析仪波形判读
### 7.3 la_wave_analyzer.py / la_wave_analyzer3.py — 逻辑分析仪波形判读
分析 Kingst VIS 导出的边沿流 CSV（列：`Time[s], 通道A, 通道B[, 通道C]`，
10ns 分辨率），按 50ms 窗口占空比签名自动分段，输出每段的签名（FF/55/AA/00）、
@@ -133,12 +165,19 @@ python la_wave_analyzer.py <capture.csv> # 2 通道（默认判读 B 口 D0/
python la_wave_analyzer3.py <capture.csv> # 3 通道（RGB 三组同拍, ch8/9/10）
```
## 7. 目录结构与从源码运行
### 7.4 selftest_rs485.py — 光机协议自检（无硬件）
对照上游 `protocols.md` 实测帧向量回归帧构造/解析/译码：`python selftest_rs485.py`，
全部通过退出码 0。改 `dlpc_rs485.py` 后必须跑一遍。
## 8. 目录结构与从源码运行
```
HDMI-Tool/
├── src/ # 源代码（人工维护区）
│ ├── hdmi_gui.py # 主程序：GUI + 命令行, 纯标准库
│ ├── hdmi_gui.py # 主程序：GUI + 命令行（标准库; pyserial/Pillow 可选）
│ ├── dlpc_rs485.py # 光机 RS485 协议与串口链路（帧/解析/译码/线程）
│ ├── selftest_rs485.py # 光机协议自检（无硬件回归）
│ ├── build_exe.py # PyInstaller 打包 → release/
│ ├── package_release.py # 组装发布 zip（exe+图案+说明）
│ ├── publish_gitea.py # 上传到 Gitea Release
@@ -152,28 +191,32 @@ HDMI-Tool/
│ └── solid_*.png ×10 # 800x600 纯色系列
├── release/ # 构建与发布产物（机器生成区, 不手改）
│ ├── HDMI-Tool.exe # 打包单文件版（改动跟随源码提交入库）
│ ├── pattern_slots.json # exe 运行配置（默认栏位预置 bw 图案）
│ ├── pattern_slots.json # exe 运行配置（栏位预置 + 串口记忆）
│ └── *.zip # 发布包（不入库, 上传 Gitea Release）
├── README.md # 本说明
└── AGENTS.md # 面向 AI/Agent 的工程档案（结构/约定/构建规程）
```
从源码运行：`python src/hdmi_gui.py`，需 Python ≥3.10，纯标准库无第三方依赖
（自定义图片要 JPG/BMP/WebP 时需可选 Pillow）。
从源码运行：`python src/hdmi_gui.py`，需 Python ≥3.10，标准库即可跑 EDID/投屏；
光机控制需 pyserial（`py -m pip install pyserial`），自定义图片要 JPG/BMP/WebP 需可选 Pillow。
## 8. 构建与发布
## 9. 构建与发布
```powershell
cd src
python build_exe.py # 打包 → ../release/HDMI-Tool.exe（自动装 PyInstaller）
python build_exe.py --debug # 额外出一个带控制台的调试变体（--dump 可用）
python package_release.py 0.1.0 # 组装 release/HDMI-Tool-v0.1.0-win64.zip
python publish_gitea.py HDMI-Tool-v0.1.0-win64.zip --insecure # 上传 Gitea Release(需 GITEA_TOKEN)
python selftest_rs485.py # 光机协议回归(改 dlpc_rs485.py 后必跑)
python build_exe.py # 打包 → ../release/HDMI-Tool.exe（自动装 PyInstaller; 内置 pyserial）
python build_exe.py --debug # 额外出一个带控制台的调试变体（--dump 可见输出）
python package_release.py 0.2.0 # 组装 release/HDMI-Tool-v0.2.0-win64.zip
python publish_gitea.py HDMI-Tool-v0.2.0-win64.zip --insecure # 上传 Gitea Release(需 GITEA_TOKEN)
```
## 9. 注意事项 / FAQ
## 10. 注意事项 / FAQ
- **exe 放只读目录会怎样**：自定义图片与 `pattern_slots.json` 写在 exe 旁边，只读目录会导致栏位配置存不下；
- **光机没反应排查**：① 串口/波特率（115200 8N1）与 A/B 接线；② 先发 `M999` 验证链路；
③ 开光机回 0xFF 是 DLPC 就绪门禁——上电后等几秒；④ USB-RS485 转换器半双工，
发送时板上回包不会回环（正常）；
- **exe 放只读目录会怎样**：自定义图片与 `pattern_slots.json` 写在 exe 旁边，只读目录会导致配置存不下；
- **重新打包后图标没变**：Windows 图标缓存，`ie4uinit -show` 或改个名即可；
- **多屏序号**：切分辨率前先确认显示器序号（GUI 下拉框与 `hdmi_source.bat -List` 输出一致）；
- **残留进程**：修改源码重新打包前先结束残留的 HDMI-Tool 进程（`build_exe.py` 会自动 taskkill）；