Skip to content

Latest commit

 

History

History
89 lines (69 loc) · 3.19 KB

README.md

File metadata and controls

89 lines (69 loc) · 3.19 KB
Raw

nodesetLoader IntegrationTests codecov

nodesetLoader is a library written in C99 for the purpose of loading OPC UA nodesets from xml and sorting the nodes based on their hierachical references.

License

MPL2.0 https://github.com/matkonnerth/nodesetLoader/blob/master/LICENSE

Current status

Official release v0.4.0 is tagged. Please be aware that interface may change in future releases.

Supported operating systems: Linux, Windows (rudimentary)

Backend open62541

Supported open62541 version: 1.3.x Support for loading values with datatypes from namespace 0 or custom namespaces Support parsing of extensions (via a callback interface)

Contribution

Feel free to work on issues or providing further tests to improve the quality of this library. You can start by forking this repository and opening pull requests on it.

dependencies

xmlImport: libXml (http://www.xmlsoft.org/) for parsing the nodeset xml
unit testing: libcheck

Design goals

  1. performance
  2. memory overhead

Build

mkdir build
cd build
cmake ..
make

Running the demo

./parserDemo pathToNodesetFile1 pathToNodesetFile2

Integration with open62541

example

#include <NodesetLoader/backendOpen62541.h>
#include <NodesetLoader/dataTypes.h>
#include <open62541/plugin/log_stdout.h>
#include <open62541/server.h>
#include <open62541/server_config_default.h>

static volatile UA_Boolean running = true;
static void stopHandler(int sign) {
  UA_LOG_INFO(UA_Log_Stdout, UA_LOGCATEGORY_SERVER, "received ctrl-c");
  running = false;
}

int main(int argc, const char *argv[]) {
  UA_Server *server = UA_Server_new();
  UA_ServerConfig_setDefault(UA_Server_getConfig(server));
  //provide the server and the path to nodeset
  //returns true in case of successful import
  if(!NodesetLoader_loadFile(server, "../Opc.Ua.Di.NodeSet2.xml", NULL))
  {
    UA_LOG_INFO(UA_Log_Stdout, UA_LOGCATEGORY_USERLAND, "importing the xml nodeset failed");
  }
  UA_StatusCode retval = UA_Server_run(server, &running);
  //NodesetLoader is allocating memory for custom dataTypes, user has to manually clean up
  const UA_DataTypeArray *customTypes =
    UA_Server_getConfig(server)->customDataTypes;
  UA_Server_delete(server);
  NodesetLoader_cleanupCustomDataTypes(customTypes);
  return retval == UA_STATUSCODE_GOOD ? EXIT_SUCCESS : EXIT_FAILURE;
}

status

  • ✔️ import of multiple nodeset files
  • ✔️ nodesetLoader uses the logger from the server configuration
  • ✔️ DataType import: custom datatypes
  • ✔️ DataType import: optionset, union, structs with optional members supported
  • ✔️ Value import: for variables with datatypes from namespace 0 and custom data types

build

Build with cmake.

There is an example in the open backend, can be started with backends/open62541/examples/server

Here's an example repo, consuming open62541 and NodesetLoader via cmake find_package: https://github.com/matkonnerth/nodesetLoader_usage