# 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）与温度读数。