【Qt】QModbusDevice类

1、概述

QModbusDevice类是Modbus类 QModbusServer和 QModbusClient的基类。

Header: #include

qmake: QT += serialbus

Since: Qt 5.8

Inherits: QObject

Inherited By: QModbusClient and QModbusServer

2. 开发环境

Windows系统：Windows10

Qt版本：Qt5.15或者Qt6

本文福利，莬费领取Qt开发学习资料包、技术视频，内容包括（C++语言基础，Qt编程入门，QT信号与槽机制，QT界面开发-图像绘制，QT网络，QT数据库编程，QT项目实战，QSS，OpenCV，Quick模块，面试题等等）↓↓↓↓↓↓见下面↓↓文章底部点击莬费领取↓↓

3. 公有类型

enum ConnectionParameter { SerialPortNameParameter, SerialParityParameter, SerialBaudRateParameter, SerialDataBitsParameter, SerialStopBitsParameter, …, UserParameter }
enum Error { NoError, ReadError, WriteError, ConnectionError, ConfigurationError, …, UnknownError }
enum State { UnconnectedState, ConnectingState, ConnectedState, ClosingState }

枚举QModbusDevice :: ConnectionParameter

该枚举描述了可以为Modbus设备连接设置的可能值。

通用值（和关联的类型）为：

 enum QModbusDevice::Error类型

该枚举描述了所有可能的错误情况。

 

enum QModbusDevice::State

该枚举描述了所有可能的设备状态。

 

4. 成员方法

QModbusDevice::QModbusDevice(QObject *parent = nullptr)
用指定的parent构造一个Modbus设备。    
    
[signal] void QModbusDevice::errorOccurred(QModbusDevice::Error error)    
当错误发生，该信号被发送   
    
[signal] void QModbusDevice::stateChanged(QModbusDevice::State state)    
每次设备状态更改时都会发出此信号。新状态由state表示。    
    
[virtual] QModbusDevice::~QModbusDevice()   
析构函数    
    
[pure virtual protected] void QModbusDevice::close()    
该函数负责关闭Modbus连接。实现必须确保实例的状态（）设置为QModbusDevice :: UnconnectedState。    
    
bool QModbusDevice::connectDevice()    
将设备连接到Modbus网络。返回true是否成功启动连接过程；否则返回false。否则false。最终连接成功确认要求状态（）更改为QModbusDevice :: ConnectedState。      
QVariant QModbusDevice::connectionParameter(int parameter) const    
返回与给定连接参数关联的值。返回的值可以为空。

默认情况下，QModbusDevice使用一些通用值初始化。串行端口设置为偶校验，波特率为每秒19200位，八个数据位和一个停止位。主机地址的网络设置设置为本地主机，端口设置为502。

注意：为了使串行连接成功，需要将SerialPortNameParameter设置为有效的通信端口。可以从QSerialPortInfo获得有关有效串行端口的信息。

注意：如果已经连接了设备，则在重新连接设备后会考虑设置。
    
QIODevice *QModbusDevice::device() const    
返回用于ModBus通信或设备尚未完全初始化时返回nullptr
    
    
void QModbusDevice::disconnectDevice()    
断开设备连接。
    
    
QModbusDevice::Error QModbusDevice::error() const
返回设备的错误状态。
    
QString QModbusDevice::errorString() const    
返回设备错误的描述性错误文本。
    
[pure virtual protected] bool QModbusDevice::open()    
该函数由connectDevice（）调用。子类必须提供true在成功进行Modbus连接或连接初始化后返回的实现；否则返回false。

实现必须确保成功时将实例的状态（）设置为QModbusDevice :: ConnectingState或QModbusDevice :: ConnectedState；否则QModbusDevice :: UnconnectedState。通常，当连接过程异步向后报告时使用QModbusDevice :: ConnectingState，而在同步连接行为的情况下使用QModbusDevice :: ConnectedState。
    
 void QModbusDevice::setConnectionParameter(int parameter, const QVariant &value)
 将parameter的值设置为value。如果参数已经存在，则先前的值将被覆盖。活动或正在运行的连接不受此类参数更改的影响。
     
 [protected] void QModbusDevice::setError(const QString &errorText, QModbusDevice::Error error)       
 设置设备的错误状态。发生错误时，ModBus设备实现必须使用此功能来设置错误类型和描述性errorText。       
        
 [protected] void QModbusDevice::setState(QModbusDevice::State newState)   
 将设备的状态设置为newState。Modbus设备实现必须使用此功能来更新设备状态。
     
 QModbusDevice::State QModbusDevice::state() const  
 返回设备的当前状态。    

本文福利，莬费领取Qt开发学习资料包、技术视频，内容包括（C++语言基础，Qt编程入门，QT信号与槽机制，QT界面开发-图像绘制，QT网络，QT数据库编程，QT项目实战，QSS，OpenCV，Quick模块，面试题等等）↓↓↓↓↓↓见下面↓↓文章底部点击莬费领取↓↓