En esta página

QModbusPdu Class

QModbusPdu es una clase contenedora abstracta que contiene el código de función y la carga útil almacenados en una ADU de Modbus. Más información...

Encabezado: #include <QModbusPdu>
CMake: find_package(Qt6 REQUIRED COMPONENTS SerialBus)
target_link_libraries(mytarget PRIVATE Qt6::SerialBus)
qmake: QT += serialbus
Heredado por:

QModbusRequest y QModbusResponse

Tipos públicos

enum ExceptionCode { IllegalFunction, IllegalDataAddress, IllegalDataValue, ServerDeviceFailure, Acknowledge, …, ExtendedException }
enum FunctionCode { Invalid, ReadCoils, ReadDiscreteInputs, ReadHoldingRegisters, ReadInputRegisters, …, UndefinedFunctionCode }

Funciones públicas

QModbusPdu()
virtual ~QModbusPdu()
QByteArray data() const
qint16 dataSize() const
void decodeData(Args &&... data) const
void encodeData(Args... data)
QModbusPdu::ExceptionCode exceptionCode() const
QModbusPdu::FunctionCode functionCode() const
bool isException() const
bool isValid() const
void setData(const QByteArray &data)
virtual void setFunctionCode(QModbusPdu::FunctionCode code)
qint16 size() const

Miembros públicos estáticos

const quint8 ExceptionByte

Funciones protegidas

QModbusPdu(QModbusPdu::FunctionCode code, const QByteArray &data)
QModbusPdu(const QModbusPdu &other)
QModbusPdu &operator=(const QModbusPdu &other)
QDataStream &operator<<(QDataStream &stream, const QModbusPdu &pdu)
QDebug operator<<(QDebug debug, const QModbusPdu &pdu)

Descripción detallada

La clase proporciona acceso a los paquetes sin procesar del protocolo Modbus, tal y como se definen en la Especificación del Protocolo de Aplicación Modbus 1.1b.

Documentación sobre los tipos de miembros

enum QModbusPdu::ExceptionCode

Esta enumeración describe todas las condiciones de error posibles tal y como las definen los códigos de excepción de Modbus. El servidor las establece tras comprobar las condiciones de error correspondientes en la respuesta a una solicitud, y el cliente debe descodificarlas para poder actuar en función del código de excepción.

ConstanteValorDescripción
QModbusPdu::IllegalFunction0x01El dispositivo no admite el código de función.
QModbusPdu::IllegalDataAddress0x02La dirección de datos recibida en la consulta no es una dirección válida para el servidor Modbus.
QModbusPdu::IllegalDataValue0x03El valor contenido en el campo de datos de la solicitud no es un valor válido para el servidor Modbus.
QModbusPdu::ServerDeviceFailure0x04Se ha producido un error irrecuperable mientras el servidor intentaba realizar la acción solicitada.
QModbusPdu::Acknowledge0x05Uso especializado en combinación con comandos de programación.
QModbusPdu::ServerDeviceBusy0x06El servidor está procesando un comando de programación de larga duración.
QModbusPdu::NegativeAcknowledge0x07El servidor no puede ejecutar la función de programa recibida en la consulta. Este código se devuelve cuando una solicitud de programación no se ha completado con éxito. El cliente debe solicitar información de diagnóstico o de error al servidor.
QModbusPdu::MemoryParityError0x08Indica que el área de archivos ampliada no ha superado una comprobación de coherencia. Se utiliza junto con los códigos de función 20 y 21. El código de excepción no hace referencia a ninguna configuración de paridad de la línea de transmisión, sino únicamente a la memoria interna del servidor donde se almacenan los registros de archivos.
QModbusPdu::GatewayPathUnavailable0x0AIndica que la pasarela no ha podido asignar una ruta de comunicación interna desde el puerto de entrada al puerto de salida para procesar la solicitud.
QModbusPdu::GatewayTargetDeviceFailedToRespond0x0BIndica que no se ha obtenido respuesta del dispositivo de destino situado detrás de una pasarela. Por lo general, esto significa que el dispositivo de destino no está conectado a la red.
QModbusPdu::ExtendedException0xFFSe trata de una excepción ampliada según la especificación Modbus. Por lo general, este código se utiliza para describir una excepción que se detalla más adelante.

enum QModbusPdu::FunctionCode

Define el código de función y el tipo implícito de acción que requiere el servidor. No todos los dispositivos Modbus pueden gestionar el mismo conjunto de códigos de función.

ConstanteValorDescripción
QModbusPdu::Invalid0x00Establecido por el constructor por defecto; no lo utilice.
QModbusPdu::ReadCoils0x01Solicita el estado de una o más bobinas de un dispositivo.
QModbusPdu::ReadDiscreteInputs0x02Solicita el estado de uno o varios registros de entrada de un dispositivo.
QModbusPdu::ReadHoldingRegisters0x03Solicita el estado de uno o varios valores de los registros de retención de un dispositivo.
QModbusPdu::ReadInputRegisters0x04Solicita el estado de uno o varios valores de registros de entrada de un dispositivo.
QModbusPdu::WriteSingleCoil0x05Solicita escribir en una sola bobina de un dispositivo.
QModbusPdu::WriteSingleRegister0x06Solicita escribir en un único registro de retención de un dispositivo.
QModbusPdu::ReadExceptionStatus0x07Solicita el estado de las ocho salidas de estado de excepción de un dispositivo.
QModbusPdu::Diagnostics0x08Se utiliza para realizar una serie de pruebas destinadas a comprobar el sistema de comunicación cliente-servidor o a comprobar elementos internos
QModbusPdu::GetCommEventCounter0x0BSolicita una palabra de estado y un recuento de eventos del contador de eventos de comunicación del dispositivo.
QModbusPdu::GetCommEventLog0x0CSolicita una palabra de estado, el recuento de eventos, el recuento de mensajes y un campo de bytes de eventos de un dispositivo.
QModbusPdu::WriteMultipleCoils0x0FSolicita escribir en una o más bobinas de un dispositivo.
QModbusPdu::WriteMultipleRegisters0x10Solicita escribir en uno o más registros de retención de un dispositivo.
QModbusPdu::ReportServerId0x11Solicita la descripción del tipo, el estado actual y otra información específica de un dispositivo.
QModbusPdu::ReadFileRecord0x14Solicita la lectura de un registro de archivo.
QModbusPdu::WriteFileRecord0x15Solicita la escritura de un registro de archivo.
QModbusPdu::MaskWriteRegister0x16Solicita modificar el contenido de un registro de almacenamiento especificado utilizando una combinación de una máscara AND u OR y el contenido actual del registro.
QModbusPdu::ReadWriteMultipleRegisters0x17Solicita el estado de uno o varios registros de retención y, al mismo tiempo, escribe en uno o varios registros de retención de un dispositivo.
QModbusPdu::ReadFifoQueue0x18Solicita la lectura del contenido de una cola de registros de tipo «primero en entrar, primero en salir» (FIFO) en un dispositivo remoto.
QModbusPdu::EncapsulatedInterfaceTransport0x2BConsulte el anexo A de la especificación Modbus.
QModbusPdu::UndefinedFunctionCode0x100No utilizar.

Documentación de las funciones de miembro

[constexpr noexcept default] QModbusPdu::QModbusPdu()

Crea un objeto QModbusPdu no válido.

[protected] QModbusPdu::QModbusPdu(QModbusPdu::FunctionCode code, const QByteArray &data)

Crea un objeto `QModbusPdu` con el código de función establecido en « code » y la carga útil en « data ». Se espera que los datos ya estén almacenados en orden de bytes «big-endian».

[noexcept protected default] QModbusPdu::QModbusPdu(const QModbusPdu &other)

Crea un objeto `QModbusPdu` que es una copia de ` other`.

[virtual noexcept] QModbusPdu::~QModbusPdu()

Destruye un « QModbusPdu ».

QByteArray QModbusPdu::data() const

Devuelve la carga útil de la PDU, sin incluir el código de función. La carga útil se almacena en orden de bytes «big-endian».

Véase también setData().

qint16 QModbusPdu::dataSize() const

Devuelve el tamaño de los datos de la PDU, sin incluir el código de función.

template <typename... Args> void QModbusPdu::decodeData(Args &&... data) const

Convierte la carga útil al orden de bytes del host y la lee en ` data`. Los datos pueden ser una lista de argumentos de longitud variable.

QModbusResponsePdu response(QModbusPdu::ReportServerId);
response.encodeData(quint8(0x02), quint8(0x01), quint8(0xff));
quint8 count, id, run;
response.decodeData(&count, &id, &run);

Nota: Su uso está limitado únicamente a ` quint8 ` y ` quint16 `. Esto se debe a que los operadores de flujo de ` QDataStream ` no solo añaden datos sin procesar, sino también, por ejemplo, el tamaño, el recuento, etc., en el caso de los tipos complejos.

template <typename... Args> void QModbusPdu::encodeData(Args... data)

Establece la carga útil en data. Los datos se convierten y se almacenan en orden de bytes «big-endian».

QModbusRequestPdu request(QModbusPdu::ReadCoils);
// starting address and quantity of coils
request.encodeData(quint16(0x0c), quint16(0x0a));

Nota: Su uso está limitado únicamente a quint8 y quint16. Esto se debe a que los operadores de flujo de QDataStream no solo añaden datos sin procesar, sino también, por ejemplo, el tamaño, el recuento, etc., en el caso de los tipos complejos.

QModbusPdu::ExceptionCode QModbusPdu::exceptionCode() const

Devuelve el código de excepción de la respuesta.

QModbusPdu::FunctionCode QModbusPdu::functionCode() const

Devuelve el código de función de la PDU.

Véase también setFunctionCode().

bool QModbusPdu::isException() const

Devuelve «true» si la PDU contiene un código de excepción; en caso contrario, devuelve «false».

bool QModbusPdu::isValid() const

Devuelve «true» si la PDU es válida; en caso contrario, «false».

Una PDU se considera válida si el código de mensaje está comprendido entre 1 y 255 (en decimal) y el tamaño total de la PDU (código de función + datos) no supera los 253 bytes. Una PDU creada por defecto no es válida.

void QModbusPdu::setData(const QByteArray &data)

Establece la carga útil de la función de la PDU en data. Se espera que los datos ya estén almacenados en orden de bytes «big-endian».

Véase también data().

[virtual] void QModbusPdu::setFunctionCode(QModbusPdu::FunctionCode code)

Establece el código de función de la PDU en « code ».

Véase también functionCode().

qint16 QModbusPdu::size() const

Devuelve el tamaño total de la PDU, incluyendo el código de función y el tamaño de los datos.

[noexcept protected default] QModbusPdu &QModbusPdu::operator=(const QModbusPdu &other)

Crea una copia del objeto ` other ` y la asigna a este objeto ` QModbusPdu `.

Documentación de las variables de miembro

const quint8 QModbusPdu::ExceptionByte

La variable se inicializa con el valor 0x80.

Las excepciones se notifican en un formato de paquete definido. Se devuelve al cliente solicitante un código de función igual al código de función original, salvo que tiene el bit más significativo activado. Esto equivale a sumar 0x80 al valor del código de función original.

Este campo puede utilizarse para enmascarar el bit de excepción en el campo de función de un paquete Modbus sin procesar.

Elementos no miembros relacionados

QDataStream &operator<<(QDataStream &stream, const QModbusPdu &pdu)

Escribe un ` pdu ` en el ` stream ` y devuelve una referencia al flujo.

QDebug operator<<(QDebug debug, const QModbusPdu &pdu)

Escribe el « pdu » de Modbus en el flujo « debug ».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.