当前位置：首页 > news >正文

Qt Modbus 协议上位机（Master）的优秀 GitHub 开源项目推荐

news 2026/5/31 9:09:15

以下是针对Qt Modbus 协议上位机（Master）的优秀 GitHub 开源项目推荐。我根据功能完整性、代码质量、是否使用 Qt 原生QtSerialBus（推荐）、对QByteArray/QByteArrayView的实际应用场景，以及是否适合工业级上位机开发进行了筛选。

1. 最推荐综合型项目（强烈建议优先学习）

项目名称：ModbusTools
GitHub 地址：https://github.com/serhmarch/ModbusTools

核心亮点：

跨平台（Windows + Linux）Qt 上位机工具集。
支持Modbus TCP、RTU、ASCII，以及 RTU/ASCII over TCP/UDP 等多种模式。
同时提供Master（客户端）和Slave（服务器）模拟器，界面简洁实用。
支持常用功能函数：Read Coils、Read Discrete Inputs、Read Holding Registers、Read Input Registers、Write Single Register、Write Multiple Registers 等（包含 0x18 Read FIFO Queue、0x2B/0x0E Read Device ID 等高级功能）。
代码结构清晰，使用 Qt 原生QModbusClient系列类，适合直接学习QModbusRtuSerialMaster、QModbusTcpClient的使用。
适合作为工业上位机的基础框架（数据监控、参数配置、日志记录等）。

学习价值：

大量使用QByteArray处理 Modbus PDU（协议数据单元）。
可以练习QByteArrayView进行零拷贝解析响应数据、帧头校验等。
非常适合扩展成带实时曲线（QCustomPlot）、数据库存储、报警系统的完整上位机。

2. 经典 Modbus Master 工具（功能最完善，推荐实战）

项目名称：qModbusMaster（QModMaster 的 fork）
GitHub 地址：https://github.com/Thuzerland/qModbusMaster
（原版 SourceForge：https://sourceforge.net/projects/qmodmaster/）

核心亮点：

成熟的 Qt-based Modbus Master 图形化工具。
支持Modbus RTU + TCP。
内置Bus Monitor（总线监视器），可查看原始数据（Raw Data）和 PDU 详细解析，非常适合调试协议。
支持多从站、连续轮询、数据导出等实用功能。
界面友好，接近商业 Modbus 上位机（如 Modbus Poll）。

适用场景：学习如何实现专业的 Modbus 主站监控界面、错误处理、重试机制、数据可视化。

3. 简单易上手 TCP Master 项目

项目名称：ModbusMasterTool
GitHub 地址：https://github.com/tonylin0826/ModbusMasterTool

专注Qt Modbus TCP Master。
代码量适中，适合快速上手QModbusTcpClient的连接、读写寄存器操作。
适合作为你自己项目的起点。

4. 其他值得参考的项目

coreanq/qt_modbus：Modbus RTU + ASCII 测试程序，代码简洁，适合入门串口 Modbus。
KB3HNS/QModbusTool：多模式 Modbus 客户端，界面支持与 PLC 等工业设备交互。
maisvendoo/qmaster：纯 RTU Master 模拟器，跨平台，适合专注串口场景。
ARoozitalab/Modbus-TCP-IP-server-QT：Modbus TCP Master 示例，结构简单。

Qt 官方推荐方式（Qt 5.8+ / Qt 6）：
Qt 官方提供了QtSerialBus模块，包含QModbusRtuSerialMaster、QModbusTcpClient、QModbusDataUnit、QModbusReply等类。
推荐所有新项目都基于QtSerialBus，而不是第三方 libmodbus 封装（除非有特殊需求）。

典型 Qt Modbus Master 核心代码示例（基于 QtSerialBus）

#include<QModbusRtuSerialMaster>#include<QModbusTcpClient>#include<QModbusDataUnit>#include<QDebug>classModbusMaster:publicQObject{Q_OBJECTpublic:explicitModbusMaster(QObject*parent=nullptr):QObject(parent){// 示例1：RTU 串口modbusDevice=newQModbusRtuSerialMaster(this);modbusDevice->setConnectionParameter(QModbusDevice::SerialPortNameParameter,"COM3");modbusDevice->setConnectionParameter(QModbusDevice::SerialBaudRateParameter,QSerialPort::Baud9600);modbusDevice->setConnectionParameter(QModbusDevice::SerialDataBitsParameter,QSerialPort::Data8);modbusDevice->setConnectionParameter(QModbusDevice::SerialParityParameter,QSerialPort::EvenParity);modbusDevice->setConnectionParameter(QModbusDevice::SerialStopBitsParameter,QSerialPort::OneStop);modbusDevice->setTimeout(1000);modbusDevice->setNumberOfRetries(3);connect(modbusDevice,&QModbusClient::stateChanged,this,&ModbusMaster::onStateChanged);connect(modbusDevice,&QModbusClient::errorOccurred,this,&ModbusMaster::onError);}voidreadHoldingRegisters(intserverAddress,intstartAddress,intnumberOfEntries){if(!modbusDevice->connectDevice())return;QModbusDataUnitreadUnit(QModbusDataUnit::HoldingRegisters,startAddress,numberOfEntries);auto*reply=modbusDevice->sendReadRequest(readUnit,serverAddress);if(reply){if(!reply->isFinished()){connect(reply,&QModbusReply::finished,this,[this,reply](){processReply(reply);});}else{deletereply;// broadcast replies return immediately}}}privateslots:voidprocessReply(QModbusReply*reply){if(reply->error()==QModbusDevice::NoError){constQModbusDataUnit unit=reply->result();for(inti=0;i<unit.valueCount();++i){qDebug()<<"Register"<<unit.startAddress()+i<<"="<<unit.value(i);// 这里可使用 QByteArrayView 处理原始响应数据}}else{qWarning()<<"Read failed:"<<reply->errorString();}reply->deleteLater();}private:QModbusClient*modbusDevice=nullptr;};

结合 QByteArrayView 的高级技巧：

在QModbusReply::rawResult()或自定义协议中，使用QByteArrayView对返回的 PDU 进行零拷贝解析（帧头、CRC、数据区截取）。
轮询大批量寄存器时，先reserve()缓存QByteArray，再用sliced()分割处理响应。

学习建议

先克隆ModbusTools或qModbusMaster，编译运行，熟悉界面和功能。
阅读源码中的协议读写部分，重点关注QModbusDataUnit与QByteArray的交互。
自己实现一个增强版：添加实时曲线显示（QCustomPlot）、数据日志、异常报警、多从站管理。
注意事项：
- RTU 需要正确设置串口参数（波特率、校验位等）。
- TCP 模式下处理超时、重连机制。
- 大规模数据时用QByteArrayView优化性能。
- Qt 6 中QtSerialBus依然可用，但需在.pro或CMakeLists.txt中添加QT += serialbus。