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.
| Constante | Valor | Descripción |
|---|---|---|
QModbusDeviceIdentification::BasicConformityLevel | 0x01 | Identificación básica (acceso por flujo). |
QModbusDeviceIdentification::RegularConformityLevel | 0x02 | Identificación normal (acceso por flujo). |
QModbusDeviceIdentification::ExtendedConformityLevel | 0x03 | Identificación ampliada (acceso a la secuencia). |
QModbusDeviceIdentification::BasicIndividualConformityLevel | 0x81 | Identificación básica (acceso a la corriente y acceso individual). |
QModbusDeviceIdentification::RegularIndividualConformityLevel | 0x82 | Identificación estándar (acceso a cursos de agua y acceso individual). |
QModbusDeviceIdentification::ExtendedIndividualConformityLevel | 0x83 | Identificació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.
| Constante | Valor | Descripción |
|---|---|---|
QModbusDeviceIdentification::VendorNameObjectId | 0x00 | El nombre del fabricante del dispositivo. |
QModbusDeviceIdentification::ProductCodeObjectId | 0x01 | El código de producto del dispositivo. |
QModbusDeviceIdentification::MajorMinorRevisionObjectId | 0x02 | La 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.
| Constante | Valor | Descripción |
|---|---|---|
QModbusDeviceIdentification::VendorUrlObjectId | 0x03 | La URL del fabricante del dispositivo. |
QModbusDeviceIdentification::ProductNameObjectId | 0x04 | El nombre del producto del dispositivo. |
QModbusDeviceIdentification::ModelNameObjectId | 0x05 | El nombre del modelo del dispositivo. |
QModbusDeviceIdentification::UserApplicationNameObjectId | 0x06 | El nombre de la aplicación de usuario del dispositivo. |
Rango reservado (es decir, ReservedObjectId >= ObjectId < ProductDependentObjectId). No utilizar.
| Constante | Valor | Descripción |
|---|---|---|
QModbusDeviceIdentification::ReservedObjectId | 0x07 | Primer valor de los identificadores de objeto reservados. |
Identificación ampliada del dispositivo. Todos estos datos dependen del dispositivo y son opcionales.
| Constante | Valor | Descripción |
|---|---|---|
QModbusDeviceIdentification::ProductDependentObjectId | 0x80 | Primer valor posible de los identificadores dependientes del producto. |
QModbusDeviceIdentification::UndefinedObjectId | 0x100 | No utilizar. |
enum QModbusDeviceIdentification::ReadDeviceIdCode
Define el tipo de acceso de la solicitud de identificación de lectura.
Acceso por flujo:
| Constante | Valor | Descripción |
|---|---|---|
QModbusDeviceIdentification::BasicReadDeviceIdCode | 0x01 | Solicitud para obtener la identificación básica del dispositivo. |
QModbusDeviceIdentification::RegularReadDeviceIdCode | 0x02 | Solicitud para obtener la identificación normal del dispositivo. |
QModbusDeviceIdentification::ExtendedReadDeviceIdCode | 0x03 | Solicitud para obtener la identificación ampliada del dispositivo. |
Acceso individual:
| Constante | Valor | Descripción |
|---|---|---|
QModbusDeviceIdentification::IndividualReadDeviceIdCode | 0x04 | Solicitud 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.