Quick HiDEOS install for latest HiDEOS version for use with EPICS R3.13

This is the instructions to help quickly set up HiDEOS for your mvme162 and mvme167. If you are still using R3.12, you may need to read Quick install for R3.12 and EPICS/HIDEOS support for R3.12 for more information.

Define HiDEOS Home

Define a place to put all the HiDEOS related stuff. We made an user login and put everything in the home directory.

Compiler

Get GNU gcc-2.7.2, binutils-2.6 for sure, flex and bison if you need them. Use the links on the HiDEOS home page to retrieve the compressed tar files. Make a directory under ~hideos for source and install (I called ours gnu_src and gnu_install-2.7.2). Go to the gnu_install-2.7.2 directory and make directories man, lib, bin, and info. Go into the man directory and make directory man1. Some of the install script are confused if directories are not present. IMPORTANT: Make sure your $PATH shell variable has (hideos_home)/gnu_install-2.7.2/bin first in it's search path. These instructions pertain to gcc 2.7.2. The latest version of HiDEOS uses this version of the compiler. This is the version that should be used with EPICS R3.13. You should be using GNU make to build the GNU tools. Use gnumake if you system has it installed already, or retrieve and build it. Be sure to install it in (hideos_home)/gnu_install-2.7.2.

IMPORTANT NOTE:
target=sun3 is correct, do not change it! A Sun3 is a 68k machine, so building with target=sun3 will build a cross compiler from your architecture to the 68k.

flex (If required - it may be installed on your system already)
- ./configure --prefix=(hideos_home)/gnu_install-2.7.2
- make ( be sure to use gnumake )
- make install ( be sure to use gnumake )
bison - (If required - it may be installed on your system already)
- ./configure --prefix=(hideos_home)/gnu_install-2.7.2
- make ( be sure to use gnumake )
- make install ( be sure to use gnumake )
binutils - This will be built as a cross development tool
- run "./config.guess". This will tell you the host architecture.
- ./configure --host=sparc-sun-solaris2.5.1 --target=sun3 --prefix=(hideos_home_directory)/gnu_install-2.7.2
  Remember to substitute the answer from config.guess for "--host" if it is different then the above one.
- make ( be sure to use gnumake )
- make install ( be sure to use gnumake )
g++/gcc
- make distclean (ignore if this doesn't work, be sure to use gnumake)
- ./configure --with-gnu_as --with-gnu-ld --host=sparc-sun-solaris2.5.1 --target=sun3 --prefix=(hideos_home_directory)/gnu_install-2.7.2 --local-prefix=(hideos_home_directory)/gnu_install-2.7.2
- edit Makefile and change the following variables to:
```
	LANGUAGES = c c++
	LIBGCC1 = # libgcc1.a
	CROSS_LIBGCC1 = # libgcc1.cross
	ENQUIRE = # enquire
	add -Dinhibit_libc to LIBGCC2_CFLAGS after -O2
```
- make ( be sure to use gnumake )
- make install ( be sure to use gnumake )

Building HiDEOS C Library Support

Undo the os_code.tar.gz file in the HiDEOS top level directory. This is the standard c library for the stand alone system. The string functions, conversion functions, and stdio functions are built here. This is the same instruction as previous HiDEOS versions. This library NEVER changes, compile it once and leave it be.

cd os_code
cp MakeArch.in MakeArch
cd config
Edit HIDEOS_VARS. Make sure the variables at the top are pointing at your installed GNU compiler and tools.
cd ..
make World ( be sure to use gnumake )

Building HiDEOS for the MVME162

Undo the hideos.tar.gz file in the HiDEOS top level directory. This step will build the 162 stand alone version of HiDEOS and vxWorks version of HiDEOS.

tar xvf hideos.tar
cd hideos

edit MakeArch, make sure

	ALL_ARCHS = bare162 vx167 vx162
	DEFAULT_ARCH = bare162

cd config
edit HIDEOS_VARS
- Make sure the GNU_DIR variable points to your GNU install (2.7.2)
- Make sure the CORE_DIR variable points to your os_code directory
check HIDEOS_VARS_bare162, HIDEOS_VARS_vx167 and HIDEOS_VARS_vx162
cd ..
make World ( be sure to use gnumake )

Building EPICS Device support for HiDEOS

The EPICS device support for HiDEOS is located in the hideos/epics directory. You should copy all these files into your EPICS application developer's tree and build it there according to the instructions in the Makefiles and the instruction in the document describing building EPICS device for HiDEOS (available from the main HiDEOS page). You should not build the EPICS device support modules in the hideos/epics directory, copy them to an EPICS app directory. Carefully read the README file in the hideos/epics directory for a description of the available Makefiles.

Building support in a 3.13beta8 and previous application directory

Copy Makefile.Vx.3.13.beta8 to your app directory as Makefile.Vx. Be careful not to destroy your current Makefile.Vx if you have already added stuff to it.
Copy all the device support files that you need into your app directory.
Edit Makefile.Vx in your app directory and add the desired device support files using "LIBOBJS_CXX +=". The default file only builds GPIB (Gpib.cc) and the hideos base library (devHideos.cc). You should always copy and build these.
Edit the CONFIG and RELEASE files in your app config directory. Use the hideos/epics/example.CONFIG and hideos/epics/example.RELEASE files as examples of what to change.
Edit the st.cmd command file in your iocBoot directory. Use the hideos/epics/example.st.cmd file as an example.
All of HiDEOS will be placed in a file in O.mv16x called hideosLib. That is the only file that is needed. Be sure to load it using ldpp() instead of ld().

The latest version of EPICS (R3.13) includes the ldpp() front end to the vxWorks loader ld(). It also supports C++ directly from it's config Makefile system.

Building support in a 3.13beta9 and future application directory

The steps are the same as beta8, except use Makefile.Vx.3.13.beta9 from the hideos/epics directory. Several config bugs were fixed in beta9 to make the makefiles cleaner.

Set Up the MVME162

Follow the instructions in setting up the MVME162. Your mvme162 should now be ready to use.

Argonne National Laboratory Copyright Information

Jim Kowalkowski (jbk@aps.anl.gov)

updated 4/97