En esta página

QModbusDeviceIdentification Class

La clase `QModbusDeviceIdentification` es una clase contenedora que representa la descripción física y funcional de un servidor Modbus. Más información...

Encabezado: #include <QModbusDeviceIdentification>
CMake: find_package(Qt6 REQUIRED COMPONENTS SerialBus)
target_link_libraries(mytarget PRIVATE Qt6::SerialBus)
qmake: QT += serialbus

Tipos públicos

enum ConformityLevel { BasicConformityLevel, RegularConformityLevel, ExtendedConformityLevel, BasicIndividualConformityLevel, RegularIndividualConformityLevel, ExtendedIndividualConformityLevel }
enum ObjectId { VendorNameObjectId, ProductCodeObjectId, MajorMinorRevisionObjectId, VendorUrlObjectId, ProductNameObjectId, …, UndefinedObjectId }
enum ReadDeviceIdCode { BasicReadDeviceIdCode, RegularReadDeviceIdCode, ExtendedReadDeviceIdCode, IndividualReadDeviceIdCode }

Funciones públicas

QModbusDeviceIdentification()
QModbusDeviceIdentification::ConformityLevel conformityLevel() const
bool contains(uint objectId) const
bool insert(uint objectId, const QByteArray &value)
bool isValid() const
QList<int> objectIds() const
void remove(uint objectId)
void setConformityLevel(QModbusDeviceIdentification::ConformityLevel level)
QByteArray value(uint objectId) const

Miembros públicos estáticos

QModbusDeviceIdentification fromByteArray(const QByteArray &ba)

Descripción detallada

La interfaz de identificación de dispositivos se modela como un espacio de direcciones compuesto por un conjunto de elementos de datos direccionables. Los elementos de datos se denominan «objetos» y se identifican mediante un « ObjectId ».

Documentación de los tipos de miembros

enum QModbusDeviceIdentification::ConformityLevel

Define el nivel de conformidad de identificación del dispositivo y el tipo de acceso compatible.

ConstanteValorDescripción
QModbusDeviceIdentification::BasicConformityLevel0x01Identificación básica (acceso por flujo).
QModbusDeviceIdentification::RegularConformityLevel0x02Identificación normal (acceso por flujo).
QModbusDeviceIdentification::ExtendedConformityLevel0x03Identificación ampliada (acceso a la secuencia).
QModbusDeviceIdentification::BasicIndividualConformityLevel0x81Identificación básica (acceso a la corriente y acceso individual).
QModbusDeviceIdentification::RegularIndividualConformityLevel0x82Identificación estándar (acceso a cursos de agua y acceso individual).
QModbusDeviceIdentification::ExtendedIndividualConformityLevel0x83Identificación ampliada (acceso a la transmisión y acceso individual).

Véase también ReadDeviceIdCode.

enum QModbusDeviceIdentification::ObjectId

Esta enumeración describe los posibles objetos de servidor. La interfaz consta de tres categorías de objetos:

Identificación básica del dispositivo. Todos los objetos de esta categoría son obligatorios.

ConstanteValorDescripción
QModbusDeviceIdentification::VendorNameObjectId0x00El nombre del fabricante del dispositivo.
QModbusDeviceIdentification::ProductCodeObjectId0x01El código de producto del dispositivo.
QModbusDeviceIdentification::MajorMinorRevisionObjectId0x02La numeración de la versión del producto.

Identificación estándar del dispositivo. Todos los objetos de esta categoría son de definición estándar y opcionales.

ConstanteValorDescripción
QModbusDeviceIdentification::VendorUrlObjectId0x03La URL del fabricante del dispositivo.
QModbusDeviceIdentification::ProductNameObjectId0x04El nombre del producto del dispositivo.
QModbusDeviceIdentification::ModelNameObjectId0x05El nombre del modelo del dispositivo.
QModbusDeviceIdentification::UserApplicationNameObjectId0x06El nombre de la aplicación de usuario del dispositivo.

Rango reservado (es decir, ReservedObjectId >= ObjectId < ProductDependentObjectId). No utilizar.

ConstanteValorDescripción
QModbusDeviceIdentification::ReservedObjectId0x07Primer valor de los identificadores de objeto reservados.

Identificación ampliada del dispositivo. Todos estos datos dependen del dispositivo y son opcionales.

ConstanteValorDescripción
QModbusDeviceIdentification::ProductDependentObjectId0x80Primer valor posible de los identificadores dependientes del producto.
QModbusDeviceIdentification::UndefinedObjectId0x100No utilizar.

enum QModbusDeviceIdentification::ReadDeviceIdCode

Define el tipo de acceso de la solicitud de identificación de lectura.

Acceso por flujo:

ConstanteValorDescripción
QModbusDeviceIdentification::BasicReadDeviceIdCode0x01Solicitud para obtener la identificación básica del dispositivo.
QModbusDeviceIdentification::RegularReadDeviceIdCode0x02Solicitud para obtener la identificación normal del dispositivo.
QModbusDeviceIdentification::ExtendedReadDeviceIdCode0x03Solicitud para obtener la identificación ampliada del dispositivo.

Acceso individual:

ConstanteValorDescripción
QModbusDeviceIdentification::IndividualReadDeviceIdCode0x04Solicitud para obtener un objeto de identificación específico.

Documentación de la función miembro

[constexpr noexcept default] QModbusDeviceIdentification::QModbusDeviceIdentification()

Crea un objeto `QModbusDeviceIdentification` no válido.

QModbusDeviceIdentification::ConformityLevel QModbusDeviceIdentification::conformityLevel() const

Devuelve el nivel de conformidad de identificación del dispositivo y el tipo de acceso compatible.

Véase también setConformityLevel().

bool QModbusDeviceIdentification::contains(uint objectId) const

Devuelve « true » si existe un elemento para el objectId dado; en caso contrario, devuelve « false ».

Véase también ObjectId.

[static] QModbusDeviceIdentification QModbusDeviceIdentification::fromByteArray(const QByteArray &ba)

Convierte la matriz de bytes ba en un objeto QModbusDeviceIdentification.

Nota: El objeto devuelto puede estar vacío o incluso ser inválido si se produce algún error durante el procesamiento de la matriz de bytes.

Véase también isValid().

bool QModbusDeviceIdentification::insert(uint objectId, const QByteArray &value)

Inserta un nuevo elemento con el objectId y un valor de value. Si ya existe un elemento con el objectId, el valor de dicho elemento se sustituye por value.

Devuelve true si el tamaño de value es inferior a 245 bytes y el objectId es menor que QModbusDeviceIdentification::UndefinedObjectId.

Véase también ObjectId.

bool QModbusDeviceIdentification::isValid() const

Devuelve « true » si el objeto de identificación del dispositivo es válido; en caso contrario, devuelve « false ».

Un objeto de identificación de dispositivo se considera válido si ProductNameObjectId, ProductCodeObjectId y MajorMinorRevisionObjectId están establecidos en un valor no vacío. Aun así, el objeto puede contener identificadores de objeto válidos y datos asociados.

Nota: Un objeto de identificación de dispositivo creado por defecto no es válido.

QList<int> QModbusDeviceIdentification::objectIds() const

Devuelve una lista que contiene todos los identificadores de los objetos del objeto « QModbusDeviceIdentification » en orden ascendente.

Véase también ObjectId.

void QModbusDeviceIdentification::remove(uint objectId)

Elimina el elemento correspondiente a la dirección objectId.

Véase también ObjectId.

void QModbusDeviceIdentification::setConformityLevel(QModbusDeviceIdentification::ConformityLevel level)

Establece el nivel de conformidad de identificación del dispositivo y el tipo de acceso admitido en level.

Véase también conformityLevel().

QByteArray QModbusDeviceIdentification::value(uint objectId) const

Devuelve el valor asociado a ` objectId`. Si no existe ningún elemento con ` objectId`, la función devuelve un valor construido por defecto.

Véase también ObjectId.

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