74 lines
5.6 KiB
Markdown
74 lines
5.6 KiB
Markdown
# HW-Debug-Tools
|
||
|
||
硬件调试上位机工具集，起家于 LT8619C（HDMI→RGB888）→ DLPC3421 投影转接板调试配套，
|
||
现收纳全部调试工具；原名 `LT8619C_Debug_Tools`，2026-09-28 更名（Gitea 旧地址自动重定向）。
|
||
上游主仓库（固件）：[LT8619C_DLPC3421_HDMI](https://gitea.hulk.wang/hulk/LT8619C_DLPC3421_HDMI)。
|
||
|
||
## 工具一览
|
||
|
||
| 图标 | 工具 | 用途 | 获取 |
|
||
|---|---|---|---|
|
||
| <img src="DLPilot/src/logos/logo_dlpilot.png" width="64" alt="DLPilot 图标"/> | [DLPilot](DLPilot/) | HDMI 源端（EDID 查看/逐字节解析、分辨率切换、纯色与测试图案全屏投屏）+ 光机控制（RS485→GD32 网关→DLPC3421：开关光机/设光强/查温度电流） | 到 [Releases](https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases) 下 `DLPilot-vX.Y.Z-win64.zip`，解压即用；详见 [DLPilot/README.md](DLPilot/README.md) |
|
||
| <img src="EDID-viewer/assets/edid-viewer.png" width="64" alt="EDID-Viewer 图标"/> | [EDID-viewer](EDID-viewer/) | Windows 显示器 EDID 只读查看器：活动设备或离线文件的厂家/序列号/分辨率时序、CTA/HDMI/音频/HDR 能力、校验诊断；BIN/HEX 导入，BIN/JSON 报告导出 | 到 [Releases](https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases) 下 `EDID-Viewer-vX.Y.Z-win64.zip`，解压即用；详见 [EDID-viewer/README.md](EDID-viewer/README.md) |
|
||
| <img src="SerialMate/assets/serial-mate.png" width="64" alt="SerialMate 图标"/> | [SerialMate](SerialMate/) | RS485/串口调试助手：收发 + 协议包解析（帧构成令牌序列/包头/板ID/LEN口径/CRC 全可定制，默认兼容 DLPilot 光机协议）、板型档案一键切换协议参数与命令预设、payload 字符串/HEX 显示、4 通道曲线（弹窗独立、时间窗滑笔回看、悬停读值、暂停渲染）、发送框输入 payload 自动包装组帧（`/` 分隔多条）、HEX 直发与周期发送 | 到 [Releases](https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases) 下 `SerialMate-vX.Y.Z-win64.zip`，解压即用；详见 [SerialMate/README.md](SerialMate/README.md) |
|
||
| <img src="I2C-Inject/logos/logo_i2c_orange.png" width="64" alt="I2C-Inject 图标"/> | [I2C-Inject](I2C-Inject/) | ⏸ **暂停开发**：LT8619C 寄存器在线读写（RP2040 注入器在 demo 板 I2C 总线上择机注入，避让主控轮询，写后自动读回校验）。代码与固件保留备查 | 暂不提供发布；状态与原理详见 [I2C-Inject/README.md](I2C-Inject/README.md) |
|
||
|
||
## 环境要求
|
||
|
||
- 发布版 zip 开箱即用（Windows 10/11 x64，无需安装 Python）
|
||
- 源码运行：Python ≥3.10；DLPilot 命令行/EDID 纯标准库，GUI 需
|
||
`py -m pip install PySide6-Fluent-Widgets`（自定义图片 JPG/BMP 可选 Pillow、光机控制可选 pyserial）；
|
||
EDID-viewer GUI 需 `py -m pip install -r EDID-viewer/requirements.txt`（PySide6 + PySide6-Fluent-Widgets）；
|
||
SerialMate GUI 需 `py -m pip install PySide6 PySide6-Fluent-Widgets pyserial`；
|
||
I2C-Inject 需 `py -m pip install pyserial`
|
||
- 重新打包：`DLPilot/src/build_exe.py`、`EDID-viewer/src/build_exe.py` 与
|
||
`SerialMate/src/build_exe.py`（均自动安装 PyInstaller）；I2C-Inject 目录内 `python build_exe.py`
|
||
|
||
## 目录结构
|
||
|
||
每个工具内统一三区：**src/ 源代码（人写）** → **assets/ 生成资产（可再生成）** →
|
||
**release/ 打包与发布产物（机器生成）**；README.md 面向使用者，AGENTS.md 记录工程约束与开发进度，
|
||
仓库整体的开发需求与进度管理见根目录 `agent.md`。
|
||
|
||
```
|
||
HW-Debug-Tools/
|
||
├── DLPilot/
|
||
│ ├── src/ # 源码 + 打包/发布脚本 + 图标源
|
||
│ ├── assets/ # 生成的测试图案 PNG（gen_*.py 产物）
|
||
│ ├── release/ # 打包 exe + 运行配置（入库）；发布 zip（不入库）
|
||
│ ├── README.md # 使用说明
|
||
│ └── AGENTS.md # 工程档案
|
||
├── EDID-viewer/
|
||
│ ├── src/ # 界面/解析/WMI 读取 + 打包/发布脚本
|
||
│ ├── assets/ # 图标与生成脚本
|
||
│ ├── release/ # EDID-Viewer.exe + README（入库）；发布 zip（不入库）
|
||
│ ├── README.md # 使用说明
|
||
│ └── AGENTS.md # 工程档案
|
||
├── SerialMate/
|
||
│ ├── src/ # 协议/串口线程/曲线控件/GUI + 自检 + 打包/发布脚本
|
||
│ ├── release/ # SerialMate.exe + README（入库）；发布 zip（不入库）
|
||
│ ├── README.md # 使用说明
|
||
│ └── AGENTS.md # 工程档案
|
||
├── I2C-Inject/ # PC 端 GUI + RP2040 固件 + 打包 exe + 图标 + README
|
||
├── LICENSE
|
||
└── README.md
|
||
```
|
||
|
||
## 发布流程（DLPilot / EDID-Viewer / SerialMate 同一套流水线）
|
||
|
||
```powershell
|
||
cd DLPilot/src # 或 EDID-viewer/src、SerialMate/src
|
||
python build_exe.py # 打包 → ../release/<工具>.exe
|
||
python package_release.py <版本> # → ../release/<工具>-v<版本>-win64.zip
|
||
python publish_gitea.py <工具>-v<版本>-win64.zip --insecure # 上传 Gitea Release(需 GITEA_TOKEN)
|
||
```
|
||
|
||
每个工具独立打标签发布（`DLPilot-v*` / `EDID-Viewer-v*` / `SerialMate-v*`），Release 列表按时间倒序混排于同一页面。
|
||
|
||
## 备注
|
||
|
||
- 源码与打包产物（exe、pattern_slots.json）均入库；发布 zip 不入库，只上传 Gitea Release
|
||
- 两件工具的寄存器语义（0x606E 位交换 / 0x606D 整组顺序）均经 demo 板逻辑分析仪
|
||
双色交叉实测，过程数据与规程存于上游主仓库 `doc/architecture/`
|
||
- 更新：2026-09-28
|