EMP BWEC

Installation Guide

1. Install Software Requirements

GNU make

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install build-essential

Perl

sudo apt-get install perl

Unzip and tar

sudo apt-get install unzip
sudo apt-get install tar

vxWorks or RTEMS
GNU readline or Tecla library

apt-cache search readline (to check for latest versions of GNU readline)
sudo apt-get install libreadline7
sudo apt-get install libreadline-dev

maybe also this is needed: (sudo apt-get install lib64readline7; sudo apt-get install lib64readline-dev)

2. Download EPICS base

EPICS base download (version: baseR3.14.12.5.tar.gz)
unzip it

3. In folder base/documentation you can find the README files for further instruction

If you don’t want to change any default parameter, go to:

cd base-3.XX.X/startup
./EpicsHostArch
export EPICS_HOST_ARCH=linux-x86_64

this sets an environment variable EPICS_HOST_ARCH

For building go to base-3.XX.X (you may need sudo)

cd ..
make clean uninstall
make

if you use GCC 6 change in /base/src/libCom/test/epicsExceptionTest.cpp:

static const size_t unsuccessfulNewSize = numeric_limits < size_t > :: max () to:
static size_t unsuccessfulNewSize = numeric_limits < size_t > :: max ()

4. In folder base/documentation you can find the README files for further instruction

in folder base-3.XX.X/

mkdir exampleApp
cd exampleApp
export EPICS_HOST_ARCH=linux-x86_64
<base>/bin/<arch>/makeBaseApp.pl -t example myexample
<base>/bin/<arch>/makeBaseApp.pl -i -t example myexample

in file configure/RELEASE – Set SNCSEQ to the location of the sequencer (therefor the sequencer needs to be installed, see 4*)
in file exampleapp/iocBoot/iocmyexample/st.cmd – Remove the comment character # from this line:

#seq sncExample, "user=<user>"

4*. Installing sequencer

build prequisite: re2c

sudo apt install re2c

downloads can be found on: http://www-csr.bessy.de/control/SoftDist/sequencer/releases/
instructions for installation can be found in /seq-2.2.X/documentation/Installation.txt

5. Installing libreadline6

get the deb file
install libreadline 6
A temporary but related linkhttps://linuxprograms.wordpress.com/2010/10/19/install-readline-linux/

6. Add EPICS base to your bashrc

the bashrc is executed each time you open your terminal (for example some paths are set)
if you want to execute an EPICS IOC the path to EPICS-base and to EPICS-host-arch needs to be known, therefore open your bashrc:

~$ geany .bashrc

and add the following lines (make sure to adapt the right path)

# EPICS
export EPICS_BASE=/home/sahra/EPICS/epics-base
export EPICS_HOST_ARCH=$(${EPICS_BASE}/startup/EpicsHostArch)
export PATH=${EPICS_BASE}/bin/${EPICS_HOST_ARCH}:${PATH}

7. Create a demo/test ioc to test ca and pva

stolen from here: https://epics-controls.org/resources-and-support/documents/getting-started/

mkdir -p $HOME/EPICS/TEST/testIoc
cd $HOME/EPICS/TEST/testIoc
makeBaseApp.pl -t example testIoc
makeBaseApp.pl -i -t example testIoc
make
cd iocBoot/ioctestIoc
chmod u+x st.cmd
ioctestIoc> ./st.cmd
#!../../bin/darwin-x86/testIoc
< envPaths 
epicsEnvSet("IOC","ioctestIoc") 
epicsEnvSet("TOP","/Users/maradona/EPICS/TEST/testIoc") 
epicsEnvSet("EPICS_BASE","/Users/maradona/EPICS/epics-base") 
cd "/Users/maradona/EPICS/TEST/testIoc" 
## Register all support components 
dbLoadDatabase "dbd/testIoc.dbd" 
testIoc_registerRecordDeviceDriver pdbbase 
## Load record instances dbLoadTemplate "db/user.substitutions" 
dbLoadRecords "db/testIocVersion.db", "user=junkes" 
dbLoadRecords "db/dbSubExample.db", "user=junkes" 
#var mySubDebug 1 
#traceIocInit 
cd "/Users/maradona/EPICS/TEST/testIoc/iocBoot/ioctestIoc" 
iocInit 
Starting iocInit 
############################################################################ 
## EPICS R7.0.1.2-DEV 
## EPICS Base built Mar 8 2018 
############################################################################ 
cas warning: Configured TCP port was unavailable. 
cas warning: Using dynamically assigned TCP port 52907, 
cas warning: but now two or more servers share the same UDP port. 
cas warning: Depending on your IP kernel this server may not be 
cas warning: reachable with UDP unicast (a host's IP in EPICS_CA_ADDR_LIST) 
iocRun: All initialization complete 
2018-03-09T13:07:02.475 Using dynamically assigned TCP port 52908. 
## Start any sequence programs 
#seq sncExample, "user=maradona" epics> dbl
maradona:circle:tick
maradona:compressExample
maradona:line:b
maradona:aiExample
maradona:aiExample1
maradona:ai1
maradona:aiExample2
 ... etc. ...
epics>

dbl shows all the PVs

8. Include Stream

Therfore add the following in examplieIOCAPP/src/Makefile and change esampleIOC_LIBS to your current ioc_lib:

#add asyn and streamDevice to this IOC production libs

exampleIOC_LIBS += stream
exampleIOC_LIBS += asyn

in examplieIOCAPP/src/xxxSupport.dbd add

#
include "stream.dbd"
include "asyn.dbd"
registrar(drvAsynIPPortRegisterCommands)
registrar(drvAsynSerialPortRegisterCommands)
registrar(vxi11RegisterCommands)

in configure/RELEASE add:

# Build variables that are NOT used in paths should be set in
# the CONFIG_SITE file.
# Variables and paths to dependent modules:
SUPPORT = ${HOME}/EPICS/support
ASYN=$(SUPPORT)/asyn
STREAM=$(SUPPORT)/stream
# If using the sequencer, point SNCSEQ at its top directory:
#SNCSEQ = $(MODULES)/seq-ver

9. Some useful links

EPICS in PANDA:

EPICS slildes/training: