En esta página

QModbusClient Class

La clase QModbusClient es la interfaz para enviar solicitudes Modbus. Más información...

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

QModbusRtuSerialClient y QModbusTcpClient

Funciones públicas

QModbusClient(QObject *parent = nullptr)
int numberOfRetries() const
QModbusReply *sendRawRequest(const QModbusRequest &request, int serverAddress)
QModbusReply *sendReadRequest(const QModbusDataUnit &read, int serverAddress)
QModbusReply *sendReadWriteRequest(const QModbusDataUnit &read, const QModbusDataUnit &write, int serverAddress)
QModbusReply *sendWriteRequest(const QModbusDataUnit &write, int serverAddress)
void setNumberOfRetries(int number)
void setTimeout(int newTimeout)
int timeout() const

Señales

void timeoutChanged(int newTimeout)

Funciones protegidas

virtual bool processPrivateResponse(const QModbusResponse &response, QModbusDataUnit *data)
virtual bool processResponse(const QModbusResponse &response, QModbusDataUnit *data)

Descripción detallada

La API de QModbusClient se basa en un único objeto QModbusClient, que contiene la configuración y los ajustes comunes para las solicitudes que envía. Un único objeto QModbusClient debería ser suficiente para toda la aplicación Qt.

Una vez creado un objeto `QModbusClient`, la aplicación puede utilizarlo para enviar solicitudes. El objeto devuelto se utiliza para obtener cualquier dato devuelto en respuesta a la solicitud correspondiente.

QModbusClient cuenta con una API asíncrona. Cuando se invoca el slot «finished», el parámetro que recibe es el objeto « QModbusReply », que contiene la PDU, así como los metadatos (direccionamiento, etc.).

Nota: QModbusClient pone en cola las solicitudes que recibe. El número de solicitudes ejecutadas en paralelo depende del protocolo. Por ejemplo, el protocolo HTTP en plataformas de escritorio envía 6 solicitudes en paralelo para una combinación de host/puerto.

Documentación de las funciones miembro

[explicit] QModbusClient::QModbusClient(QObject *parent = nullptr)

Crea un dispositivo cliente Modbus con el ` parent` especificado.

int QModbusClient::numberOfRetries() const

Devuelve el número de reintentos que realizará un cliente antes de que una solicitud falle. El valor por defecto está establecido en « 3 ».

Véase también setNumberOfRetries().

[virtual protected] bool QModbusClient::processPrivateResponse(const QModbusResponse &response, QModbusDataUnit *data)

Debe implementarse mediante una implementación personalizada del cliente Modbus. La implementación predeterminada ignora response y data. Siempre devuelve «false» para indicar un error.

[virtual protected] bool QModbusClient::processResponse(const QModbusResponse &response, QModbusDataUnit *data)

Procesa un servidor Modbus response y almacena la información descodificada en data. Devuelve true si la operación se realiza correctamente; en caso contrario, false.

Nota: La implementación predeterminada no es compatible con todos los FunctionCode. Sobrescribe este método en implementaciones personalizadas de clientes Modbus para gestionar las funciones necesarias.

QModbusReply *QModbusClient::sendRawRequest(const QModbusRequest &request, int serverAddress)

Envía una solicitud Modbus sin procesar ( request). Una solicitud sin procesar puede contener cualquier dato que quepa en la sección de datos de la PDU de Modbus y que tenga un código de función válido. Por lo tanto, la única comprobación que se realiza antes del envío es la de validez; véase QModbusPdu::isValid. Si no se produce ningún error, la función devuelve un nuevo QModbusReply válido; en caso contrario, devuelve nullptr. Las redes Modbus pueden tener varios servidores, y cada servidor tiene un serverAddress único.

Véase también QModbusReply::rawResult().

QModbusReply *QModbusClient::sendReadRequest(const QModbusDataUnit &read, int serverAddress)

Envía una solicitud para leer el contenido de los datos a los que apunta read. Devuelve un nuevo objeto válido de tipo QModbusReply si no se ha producido ningún error; en caso contrario, devuelve nullptr. La red Modbus puede tener varios servidores, y cada servidor tiene un serverAddress único.

QModbusReply *QModbusClient::sendReadWriteRequest(const QModbusDataUnit &read, const QModbusDataUnit &write, int serverAddress)

Envía una solicitud para leer el contenido de los datos a los que apunta read y para modificar el contenido de los datos a los que apunta write utilizando el código de función Modbus QModbusPdu::ReadWriteMultipleRegisters. Devuelve un nuevo objeto QModbusReply válido si no se ha producido ningún error; en caso contrario, devuelve nullptr. La red Modbus puede tener varios servidores, y cada servidor tiene un serverAddress único.

Nota: El envío de este tipo de solicitud solo es válido si tanto read como write son de tipo QModbusDataUnit::HoldingRegisters.

QModbusReply *QModbusClient::sendWriteRequest(const QModbusDataUnit &write, int serverAddress)

Envía una solicitud para modificar el contenido de los datos a los que apunta ` write`. Devuelve un nuevo objeto válido de tipo ` QModbusReply ` si no se ha producido ningún error; en caso contrario, devuelve `nullptr`. La red Modbus puede tener varios servidores, y cada servidor tiene un ` serverAddress` único.

void QModbusClient::setNumberOfRetries(int number)

Establece el número de reintentos ( number ) que realizará un cliente antes de que una solicitud falle. El valor por defecto es « 3 ».

Nota: El nuevo valor debe ser mayor o igual que 0. El cambio de esta propiedad solo afectará a las nuevas solicitudes, no a las ya programadas.

Véase también numberOfRetries().

void QModbusClient::setTimeout(int newTimeout)

Establece el tiempo de espera ( newTimeout ) para esta instancia de QModbusClient. El tiempo de espera mínimo es de 10 ms.

El tiempo de espera lo utiliza el cliente para determinar cuánto tiempo espera a recibir una respuesta del servidor. Si no se recibe la respuesta dentro del tiempo de espera establecido, se establece el TimeoutError.

Los tiempos de espera ya activos o en ejecución no se ven afectados por dichos cambios en la duración del tiempo de espera.

Véase también timeout y timeoutChanged().

int QModbusClient::timeout() const

Devuelve el valor del tiempo de espera que utiliza esta instancia de ` QModbusClient ` en milisegundos. El tiempo de espera viene indicado por un ` TimeoutError`. El valor por defecto es 1000 ms.

Véase también setTimeout y timeoutChanged().

[signal] void QModbusClient::timeoutChanged(int newTimeout)

Esta señal se emite cuando se modifica el tiempo de espera utilizado por esta instancia de QModbusClient. El nuevo tiempo de espera de respuesta para el dispositivo se pasa como newTimeout.

Véase también setTimeout().

© 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.