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:
| Largo | Breve | Finalidad |
|---|---|---|
| --input | -i | Un 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 | -d | Un 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 | -n | Un 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 | -o | El directorio de salida donde se colocarán los archivos generados. |
| --prefix | -p | El prefijo para los nombres de los archivos, enumeraciones y clases generados. El valor por defecto es GeneratedOpcUa. |
| --bundle | -b | Genera 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.