CDP's fork of the open62541 OPC UA stack (https://github.com/open62541/open62541)

Julius Pfrommer 3268be3b9d remove dependency on lxml 8 years ago
deps e452dcf8e3 replace gmtime with a clean implementation 8 years ago
doc 3268be3b9d remove dependency on lxml 8 years ago
examples 6d840cd836 Fix call to anonymous client connect 8 years ago
include c539903821 wrap config in extern "C" for C++ interop 8 years ago
plugins 21e81840c2 reduce the used CPU when idle 8 years ago
src 21e81840c2 reduce the used CPU when idle 8 years ago
tests 1c4b6b63af Fixed the test associated /w d29d0a7 8 years ago
tools 3268be3b9d remove dependency on lxml 8 years ago
.gitignore 79da75482a add the automatically generated files to .gitignore 9 years ago
.travis.yml 25d4d52499 Use cppcheck 1.73 8 years ago
AUTHORS c495d9b248 Update AUTHORS 10 years ago
CMakeLists.txt 3268be3b9d remove dependency on lxml 8 years ago
Dockerfile 3268be3b9d remove dependency on lxml 8 years ago
LICENSE 9310d323c9 changed .gitignore again 10 years ago
LICENSE-CC0 f8265df738 clean up include structure 10 years ago
README.md 5e87c1db68 move logger and connection-function into the client config (#585) 8 years ago
TinyDockerfile 3268be3b9d remove dependency on lxml 8 years ago
appveyor.yml 3268be3b9d remove dependency on lxml 8 years ago

README.md

open62541

open62541 (http://open62541.org) is an open source and free implementation of OPC UA (OPC Unified Architecture). open62541 is a C-based library that contains all the necessary tools to set up a dedicated OPC UA server, to integrate OPC UA-based communication into existing applications (linking with C++ projects is possible), or to create an OPC UA client. The library is distributed as a single pair of header and source files, that can be easily dropped into your project. An example server and client implementation can be found in the /examples directory or further down on this page.

open62541 is licensed under the LGPL + static linking exception. That means open62541 can be freely used also in commercial projects, although changes to the open62541 library itself need to be released under the same license. The server and client implementations in the /examples directory are in the public domain (CC0 license). They can be used under any license and changes don't have to be published.

Ohloh Project Status Build Status MSVS build status Coverage Status Coverity Scan Build Status

Documentation

A general introduction to OPC UA and the open62541 documentation can be found at http://open62541.org/doc/current. Build instruction are here: https://github.com/open62541/open62541/wiki/Building-open62541.

For discussion and help, you can use

Automated builds of 50 last single-file distributions are available here. Automatically compiled MSVC binaries are available here.

Contribute to open62541

As an open source project, we invite new contributors to help improving open62541. If you are a developer, your bugfixes and new features are very welcome. Note that there are ways to contribute even without deep knowledge of the project or the UA standard:

Example Server Implementation

Compile the examples with the single file distribution open62541.h and open62541.c from the latest release. With the GCC compiler, just run gcc -std=c99 <server.c> open62541.c -o server.

#include <signal.h>
#include "open62541.h"

#define PORT 16664

UA_Boolean running = true;
void signalHandler(int sig) {
    running = false;
}

int main(int argc, char** argv)
{
    /* catch ctrl-c */
    signal(SIGINT, signalHandler);

    /* init the server */
    UA_ServerNetworkLayer nl = UA_ServerNetworkLayerTCP(UA_ConnectionConfig_standard, PORT);
    UA_ServerConfig config = UA_ServerConfig_standard;
    config.networkLayers = &nl;
    config.networkLayersSize = 1;
    UA_Server *server = UA_Server_new(config);

    /* add a variable node */
    /* 1) set the variable attributes (no memory allocations here) */
    UA_Int32 myInteger = 42;
    UA_VariableAttributes attr;
    UA_VariableAttributes_init(&attr);
    UA_Variant_setScalar(&attr.value, &myInteger, &UA_TYPES[UA_TYPES_INT32]);
    attr.displayName = UA_LOCALIZEDTEXT("en_US","the answer");

    /* 2) define where the variable shall be added with which browsename */
    UA_NodeId newNodeId = UA_NODEID_STRING(1, "the.answer");
    UA_NodeId parentNodeId = UA_NODEID_NUMERIC(0, UA_NS0ID_OBJECTSFOLDER);
    UA_NodeId parentReferenceNodeId = UA_NODEID_NUMERIC(0, UA_NS0ID_ORGANIZES);
    UA_NodeId variableType = UA_NODEID_NULL; /* no variable type defined */
    UA_QualifiedName browseName = UA_QUALIFIEDNAME(1, "the answer");

    /* 3) add the variable */
    UA_Server_addVariableNode(server, newNodeId, parentNodeId, parentReferenceNodeId,
                              browseName, variableType, attr, NULL);

    /* run the server loop */
    UA_StatusCode retval = UA_Server_run(server, &running);
    UA_Server_delete(server);
    nl.deleteMembers(&nl);
    return retval;
}

Example Client Implementation

#include <stdio.h>
#include "open62541.h"

int main(int argc, char *argv[])
{
    /* create a client and connect */
    UA_Client *client = UA_Client_new(UA_ClientConfig_standard);
    UA_StatusCode retval = UA_Client_connect(client, "opc.tcp://localhost:16664");
    if(retval != UA_STATUSCODE_GOOD) {
        UA_Client_delete(client);
    	return retval;
    }

    /* create a readrequest with one entry */
    UA_ReadRequest req;
    UA_ReadRequest_init(&req);
    req.nodesToRead = UA_Array_new(1, &UA_TYPES[UA_TYPES_READVALUEID]);
    req.nodesToReadSize = 1;
    
    /* define the node and attribute to be read */
    req.nodesToRead[0].nodeId = UA_NODEID_STRING_ALLOC(1, "the.answer");
    req.nodesToRead[0].attributeId = UA_ATTRIBUTEID_VALUE;

    /* call the service and print the result */
    UA_ReadResponse resp = UA_Client_Service_read(client, req);
    if(resp.responseHeader.serviceResult == UA_STATUSCODE_GOOD &&
       resp.resultsSize > 0 && resp.results[0].hasValue &&
       UA_Variant_isScalar(&resp.results[0].value) &&
       resp.results[0].value.type == &UA_TYPES[UA_TYPES_INT32]) {
           UA_Int32 *value = (UA_Int32*)resp.results[0].value.data;
           printf("the value is: %i\n", *value);
   }

    UA_ReadRequest_deleteMembers(&req);
    UA_ReadResponse_deleteMembers(&resp);
    UA_Client_disconnect(client);
    UA_Client_delete(client);
    return UA_STATUSCODE_GOOD;
}