open62541/arch

open62541 Architecture Support

This folder contains all the architecture-specific code for different operating systems. The arch-specific functionality covers:

• System clock
• EventLoop (Networking, Timed events, Interrupt handling (optional))

Currently open62541 supports the architectures

• POSIX (Linux, BSD, Mac, QNX, etc.)
• Windows (integrated with the POSIX implementation)
• Zephyr

Previously (until v1.3) there was additional support for:

• freeRTOS
• vxWorks
• WEC7
• eCos

We strive to recover support for these going forward and also include their coverage to the CI.

Adding new architectures

To port open62541 to a new architecture, follow these steps:

1. Modify clock.c file that implements the following functions defined in open62541/types.h:

   • UA_DateTime UA_DateTime_now(void);

   • UA_Int64 UA_DateTime_localTimeUtcOffset(void);

   • UA_DateTime UA_DateTime_nowMonotonic(void);

2. Fork the EventLoop code (the default is POSIX) and adjust it to your architecture. Note that it is not necessary to port all networking subsystems (and interrupts). The library will detect when a certain protocol (e.g. UDP, ETH) is not available. TCP support is however mandatory.

You have to link in your custom clock and EventLoop implementation only for the final binary. To prevent the parallel build of Win32/POSIX versions, set UA_ARCHITECTURE=none in the cmake setting. To use CMake for the entire build, including a new architecture, do the following:

• Add your architecture to the list in /include/open62541/config.h.in

• Add the architecture and the new files to /CMakeLists.txt