Subversion Repositories f9daq

SOFTWARE FOR SIPM CHARACTERIZATION WITH CAMAC, SCOPE, BIAS VOLTAGE AND TABLE POSITION SUPPORT

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

By Gasper Kukec Mezek, April 2015.

________________

1. Installation:

Pre-requisites for offline and online modes:

a) Offline mode (support for histogramming and analysis):

   - A newer (5.34 or higher, support for version 6 not added yet) pro version of ROOT (https://root.cern.ch).

b) Online mode (support for histogramming, analysis and data acquisition):

   - Perl developer package libperl-dev for installation of net-snmp (sudo apt-get install libperl-dev).

   - Current version of net-snmp (http://www.net-snmp.org).

   - A newer (5.34 or higher, support for version 6 not added yet) pro version of ROOT (https://root.cern.ch).

   - USB developer package libusb-dev (sudo apt-get install libusb-dev).

Installation is done through the usual "./configure" and "make" commands to enable the use of this software with 32 bit or 64 bit systems.

Configure takes the following arguments:

- First argument is the configure option (help, nomake, all, clean, compress):

    help = shows configure help

    all = prepares OS dependent files and makes the needed usb daq libraries

    nomake = only prepares OS dependent files

    clean = cleans the installation to the base file structure (keeps the results directory)

    compress = compresses the base installation into a tar-ball

- Second argument is the online/offline configure setting (only used when first argument is nomake or all), that enables the software to work with:

    a connected CAMAC and scope (I) = Online mode

    only a connected scope (S) = Offline mode with oscilloscope connection

    with no connected devices (O) = Offline mode

- The following arguments set specific computer details and can be entered in any order:

    a) --root-install=/path/to/root/directory -> The ROOT install directory, if it is not installed in a standard location (especially needed when running the program with superuser, since it usually does not have the required environment variables).

    b) --snmp-install=/path/to/snmp/directory -> The NET-SNMP install directory, if it is not installed in a standard location.

    c) --ostype=YYYY -> Optional argument to specifically set the OS type to either 32bit (YYYY = i686) or 64bit (YYYY = x86_64). If argument not supplied, the configure script will try to get this information automatically through uname.

Running "./configure" or "./configure help" will give more information on specific uses.

Example:

   ./configure all I --root-install=/opt/root --snmp-install=/opt/net-snmp --ostype=i686

Makefile:

Once configuration is done, a Makefile will be generated and further installation is done by running "make". Running "make relib" will only recreate the libraries in case something has been edited in them.

Example:

   make

On first run of the program, make sure to copy the ./mpod/WIENER-CRATE-MIB.txt to the MIB directory in your installation of net-snmp. This can be in: 

   ~/.snmp/mibs

or

   [/snmp/install/directory]/share/snmp/mibs

________________________

2. Running the software:

Once installation is performed, use

   ./start.sh

to start the software in offline mode or

   sudo ./start.sh

to start the software in online mode. Once the software starts, it will let you know (in the terminal) if connection to CAMAC was correctly established.