This is a fork of open62541, https://github.com/open62541/open62541

Infinity95 952bd5ebef add securitypolicy plugin API and implementation for #none 7 years ago
.github a0ddf1ba9b Reformat to hopefully get more people to follow the template 7 years ago
.tito b5dbf0e024 switch to cmake 3.0 7 years ago
deps 4b300b69d6 Update mdnsd to include memory defines 7 years ago
doc b9673ee0bb Use the nodestore plugin in the server 7 years ago
examples 5ec8dd51ec fix tests with UA_ENABLE_MULTITHREADING and UA_ENABLE_TYPENAMES disabled 7 years ago
include 952bd5ebef add securitypolicy plugin API and implementation for #none 7 years ago
plugins 952bd5ebef add securitypolicy plugin API and implementation for #none 7 years ago
src 952bd5ebef add securitypolicy plugin API and implementation for #none 7 years ago
tests 952bd5ebef add securitypolicy plugin API and implementation for #none 7 years ago
tools 51288af66c simplify amalgamated header; remove duplicate extern 'C' 7 years ago
.gitignore 5c939bd176 more code groups for Visual Studio; more gitignore definitions 7 years ago
.gitmodules 14df336430 Code review: @Pro's MDNS implementation (#732) 7 years ago
.travis-apt-pin.preferences 5b2b18b376 Use simpler clang setup for fuzzing. 7 years ago
.travis.yml bd91014f37 Reenable fail on error 7 years ago
AUTHORS 7f7314c80f Update AUTHERs File 7 years ago
CHANGELOG 0d40923bbd fix API inconsistency of read-arraydimensions (breaking change) 7 years ago
CMakeLists.txt 952bd5ebef add securitypolicy plugin API and implementation for #none 7 years ago
Dockerfile 7e08e6dbc2 Fix docker file copy command 7 years ago
FEATURES.md 550b0e5b78 Correct url 7 years ago
LICENSE e5865742fc Update LICENSE 7 years ago
LICENSE-CC0 f8265df738 clean up include structure 10 years ago
README.md 7a58e6c0a5 Corrected format of LocaleId in LocalizedText attributes 7 years ago
TinyDockerfile 7e08e6dbc2 Fix docker file copy command 7 years ago
appveyor.yml 356ddf5950 install graphviz on appveyor 7 years ago
open62541.spec b5dbf0e024 switch to cmake 3.0 7 years ago

README.md

open62541

open62541 (http://open62541.org) is an open source and free implementation of OPC UA (OPC Unified Architecture) written in the common subset of the C99 and C++98 languages. The library is usable with all major compilers and provides the necessary tools to implement dedicated OPC UA clients and servers, or to integrate OPC UA-based communication into existing applications. open62541 library is platform independent. All platform-specific functionality is implemented via exchangeable plugins. Plugin implementations are provided for the major operating systems.

open62541 is licensed under the Mozilla Public License v2.0. So the open62541 library can be used in projects that are not open source. Only changes to the open62541 library itself need to published under the same license. The plugins, as well as the server and client examples are in the public domain (CC0 license). They can be reused under any license and changes do not have to be published.

The library is available in standard source and binary form. In addition, the single-file source distribution merges the entire library into a single .c and .h file that can be easily added to existing projects. Example server and client implementations can be found in the /examples directory or further down on this page.

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

Features

For a complete list of features check: open62541 Features

open62541 implements the OPC UA binary protocol stack as well as a client and server SDK. It currently supports the Micro Embedded Device Server Profile plus some additional features. The final server binaries can be well under 100kb, depending on the size of the information model.

  • Communication Stack
    • OPC UA binary protocol
    • Chunking (splitting of large messages)
    • Exchangeable network layer (plugin) for using custom networking APIs (e.g. on embedded targets)
  • Information model
    • Support for all OPC UA node types (including method nodes)
    • Support for adding and removing nodes and references also at runtime.
    • Support for inheritance and instantiation of object- and variable-types (custom constructor/destructor, instantiation of child nodes)
  • Subscriptions
    • Support for subscriptions/monitoreditems for data change notifications
    • Very low resource consumption for each monitored value (event-based server architecture)
  • Code-Generation
    • Support for generating data types from standard XML definitions
    • Support for generating server-side information models (nodesets) from standard XML definitions

Features still missing in the 0.2 release are:

  • Encryption
  • Access control for individual nodes
  • Events (notifications emitted by objects, data change notifications are implemented)
  • Event-loop (background tasks) and asynchronous service requests in the client

Using open62541

A general introduction to OPC UA and the open62541 documentation can be found at http://open62541.org/doc/current. Past releases of the library can be downloaded at https://github.com/open62541/open62541/releases. To use the latest improvements, download a nightly build of the single-file distribution (the entire library merged into a single source and header file) from http://open62541.org/releases. Nightly builds of MSVC binaries of the library are available here.

For discussion and help, you can use

Development

Besides the general open62541 community, a group of core maintainers jointly steers the long-term development. The current core maintainers are (as of Mai 2017, in alphabetical order):

  • Chris-Paul Iatrou (Dresden University of Technology, Chair for Process Control Systems Engineering)
  • Florian Palm (RWTH Aachen University, Chair of Process Control Engineering)
  • Julius Pfrommer (Fraunhofer IOSB, Karlsruhe)
  • Stefan Profanter (fortiss, Munich)

As an open source project, we encourage new contributors to help improve open62541. There are ways to begin contributing without deep knowledge of the OPC UA standard:

Example Server Implementation

Compile the examples with the single-file distribution open62541.h/.c header and source file. Using the GCC compiler, just run gcc -std=c99 <server.c> open62541.c -o server (under Windows you may need to add -lws2_32).

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

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

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

    /* Create a server listening on port 4840 */
    UA_ServerConfig *config = UA_ServerConfig_new_default();
    UA_Server *server = UA_Server_new(config);

    /* Add a variable node */
    /* 1) Define the node attributes */
    UA_VariableAttributes attr = UA_VariableAttributes_default;
    attr.displayName = UA_LOCALIZEDTEXT("en-US", "the answer");
    UA_Int32 myInteger = 42;
    UA_Variant_setScalar(&attr.value, &myInteger, &UA_TYPES[UA_TYPES_INT32]);

    /* 2) Define where the node 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; /* take the default variable type */
    UA_QualifiedName browseName = UA_QUALIFIEDNAME(1, "the answer");

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

    /* Run the server loop */
    UA_StatusCode status = UA_Server_run(server, &running);
    UA_Server_delete(server);
    UA_ServerConfig_delete(config);
    return status;
}

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_default);
    UA_StatusCode status = UA_Client_connect(client, "opc.tcp://localhost:4840");
    if(status != UA_STATUSCODE_GOOD) {
        UA_Client_delete(client);
        return status;
    }

    /* Read the value attribute of the node. UA_Client_readValueAttribute is a
     * wrapper for the raw read service available as UA_Client_Service_read. */
    UA_Variant value; /* Variants can hold scalar values and arrays of any type */
    UA_Variant_init(&value);
    status = UA_Client_readValueAttribute(client, UA_NODEID_STRING(1, "the.answer"), &value);
    if(status == UA_STATUSCODE_GOOD &&
       UA_Variant_hasScalarType(&value, &UA_TYPES[UA_TYPES_INT32])) {
        printf("the value is: %i\n", *(UA_Int32*)value.data);
    }

    /* Clean up */
    UA_Variant_deleteMembers(&value);
    UA_Client_delete(client); /* Disconnects the client internally */
    return status;
}