Der Datentyp-Generator von „ Qt OPC UA “

Ab Qt 6.7 enthält „ Qt OPC UA “ einen Datentyp-Generator namens „ qopcuaxmldatatypes2cpp “, der aus Enums und strukturierten Typen in .bsd-Dateien „ Qt OPC UA “-kompatible C++-Enumerationen und Datenklassen generiert. Als sekundäre Funktion werden Knoten-ID-Enums aus CSV-Dateien generiert.

Der Generator ist ein Befehlszeilentool, das über die folgenden Argumente gesteuert werden kann:

Bei jedem Durchlauf werden folgende Dateien generiert:

• Eine Datei „ .h “, die einen Namespace mit allen Aufzählungstypen enthält
• Je eine Datei „ .h “ und „ .cpp “ für jeden strukturierten Typ
• Eine „ .h “- und eine „ .cpp “-Datei, die Kodierungs- und Dekodierungsmethoden enthalten
• Eine „ .h “-Datei, die die Knoten-ID-Enumerationen enthält, sofern -n mindestens einmal angegeben wurde
• Die Bundle-Dateien <prefix>datatypes.h und <prefix>datatypes.cpp, wenn -b angegeben wird

CMake-Integration

Die Funktion qt_opcua_generate_datatypes() nimmt eine oder mehrere Eingabe -BSD -Dateien sowie alle erforderlichen abhängigen BSD -Dateien entgegen und ruft qopcuaxmldatatypes2cpp auf. Die generierten Quell- und Header-Dateien werden in OUTPUT_DIR geschrieben und dem als erstes Argument angegebenen Ziel hinzugefügt.

Das Verzeichnis OUTPUT_DIR oder dessen übergeordnetes Verzeichnis muss ebenfalls zu den Include-Verzeichnissen des Ziels hinzugefügt werden.

Der folgende Ausschnitt aus der Datei „CMakeLists.txt“ zeigt, wie der Codegenerator in ein CMake-basiertes Projekt integriert wird:

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)

Die generierten Dateien können dann in jeder Header- oder Quelldatei verwendet werden, indem die beiden Header der obersten Ebene für die Datentypen und die Encoder-/Decoder-Klasse eingebunden werden.

#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