Open source implementation of OPC UA (OPC Unified Architecture) aka IEC 62541 licensed under Mozilla Public License v2.0
Clone or download
jonasgreen88 and jpfr WIP: Separate SecurityPolicies from Endpoints in the server (#2247)
* WIP: Separate SecurityPolicies from Endpoints in the server

Currently the SecurityPolicies supported by the server are strongly
tied together with the endpoints. To be able to reuse the
SecurityPolicy instances of the server also in the Access Control
plugin to handle encrypted passwords the SecurityPolicies are moved
to the server config struct.
Latest commit 1a40bb1 Jan 16, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
arch Doc: Fix various Codacy formatting issues Jan 2, 2019
debian CI: Lower debian cmake dependency Dec 19, 2018
deps Fix stack-buffer-overflow Jan 3, 2019
doc Add debian packaging configuration Dec 19, 2018
examples Provide information for ExtensionObject decoding via DataTypeDictiona… Jan 10, 2019
include WIP: Separate SecurityPolicies from Endpoints in the server (#2247) Jan 16, 2019
plugins WIP: Separate SecurityPolicies from Endpoints in the server (#2247) Jan 16, 2019
src WIP: Separate SecurityPolicies from Endpoints in the server (#2247) Jan 16, 2019
tests ArrayDimension constraints are only upper bounds (fix #2325) Jan 11, 2019
tools Support of PercentDeadband feature Jan 11, 2019
.clang-format mDNS: Remove resolving IP address for mDNS announce Jan 4, 2019
.cquery Add .cquery file for code completion in vim, VS Code, etc. May 10, 2018
.editorconfig Add clang-format and editorconfig file Feb 5, 2018
.gitignore Move plugins to directories for better organisation Dec 19, 2018
.gitmodules Use ua-nodeset repository instead of local nodeset copy Oct 12, 2017
.travis-apt-pin.preferences Use simpler clang setup for fuzzing. Jul 19, 2017
.travis.yml CI: Remove coverity since it does not integrate well. Jan 7, 2019
AUTHORS Set the correct copyright for @jpfr Mar 23, 2018
CHANGELOG Also add client to monitoredEvent callback Feb 5, 2018
CMakeLists.txt Support of PercentDeadband feature Jan 11, 2019
CODE_OF_CONDUCT.md Doc: Fix various Codacy formatting issues Jan 2, 2019
CONTRIBUTING.md Doc: Fix various Codacy formatting issues Jan 2, 2019
CPPLINT.cfg remove some filters Feb 5, 2018
Dockerfile Fixup python six dependency Oct 26, 2017
FEATURES.md Doc: Fix various Codacy formatting issues Jan 2, 2019
ISSUE_TEMPLATE.md Doc: Fix various Codacy formatting issues Jan 2, 2019
LICENSE Update LICENSE Jan 27, 2017
LICENSE-CC0 clean up include structure Sep 9, 2014
README.md CI: Add codecov.io Jan 7, 2019
TinyDockerfile Fix docker file copy command May 16, 2017
appveyor.yml CI: Use make install to collect release files Dec 19, 2018
open62541.spec Fix spec file of RPM build Mar 3, 2018
sonar-project.properties Reduce SonarCloud scope (see #1715) Apr 6, 2018

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.

Project Information

Build Status:

Build Status Build Status

Code Quality:

Codacy Badge Total Alerts Coverage Status codecov Code Quality: Cpp

General Project Info:

Ohloh Project 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 currently being implemented:

  • Target 0.3 release (to be released in the coming weeks):
    • Secure communication with encrypted messages (Done)
    • Access control for individual nodes (Done)
    • Asynchronous service requests in the client (Done)
  • Target 0.4 release:
    • Events (notifications emitted by objects, data change notifications are implemented), (Done)
    • Event-loop (background tasks) in the client
    • Publish/Subscribe based on UDP (Specification Part 14), WIP @ Fraunhofer IOSB

Dependencies

On most systems, open62541 requires the C standard library only. For dependencies during the build process, see the following list and the build documentation for details.

  • Core Library: The core library has no dependencies besides the C99 standard headers.
  • Default Plugins: The default plugins use the POSIX interfaces for networking and accessing the system clock. Ports to different (embedded) architectures are achieved by customizing the plugins.
  • Building and Code Generation: The build environment is generated via CMake. Some code is auto-generated from XML definitions that are part of the OPC UA standard. The code generation scripts run with both Python 2 and 3.

Code Quality

We emphasize code quality. The following quality metrics are continuously checked and are ensured to hold before an official release is made:

  • Zero errors indicated by the Compliance Testing Tool (CTT) of the OPC Foundation for the supported features
  • Zero compiler warnings from GCC/Clang/MSVC with very strict compilation flags
  • Zero issues indicated by unit tests (more than 80% coverage)
  • Zero issues indicated by clang-analyzer, clang-tidy, cpp-check and the Codacy static code analysis tools
  • Zero unresolved issues from fuzzing the library in Google's oss-fuzz infrastructure
  • Zero issues indicated by Valgrind (Linux), DrMemory (Windows) and Clang AddressSanitizer / MemorySanitizer for the CTT tests, unit tests and fuzzing

Documentation and Support

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 individual discussion and support, use the following channels:

We want to foster an open and welcoming community. Please take our code of conduct into regard.

Jointly with the overall open62541 community, the core maintainers steer the long-term development. The current core maintainers are (as of April 2018, 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)

Support & Development

Commercial Support

The open62541 community handles support requests for the open source library and its development. Custom development and individual support is provided by commercial partners that are affiliated with open62541:

For custom development that shall eventually become part of the open62541 library, please keep one of the core maintainers in the loop. Again, please note that all changes to files that are already licensed under the MPLv2 automatically become MPLv2 as well. Static linking of the open62541 library with code under a different license is possible. All architecture-specific code is implemented in the form of exchangeable plugins under a very permissible CC0 license.

Development

As an open source project, new contributors are encouraged to help improve open62541. The following are good starting points for new contributors:

Examples

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 -DUA_ARCHITECTURE_POSIX <server.c> open62541.c -o server (under Windows you may need to add -lws2_32 and change -DUA_ARCHITECTURE_POSIX to -DUA_ARCHITECTURE_WIN32).

#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;
}