Files
HW-Debug-Tools/README.md
T
hulk d133906d32 feat: 新增 SerialMate 串口调试助手 v0.1.0
- 协议帧构成令牌序列可定制(包头/板ID/LEN口径/5种CRC x 3种覆盖), 默认兼容 DLPilot 光机协议
2026-09-27 18:52:54 +08:00

5.2 KiB
Raw Blame History

LT8619C_Debug_Tools

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

工具一览

工具 用途 获取
DLPilot HDMI 源端(EDID 查看/逐字节解析、分辨率切换、纯色与测试图案全屏投屏)+ 光机控制(RS485→GD32 网关→DLPC3421:开关光机/设光强/查温度电流) 到 Releases 下 DLPilot-vX.Y.Z-win64.zip,解压即用;详见 DLPilot/README.md
EDID-viewer Windows 显示器 EDID 只读查看器:活动设备或离线文件的厂家/序列号/分辨率时序、CTA/HDMI/音频/HDR 能力、校验诊断;BIN/HEX 导入,BIN/JSON 报告导出 到 Releases 下 EDID-Viewer-vX.Y.Z-win64.zip,解压即用;详见 EDID-viewer/README.md
SerialMate RS485/串口调试助手:收发 + 协议包解析(帧构成令牌序列/包头/板ID/LEN口径/CRC 全可定制,默认兼容 DLPilot 光机协议)、板型档案一键切换协议参数与命令预设、payload 字符串/HEX 显示、4 通道曲线(弹窗独立、时间窗滑笔回看、悬停读值、暂停渲染)、发送框输入 payload 自动包装组帧(/ 分隔多条)、HEX 直发与周期发送 到 Releases 下 SerialMate-vX.Y.Z-win64.zip,解压即用;详见 SerialMate/README.md
I2C-Inject ⏸ 暂停开发:LT8619C 寄存器在线读写(RP2040 注入器在 demo 板 I2C 总线上择机注入,避让主控轮询,写后自动读回校验)。代码与固件保留备查 暂不提供发布;状态与原理详见 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。

LT8619C_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 同一套流水线)

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-27