hulk/HW-Debug-Tools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 8 Wiki Activity
Files
955e56efef0785c47f3454faa7d13a0ab7f55894
HW-Debug-Tools/DLPilot/使用说明.md
T

20 KiB
Raw Blame History

DLPilot 使用说明

HDMI 源端调试 + 光机控制工具

项目 说明
适用版本 v0.4.3（2026-10-13 发布）
适用系统 Windows 10 / 11 x64，免安装、无需 Python
适用对象 LT8619C（HDMI→RGB888）→ DLPC3421 投影转接板的调试、测试与校准人员
文档日期 2026-10-14

DLPilot 是配套投影转接板调试的 PC 端工具，一台电脑同时完成两件事：

  • HDMI 源端：查看板卡上报的 EDID、切换输出分辨率、向板卡全屏投放测试图案 （纯色、黑白测试图、自定义校准图）；
  • 光机控制：通过 USB-RS485 控制光机——开关光机、设光强、查温度/电流、 PD 电源自检与功率读数、TEC 温控。

界面上左右两列分别对应这两个功能域，互不干扰，可以只用其中一列。

[TOC]

1. 安装（从压缩包开始）

1.1 拿到安装包

安装包为 DLPilot-v0.4.3-win64.zip（约 67 MB），由我方对接工程师提供。 收到后请先核对文件名中的版本号，本文档对应 v0.4.3；若版本更新，以随包说明为准。

1.2 解压

  1. 在电脑上选择一个可写的本地目录，例如 D:\Tools\（不要解压到只读目录、 网络共享盘或需要管理员权限才能写入的系统目录，原因见 1.5 节）；
  2. 右键压缩包 →「全部解压」→ 目标路径填 D:\Tools\，确认后完成解压；
  3. 解压后得到一个 DLPilot 文件夹。

注意：不要在压缩包预览窗口里直接双击运行 exe。 直接从压缩包内运行时程序被解压到临时目录，你配置的自定义图片和串口参数 会写到临时目录并随其清空而丢失。务必先完整解压，再运行解压后的 exe。

解压后的文件夹内容如下：

文件 作用
DLPilot.exe 主程序，双击运行（单文件自包含，光机控制所需串口库已内置）
pattern_slots.json 运行配置：自定义图案栏位、测试卡区域、串口参数记忆。删除它会丢失你的全部本地配置
bw_*.png（5 张） 640×360 黑白测试图：西门子星、频率扫描条纹、渐变棋盘、波带片、综合测试卡
solid_*.png（10 张） 800×600 纯色测试图（R/G/B 各 55/AA/FF + 三原色），供自定义栏位加载
CeramixNano-*.png（如包含） 光机校准图案（black / white / contrast / circle_640p / caliPoint / sharpness），新版本安装包已预置到自定义栏位
README.md 随包说明（与本文档内容同源）

1.3 首次启动

双击 DLPilot.exe：

  • 首次启动比之后慢一两秒（单文件程序需要先自解压），属正常现象；
  • 程序没有数字签名，首次运行 Windows SmartScreen 可能弹出 「Windows 已保护你的电脑」——点「更多信息」→「仍要运行」即可；
  • 个别杀毒软件可能对加壳的单文件 exe 误报，如遇拦截请放行或将安装目录加入白名单。

程序启动后出现双栏主界面（见第 3 节），即安装成功。

1.4 升级新版本

  1. 关闭正在运行的 DLPilot；
  2. 解压新版本压缩包到新的空目录（不要直接覆盖旧目录，避免新旧文件混杂）；
  3. 如需保留旧版的自定义栏位与串口记忆：把旧目录里的 pattern_slots.json 和你自己添加的图片文件复制到新目录，覆盖同名文件即可；
  4. 双击新目录的 DLPilot.exe。

1.5 为什么必须放在可写目录

程序的所有本地数据（pattern_slots.json 配置、你添加的自定义图片）都保存在 exe 所在目录，不写注册表、不写用户目录。放在只读目录会导致配置保存失败。 两份不同目录的安装（比如两台工位电脑、或同一台电脑解压了两份）各自独立保存配置，互不影响。

2. 硬件连接

2.1 整体链路

PC(DLPilot) ──HDMI──→ LT8619C（HDMI→RGB888）──RGB888 视频──→ DLPC3421 光机
PC(DLPilot) ──USB-RS485──→ GD32E230 主控 ───I2C 控制(0x1B)──→ DLPC3421 光机

HDMI 与 RS485 接的是同一块转接板：LT8619C 负责把 HDMI 视频转换为 RGB888； GD32E230 是板上的主控 MCU，负责整板逻辑控制——DLPilot 的 RS485 命令由它解析， 再经 I2C 总线控制光机（DLPC3421）。

2.2 HDMI 连接

  1. 用 HDMI 线把电脑显卡输出接到转接板 HDMI 输入；
  2. 板卡正常上电。板卡 shadow EDID 只声明 640×360@60 一种模式；
  3. 如果 Windows 没有自动点亮这块"显示器"（显示设置里看不到）： 启动 DLPilot，工具检测到是本系列板卡（EDID 厂商签名）接入但未进桌面时， 会自动把它以扩展屏方式拉回桌面；仍不行时在 Windows「显示设置」里手动改为「扩展这些显示器」。

2.3 RS485 连接（光机控制）

  1. USB-RS485 转换器接电脑 USB，其 A/B 端子对应接转接板的 RS485 A/B 端子；
  2. 串口参数固定 115200 波特率、8 数据位、无校验、1 停止位（115200 8N1）， 软件默认值即为此，一般无需修改；
  3. 板卡供电建议使用满足 PD 12V / ≥3A 的电源适配器——软件的"电源自检" 就是以该挡位为正常判据（见 5.3 节）。

2.4 上电时序（重要）

DLPC3421 光机芯片启动需要几秒钟。上电后立即发开光机/设光强/查电流命令会收到 拒绝应答（0xFF），这是正常保护，不是故障——稍等几秒待光机就绪后再发。

3. 界面总览

主窗口为双栏仪表盘，顶栏可切换 Dark / Light / System 外观（跟随系统为默认）， 顶栏右侧「关于」按钮内有软件版本信息：

左列（HDMI 源端） 右列（光机控制 RS485）
显示器选择：显示器下拉 + 刷新 串口选择：串口下拉 + 波特率等参数 + 连接
支持的模式（默认折叠）：分辨率下拉 + 应用 / 恢复 + 时序明细 电源检查：电源自检 + 功率检测
EDID 信息（默认折叠）：解算结果一览 串口数据：收发日志（译码 + hex）+ 清空
测试图案：内置图案 / R·G·B 色值 / 自定义与校准栏位 / 测试卡区域选择 光机命令：快捷按钮排 + 预设下拉 + 自定义输入 + 温度读取
EDID 原始数据：hex 显示 + 逐字节解析 快捷滑条：光强 / 定时 / TEC 温度

DLPilot 主界面（红框标注为快速开始要点）

图 1　主界面与快速开始要点

红框与编号对应四个上手要点：

  1. 选显示器：左上「显示器选择」卡的下拉框选中接转接板的显示器 （Generic PnP Monitor），下方会显示当前实际输出分辨率/刷新率； 多屏或热插拔后点「刷新」重新枚举；
  2. 投测试图案：现在的转接板上电默认打开光机，无需先连串口—— 在「测试图案」卡选好测试卡区域后即可直接投放指定图案 （点「停止」按钮或按 ESC 退出全屏）；
  3. 连串口：需要控制光机光强、查温度/电流等才需要串口——USB-RS485 转换器接好后，在「串口」卡选口（参数保持默认 115200 8N1）点「连接」；
  4. 控光机：常用光机控制都集中在「光机命令」卡（开/关光机、查版本、 软件重启、TEC、温度读取、预设下拉与自定义输入），下方「快捷滑条」 可便捷调光强、定时投光、TEC 温度。

「支持的模式」「EDID 信息」两张卡片默认折叠，点卡片标题展开。 左列只操作显卡输出（不碰光机），右列只操作光机（不碰显卡）。

4. HDMI 源端操作（左列）

4.1 选择显示器

  1. 左上下拉框列出当前所有显示器，选中接转接板的那一块； 多屏时注意核对型号/分辨率，不要选成你的主屏；
  2. 热插拔后列表没刷新时点「刷新」重新枚举；
  3. 下拉框内容与系统识别一致；如对序号有疑问，可在 Windows「显示设置」中 点「识别」核对。

4.2 查看支持的模式 / 切换分辨率

  1. 展开「支持的模式」卡片，下拉框列出显卡按该屏 EDID 提供的全部模式 （板卡正常时可见 640×360@60）；
  2. 选中模式后点「应用」即切换。切换是临时的：不写注册表，重启电脑或 重新插拔即还原，不会永久改动你的桌面设置；
  3. 测试完成后点「恢复」，回到本次打开软件时的原始模式；
  4. 卡片同时显示选中模式的时序明细，可核对像素时钟、刷新率等。

4.3 查看 EDID

  • 「EDID 信息」卡片：显示从该显示器读到的 EDID 解算结果——厂商、型号、 尺寸、Gamma、输入类型、支持的全部模式、首选时序完整参数、校验和；
  • 「EDID 原始数据」卡片：显示 128 字节（含扩展块）原始 hex； 点右上「逐字节解析」按钮，可按偏移逐字段展开基础块与 CTA-861 扩展块， 每个字段附原始字节，适合核对板卡 EDID 是否按规格上报。

4.4 投放测试图案

  1. 先在「测试卡区域」选择投放区域：
    • 640x360（默认）——与光机面板原生分辨率 1:1，链路验证/校准用这个；
    • 800x600——对应 demo 板首选时序；
    • full——铺满所选显示器的整个屏幕；
  2. 点「测试图案」卡片中的按钮即全屏投放到所选显示器：
    • 内置图案：纯红、纯绿、纯蓝、黑白棋盘格、网格线（程序直接绘制）；
    • R/G/B 三行 55 / AA / FF 色值按钮：按通道着色的纯色，用途见 7.2 节；
    • 自定义/校准图片栏位：见 4.5 节；
  3. 投放新图案会自动替换当前旧图案；按 ESC 键或点「停止测试图像」退出全屏。

4.5 自定义图片栏位（含校准图案）

「测试图案」卡片提供 10 个可配置栏位，每个栏位一个图案按钮 + 一个齿轮按钮：

  1. 点某个栏位的齿轮按钮，弹出配置对话框；
  2. 填写栏位名称（显示在按钮上），选择图片文件（推荐 PNG；JPG/BMP/WebP 依运行环境而定，PNG 最稳妥）；
  3. 保存后图片自动复制到 exe 所在目录，栏位按钮即可点按投放。 因此不要事后手动移动/删除 exe 旁的图片文件，否则栏位失效；
  4. 安装包已预置常用栏位（黑白测试图与校准图案，具体以包内为准）， 可按上述步骤改成你自己的图。

栏位配置、测试卡区域选择会自动保存在 exe 旁的 pattern_slots.json。

5. 光机控制操作（右列）

5.1 连接串口

  1. 「串口选择」卡片：下拉框列出所有串口，显示为 COMx + 设备描述。 多路 USB 转换器（如 CH344 四路）每一路描述不同（serial-A/B/C/D）， 据此选口；描述相同时软件自动附物理位置区分；
  2. 波特率等参数默认 115200 8N1，与板卡固件约定一致，保持默认即可；
  3. 点「连接」。连接失败会给出简短原因（串口被占用/不存在等）， 完整错误信息进收发日志；
  4. 上次使用的串口与参数会被记住，下次启动自动带出（预置配置带的串口如与 你现场不符，第一次使用时改成你的实际串口即可）。

5.2 收发日志

「串口数据 · 收发日志」卡片实时显示：

  • → 发出的命令；
  • ← 收到的应答：可读译码 + 原始 hex 对照显示；
  • 错误自动附释义，例如 err:3（I2C NACK） 表示光机侧 I2C 无应答；
  • 点「清空」清屏。日志超过 500 行自动滚动淘汰旧条目，长时间联机不会卡顿。

协议帧格式（判读 hex 时参考）：命令帧 D5 01 LEN <ASCII命令> CRC， 应答帧 B5 TYPE LEN <payload> CRC，CRC 为自第 2 字节起的累加和低 8 位。

5.3 电源检查

「电源检查」卡片有两个按钮：

  • 电源自检：自动依次查询供电协议（M301）→ PD 挡位最大电流（M302）→ 实测母线电压（M303），并按实测电压就近判定 PD 固定挡（5/9/12/15/20/28V）：

    显示 含义
    绿底，如 FPDO: 12V@3A 供电正常：12V 挡且电流 ≥3A
    红底，如 FPDO: 9V@3A 挡位不符：电源没有协商到 12V 挡，请换符合要求的 PD 电源
    ERR 实测电压不落在任何标准 PD 挡内，检查供电

    说明：取电芯片的电压配置寄存器只写不可读，挡位只能靠实测电压判定， 所以以自检结果为准，而不是电源标称。

  • 功率检测：自动依次读母线电压（M303）/ 负载电流（M304）/ 负载功率（M305）， 读数框显示 电压(V)、电流(mA)、功率(W)。功率量程 0～295 W。

5.4 光机命令

「光机命令」卡片从上到下：

  1. 快捷按钮排（最常用操作一键完成）： 开光机、关光机、查版本、软件重启、开TEC、关TEC、TEC33.0°C；
  2. 温度读取：查DMD温度、查LAMP温度，应答数值（0.1°C 单位换算后） 实时填入按钮旁的显示框；
  3. 预设下拉：常用命令清单，选中即发送；
  4. 自定义输入框：手动输入任意命令（见第 6 节命令表），回车即发送。

5.5 快捷滑条

「快捷滑条」卡片三个滑条，拖到目标值后点对应按钮下发：

  • 光强：拖动后点「下发电流值」（有效范围 54–800，RGB 三路同值）；
  • 定时：设定毫秒数后点「开光机(定时)」——开光机并在到时后自动关， 0 表示不限时；上限 32700 ms；
  • TEC 温度：滑条/输入框设定凝露点 200–350（对应 20.0–35.0°C）， 点「下发温度值」。

滑条旁的数值输入框支持直接键入，回车后自动限制到有效范围并与滑条同步。

6. 光机命令参考

命令 功能 应答示例 / 说明
M1 协议握手 ok
M730S0 / M730S1 开 / 关光机 ok
M730S0T2000 开光机并定时 2000ms 自动关 ok；定时 ≤32700 ms
M731S100 设光强（54–800，RGB 同值） ok；失败回 err:R..G..B..
M732 查三路电流设置值 okR110G110B110
M737 查投光是否结束 投光进行中会延迟应答，属正常
M201 / M202 查 DMD / LAMP 温度 okTL:246 = 24.6°C
M7S0 / M7S1 TEC 自动控温 开 / 关 注意 S0 是开，方向与直觉相反
M8S330 TEC 凝露点 33.0°C 范围 200–350，超范围回 err:OL
M301 查供电协议（PD/QC3.0/EPR…） ASCII 文本
M302 查 PD 挡位最大电流 mA（50mA/LSB 已换算）
M303 查母线电压（实测） 如 12020 mV = 12.02 V
M304 查负载电流（实测） mA，带符号（正=正向）
M305 查负载功率（实测） mW，软件换算显示为 W
M999 查固件版本 如 okv20.0.0.1
M888 软件重启 ok 后约 100ms 复位

注意：

  1. 光机上电后几秒内处于启动期，此时 M730/M731/M732 会被就绪门禁拒绝（回 0xFF）， 等几秒再发即可；
  2. USB-RS485 转换器是半双工的：本机发送期间板上回包不会回环显示，属正常现象；
  3. 设光强等带数值的命令，超范围值会被板卡拒绝，请按表中范围下发。

7. 典型操作流程

7.1 首次整链路验证（新板卡点灯）

1. HDMI 接转接板，USB-RS485 接板卡 A/B，板卡上电（PD 12V/≥3A），等数秒
2. 启动 DLPilot → 「刷新」→ 显示器下拉选中板卡（640x360@60）
3. 光机控制：选串口 → 连接 → 点「查版本」（M999）
   应答 okv... 即 RS485→光机 链路通；无应答见第 9 节排查
4. 点「电源自检」：绿底 FPDO: 12V@3A 即供电合格
5. 测试卡区域选 640x360（与光机面板原生 1:1）；转接板目前上电默认开光机，
   可直接投图，若光机已被关闭再点「开光机」
6. 投放测试图案目视检查 → 设光强/查温度电流（按需）
7. 测完：「关光机」→ 分辨率「恢复」→ 停止测试图像

7.2 RGB 通道与位序检查

用「测试图案」里的 R/G/B 行色值按钮（55 / AA / FF 三档）：

  1. 纯红/纯绿/纯蓝：验证 RGB 三通道映射是否正确 （硬件约定 R=D[23:16]、G=D[15:8]、B=D[7:0]，投纯红时仅 R 通道应有输出）；
  2. 55 与 AA 配对：0x55（01010101）与 0xAA（10101010）互为字节镜像， 专用于检出位序颠倒——位交换设置（0x606E）正确时图像应为 50% 灰阶占空比；
  3. FF：全高基准，配合电流读数核对满幅输出。

7.3 校准图案投放

  1. 「测试卡区域」选 640x360（校准图按光机原生分辨率制作）；
  2. 安装包已预置校准栏位（black / white / contrast / circle_640p / caliPoint / sharpness，以包内为准）；如需换用自己的校准图，按 4.5 节齿轮按钮配置；
  3. 依次点栏位按钮投放，按校准规程判读（新图案自动替换旧图案，无需先停止）；
  4. 完成后 ESC 退出。

8. 数据判读速查

现象/读数 判读
开机后发命令回 0xFF 光机启动中，就绪门禁拒绝，等几秒重发
日志出现 err:3（I2C NACK） 光机侧 I2C 无应答：光机未上电/未就绪，或板卡故障
温度应答 okTL:246 24.6°C（0.1°C 单位）
电流应答 okR110G110B110 R/G/B 三路电流设置值均为 110
电源自检红底 FPDO: 9V@3A PD 只协商到 9V 挡，未到 12V，更换/检查电源与线材
定时投光中 M737 无立即应答 正常：投光结束才应答，勿反复重发

9. 常见问题（FAQ）

Q1：双击 exe 没反应 / 被 Windows 拦截。 SmartScreen 弹窗点「更多信息」→「仍要运行」；杀毒软件误报时放行或加白名单； 仍不行则确认解压完整（exe 约 67 MB）。

Q2：光机命令发出去没反应。 按顺序排查：① 串口选对没有（115200 8N1）、A/B 线接对没有；② 先点「查版本」 （M999）验证链路，M999 都不通就是串口/接线问题；③ M999 通但开光机回 0xFF—— 光机启动中，等几秒重试；④ 半双工转换器发送期间看不到回环是正常的。

Q3：显示器下拉里找不到板卡。 检查 HDMI 线与板卡供电；点「刷新」；启动 DLPilot 会自动把本系列板卡拉回扩展桌面， 仍不行到 Windows 显示设置手动改「扩展这些显示器」，然后回软件刷新。

Q4：切了分辨率，桌面布局乱了。 软件的切换是临时的：点「恢复」立即还原；重启电脑或重插 HDMI 也会还原。 不会永久改动系统设置。

Q5：自定义栏位点了没图。 该栏位未配置图片（点齿轮配置）；或 exe 旁的图片文件被移动/删除——重新配置一次， 图片会重新复制到 exe 旁。

Q6：串口下拉里好几个 COM 口，选哪个？ 下拉项带设备描述（如 USB-SERIAL CH340 / serial-A~D），选你的 USB-RS485 转换器对应的口；描述相同的会附物理位置。拿不准就拔插一次看哪个口出现/消失。

Q7：两台电脑/两个目录各解压了一份，配置会串吗？ 不会。配置保存在各自 exe 旁的 pattern_slots.json，互相独立。

Q8：软件用久了变卡。 v0.4.2 及更早版本存在长会话卡顿问题，v0.4.3 已修复；请确认用的是 v0.4.3 （顶栏「关于」可查版本），旧版本请升级。

Q9：换电脑要带走哪些东西？ 整个安装目录打包即可；至少要 DLPilot.exe + pattern_slots.json（含你的栏位 与串口记忆）+ 你添加的自定义图片。

10. 版本沿革

版本 日期 要点
v0.4.3（当前） 2026-10-13 修复长会话越用越卡、命令点击无响应的问题（收发日志积压）；新增日志回归自检
v0.4.2 2026-09-28 收发日志「清空」按钮归位；恢复光机快捷按钮排（开/关光机、查版本、TEC 等）
v0.4.1 2026-09-28 修复切换 Light/Dark 主题后色值按钮底色丢失；串口连接失败改为简短提示，不再撑破窗口
v0.4.0 2026-09-24 界面重写为双栏仪表盘（Fluent 风格），功能基线版本

附录：技术支持

遇到本文未覆盖的问题，请联系我方对接工程师反馈： 软件版本号（顶栏「关于」）、操作步骤、收发日志截图（含原始 hex）， 光机问题请同时提供「查版本」（M999）与温度读数。

Reference in New Issue View Git Blame Copy Permalink