LT8619C_Debug_Tools/README.md

LT8619C_Debug_Tools

LT8619C（HDMI→RGB888）→ DLPC3421 投影转接板调试配套上位机工具集。 上游主仓库（固件）：LT8619C_DLPC3421_HDMI。

工具一览

工具	用途	获取
HDMI-Tool	HDMI 源端（EDID 查看/逐字节解析、分辨率切换、纯色与测试图案全屏投屏）+ 光机控制（RS485→GD32 网关→DLPC3421：开关光机/设光强/查温度电流）	到 Releases 下 HDMI-Tool-vX.Y.Z-win64.zip，解压即用；详见 HDMI-Tool/README.md
I2C-Inject	LT8619C 寄存器在线读写：RP2040 注入器在 demo 板 I2C 总线上择机注入（避让主控轮询，写后自动读回校验）	需配合 RP2040 固件 rp2040_inject.py；详见 I2C-Inject/README.md

环境要求

• 发布版 zip 开箱即用（Windows 10/11 x64，无需安装 Python）
• 源码运行：Python ≥3.10；HDMI-Tool 为纯标准库（自定义图片 JPG/BMP 需可选 Pillow）； I2C-Inject 需 py -m pip install pyserial
• 重新打包：HDMI-Tool/src/build_exe.py（自动安装 PyInstaller）；I2C-Inject 目录内 python build_exe.py

目录结构

每个工具内统一三区：src/ 源代码（人写） → assets/ 生成资产（可再生成） → release/ 打包与发布产物（机器生成）；README.md 面向使用者，AGENTS.md 面向 AI/Agent（工程约定与构建规程）。

LT8619C_Debug_Tools/
├── HDMI-Tool/
│   ├── src/                 # 源码 + 打包/发布脚本 + 图标源
│   ├── assets/              # 生成的测试图案 PNG（gen_*.py 产物）
│   ├── release/             # 打包 exe + 运行配置（入库）；发布 zip（不入库）
│   ├── README.md            # 使用说明
│   └── AGENTS.md            # AI/Agent 工程档案
├── I2C-Inject/              # PC 端 GUI + RP2040 固件 + 打包 exe + 图标 + README
├── LICENSE
└── README.md

发布流程（HDMI-Tool）

cd HDMI-Tool/src
python build_exe.py                              # 打包 → ../release/HDMI-Tool.exe
python package_release.py <版本>                  # → ../release/HDMI-Tool-v<版本>-win64.zip
python publish_gitea.py HDMI-Tool-v<版本>-win64.zip --insecure   # 上传 Gitea Release(需 GITEA_TOKEN)

备注

• 源码与打包产物（exe、pattern_slots.json）均入库；发布 zip 不入库，只上传 Gitea Release
• 两件工具的寄存器语义（0x606E 位交换 / 0x606D 整组顺序）均经 demo 板逻辑分析仪 双色交叉实测，过程数据与规程存于上游主仓库 doc/architecture/
• 更新：2026-09-11