Installing SSRL's DHS

A DHS can be any program that can speak the DCS protocol (or subset of it) and does one of the following:

• Accepts DCS messages and controls a piece of hardware directly.

• Accepts, translates,and forwards DCS messages to another control system.

SSRL currently uses a DHS program which supports the following hadware:

• DMC2180 motion controller.

• ADSC Quantum 4 CCD detector.

• ADSC Quantum Q315 CCD detector.

• MAR345 detector without a base.

• Canberra DSA 2000 multi channel analyzer (limited functionallity)

• Image analysis of JPEG's obtained by AXIS 2400 servers. (for automatic crystal centering)

This program requires that a functional mysql database is available so that it can obtain its configuration at start-up.

1. Install the mysql client libraries .

2. Install the xos library .

3. Install the diffimage library .

4. Checkout dhs from CVS into your DCS 'root' directory.

   blctlxx:~/release-3_2 > cvs checkout -r release-3_2 dhs
   

5. Check out the Q4 image transformation files found in the xform project. These files contain some algorithms and code which Area Detector Systems Corporation does not wish to have distributed without prior permission.

   blctlxx:~/release-3_2 > cvs checkout -r release-3_2 xform
   cvs checkout: Updating xform
   U xform/xform.c
   U xform/xform.h
   blctlxx:~/release-3_2 >
   

   If you do not have access to this project, the xformstub.c and xformstub.h (provided by SSRL) can be used to build the DHS. Create the xform directory in your 'DCS root' directory before copying and renaming the follow the files as shown in this example:

   blctlxx:~/release-3_2 > mkdir xform
   blctlxx:~/release-3_2 > cd xform
   blctlxx:~/release-3_2/xform > cp ~/release-3_2/dhs/src/xformstub.c xform.c
   blctlxx:~/release-3_2/xform > cp ~/release-3_2/dhs/src/xformstub.h xform.h
   

6. Install the third party dali library or remove references to -DWITH_CAMERA_SUPPORT and DALIIMAGE_LIBS from the makefile if you do not need support for image analysis for crystal centering.

   smblx5:~/release-3_2/dhs/linux > cvs diff
   cvs diff: Diffing .
   Index: dhs
   ===================================================================
   RCS file: /home/code/repository/dhs/linux/dhs,v
   retrieving revision 1.1
   diff -r1.1 dhs
   Binary files /tmp/cvsB6eKRE and dhs differ
   Index: makefile
   ===================================================================
   RCS file: /home/code/repository/dhs/linux/makefile,v
   retrieving revision 1.11
   diff -r1.11 makefile
   31c31
   < CPP_CONSTANTS = -DLINUX -Ddatabase_mysql -DWITH_CAMERA_SUPPORT -DWITH_DETECTOR_SUPPORT -DWITH_ASYNC2100_SUPPORT -DWITH_DMC2180_SUPPORT -DWITH_HUTCH_DOOR_BIT_SUPPORT
   ---
   > CPP_CONSTANTS = -DLINUX -Ddatabase_mysql  -DWITH_DETECTOR_SUPPORT -DWITH_ASYNC2100_SUPPORT -DWITH_DMC2180_SUPPORT -DWITH_HUTCH_DOOR_BIT_SUPPORT
   62,63c62
   < ALL_LIBS =  ${MYSQL_LIB_DIR}/libmysqlclient.a ${LOCAL_LIBS}  ${THREAD_LIBS} ${STD_LIBS} ${DALIIMAGE_LIBS}
   < 
   ---
   > ALL_LIBS =  ${MYSQL_LIB_DIR}/libmysqlclient.a ${LOCAL_LIBS}  ${THREAD_LIBS} ${STD_LIBS}
   81,83c80
   <        safeFile.o \
   <        dhs_Camera.o \
   <        imgCentering.o
   ---
   >        safeFile.o
   smblx5:~/release-3_2/dhs/linux >
   

7. Edit the dhs_main.c file and change the default mysql database hostname reference the hostname of your mysql server. For example, to change to localhost:

   blctlxx:~/release-3_2/dhs/src > cvs diff
   cvs diff: Diffing .
   Index: dhs_main.cc
   ===================================================================
   RCS file: /home/code/repository/dhs/src/dhs_main.cc,v
   retrieving revision 1.6
   diff -r1.6 dhs_main.cc
   70c70
   < 	m_db_hostname = "smb";
   ---
   > 	m_db_hostname = "localhost";
   

8. cd into the linux, decunix, or irix build directory and build.

   blctlxx:~/release-3_2/dhs/linux > make