open62541

An open-source communication stack implementation of OPC UA (OPC Unified Architecture) licensed under LGPL + static linking exception.

Documentation

Documentation is generated from Doxygen annotations in the source code. The current version can be accessed at http://open62541.org/doxygen/.

Getting dependencies

Ubuntu

Getting gcc toolchain:

sudo apt-get install build-essential subversion git autoconf libtool pkg-config texinfo

Getting python toolchain for the 62541 structures code generator:

sudo apt-get install python python-lxml

Getting additional libraries:

sudo apt-get install expat libexpat1-dev

Getting and installing check as unit test framework (http://check.sourceforge.net/):

$ svn checkout https://svn.code.sf.net/p/check/code/trunk check-code
$ cd check-code
$ autoreconf --install
$ ./configure
$ make
$ sudo make install
$ sudo ldconfig

Getting and using Doxygen

install the needed packages

sudo apt-get install graphviz doxygen

configure autotools, clean and build:

$ ./configure --enable-doxygen
$ make clean
$ make all

the output is generated in doc/html/index.htm
configure the output of Doxygen with doc/Doxygen.in file

Windows

Getting MinGW and MSYS:

Get the latest MinGW installer: http://sourceforge.net/projects/mingw/files/latest/download?source=files
Select following packages: mingw-developer-toolkit, mingw32-base, msys-base
After install, run MinGW\msys\1.0\postinstall\pi.bat

Get Gtk+ bundle (just for m4 marcros and pkg-config):

Download http://ftp.gnome.org/pub/gnome/binaries/win32/gtk+/2.24/gtk+-bundle_2.24.10-20120208_win32.zip and extract it
Copy gtk+/share/aclocal/*.m4 files to MinGW/share/aclocal
Merge grk+ folder and MinGW\msys\1.0\ folder

Get expat

start MinGW Installation Manager
choose all Packages, mark mingw32-expat and install
Open MinGW\msys\1.0\msys.bat

$ mingw-get install libexpat

Get Python and lxml:

download Python (Windows x86 MSI Installer) at https://python.org/downloads (necessary version: 2.7.x)
install the executable
add the install directory (e. g. "c:\python27") to your windows path variable [Selectable in the setup-options]
restart mingw console
install lxml by either downloading and installing http://www.lfd.uci.edu/~gohlke/pythonlibs/#lxml (choose the version which fits to your python installation (x86 version)) or by following the instructions given here: http://lxml.de/installation.html
add ("C:\Python27\Tools\Scripts") to your windows path variable

Get git (IMPORTANT: get 1.8.4, since 1.8.5.2 has a bug):

http://code.google.com/p/msysgit/downloads/detail?name=Git-1.8.4-preview20130916.exe&can=2&q=

SVN:

download: http://tortoisesvn.net/downloads.html
install svn @ c:\MinGW\

Getting and installing check as unit testing framework (http://check.sourceforge.net/):

Open MinGW\msys\1.0\msys.bat

$ svn checkout svn://svn.code.sf.net/p/check/code/trunk check-code
$ cd check-code
$ autoreconf --install
$ ./configure
$ make
$ make install

Adjusting MinGW

open the file c:\MinGW\include\io.h and replace every off64_t with _off64_t (4x should off64_t appear)
open the file c:\MinGW\include\unistd.h and replace every off_t with _off_t (2x should off_t appear)
download the queue.h header @ http://cvsweb.netbsd.org/bsdweb.cgi/src/sys/sys/queue.h and copy it to c:\MinGW\include\sys

Building

use autogen.sh only first time and whenever aclocal.m4 or configure.ac were modified

$ cd open62541
$ ./autogen.sh
$ ./configure --enable-debug=yes
$ make
$ make check

Configure Options

--enable-debug=(yes|no|verbose) - omit/include debug code
--enable-multithreading - enable pthreads (for examples/src/opcuaServerMT)
--enable-doxygen - make documentation as well
--enable-coverage - profiling with gcov,lcov, make check will generate reports in tests/coverage

hua1007 / open62541 Goto Github PK

open62541's Introduction