Qt MODBUS协议

Qt中使用Modbus协议

Qt提供了Qt Modbus模块,支持Modbus RTU和Modbus TCP协议,可用于与硬件设备通信。以下是具体实现步骤:

环境准备 确保Qt安装时勾选了Qt Serial Port和Qt Modbus模块。在项目配置文件(.pro)中添加:

qmake 复制代码
QT += serialport modbus

创建Modbus客户端

cpp 复制代码
#include <QModbusRtuSerialMaster>
#include <QModbusTcpClient>

// RTU串口模式
QModbusRtuSerialMaster *modbusDevice = new QModbusRtuSerialMaster;
modbusDevice->setConnectionParameter(QModbusDevice::SerialPortNameParameter, "COM1");
modbusDevice->setConnectionParameter(QModbusDevice::SerialBaudRateParameter, QSerialPort::Baud19200);
modbusDevice->setConnectionParameter(QModbusDevice::SerialParityParameter, QSerialPort::NoParity);
modbusDevice->setConnectionParameter(QModbusDevice::SerialDataBitsParameter, QSerialPort::Data8);
modbusDevice->setConnectionParameter(QModbusDevice::SerialStopBitsParameter, QSerialPort::OneStop);

// TCP模式
QModbusTcpClient *modbusDevice = new QModbusTcpClient;
modbusDevice->setConnectionParameter(QModbusDevice::NetworkPortParameter, 502);
modbusDevice->setConnectionParameter(QModbusDevice::NetworkAddressParameter, "192.168.1.100");

连接设备

cpp 复制代码
if (!modbusDevice->connectDevice()) {
    qDebug() << "连接失败:" << modbusDevice->errorString();
}

数据读写操作 读取保持寄存器(功能码0x03):

cpp 复制代码
QModbusDataUnit readUnit(QModbusDataUnit::HoldingRegisters, 0, 10);
if (auto *reply = modbusDevice->sendReadRequest(readUnit, 1)) {
    if (!reply->isFinished())
        connect(reply, &QModbusReply::finished, this, [this, reply]() {
            if (reply->error() == QModbusDevice::NoError) {
                const QModbusDataUnit unit = reply->result();
                for (uint i = 0; i < unit.valueCount(); i++)
                    qDebug() << "地址" << unit.startAddress() + i << "值:" << unit.value(i);
            }
            reply->deleteLater();
        });
    else
        delete reply;
}

写入单个寄存器(功能码0x06):

cpp 复制代码
QModbusDataUnit writeUnit(QModbusDataUnit::HoldingRegisters, 5, {123});
if (auto *reply = modbusDevice->sendWriteRequest(writeUnit, 1)) {
    connect(reply, &QModbusReply::finished, this, [this, reply]() {
        if (reply->error() == QModbusDevice::NoError)
            qDebug() << "写入成功";
        reply->deleteLater();
    });
}

错误处理

cpp 复制代码
connect(modbusDevice, &QModbusClient::errorOccurred, [](QModbusDevice::Error error) {
    qDebug() << "Modbus错误:" << error;
});

断开连接

cpp 复制代码
modbusDevice->disconnectDevice();

注意事项

  • Modbus RTU需要正确配置串口参数(波特率、数据位等)
  • 从站地址需要与硬件设备设置一致
  • 读写操作是异步的,需要通过信号槽处理结果
  • 工业环境中建议添加超时重试机制
  • 对于大量数据读取,需注意Modbus协议的单帧限制(通常最多125个寄存器)

调试建议

  • 使用Modbus调试工具(如Modbus Poll)验证硬件通信
  • 启用Qt Modbus模块的调试输出:
cpp 复制代码
QLoggingCategory::setFilterLevel("qt.modbus*", QtDebugMsg);
  • 检查硬件设备的Modbus地址映射表,确保访问正确的寄存器地址
相关推荐
西西弗Sisyphus9 小时前
C++ explicit 关键字工程实践
开发语言·c++
郝学胜-神的一滴11 小时前
Effective Python 条款35:用类封装替代生成器异常注入
开发语言·人工智能·python·金融·pandas·scikit-learn·matplotlib
feixing_fx11 小时前
原始类型与引用类型:赋值时到底复制了什么
开发语言·前端·javascript·前端框架
wuyk55511 小时前
Python办公自动化-第02讲-Excel文件认知与四大库选型
开发语言·python·excel
神明不懂浪漫12 小时前
【第八章】多线程(一)
java·开发语言·经验分享·笔记
yiangL_13 小时前
1、Python 输入输出实验|print 与 input 人机交互实践
开发语言·python·人机交互
慧都产品智能化15 小时前
Qt 开发 CAD/CAM 工序表的隐性成本分析
c++·qt·qt5·qt6.3
山楂树の15 小时前
Java 泛型:泛型类、泛型方法、泛型接口与通配符
java·开发语言·笔记
利威尔xu15 小时前
2026-11-18-Go接口幂等设计实战
开发语言·后端·golang
eggwyw16 小时前
linux下的C\C++多进程多线程编程实例详解
开发语言·c++