En esta página

QModbusServer Class

La clase QModbusServer es la interfaz para recibir y procesar solicitudes Modbus. Más información...

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

QModbusRtuSerialServer y QModbusTcpServer

Tipos públicos

enum Option { DiagnosticRegister, ExceptionStatusOffset, DeviceBusy, AsciiInputDelimiter, ListenOnlyMode, …, UserOption }

Funciones públicas

QModbusServer(QObject *parent = nullptr)
bool data(QModbusDataUnit *newData) const
bool data(QModbusDataUnit::RegisterType table, quint16 address, quint16 *data) const
virtual bool processesBroadcast() const
int serverAddress() const
bool setData(const QModbusDataUnit &newData)
bool setData(QModbusDataUnit::RegisterType table, quint16 address, quint16 data)
virtual bool setMap(const QModbusDataUnitMap &map)
void setServerAddress(int serverAddress)
virtual bool setValue(int option, const QVariant &newValue)
virtual QVariant value(int option) const

Señales

void dataWritten(QModbusDataUnit::RegisterType table, int address, int size)

Funciones protegidas

virtual QModbusResponse processPrivateRequest(const QModbusPdu &request)
virtual QModbusResponse processRequest(const QModbusPdu &request)
virtual bool readData(QModbusDataUnit *newData) const
virtual bool writeData(const QModbusDataUnit &newData)

Descripción detallada

Las redes Modbus pueden tener varios servidores Modbus. Los servidores Modbus son leídos y escritos por un cliente Modbus representado por ` QModbusClient`. `QModbusServer` se comunica con un backend Modbus, proporcionando a los usuarios una API práctica.

Documentación sobre los tipos de miembros

enum QModbusServer::Option

Cada servidor Modbus tiene asociado un conjunto de valores, cada uno con su propia opción.

Las opciones de uso general (y los tipos asociados) son:

ConstanteValorDescripción
QModbusServer::DiagnosticRegister0El registro de diagnóstico del servidor. quint16
QModbusServer::ExceptionStatusOffset1El desplazamiento del byte de estado de excepción del servidor. quint16
QModbusServer::DeviceBusy2Indicador que señala que el servidor está procesando un comando de programa de larga duración. quint16
QModbusServer::AsciiInputDelimiter3El delimitador de fin de mensaje ASCII de Modbus. char
QModbusServer::ListenOnlyMode4Indicador para establecer el modo de solo escucha del servidor. Esta función suele ser compatible únicamente con dispositivos Modbus serie. bool
QModbusServer::ServerIdentifier5El identificador del servidor, no la dirección del servidor. quint8
QModbusServer::RunIndicatorStatus6El indicador de ejecución del servidor. quint8
QModbusServer::AdditionalData7Los datos adicionales del servidor. QByteArray
QModbusServer::DeviceIdentification8La descripción física y funcional del servidor. QModbusDeviceIdentification

Opciones de usuario:

ConstanteValorDescripción
QModbusServer::UserOption0x100La primera opción que se puede utilizar para fines específicos del usuario.

En el caso de las opciones de usuario, corresponde al desarrollador decidir qué tipos utilizar y asegurarse de que los componentes utilicen los tipos correctos al acceder a los valores y al establecerlos.

Documentación de la función miembro

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

Crea un servidor Modbus con el parent especificado.

bool QModbusServer::data(QModbusDataUnit *newData) const

Devuelve los valores del rango de registros especificado por ` newData`.

newData Se debe proporcionar un tipo de registro válido, una dirección de inicio y un valorCount. El objeto ` newData ` devuelto contendrá los valores de los registros asociados al rango especificado.

Si ` newData ` contiene un tipo de registro válido pero una dirección de inicio negativa, se devuelve todo el mapa de registros y ` newData ` se ajusta al tamaño adecuado.

Véase también setData().

bool QModbusServer::data(QModbusDataUnit::RegisterType table, quint16 address, quint16 *data) const

Lee los datos almacenados en el servidor Modbus. Un servidor Modbus cuenta con cuatro tablas (table) y cada una de ellas tiene un campo único « address », que se utiliza para leer « data » del campo deseado. Consulte QModbusDataUnit::RegisterType para obtener más información sobre las diferentes tablas. Devuelve « false » si la dirección se encuentra fuera del rango del mapa o si el tipo de registro ni siquiera está definido.

Véase también QModbusDataUnit::RegisterType y setData().

[signal] void QModbusServer::dataWritten(QModbusDataUnit::RegisterType table, int address, int size)

Esta señal se emite cuando un cliente Modbus ha escrito uno o más campos de datos en el servidor Modbus. La señal contiene información sobre los campos que se han escrito:

  • Tipo de registro (table) que se ha escrito,
  • address del primer campo que se ha escrito,
  • y size de los campos consecutivos que se han escrito a partir de address.

La señal no se emite cuando los campos que se van a escribir no han cambiado debido a que no se ha producido ninguna modificación en su valor.

[virtual protected] QModbusResponse QModbusServer::processPrivateRequest(const QModbusPdu &request)

Esta función debe ser implementada por servidores Modbus personalizados. La función ` processRequest()` la invoca si el código de función ` request ` proporcionado no es una solicitud Modbus estándar.

La sobrescritura de esta función permite gestionar códigos de función y códigos de subfunción adicionales no especificados en la Especificación del Protocolo de Aplicación Modbus 1.1b. Las reimplementaciones deben volver a llamar a esta función para garantizar que se devuelva una respuesta de excepción para todos los códigos de función desconocidos que la implementación Modbus personalizada no gestione.

Esta implementación predeterminada devuelve un objeto ` QModbusExceptionResponse ` con el código de función ` request ` y el código de error establecido en «función no válida».

Véase también processRequest().

[virtual protected] QModbusResponse QModbusServer::processRequest(const QModbusPdu &request)

Procesa una solicitud de cliente Modbus request y devuelve una respuesta Modbus. Esta función devuelve un objeto « QModbusResponse » o « QModbusExceptionResponse », dependiendo de la naturaleza de la solicitud.

La implementación predeterminada de esta función gestiona todos los códigos de función Modbus estándar tal y como se definen en la Especificación del Protocolo de Aplicación Modbus 1.1b. Todos los demás códigos de función Modbus no incluidos en la especificación se reenvían a processPrivateRequest().

El tratamiento por defecto de las solicitudes de códigos de función Modbus estándar puede sobrescribirse reimplementando esta función. La reimplementación debe gestionar el tipo de solicitud en cuestión y devolver el código de función « QModbusResponse » adecuado. Un motivo habitual podría ser filtrar las solicitudes de códigos de función para valores de datos, con el fin de limitar el acceso de lectura/escritura, así como los códigos de función no deseados en implementaciones concretas, como el diagnóstico de la línea serie en Ethernet o las capas de transporte de Modbus Plus. Cualquier otro tipo de solicitud debe reenviarse a esta implementación predeterminada.

Nota: Esta función no debe sobrescribirse para proporcionar una implementación personalizada para tipos de solicitud Modbus no estándar.

Véase también processPrivateRequest().

[virtual] bool QModbusServer::processesBroadcast() const

Las subclases deben implementar esta función si la capa de transporte debe gestionar las difusiones. La implementación debe devolver entonces ` true ` si la solicitud que se está procesando actualmente es una solicitud de difusión; en caso contrario, ` false`. La implementación por defecto devuelve siempre ` false`.

Nota: El valor de retorno de esta función solo tiene sentido desde dentro de ` processRequest()` o ` processPrivateRequest()`; en caso contrario, solo permite saber que la última solicitud procesada fue una solicitud de difusión.

[virtual protected] bool QModbusServer::readData(QModbusDataUnit *newData) const

Lee los valores del rango de registros indicado por ` newData ` y vuelve a escribir los datos en ` newData`. Devuelve ` true ` si la operación se realiza correctamente, o ` false ` si ` newData ` es ` 0`, el rango ` newData ` está fuera del rango del mapa o `registerType()` no existe.

Nota: Las subclases que implementen la lectura desde un almacén de respaldo distinto al predeterminado también deben implementar setMap() y writeData().

Véase también setMap() y writeData().

int QModbusServer::serverAddress() const

Devuelve la dirección de esta instancia del servidor Modbus.

Véase también setServerAddress().

bool QModbusServer::setData(const QModbusDataUnit &newData)

Escribe « newData » en el mapa del servidor Modbus. Devuelve « false » si el rango « newData » se encuentra fuera del rango del mapa.

Si la llamada se ha realizado correctamente, se emite la señal dataWritten(). Tenga en cuenta que la señal no se emite cuando el registro al que se hace referencia no ha cambiado. Esto puede ocurrir cuando newData ya contiene exactamente los mismos valores que el registro. No obstante, esta función devuelve true en tales casos.

Véase también data().

bool QModbusServer::setData(QModbusDataUnit::RegisterType table, quint16 address, quint16 data)

Escribe datos en el servidor Modbus. Un servidor Modbus tiene cuatro tablas (table) y cada una de ellas cuenta con un campo único « address », que se utiliza para escribir « data » en el campo deseado. Devuelve « false » si la dirección se encuentra fuera del rango del mapa.

Si la llamada se ha realizado correctamente, se emite la señal « dataWritten()». Ten en cuenta que la señal no se emite cuando « data » no ha cambiado. No obstante, esta función devuelve « true » en tales casos.

Véanse también QModbusDataUnit::RegisterType, data() y dataWritten().

[virtual] bool QModbusServer::setMap(const QModbusDataUnitMap &map)

Establece la estructura de mapa registrada para las solicitudes de otros clientes ModBus dirigidas a map. Los valores de los registros se inicializan a cero. Devuelve true si la operación se realiza correctamente; en caso contrario, false.

Si no se llama a esta función antes de conectarse, se configura un registro por defecto con cero entradas.

Nota: Al llamar a esta función se descartan todos los valores de registro que se hubieran establecido previamente.

void QModbusServer::setServerAddress(int serverAddress)

Establece la dirección de esta instancia del servidor Modbus en serverAddress.

Véase también serverAddress().

[virtual] bool QModbusServer::setValue(int option, const QVariant &newValue)

Establece el valor « newValue » para « option » y devuelve « true » si la operación se realiza correctamente; « false » en caso contrario.

Nota: Si el tipo asociado a la opción es « quint8 » o « quint16 » y el tipo de « newValue » es mayor, los datos se truncarán o la conversión fallará.

ClaveDescripción
QModbusServer::DiagnosticRegisterEstablece el registro de diagnóstico del servidor en una codificación específica del dispositivo en newValue. El valor predeterminado es 0x0000. Los valores de los bits del registro requieren documentación específica del dispositivo.
QModbusServer::ExceptionStatusOffsetEstablece el desplazamiento del byte de estado de excepción del servidor en newValue, que es la dirección de desplazamiento absoluta en las bobinas (registro 0x). Tabla de registros Modbus que comienza en 0x0000h. El valor predeterminado es 0x0000, utilizando las bobinas de estado de excepción de forma similar a las CPU Modicon 984 (bobinas 1-8).

La función devuelve « true » si el registro de bobinas contiene los 8 bits necesarios para almacenar y recuperar las bobinas de estado; en caso contrario, devuelve « false ».

QModbusServer::DeviceBusyEstablece un indicador que señala que el servidor está procesando un comando de programa de larga duración. Los valores válidos son 0x0000 (no ocupado) y 0xffff (ocupado). El valor predeterminado es 0x0000.
QModbusServer::AsciiInputDelimiterEl valor « newValue » se convierte en el delimitador de fin de mensaje para los futuros mensajes Modbus ASCII. El valor predeterminado es « \n ».
QModbusServer::ListenOnlyModeEstablece el estado de «solo escucha» del servidor en newValue. Si el modo de «solo escucha» se configura en true, los mensajes se supervisan, pero no se envía ninguna respuesta. El valor predeterminado es false.
QModbusServer::ServerIdentifierEstablece el identificador del fabricante del servidor en newValue. Los valores posibles están comprendidos entre 0x00 y 0xff. El valor predeterminado es 0x0a.
QModbusServer::RunIndicatorStatusEstablece el estado del indicador de funcionamiento del servidor en newValue. Estos datos se utilizan como complemento del código de función QModbusPdu::ReportServerId. Los valores válidos son 0x00 (OFF) y 0xff (ON). El valor predeterminado es 0xff (ON).
QModbusServer::AdditionalDataEstablece los datos adicionales del servidor en newValue. Estos datos se utilizan como apéndice por el código de función QModbusPdu::ReportServerId. El tamaño máximo de los datos no puede superar los 249 bytes para ajustarse a las restricciones de tamaño de los mensajes de respuesta. El valor predeterminado es Qt Modbus Server.
QModbusServer::DeviceIdentificationEstablece la descripción física y funcional del servidor. De forma predeterminada, no hay ningún dato adicional de identificación del dispositivo establecido.
QModbusServer::UserOptionEstablece el valor de una opción de usuario en newValue.

Nota: En el caso de las opciones de usuario, corresponde al desarrollador decidir qué tipos utilizar y asegurarse de que los componentes utilicen los tipos correctos al acceder a los valores y establecerlos.

Véase también value().

[virtual] QVariant QModbusServer::value(int option) const

Devuelve el valor de « option » o una « QVariant » no válida si la opción no está configurada.

OpciónDescripción
QModbusServer::DiagnosticRegisterDevuelve el valor del registro de diagnóstico del servidor. El registro de diagnóstico contiene información específica del dispositivo, en la que cada bit tiene un significado concreto.
QModbusServer::ExceptionStatusOffsetDevuelve la dirección de desplazamiento de la ubicación del byte de estado de excepción en el registro de bobinas.
QModbusServer::DeviceBusyDevuelve un indicador que señala si el servidor está procesando un comando de programa de larga duración.
QModbusServer::AsciiInputDelimiterDevuelve un delimitador de fin de mensaje de los mensajes Modbus ASCII.
QModbusServer::ListenOnlyModeDevuelve el estado de «solo escucha» del servidor. Se supervisan los mensajes, pero no se envía ninguna respuesta.
QModbusServer::ServerIdentifierDevuelve el código identificativo del fabricante del servidor. Puede ser un valor arbitrario comprendido entre 0x00 y 0xff.
QModbusServer::RunIndicatorStatusDevuelve el estado del indicador de funcionamiento del servidor. Estos datos se utilizan como complemento del código de función « QModbusPdu::ReportServerId ».
QModbusServer::AdditionalDataDevuelve los datos adicionales del servidor. Estos datos se utilizan como complemento del código de función « QModbusPdu::ReportServerId ».
QModbusServer::DeviceIdentificationDevuelve la descripción física y funcional del servidor.
QModbusServer::UserOptionDevuelve el valor de una opción de usuario.

Nota: En el caso de las opciones de usuario, corresponde al desarrollador decidir qué tipos utilizar y asegurarse de que los componentes utilicen los tipos correctos al acceder a los valores y al establecerlos.

Véase también setValue().

[virtual protected] bool QModbusServer::writeData(const QModbusDataUnit &newData)

Escribe newData en el mapa del servidor Modbus. Devuelve true si la operación se realiza correctamente, o false si el rango de newData está fuera del rango del mapa o si el registerType() no existe.

Nota: Las subclases que implementen la escritura en un almacén de respaldo distinto al predeterminado también deben implementar setMap() y readData(). La señal dataWritten() también debe emitirse desde la implementación de las funciones.

Véase también setMap(), readData() y dataWritten().

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