opcua - EPICS Device Support for OPC UA

EPICS Device Support module for interfacing to the OPC UA protocol. The architecture allows supporting different implementations of the low level client library.

Linux and Windows builds are supported.

Status

⚠️ This module is under development. Please contact the author Ralph Lange for details. :warning:

There are two choices for the low-level OPC UA client library:

1. The commercially available Unified Automation C++ Based OPC UA Client SDK.
   This is the original, full implementation.

2. The open source client implementation of the open62541 project.
   This integration is still experimental and does not support structured data yet.

Prerequisites

• A C++ compiler that supports the C++11 standard.
  Microsoft Visual C++ needs to be from Visual Studio 2015 or newer. g++ needs to be 4.6 or above.

• EPICS Base 3.15 (>= 3.15.7) or EPICS 7 (>= 7.0.4).

• The gtest module if you want to compile and run the Google Test based unit tests.

Using the Unified Automation Client SDK

• Unified Automation C++ Based OPC UA Client SDK (1.5/1.6/1.7 are supported, as well as their evaluation bundles; 1.8 is having trouble).

• For OPC UA security support (authentication/encryption), you need openssl/libcrypto on your system - both when compiling the SDK and when generating any binaries (IOCs).

• In CONFIG_SITE.local, set UASDK to the path of the SDK installation.

• For more details, refer to the README.md in the devOpcuaSup/UaSdk directory.

Using the open62541 SDK

• The open62541 SDK is available at https://open62541.org/
  Choose a recent release (1.2 and 1.3 are supported).

• For OPC UA security support (authentication/encryption), you need openssl/libcrypto on your system - both when compiling the SDK and when generating any binaries (IOCs).

• In CONFIG_SITE.local, set OPEN62541 to the path of the SDK installation.

• For more details, refer to the README.md in the devOpcuaSup/open62541 directory.

Building the module

This is a standard EPICS module.

Inside the configure subdirectory or one level above the TOP location (TOP is where this README file resides), create a file RELEASE.local that sets EPICS_BASE and GTEST to the absolute paths inside your EPICS installation. The GTEST module is needed to compile and run the tests. Not defining it produces a clean build, but without any tests.

Configure the compiler on Linux to use the C++11 standard by adding

USR_CXXFLAGS_Linux += -std=c++11

to the CONFIG_SITE file (or one of the host/target specific site configuration files).
It is preferable to set this option globally in EPICS Base.

The configuration necessary when building against a specific client library is documented in the README.md file inside the respective subdirectory of devOpcuaSup.

Using the module

IOC applications that use the module need to

• add an entry to the Device Support module in their RELEASE.local file
• include opcua.dbd when building the IOC's DBD file
• include opcua in the support libraries for the IOC binary.

Documentation

Sparse, but getting better.

The documentation folder of the Device Support module contains the Requirements Specification (SRS) giving an introduction and the list of requirements that should convey a good idea of the planned features.

The Cheat Sheet explains the configuration in the startup script and the database links.

Binary Distribution

Please look at the "Assets" sections of specific releases on the release page for the binary distribution tars. These tars contain an EPICS module with a binary Linux shared library (libopcua.so.<version>) that contains (embeds) the Unified Automation low-level client. In your build setup, the module from the binary distribution can be used like a support module built from source. The binary device support is fully functional and can be used without limitations or any fees.

You need to download the binary distribution tar that matches your Linux distribution and the exact EPICS Base version, else you will not be able to create IOCs.

Feedback / Reporting issues

Please use the GitHub project's issue tracker.

Credits

This module is based on extensive prototype work by Bernhard Kuner (HZB/BESSY) and uses ideas and code snippets from Michael Davidsaver (Osprey DCS).

Support for the open62541 client library was added by Dirk Zimoch (PSI) with additional help from Carsten Winkler (HZB/BESSY).

The end-to-end test suite is a reduced clone of the test application that has been developed at the ESS by Ross Elliot and Karl Vestin.

License

This module is distributed subject to a Software License Agreement found in file LICENSE that is included with this distribution.