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: |
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) |
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:
| Constante | Valor | Descripción |
|---|---|---|
QModbusDevice::SerialPortNameParameter | 0 | Este parámetro indica el puerto serie utilizado para la comunicación con el dispositivo, p. ej., COM1. QString |
QModbusDevice::SerialParityParameter | 1 | Este parámetro indica el modo de comprobación de paridad. QSerialPort::Parity |
QModbusDevice::SerialBaudRateParameter | 2 | Este parámetro indica la velocidad de transmisión de datos para la comunicación. QSerialPort::BaudRate |
QModbusDevice::SerialDataBitsParameter | 3 | Este parámetro indica el número de bits de datos en una trama. QSerialPort::DataBits |
QModbusDevice::SerialStopBitsParameter | 4 | Este parámetro indica el número de bits de parada en una trama. QSerialPort::StopBits |
QModbusDevice::NetworkPortParameter | 5 | Este parámetro indica el puerto de red. int |
QModbusDevice::NetworkAddressParameter | 6 | Este 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.
| Constante | Valor | Descripción |
|---|---|---|
QModbusDevice::NoError | 0 | No se ha producido ningún error. |
QModbusDevice::ReadError | 1 | Se ha producido un error durante una operación de lectura. |
QModbusDevice::WriteError | 2 | Se ha producido un error durante una operación de escritura. |
QModbusDevice::ConnectionError | 3 | Se ha producido un error al intentar abrir el backend. |
QModbusDevice::ConfigurationError | 4 | Se ha producido un error al intentar establecer un parámetro de configuración. |
QModbusDevice::TimeoutError | 5 | Se 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::ProtocolError | 6 | Se ha producido un error específico del protocolo Modbus. |
QModbusDevice::ReplyAbortedError | 7 | La respuesta se ha interrumpido debido a una desconexión del dispositivo. |
QModbusDevice::UnknownError | 8 | Se ha producido un error desconocido. |
QModbusDevice::InvalidResponseError (since Qt 6.4) | 9 | Se 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.
| Constante | Valor | Descripción |
|---|---|---|
QModbusDevice::ResponseCrcError | 0 | Se ha recibido una respuesta Modbus con un CRC incorrecto. |
QModbusDevice::ResponseRequestMismatch | 1 | Se 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.
| Constante | Valor | Descripción |
|---|---|---|
QModbusDevice::UnconnectedState | 0 | El dispositivo está desconectado. |
QModbusDevice::ConnectingState | 1 | El dispositivo se está conectando. |
QModbusDevice::ConnectedState | 2 | El dispositivo está conectado a la red Modbus. |
QModbusDevice::ClosingState | 3 | Se 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.
© 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.