/home/kopmann/git-mirror/fdhwlib/fdhwlib/hw4/sltdef.h

Go to the documentation of this file.

/***************************************************************************
    sltdef.h  -  base defines for v4 slt

    begin                : Tue Jul 18 2000
    copyright            : (C) 2000 by Andreas Kopmann
    email                : kopmann@hpe.fzk.de
 ***************************************************************************/

#ifndef _HW4_SLTDEF_H_INCLUDED
#define _HW4_SLTDEF_H_INCLUDED

// USCT
#ifdef USCT
# define SLT_VER 110
#endif // USCT

// V4
#ifdef V4
# define SLT_VER 400
#endif // V4

#ifndef SLT_VER
// Version of the SLT description
//  1.00 First version
//# define SLT_VER 100
//  1.10 Minor modification effecting the control register
//       Released 7.6.01 ak
//# define SLT_VER 110
//  3.00 Changes for Hardware version 3
//       Numbering of the slots changed
//       Memory doubled
//# define SLT_VER 300
//  3.10 New: veto time counters and
//       the trigger time stamp information changed
//# define SLT_VER 310
//  4.00 Driver for Hw Version 4
# define SLT_VER 400
#endif // SLT_VER


// Version number of the slt implementation

#define SLT_HW_VER400 0x40  // 2009-07-17 the first v4 version number


// AM to Versions 3.11 to 3.13
// I downloaded today new slt revision with number 0x1c in Co.
// In the previous two revisions I implemented
// in the control register bit 16. This bit I used during my
// tests of the single phe measurements (this bit when '1' masks
// external inhibit). To avoid any possible troubles during
// DAQ tests I cancelled this bit. It still can be written and
// read back but it has no influence on the slt behaviour.


#define SLT_HW_VER35 0x23  // ???
#define SLT_HW_VER34 0x22  // ???
#define SLT_HW_VER318 0x21 // Mar 2006 no reset release after startup required (for FLTs)
#define SLT_HW_VER317 0x20 // Mar 2005 changes/ fixes of dead/veto counter?!
#define SLT_HW_VER316 0x1f // Oct 2004, Bug fixes in page controller
                           // Changed order of dead time counters
                           // Status of setpagefree: reading register will give
                           // 1 if still running, 0 if ready...(?)
#define SLT_HW_VER315 0x1e // Mar 2004, Improved timing in Slt-FPGA design
                           // Fixed problems: Disfunction after burn-in tests
                           //       Second strobe not recocnised after a while
#define SLT_HW_VER314 0x1d // ???
#define SLT_HW_VER313 0x1c // Feb 2004, Ext Inhibit Mask disabled again
#define SLT_HW_VER312 0x1b // Nov 2003
#define SLT_HW_VER311 0x1a
#define SLT_HW_VER310 0x19

#define SLT_HW_VER300 0x18
#define SLT_HW_VER110 0x02 // ???
#define SLT_HW_VER100 0x00

// Define for which version the library can be used
// Give min and max value that is compatible

#if defined (SLT_VER) && (SLT_VER >= 400)
# define SLT_HW_VER SLT_HW_VER400
# define SLT_HW_VER_MAX SLT_HW_VER400
#endif // SLT_VER 400

// Number of memory pages
#define SLT_PAGES 64

// Flags of the IR mask
//#define SLT_IRMASK_NXPG              0x01
//#define SLT_IRMASK_PG_ERR            0x02
//#define SLT_IRMASK_FLT_CONF_ERR      0x04
//#define SLT_IRMASK_CONF_ERR          0x08
//#define SLT_IRMASK_SLOW_CNTRL_ERR    0x10

//#define SLT_IRMASK_C_SYNC_ERR        0x20
//#define SLT_IRMASK_T_SYNC_ERR        0x40
//#define SLT_IRMASK_SYNC_ERR          0x60

#if defined (SLT_VER) && (SLT_VER >= 400)
// Trigger sources
# define SLT_TRIGGER_SW    0x01  // Software
# define SLT_TRIGGER_I_N   0x07  // Internal + Neighbors
# define SLT_TRIGGER_LEFT  0x04  // left neighbor
# define SLT_TRIGGER_RIGHT 0x02  // right neighbor
# define SLT_TRIGGER_INT   0x08  // Internal only
# define SLT_TRIGGER_EXT   0x10  // External
# define SLT_TRIGGER_FRN   0x20  // Front Panel

// Inhibit masks
# define SLT_INHIBIT_SW    0x01  // Software
# define SLT_INHIBIT_INT   0x02  // Internal
# define SLT_INHIBIT_EXT   0x04  // External
# define SLT_INHIBIT_ALL   0x07  // Internal + External
# define SLT_INHIBIT_NO    0x01  // None of both (only Software)

// Test pulse settings ???
//#define SLT_TESTPULS_NO   0x00   // None
//#define SLT_TESTPULS_EXT  0x02   // External
//#define SLT_TESTPULS_SW   0x01   // Software

// Second strobe sources
# define SLT_SECSTROBE_INT 0x00   // Internal SecStrobe Signal
# define SLT_SECSTROBE_EXT 0x01   // Extern

#endif // SLT_VER >= 400

#if 0 // thjm
/*  Mask for the IR controller on the Slt board:
  * The interrupt "NextPage" is generated if a next page
  * signal occures.
  */
#define SLT_IRMASK_NXPG       0x0001

/*  Mask for the IR controller on the Slt board:
  * The interrupt "Warning AllPagesFull" is
  * generated if the actual page
  * pointer is set to the last free page. The
  * next trigger will stop the data aquisition.
  */
#define SLT_IRMASK_WAR_PGFULL 0x0002

/*  Mask for the IR controller on the Slt board:
  * The interrupt "Error Loading Flt FPGAs"
  * is generated if an error
  * occures while the configuration of the
  * FPGAs on the Flt boards.
  */
#define SLT_IRMASK_ERR_FLT    0x0004

/*  Mask for the IR controller on the Slt board:
  * The interrupt "Error Configuration"
  * is generated if the command
  * configure FPGAs is given on a system without
  * an confuration error?!
  */
#define SLT_IRMASK_ERR_CONF   0x0008

/*  Mask for the IR controller on the Slt board:
  * The interrupt "Error Sensor OutOfRange" is generated if one
  * of the sensors leaves the allowed range.
  */
#define SLT_IRMASK_ERR_SC     0x0010

/*  ?
  */
#define SLT_IRMASK_ERR_CFPGA  0x0020
/*  ?
  */
#define SLT_IRMASK_ERR_TFPGA  0x0040


/*  Mask for the IR controller on the Slt board:
  * The interrupt "Error PageFull" is generated if all pages
  * are full. The data aquisition has been stopped
  * in this case and needs to be restarted
  * manually after some pages have been cleared.
  */
#define SLT_IRMASK_ERR_PGFULL 0x0080

/*  Mask for the IR controller on the Slt board:
  * The interrupt "PageLost" is generated if an next
  * page occures before an acknowledge for
  * last occurence of the trigger has been received.
  * If this warning occures, it is necessary
  * to analyse the page status register for
  * the filled pages. At least one page number will not
  * be returned with the acknoledge vector.
  */
#define SLT_IRMASK_WAR_PGLOST 0x0100


/*  Mask for the IR controller on the Slt board:
  * An interrupt is generated if at least one
  * of the two FPGA errors occure.
  * In both cases the synchronisation with the
  * second strobe signal failed.
  * This mask includes Error CFPGA Sync and
  * Error TFPGA Sync
  */
#define SLT_IRMASK_ERR_SYNC   0x0060


/*  Mask for the IR controller on the Slt board:
  * An interrupt is generated if any of
  * the page controller interrupts is generated.
  * This mask includes "NextPage", "Warning AllPagesFull",
  * "Error AllPagesFull" and "Warning PageLost".
  *
  */
#define SLT_IRMASK_PGCTRL     0x0183

#endif // thjm

// new constants for V4, I prefer them to be in a namespace

namespace hw4 {
  
  static const int kSLT_VER = SLT_VER;
  
  static const int kSLT_PAGES = 64 /* SLT_PAGES */;

  static const int kSLT_SAMPLES = 2000;
  
  static const int kMULTIPLICITY_SAMPLES = 1000;
  
  static const int kSLT_COINCTIME_STEPWIDTH = 30;
  
  static const int kSLT_TRIGGERWINDOW_MAX = 7;
  
} // namespace hw4

#endif // _HW4_SLTDEF_H_INCLUDED