An open API service indexing awesome lists of open source software.

https://github.com/slac-epics/edm

EPICS Extensible Display Manager
https://github.com/slac-epics/edm

epics epics-extensions

Last synced: 2 months ago
JSON representation

EPICS Extensible Display Manager

Awesome Lists containing this project

README

        

###### INSTALLATION NOTES #########

##### EDM Version 1-10-1zd ###########################################
The Makefile has been modified to be more native for EPICS R3.14 builds.
The modifications have been made for Linux only.

### EDM Version 1-7-0c ############################

#### Installing on Solaris 8/9/10 *********************

1. Additional software packages required:
1a. You need "zlib" for libpng (we use version 1.1.3)
-- http://www.gzip.org/zlib/

1b. You need "libpng" (we use version 1.0.9)
-- http://www.libpng.org/pub/png/libpng.html

1c. You need "giflib" (we use version 4.1.0)
-- http://prtr-13.ucsc.edu/~badger/software/libungif/giflib.shtml
note: you may have trouble getting giflib because of licensing issues
so a src distribution will be placed on the SNS FTP site
(ftp://snsftp.sns.ornl.gov/UPLOAD/controls/edm) for your convenience.
I think we should use libpng from now on.

2. Configuration for compiling
-- To build edm as an EPICS Extensions unzip/untar the distribution in
the following location: $EPICS_EXTENSIONS/src

-- We are building as an EPICS extension; so modify the files in
"$EPICS_EXTENSIONS/configure" appropriately for your site

-- Note we are using gcc-2.95.2 and GNU make version 3.79.1

-- Now go for the gusto and compile

3. Run Time Configuration/Setup
a. Define the following environment variables:
The $EPICS_EXTENSIONS/src/edm/setup directory contains an example color table, font table
and calc.list file. This directory also contains a setup.sh for Bourne shell users.
The setup.sh files sets up required environment variables and creates an initial
edmObjects and edmPvObjects file.

EDMPVOBJECTS "This is the location of a file that describes the path to EPICS
PV shared libraries"
EDMOBJECTS "This is the location of a file that describes the path to the
various EDM shared libraries"
EDMHELPFILES " Location of EDM "HELP system"

EDMFILES " Location of colors.list, fonts.list, and default.scheme files"

EDMDATAFILES " Default search path for edm screens (analogous to $EPICS_DISPLAY_PATH)

As an example here is what we set at the SNS:

-- EDMPVOBJECTS=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMOBJECTS=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMHELPFILES=$EPICS_EXTENSIONS/src/edm/helpFiles
-- EDMFILES=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMDATAFILES=./:$IOCTOP//opi/edl:$IOCTOP//opi/edl

Also, we will make available the $EPICS_EXTENSIONS/ext_pref/edm as an example.
This will be tarred up as ext_pref-edm.tar on our ftp site: (ftp://snsftp.sns.ornl.gov/UPLOAD/controls/edm)
Some of the configuration steps may be discussed in the edm documentation located
in the following: $EPICS_EXTENSIONS/src/edm/doc
b. You do not need to modify LD_LIBRARY_PATH to run edm but make sure you do not
rename the $EPICS_EXTESIONS/lib/$HOST_ARCH directory. This full path name is
recorded in the build output executables and libraries and is added to the
library search directories used by the runtime linker.

#### Installing on Red Hat Linux 7.0/7.1/7.2 *********************

1. Additional software packages required:
1a. You need "Motif" (we use openMotif version 2.1.30-6 on RH 7.1)
(we use openMotif version 2.1.30-8 on RH 7.1/7.2)
-- http://www.opengroup.org/openmotif/
2a. Giflib, zlib, and libpng is part of the general Linux distribution in most cases

2. Configuration for compiling
-- To build edm as an EPICS Extensions unzip/untar the distribution in
the following location: $EPICS_EXTENSIONS/src

-- We are building as an EPICS extension; so modify the files in
"$EPICS_EXTENSIONS/configure" appropriately for your site

-- Note we are using gcc-2.96 (Linux native compiler) and GNU make version 3.79.1

-- Need to make the following softlinks in /usr/include so edm can find motif headers:
"ln -s ../X11R6/include/Xm Xm".
"ln -s ../X11R6/include/X11 X11".

Note there is already a softlink for X11
-- Now go for the gusto and compile

3. Run Time Configuration/Setup
a. Define the following environment variables:
EDMPVOBJECTS "This is the location of a file that describes the path to EPICS
PV shared libraries"
EDMOBJECTS "This is the location of a file that describes the path to the
various EDM shared libraries"
EDMHELPFILES " Location of EDM "HELP system"

EDMFILES " Location of colors.list, fonts.list, and default.scheme files"

EDMDATAFILES " Default search path for edm screens (analogous to $EPICS_DISPLAY_PATH)

As an example here is what we set at the SNS:

-- EDMPVOBJECTS=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMOBJECTS=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMHELPFILES=$EPICS_EXTENSIONS/src/edm/helpFiles
-- EDMFILES=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMDATAFILES=./:$IOCTOP//opi/edl:$IOCTOP//opi/edl

Also, we will make available the $EPICS_EXTENSIONS/ext_pref/edm as an example.
This will be tarred up as ext_pref-edm.tar on our ftp site: (ftp://snsftp.sns.ornl.gov/UPLOAD/controls/edm)
Some of the configuration steps may be discussed in the edm documentation located
in the following: $EPICS_EXTENSIONS/src/edm/doc
b. Make sure you define LD_LIBRARY_PATH to include $EPICS_EXTESIONS/lib/$HOST_ARCH


#### Installing on Mac OS X 10.4.5 PowerPC *********************

1. Additional software packages required:
1a. Install Apple's developer tools including the optional X11 SDK
2a. Make sure you install X11 (Apple provides X11 as an optional installation for Mac OS X and the developer tools)
3a. You need to download and install darwin ports for other items
-- http://darwinports.opendarwin.org/
4a. Using darwin ports, install openmotif, libungif and libpng
-- sudo port install openmotif
-- sudo port install libungif
-- sudo port install libpng

2. Configuration for compiling
-- To build edm as an EPICS Extensions unzip/untar the distribution in the following location: $EPICS_EXTENSIONS/src

-- Make sure your environment variables are setup for EPICS (EPICS base, extensions, EDM, etc).

-- We are building as an EPICS extension; so modify the files in
"$EPICS_EXTENSIONS/configure" appropriately for your site (for example, you must specify EPICS_BASE_RELEASE explicitly)

-- Note we are using gcc-4.0.1 (Apple's version of the Mac OS X native compiler) and GNU make version 3.80

-- EPICS 3.14.8 is recommended. If you are using EPICS 3.14.7, you must make sure that "-Ddarwin" flag is passed to the compiler. Typically you do this by modifying the configuration file: /configure/os/CONFIG.Common.darwin-ppc to append the darwin flag as such: OP_SYS_CPPFLAGS += -Ddarwin

-- Open the Terminal application and change directory to the EDM source and type "make" to build EDM

3. Run Time Configuration/Setup
a. Define the following environment variables:
EDMPVOBJECTS "This is the location of a file that describes the path to EPICS
PV shared libraries"
EDMOBJECTS "This is the location of a file that describes the path to the
various EDM shared libraries"
EDMHELPFILES " Location of EDM "HELP system"

EDMFILES " Location of colors.list, fonts.list, and default.scheme files"

EDMDATAFILES " Default search path for edm screens (analogous to $EPICS_DISPLAY_PATH)

As an example here is what we set at the SNS:

-- EDMPVOBJECTS=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMOBJECTS=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMHELPFILES=$EPICS_EXTENSIONS/src/edm/helpFiles
-- EDMFILES=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMDATAFILES=./:$IOCTOP//opi/edl:$IOCTOP//opi/edl

Note: Documentation is still under construction. If you find any problems with this install
note, please send e-mail ([email protected]). I will update the README.install
Please take a look at the HTML-based edm documentation as well.

Note: Also, edm works with Red Hat 7.3