DLD154Pro/DLD154Tool/README.md

DLD154Tool — DLD154Pro 桌面串口调试工具

基于 PySide6 + pyserial 的 RS485 串口调试工具，支持 DLD154Pro 的两种 RS485 协议。

协议支持

协议	Tab	功能
700BS	700BS	查询状态 (0xFA)、查询频率 (0x1B)、查询拨码 (0x3D)、复位初始化 (0x2C)、自动轮询
Modbus RTU	Modbus RTU	FC 0x02/0x03/0x04/0x06/0x10/0x11、全数据块查询 (0x0100)、主动上报使能/阈值设置

快速开始

cd DLD154Tool
python3 -m venv venv
source venv/bin/activate   # Windows: venv\\Scripts\\activate
pip install -r requirements.txt
python main.py

界面布局

┌────────────────────────────────────────────┐
│  Tab: 串口设置 │ 700BS │ Modbus RTU │ 日志  │
├────────────────────────────────────────────┤
│                                            │
│  串口设置:                                  │
│    [端口▼] [刷新]  波特率: [9600▼]            │
│    从机地址: [1]                            │
│    [连接]                                   │
│                                            │
├────────────────────────────────────────────┤
│  700BS:                                    │
│    [查询状态] [查询频率] [查询拨码]            │
│    [复位初始化]                              │
│    自动轮询: ☑启用  间隔: [1000ms▼]          │
│    响应显示区                               │
├────────────────────────────────────────────┤
│  Modbus RTU:                               │
│    读: 起始 [0100] 数量 [19]                 │
│    [读IR] [读HR] [读DI] [SlaveID]           │
│    写: 地址 [0010] 值 [0001] [写单寄存器]      │
│    主动上报: ☑使能  阈值 [10] [设置]          │
│    [查询全数据块]  响应 & 全数据显示            │
├────────────────────────────────────────────┤
│  日志: TX/RX hex dump + 事件                  │
└────────────────────────────────────────────┘

项目结构

DLD154Tool/
├── main.py              # PySide6 GUI (4 tabs + 后台串口线程)
├── serial_client.py     # 串口抽象层 (扫描/连接/收发)
├── protocol_700bs.py    # 700BS 协议编解码
├── protocol_modbus.py   # Modbus RTU 协议编解码 + CRC16
├── DLD154Tool.spec      # PyInstaller 打包配置
├── requirements.txt     # pyside6, pyserial
├── .gitignore
├── dist/                # 打包产物 (gitignored)
└── README.md

打包为可执行文件

PyInstaller 不支持跨平台交叉编译，需要在目标系统上执行。

Linux

pip install pyinstaller
pyinstaller DLD154Tool.spec
# → dist/DLD154Tool  (69MB, 单文件 ELF x86-64)

Windows

python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt pyinstaller
pyinstaller DLD154Tool.spec
:: → dist\DLD154Tool.exe  (单文件，双击运行)

spec 文件已预置，无需重新生成。产物 dist/ 目录已加入 .gitignore。

RS485 接线

USB-to-RS485 模块          DLD154Pro
─────────────────         ─────────
A (D+)  ─────────────────  A (PA15 / PA14)
B (D−)  ─────────────────  B (PA15 / PA14)
GND     ─────────────────  GND

DLD154Pro RS485 为半双工，UART0 通过 PA13 自动切换收发方向。

串口参数

参数	默认值	范围
波特率	9600	9600/19200/38400/57600/115200
数据位	8	—
校验	无	—
停止位	1	—
从机地址	1	1–247

协议文档

• 700BS: docs/DLD-700BS-V1.15-使用说明书.md
• Modbus: docs/rs485-modbus-protocol.md (V1.6)