【Qt】QModbusPdu类

00. 目录

01. 概述

QModbusPdu是一个抽象的容器类，其中包含存储在Modbus ADU中的功能代码和数据。

该类提供对Modbus应用协议规范1.1b所定义的原始Modbus协议数据包的访问。

Header: #include
qmake: QT += serialbus

Since: Qt 5.8

Inherited By: QModbusRequest and QModbusResponse

02. 开发环境

Windows系统：Windows10

Qt版本：Qt5.15或者Qt6

03. 公有类型

enum ExceptionCode { IllegalFunction, IllegalDataAddress, IllegalDataValue, ServerDeviceFailure, Acknowledge, …,
                    ExtendedException }

enum FunctionCode { Invalid, ReadCoils, ReadDiscreteInputs, ReadHoldingRegisters, ReadInputRegisters, …, 
                   UndefinedFunctionCode }

enum QModbusPdu::ExceptionCode

该枚举描述了Modbus异常代码所定义的所有可能的错误情况。服务器在检查对请求的答复中的适当错误条件之后，会设置它们，并且必须由客户端进行解码才能对异常代码进行操作。

enum QModbusPdu::FunctionCode

定义服务器需要的功能代码和隐式操作类型。并非所有Modbus设备都可以处理同一组功能代码。

04. 成员方法

公有成员方法

QModbusPdu()
构造一个无效的QModbusPdu。
     
 virtual ~QModbusPdu()
 析构函数
    
 QByteArray data() const
 返回PDU的有效数据，不包括功能代码。有效数据以大端字节顺序存储。
    
 qint16 dataSize() const
 返回PDU的数据大小，不包括功能码。   
    
 void decodeData(Args &&... data) const
 将有效数据转换为主机字节顺序并将其读取为data。数据可以是可变长度的参数列表。   
     QModbusResponsePdu response(QModbusPdu::ReportServerId);
     response.encodeData(quint8(0x02), quint8(0x01), quint8(0xff));
     quint8 count, id, run;
     response.decodeData(&count, &id, &run);


 void encodeData(Args... data)
 将有效数据设置为data。数据被转换并以大端字节顺序存储。    
 QModbusRequestPdu request(QModbusPdu::ReadCoils);
 // starting address and quantity of coils
 request.encodeData(quint16(0x0c), quint16(0x0a));
    
 QModbusPdu::ExceptionCode exceptionCode() const
 返回响应的异常代码。    
        
 QModbusPdu::FunctionCode functionCode() const
 返回PDU的功能码。    
     
 bool isException() const
 如果PDU包含异常代码，则返回true；否则，返回false。    
         
 bool isValid() const
 如果PDU有效，则返回true；否则，返回true。    
 如果消息代码在1到255的十进制范围内，并且PDU的复合大小（功能代码+数据）不超过253个字节，则认为PDU有效。默认构造的PDU无效。
     
 void setData(const QByteArray &data)
 将PDU的功能有效数据设置为data。数据应该已经按大端字节顺序存储。    
     
 virtual void setFunctionCode(QModbusPdu::FunctionCode code)
 将PDU的功能代码设置为code。    
      
 qint16 size() const
 返回PDU的完整大小，包括功能代码和数据大小。    
     

受保护成员方法

QModbusPdu(const QModbusPdu &other)
构造一个QModbusPdu是副本等。
     
QModbusPdu(QModbusPdu::FunctionCode code, const QByteArray &data)
构造一个QModbusPdu，其功能码设置为code，数据设置为data。数据应该已经按大端字节顺序存储。
    
QModbusPdu &operator=(const QModbusPdu &other)
使得副本等，并为其指派该QModbusPdu对象。     

05. 成员变量

const quint8 QModbusPdu::ExceptionByte

该变量初始化为0x80。

异常以定义的数据包格式报告。除了设置了最高有效位以外，其他功能代码均与原始功能代码一样返回给请求的客户端。这等效于在原始功能代码的值上加上0x80。

该字段可用于屏蔽原始Modbus数据包功能字段中的异常位。

06. 附录

6.1 Qt教程汇总
网址：https://dengjin.blog.csdn.net/article/details/115174639