En esta página

El generador de tipos de datos de Qt OPC UA

A partir de Qt 6.7, Qt OPC UA incluye un generador de tipos de datos denominado « qopcuaxmldatatypes2cpp », que genera enumeraciones y clases de datos en C++ compatibles con Qt OPC UA a partir de enumeraciones y tipos estructurados en archivos .bsd. Como función secundaria, se generan enumeraciones de ID de nodo a partir de archivos CSV.

El generador es una herramienta de línea de comandos que se puede controlar mediante los siguientes argumentos:

LargoBreveFinalidad
--input-iUn archivo .bsd del que se generarán todos los tipos enum y struct que contenga. Se puede utilizar más de una vez para generar código para varios modelos.
--dependencia_entrada-dUn archivo .bsd de entrada de dependencias en el que solo se generarán los tipos requeridos por una estructura de un archivo de entrada pasado mediante --input. Se puede utilizar más de una vez para dar cabida a modelos con dependencias respecto a otros modelos múltiples.
--nodeids-nUn nombre y la ruta a un archivo .csv con los identificadores de nodo para los que se generará una enumeración; por ejemplo, MyModel:/path/to/nodeids.csv => clase de enumeración MyModelNodeId. Se puede especificar varias veces.
--output-oEl directorio de salida donde se colocarán los archivos generados.
--prefix-pEl prefijo para los nombres de los archivos, enumeraciones y clases generados. El valor por defecto es GeneratedOpcUa.
--bundle-bGenera los archivos del paquete <prefijo>datatypes.h y <prefijo>datatypes.cpp, que incluyen mediante #include todos los archivos generados

En cada ejecución se generan los siguientes archivos:

  • Un archivo .h que contiene un espacio de nombres con todos los tipos enumerados
  • Un archivo .h y un archivo .cpp para cada tipo estructurado
  • Un archivo .h y un archivo .cpp que contienen métodos de codificación y decodificación
  • Un archivo .h que contenga las enumeraciones de identificadores de nodo si se especifica -n al menos una vez
  • Los archivos del paquete <prefijo>datatypes.h y <prefijo>datatypes.cpp si se especifica la opción -b

Integración con CMake

La función qt_opcua_generate_datatypes() toma uno o varios archivos .bsd de entrada y cualquier archivo .bsd de dependencia necesario, y ejecuta qopcuaxmldatatypes2cpp. Los archivos fuente y de cabecera generados se escriben en OUTPUT_DIR y se añaden al objetivo especificado como primer argumento.

OUTPUT_DIR o su directorio padre también deben añadirse a los directorios de inclusión del objetivo.

El siguiente fragmento de CMakeLists.txt muestra cómo integrar el generador de código en un proyecto basado en CMake:

find_package(Qt6 REQUIRED COMPONENTS Core OpcUa)

qt_standard_project_setup()

qt_add_executable(my_codegen
    mycodegen.cpp
)

qt_opcua_generate_datatypes(
    my_codegen # The target to add the generated files to
    INPUT_BSD "${CMAKE_CURRENT_SOURCE_DIR}/mymodel.bsd" # Must be set at least once if INPUT_CSV_MAP is not set
    INPUT_BSD "${CMAKE_CURRENT_SOURCE_DIR}/myothermodel.bsd"
    DEPENDENCY_BSD "${CMAKE_CURRENT_SOURCE_DIR}/mydependency.bsd" # Optional
    INPUT_CSV_MAP "MyModel:${CMAKE_CURRENT_SOURCE_DIR}/mymodel.csv" # Must be set at least once if INPUT_BSD is not set
    INPUT_CSV_MAP "MyOtherModel:${CMAKE_CURRENT_SOURCE_DIR}/myothermodel.csv"
    PREFIX "GeneratedOpcUa" # Mandatory
    OUTPUT_DIR "${CMAKE_CURRENT_BINARY_DIR}/generated" # Mandatory
)

target_include_directories(my_codegen
    PRIVATE
        ${CMAKE_CURRENT_BINARY_DIR}
)

target_link_libraries(my_codegen PRIVATE Qt6::Core Qt6::OpcUa)

Los archivos generados pueden utilizarse en cualquier archivo de cabecera o de código fuente incluyendo las dos cabeceras de nivel superior para los tipos de datos y la clase de codificador/decodificador.

#include <generated/generatedopcuabinarydeencoder.h> // If INPUT_BSD was set
#include <generated/generatedopcuadatatypes.h> // If INPUT_BSD was set
#include <generated/generatedopcuanodeids.h> // If INPUT_CSV_MAP was set

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