QModbusRequest Class
QModbusRequest es una clase contenedora que incluye el código de función y la carga útil almacenados en una ADU de Modbus. Más información...
| Encabezado: | #include <QModbusRequest> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS SerialBus) target_link_libraries(mytarget PRIVATE Qt6::SerialBus) |
| qmake: | QT += serialbus |
| Heredado de: | QModbusPdu |
Tipos públicos
Funciones públicas
| QModbusRequest() | |
| QModbusRequest(const QModbusPdu &pdu) | |
| QModbusRequest(QModbusPdu::FunctionCode code, Args... data) | |
| QModbusRequest(QModbusPdu::FunctionCode code, const QByteArray &data = QByteArray()) |
Miembros públicos estáticos
| int | calculateDataSize(const QModbusRequest &request) |
| int | minimumDataSize(const QModbusRequest &request) |
| void | registerDataSizeCalculator(QModbusPdu::FunctionCode fc, QModbusRequest::CalcFuncPtr calculator) |
Elementos no miembros relacionados
| QDataStream & | operator>>(QDataStream &stream, QModbusRequest &pdu) |
Descripción detallada
Una solicitud Modbus suele constar de un solo byte que describe el « FunctionCode » y N bytes de carga útil
Una solicitud Modbus típica puede tener este aspecto:
QModbusRequest request(QModbusRequest::WriteMultipleCoils,
QByteArray::fromHex("0013000a02cd01"));Nota: Al utilizar el constructor que toma el QByteArray, asegúrate de convertir los datos que contiene al orden de bytes big-endian antes de crear la solicitud.
La misma solicitud se puede crear así, si los valores se conocen en tiempo de compilación:
quint16 startAddress = 19, numberOfCoils = 10;
quint8 payloadInBytes = 2, outputHigh = 0xcd, outputLow = 0x01;
QModbusRequest request(QModbusRequest::WriteMultipleCoils, startAddress, numberOfCoils,
payloadInBytes, outputHigh, outputLow);Documentación sobre los tipos de miembros
[alias] QModbusRequest::CalcFuncPtr
Definición de tipo para un puntero a una función de calculadora personalizada con la misma firma que QModbusRequest::calculateDataSize.
Documentación de las funciones de miembro
[constexpr noexcept default] QModbusRequest::QModbusRequest()
Crea un objeto `QModbusRequest` no válido.
QModbusRequest::QModbusRequest(const QModbusPdu &pdu)
Crea una copia de pdu.
template <typename... Args> QModbusRequest::QModbusRequest(QModbusPdu::FunctionCode code, Args... data)
Crea un objeto `QModbusRequest` con el código de función establecido en ` code ` y la carga útil establecida en ` data`. Los datos se convierten y se almacenan en orden de bytes «big-endian».
Nota: El uso se limita exclusivamente 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.
[explicit] QModbusRequest::QModbusRequest(QModbusPdu::FunctionCode code, const QByteArray &data = QByteArray())
Crea un objeto ` QModbusResponse ` con el código de función establecido en ` code ` y la carga útil establecida en ` data`. Se espera que los datos ya estén almacenados en orden de bytes «big-endian».
[static] int QModbusRequest::calculateDataSize(const QModbusRequest &request)
Calcula el tamaño previsto de los datos para request en función del código de función y los datos de la solicitud. Devuelve el tamaño total de la parte de datos de la solicitud; -1 si no se ha podido calcular correctamente el tamaño.
Véase también minimumDataSize y registerDataSizeCalculator.
[static] int QModbusRequest::minimumDataSize(const QModbusRequest &request)
Devuelve el tamaño mínimo esperado de los datos para « request » en función del código de función de la solicitud; « -1 » si se desconoce el código de función.
[static] void QModbusRequest::registerDataSizeCalculator(QModbusPdu::FunctionCode fc, QModbusRequest::CalcFuncPtr calculator)
Esta función registra una implementación definida por el usuario para calcular el tamaño de los datos de la solicitud para el código de la función fc. Se puede utilizar para ampliar o sobrescribir la implementación de QModbusRequest::calculateDataSize().
CalcFuncPtr es un typedef para un puntero a una función personalizada calculator con la siguiente firma:
int myCalculateDataSize(const QModbusRequest &pdu);Elementos no miembros relacionados
QDataStream &operator>>(QDataStream &stream, QModbusRequest &pdu)
Lee un « pdu » del « stream » y devuelve una referencia al flujo.
Nota: Es posible quela función no transmita correctamente las PDU con el código de función QModbusPdu::Diagnostics o QModbusPdu::EncapsulatedInterfaceTransport debido a la ausencia del indicador de tamaño dentro de la PDU. En concreto, esto puede ocurrir cuando la PDU está incrustada en un flujo que no termina con la propia solicitud de diagnóstico/encapsulada.
© 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.