En esta página

QModbusDevice Class

La clase `QModbusDevice` es la clase base para las clases Modbus: QModbusServer y QModbusClient. Más información...

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

QModbusClient y QModbusServer

Tipos públicos

enum ConnectionParameter { SerialPortNameParameter, SerialParityParameter, SerialBaudRateParameter, SerialDataBitsParameter, SerialStopBitsParameter, …, NetworkAddressParameter }
enum Error { NoError, ReadError, WriteError, ConnectionError, ConfigurationError, …, InvalidResponseError }
(since 6.0) enum IntermediateError { ResponseCrcError, ResponseRequestMismatch }
enum State { UnconnectedState, ConnectingState, ConnectedState, ClosingState }

Funciones públicas

QModbusDevice(QObject *parent = nullptr)
virtual ~QModbusDevice()
bool connectDevice()
QVariant connectionParameter(QModbusDevice::ConnectionParameter parameter) const
QIODevice *device() const
void disconnectDevice()
QModbusDevice::Error error() const
QString errorString() const
void setConnectionParameter(QModbusDevice::ConnectionParameter parameter, const QVariant &value)
QModbusDevice::State state() const

Señales

void errorOccurred(QModbusDevice::Error error)
void stateChanged(QModbusDevice::State state)

Funciones protegidas

virtual void close() = 0
virtual bool open() = 0
void setError(const QString &errorText, QModbusDevice::Error error)
void setState(QModbusDevice::State newState)

Descripción detallada

Documentación sobre los tipos de miembros

enum QModbusDevice::ConnectionParameter

Esta enumeración describe los valores posibles que se pueden establecer para la conexión de un dispositivo Modbus.

Los valores de uso general (y los tipos asociados) son:

ConstanteValorDescripción
QModbusDevice::SerialPortNameParameter0Este parámetro indica el puerto serie utilizado para la comunicación con el dispositivo, p. ej., COM1. QString
QModbusDevice::SerialParityParameter1Este parámetro indica el modo de comprobación de paridad. QSerialPort::Parity
QModbusDevice::SerialBaudRateParameter2Este parámetro indica la velocidad de transmisión de datos para la comunicación. QSerialPort::BaudRate
QModbusDevice::SerialDataBitsParameter3Este parámetro indica el número de bits de datos en una trama. QSerialPort::DataBits
QModbusDevice::SerialStopBitsParameter4Este parámetro indica el número de bits de parada en una trama. QSerialPort::StopBits
QModbusDevice::NetworkPortParameter5Este parámetro indica el puerto de red. int
QModbusDevice::NetworkAddressParameter6Este parámetro especifica la dirección del host para la comunicación en red. QString

enum QModbusDevice::Error

Esta enumeración describe todas las condiciones de error posibles.

ConstanteValorDescripción
QModbusDevice::NoError0No se ha producido ningún error.
QModbusDevice::ReadError1Se ha producido un error durante una operación de lectura.
QModbusDevice::WriteError2Se ha producido un error durante una operación de escritura.
QModbusDevice::ConnectionError3Se ha producido un error al intentar abrir el backend.
QModbusDevice::ConfigurationError4Se ha producido un error al intentar establecer un parámetro de configuración.
QModbusDevice::TimeoutError5Se ha producido un tiempo de espera agotado durante la E/S. Una operación de E/S no ha finalizado en el plazo establecido.
QModbusDevice::ProtocolError6Se ha producido un error específico del protocolo Modbus.
QModbusDevice::ReplyAbortedError7La respuesta se ha interrumpido debido a una desconexión del dispositivo.
QModbusDevice::UnknownError8Se ha producido un error desconocido.
QModbusDevice::InvalidResponseError (since Qt 6.4)9Se ha producido un error al analizar la respuesta, o bien la función « FunctionCode » no es compatible con la implementación actual. En este último caso, una implementación personalizada del cliente Modbus puede anular los métodos « processResponse()» y « processPrivateResponse()» para proporcionar soporte a las funciones necesarias.

[since 6.0] enum QModbusDevice::IntermediateError

Esta enumeración describe los posibles errores que pueden producirse durante un ciclo completo de envío y recepción de una respuesta Modbus.

ConstanteValorDescripción
QModbusDevice::ResponseCrcError0Se ha recibido una respuesta Modbus con un CRC incorrecto.
QModbusDevice::ResponseRequestMismatch1Se ha recibido una respuesta Modbus, pero no coincidía con la solicitud abierta, probablemente debido a que el código de función de la PDU no coincidía.

Si se ha producido alguno de los errores intermedios anteriores, es probable que la trama siga presente hasta que se haya alcanzado el número máximo de reintentos.

La lista de errores intermedios puede consultarse mediante la función de errores intermedios QModbusReply.

Esta enumeración se introdujo en Qt 6.0.

Véase también ` QModbusClient::numberOfRetries()` y ` QModbusReply::intermediateErrors()`.

enum QModbusDevice::State

Esta enumeración describe todos los estados posibles del dispositivo.

ConstanteValorDescripción
QModbusDevice::UnconnectedState0El dispositivo está desconectado.
QModbusDevice::ConnectingState1El dispositivo se está conectando.
QModbusDevice::ConnectedState2El dispositivo está conectado a la red Modbus.
QModbusDevice::ClosingState3Se está cerrando el dispositivo.

Documentación de las funciones de miembro

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

Crea un dispositivo Modbus con el ` parent` especificado.

[virtual noexcept] QModbusDevice::~QModbusDevice()

Elimina la instancia de « QModbusDevice »

[pure virtual protected] void QModbusDevice::close()

Esta función se encarga de cerrar la conexión Modbus. La implementación debe garantizar que la propiedad ` state()` de la instancia esté establecida en ` QModbusDevice::UnconnectedState`.

Véase también disconnectDevice().

bool QModbusDevice::connectDevice()

Conecta el dispositivo a la red Modbus. Devuelve ` true ` si el proceso de conexión se ha iniciado correctamente; en caso contrario, devuelve ` false`. Para confirmar definitivamente que la conexión se ha realizado con éxito, es necesario que la función ` state()` cambie a ` QModbusDevice::ConnectedState`.

Esta función llama a open() como parte de su implementación.

Véase también open().

QVariant QModbusDevice::connectionParameter(QModbusDevice::ConnectionParameter parameter) const

Devuelve el valor asociado a la conexión indicada parameter. El valor devuelto puede estar vacío.

Por defecto, el QModbusDevice se inicializa con unos valores comunes. La configuración del puerto serie es: paridad par, una velocidad de transmisión de 19 200 bits por segundo, ocho bits de datos y un bit de parada. La configuración de red establece la dirección del host como el host local y el puerto como 502.

Nota: Para que una conexión serie se establezca correctamente, el « SerialPortNameParameter » debe configurarse en un puerto de comunicación válido. La información sobre los puertos serie válidos puede consultarse en QSerialPortInfo.

Nota: Si el dispositivo ya está conectado, la configuración se aplicará tras volver a conectarlo.

Véase también setConnectionParameter() y ConnectionParameter.

QIODevice *QModbusDevice::device() const

Devuelve el objeto ` QIODevice ` subyacente utilizado para la comunicación Modbus o ` nullptr ` si el dispositivo aún no se ha inicializado por completo.

Nota: No almacene un puntero al dispositivo subyacente, ya que puede quedar invalidado en cualquier momento.

void QModbusDevice::disconnectDevice()

Desconecta el dispositivo.

Esta función llama a ` close()` como parte de su implementación.

QModbusDevice::Error QModbusDevice::error() const

Devuelve el estado de error del dispositivo.

Véase también setError() y QModbusDevice::Error.

[signal] void QModbusDevice::errorOccurred(QModbusDevice::Error error)

Esta señal se emite cuando se produce un error del tipo « error ».

QString QModbusDevice::errorString() const

Devuelve un texto descriptivo del error del dispositivo.

Véase también QModbusDevice::Error.

[pure virtual protected] bool QModbusDevice::open()

Esta función es llamada por ` connectDevice()`. Las subclases deben proporcionar una implementación que devuelva ` true ` si la conexión Modbus se establece correctamente o si se inicia la conexión; en caso contrario, debe devolver ` false`.

La implementación debe garantizar que el método state() de la instancia se establezca en QModbusDevice::ConnectingState o QModbusDevice::ConnectedState en caso de éxito; de lo contrario, en QModbusDevice::UnconnectedState. Normalmente, se utiliza QModbusDevice::ConnectingState cuando el proceso de conexión devuelve información de forma asíncrona y QModbusDevice::ConnectedState en caso de que la conexión se realice de forma síncrona.

Véase también connectDevice().

void QModbusDevice::setConnectionParameter(QModbusDevice::ConnectionParameter parameter, const QVariant &value)

Establece el valor de « parameter » en « value ». Si el « parameter » ya existe, se sobrescribe el valor anterior. Una conexión activa o en curso no se ve afectada por estos cambios en los parámetros.

Véase también ConnectionParameter y connectionParameter().

[protected] void QModbusDevice::setError(const QString &errorText, QModbusDevice::Error error)

Establece el estado de error del dispositivo. Las implementaciones de dispositivos ModBus deben utilizar esta función en caso de error para establecer el tipo de error « error » y un valor descriptivo « errorText ».

Véanse también error() y QModbusDevice::Error.

[protected] void QModbusDevice::setState(QModbusDevice::State newState)

Establece el estado del dispositivo en « newState ». Las implementaciones de dispositivos Modbus deben utilizar esta función para actualizar el estado del dispositivo.

Véase también state().

QModbusDevice::State QModbusDevice::state() const

Devuelve el estado actual del dispositivo.

Véase también setState() y stateChanged().

[signal] void QModbusDevice::stateChanged(QModbusDevice::State state)

Esta señal se emite cada vez que cambia el estado del dispositivo. El nuevo estado viene representado por state.

Véanse también « setState()» y « state()».

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