MARTe2 » MARTe2-core

MARTe2 Training Demo Repository

===============================

Setting up environment 

----------------------

It is assumed that a clean CentOS 7 installation is being used (https://www.centos.org/download/).

Alternatively, there is also a Dockerfile available (see below).

Download all the needed software

--------------------------------

Open a terminal, install epel repository and update the distribution: ::

    yum -y install epel-release

    yum -y update

Install git: ::

    yum -y install git

Install all the standard development tools, the cmake3 compiler and octave: ::

    yum -y groups install "Development Tools"

    yum -y install wget cmake3 octave libxml2 libxml2-devel bc

Solve dependencies for MARTe2 and EPICS:  ::

    yum -y install ncurses-devel readline-devel

Install Python and Perl Parse utilities for open62541: ::

    yum -y install python-dateutil python-six perl-ExtUtils-ParseXS

Install MDSplus ::

    yum -y install http://www.mdsplus.org/dist/el7/stable/RPMS/noarch/mdsplus-repo-7.50-0.el7.noarch.rpm

    yum -y install mdsplus-kernel* mdsplus-java* mdsplus-python* mdsplus-devel*

Create a folder named Projects and clone MARTe2 Core,  MARTe2 components and the MARTe2 demos: ::

    mkdir ~/Projects

    cd ~/Projects

    git clone https://vcis-gitlab.f4e.europa.eu/aneto/MARTe2.git MARTe2-dev

    git clone -b \master https://vcis-gitlab.f4e.europa.eu/aneto/MARTe2-components.git

    git clone https://vcis-gitlab.f4e.europa.eu/aneto/MARTe2-demos-padova.git

Download EPICS R70.2: ::

    git clone -b R7.0.2 --recursive https://github.com/epics-base/epics-base.git epics-base-7.0.2

Clone open62541 v1.0 library: ::

    git clone -b 1.0 https://github.com/open62541/open62541.git

Download SDN: ::

    wget https://vcis-gitlab.f4e.europa.eu/aneto/MARTe2-demos-padova/raw/develop/Other/SDN_1.0.12_nonCCS.tar.gz

    tar zxvf SDN_1.0.12_nonCCS.tar.gz

Building libraries and frameworks

---------------------------------

Build Open623541:

    cd ~/Projects/open62541

    Open the CMakeLists.txt file and comment the lines marked with # below

        if("${CMAKE_VERSION}" VERSION_GREATER 3.9)

            cmake_policy(SET CMP0069 NEW) # needed as long as required cmake < 3.9

            #include(CheckIPOSupported)

            #check_ipo_supported(RESULT CC_HAS_IPO) # Inter Procedural Optimization / Link Time Optimization (should be same as -flto)

            #if(CC_HAS_IPO)

            #    set(CMAKE_INTERPROCEDURAL_OPTIMIZATION ON)

            #endif()

        endif()

    Start building the open62541 library: ::

    mkdir ~/Projects/open62541/build

    cd ~/Projects/open62541/build

    cmake3 -DUA_ENABLE_AMALGAMATION=ON ..

    make

Compile EPICS: ::

    cd ~/Projects/epics-base-7.0.2

    echo "OP_SYS_CXXFLAGS += -std=c++11" >> configure/os/CONFIG_SITE.linux-x86_64.Common

    make

Compile SDN: ::

    cd ~/Projects/SDN_1.0.12_nonCCS

    make

Docker (optional) 

-----------------

In the root folder of this project there is a Dockerfile which includes all the demo dependencies. ::

    cd ~/Projects/MARTe2-demos-padova

    docker build -t <DOCKER_IMAGE> .

For instance, you can use "docker build -t marte2-demos-padova/centos:7 ."

Note that you need to map your local Projects directory with the /root/Projects directory in the container.

Also, the docker daemon needs to be running.

To execute the image with your host folder mapped into the container, run: ::

    docker run -it -e DISPLAY=$DISPLAY -w /root/Projects -v ~/Projects:/root/Projects:Z -v /tmp/.X11-unix:/tmp/.X11-unix <DOCKER_IMAGE>

Following the previous example, the command should be "docker run -it -e DISPLAY=$DISPLAY -w /root/Projects -v ~/Projects:/root/Projects:Z -v /tmp/.X11-unix:/tmp/.X11-unix marte2-demos-padova/centos:7"

where <DOCKER_IMAGE> is the name of the image in the form [REPOSITORY]:[TAG]. For instance, "docker.io/centos:7"

Compilings the MARTe and the examples

-------------------------------------

Make sure that all the environment variables are correctly exported. ::

    export MARTe2_DIR=~/Projects/MARTe2-dev

    export MARTe2_Components_DIR=~/Projects/MARTe2-components

    export OPEN62541_DIR=~/Projects/open62541

    export OPEN62541_LIB=~/Projects/open62541/build/bin

    export OPEN62541_INCLUDE=~/Projects/open62541/build

    export EPICS_BASE=~/Projects/epics-base-7.0.2

    export EPICSPVA=~/Projects/epics-base-7.0.2

    export EPICS_HOST_ARCH=linux-x86_64

    export PATH=$PATH:$EPICS_BASE/bin/$EPICS_HOST_ARCH

    export SDN_CORE_INCLUDE_DIR=~/Projects/SDN_1.0.12_nonCCS/src/main/c++/include/

    export SDN_CORE_LIBRARY_DIR=~/Projects/SDN_1.0.12_nonCCS/target/lib/

    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$MARTe2_DIR/Build/x86-linux/Core/:$EPICS_BASE/lib/$EPICS_HOST_ARCH:$SDN_CORE_LIBRARY_DIR

    cd ~/Projects/MARTe2-dev

    make -f Makefile.linux

    cd ~/Projects/MARTe2-components

    make -f Makefile.linux

    cd ~/Projects/MARTe2-demos-padova

    make -f Makefile.x86-linux

Disable firewall rules (otherwise the communication with EPICS may not work): ::

    iptable -F

Export all variables permanently (assumes that the relative paths above were used!). ::

    cp marte2-exports.sh /etc/profile.d/