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: |
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) |
Elementos no miembros relacionados
| 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.
| Constante | Valor | Descripción |
|---|---|---|
QModbusPdu::IllegalFunction | 0x01 | El dispositivo no admite el código de función. |
QModbusPdu::IllegalDataAddress | 0x02 | La dirección de datos recibida en la consulta no es una dirección válida para el servidor Modbus. |
QModbusPdu::IllegalDataValue | 0x03 | El valor contenido en el campo de datos de la solicitud no es un valor válido para el servidor Modbus. |
QModbusPdu::ServerDeviceFailure | 0x04 | Se ha producido un error irrecuperable mientras el servidor intentaba realizar la acción solicitada. |
QModbusPdu::Acknowledge | 0x05 | Uso especializado en combinación con comandos de programación. |
QModbusPdu::ServerDeviceBusy | 0x06 | El servidor está procesando un comando de programación de larga duración. |
QModbusPdu::NegativeAcknowledge | 0x07 | El 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::MemoryParityError | 0x08 | Indica 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::GatewayPathUnavailable | 0x0A | Indica 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::GatewayTargetDeviceFailedToRespond | 0x0B | Indica 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::ExtendedException | 0xFF | Se 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.
| Constante | Valor | Descripción |
|---|---|---|
QModbusPdu::Invalid | 0x00 | Establecido por el constructor por defecto; no lo utilice. |
QModbusPdu::ReadCoils | 0x01 | Solicita el estado de una o más bobinas de un dispositivo. |
QModbusPdu::ReadDiscreteInputs | 0x02 | Solicita el estado de uno o varios registros de entrada de un dispositivo. |
QModbusPdu::ReadHoldingRegisters | 0x03 | Solicita el estado de uno o varios valores de los registros de retención de un dispositivo. |
QModbusPdu::ReadInputRegisters | 0x04 | Solicita el estado de uno o varios valores de registros de entrada de un dispositivo. |
QModbusPdu::WriteSingleCoil | 0x05 | Solicita escribir en una sola bobina de un dispositivo. |
QModbusPdu::WriteSingleRegister | 0x06 | Solicita escribir en un único registro de retención de un dispositivo. |
QModbusPdu::ReadExceptionStatus | 0x07 | Solicita el estado de las ocho salidas de estado de excepción de un dispositivo. |
QModbusPdu::Diagnostics | 0x08 | Se utiliza para realizar una serie de pruebas destinadas a comprobar el sistema de comunicación cliente-servidor o a comprobar elementos internos |
QModbusPdu::GetCommEventCounter | 0x0B | Solicita una palabra de estado y un recuento de eventos del contador de eventos de comunicación del dispositivo. |
QModbusPdu::GetCommEventLog | 0x0C | Solicita una palabra de estado, el recuento de eventos, el recuento de mensajes y un campo de bytes de eventos de un dispositivo. |
QModbusPdu::WriteMultipleCoils | 0x0F | Solicita escribir en una o más bobinas de un dispositivo. |
QModbusPdu::WriteMultipleRegisters | 0x10 | Solicita escribir en uno o más registros de retención de un dispositivo. |
QModbusPdu::ReportServerId | 0x11 | Solicita la descripción del tipo, el estado actual y otra información específica de un dispositivo. |
QModbusPdu::ReadFileRecord | 0x14 | Solicita la lectura de un registro de archivo. |
QModbusPdu::WriteFileRecord | 0x15 | Solicita la escritura de un registro de archivo. |
QModbusPdu::MaskWriteRegister | 0x16 | Solicita 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::ReadWriteMultipleRegisters | 0x17 | Solicita 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::ReadFifoQueue | 0x18 | Solicita la lectura del contenido de una cola de registros de tipo «primero en entrar, primero en salir» (FIFO) en un dispositivo remoto. |
QModbusPdu::EncapsulatedInterfaceTransport | 0x2B | Consulte el anexo A de la especificación Modbus. |
QModbusPdu::UndefinedFunctionCode | 0x100 | No 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.