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.