/*   HERA to LPS Data Definition language */
                /*  OS9 file = /h0/users/MONI/Hera_Zeus.h */

/****---...+

  In order to operate pots safelly, LPS needs data from HERA and from ZEUS :

    1) HERA :
       - Some magnet current values. Important magnet names are listed below
         after the definition of NMAGNET. An indicative flag (say 0 or 1) is
         needed also to tell  LPS  that any  other magnet  or anything  goes
         wrong in the HERA machine.

       - Beam position monitors (e.g. pick-up). These data are also known by
         the ZEUS slow control.

       - West Collimators rate  AND  positions.  See Collimator names listed
         after the definition of NWCOLLIM.

       - Beam emittance epsilonX, epsilonY.

    2) ZEUS :
       - C5 rate.
       - FNC rate.

    NOTE : LPS is directly looking with OS9 at the following data :

       - Beam Position Monitors (i.e. signal sent by HERA to LPS to generate
         a fast pot withdraw of pots if signal out of 200 mu threshold).
       
       - wire map of detectors.
       - L1 trigger planes rates.


  The idea is that the following definitions and structure are common to all
 concerned computer. When NFS will be used, this file will be located on an
 unique machine.

+...---****/       


#define NMAGNET   32   /* 9 Hera magnets values are needed by LPS : S 26 BS, */
                       /* SL 47 BT, SL 148 CX, SR 47 BT, SR 145 CX, SL 45 BZ,*/
                       /* SL 117 CY, SR 45 BZ, S5 114 CY. + 7 spares         */

#define NHBPM     8    /* 8 Hera Beam Position Monitors : 4 x and 4 y        */
                       /* 1 to 8 increase with the proton beam direction.    */

#define NWCOLLIM  12    /* 6 WEST Collimators :  WL150 Oben,  WL150 Aussen,   */
                       /*                       WL105 Innen, WL105 Unten,    */
                       /*                       WL109 Oben,  WL109 Aussen.   */


/* Hera to Zeus contact men : P. Duval  Herb  R. Ayad  C. Youngman           */
/* Zeus to LPS Ayad, Nemoz                                                   */


typedef struct {       
   char time_data[32];
   int HERA_ok;        /* HERA status flag : if any magnet is not at its ref */
                       /* value or if anything goes wrong in the machine, it */
                       /* has to be set to 0. 1 means HERA OK                */
                       /* contact man :  ?    tel :                          */
                     
   float bump[NMAGNET];/* Present values in Amps of Bump magnets             */
                       /* contact man :  ?    tel :                          */
   
   float bpmx[NHBPM];   /* values in mm of HERA beam Position Monitors        */
   float bpmy[NHBPM];   /* values in mm of HERA beam Position Monitors        */
                       /* contact man : Wendt (   )  Mess (   )              */

   float c_pos[NWCOLLIM];
                       /* present values in mm of HERA West Collimators      */
                       /* contact man :  ?    tel :                          */    

   int  c_rate[NWCOLLIM];
                       /* HERA West Collimators rates in Hz                  */
    
   float epsilon[2];   /* Beam emittance, H and V in mm.mrad                 */
                       /* contact man :  ?    tel :                          */

 /* The following data are given by ZEUS. To read data from the HERA server, */
 /* the number of bytes to be read is 'sizeof(sc_to_os9) - 8', unless HERA   */
 /* send the whole structure, the 2 last integers C5_rate and FNC_rate are   */
 /* dummy.                                                                   */

   int c5_rate;        /* C5 counter rate in Hz                              */
                       /* contact man :  ?    tel :                          */

   int fnc_rate;       /* Forward Neutron Calorimeter rate in Hz             */
                       /* contact man : Futurani .. ?    tel :               */
} sc_to_os9;


     /* N.B.  This structure is included in the environemental trigger */