Files
HW-Debug-Tools/DLPilot/使用说明.md
T

394 lines
20 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 主界面(红框标注为快速开始要点)](manual-img/ui-overview-quickstart.png)
*图 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)与温度读数。