TRD/AliTRDRawStream.h

   1 #ifndef ALITRDRAWSTREAM_H
   2 #define ALITRDRAWSTREAM_H
   3 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
   4  * See cxx source for full Copyright notice                               */
   5
   6 /* $Id$ */
   7
   8 ////////////////////////////////////////////////////////////////////////////
   9 //                                                                        //
  10 // This class provides access to TRD digits in raw data.                  //
  11 //                                                                        //
  12 ////////////////////////////////////////////////////////////////////////////
  13
  14 #include <TObject.h>
  15 #include "AliTRDrawStreamBase.h"
  16
  17 class AliRawReader;
  18
  19 class AliTRDgeometry;
  20 class AliTRDdigitsManager;
  21
  22 // Some constants:
  23 const UInt_t kEndoftrackletmarker = 0xAAAAAAAA; /*This marks the end of tracklet data words*/
  24 const UInt_t kEndofrawdatamarker  = 0x00000000; /*This marks the end of half-chamber-data*/
  25 const UInt_t kSizeWord            = sizeof(UInt_t);
  26
  27 //class AliTRDRawStream: public TObject {
  28 class AliTRDRawStream: public AliTRDrawStreamBase {
  29
  30   public :
  31
  32     AliTRDRawStream();
  33     AliTRDRawStream(AliRawReader *rawReader);
  34     virtual ~AliTRDRawStream();
  35
  36     virtual Bool_t       Next();                                // Read the next data
  37     virtual Int_t        NextChamber(AliTRDdigitsManager *man); // Read next chamber data
  38     virtual Bool_t        Init();                                // Init for the fRawVersion > 1
  39
  40     enum { kDDLOffset = 0x400 };                                // Offset for DDL numbers
  41
  42     Bool_t               SetRawVersion(Int_t rv);
  43     Int_t                GetRawVersion() const                      { return fRawVersion;     };
  44     void                 SetRawReader(AliRawReader *rawReader);
  45
  46     // Get Filter settings (does not make a lot of sense):
  47     Int_t                TRAPfilterTCon() const                     { return fTCon;           };
  48     Int_t                TRAPfilterPEDon() const                    { return fPEDon;          };
  49     Int_t                TRAPfilterGAINon() const                   { return fGAINon;         };
  50     Int_t                TRAPsendsUnfilteredData() const            { return fBypass;         };
  51
  52     // Get Tracklet parameters (does not make a lot of sense):
  53     Float_t              GetTrackletPID() const                     { return fTracklPID;      };
  54     Float_t              GetTrackletDeflLength() const              { return fTracklDefL;     };
  55     Float_t              GetTrackletPadPos() const                  { return fTracklPadPos;   };
  56     Int_t                GetTrackletPadRow() const                  { return fTracklPadRow;   };
  57
  58     // Check if the link has optical power (HC sends data)
  59     Bool_t               IsGTULinkActive(Int_t sm, Int_t la, Int_t sta, Int_t side)
  60       { return ( ((fGTUlinkMask[sm][sta]) >> (2*la+side)) & 0x1 ); };
  61
  62     Int_t *GetSignals() const          { return (Int_t*)fSig;     } // Signals in the three time bins from Data Word
  63     Int_t  GetADC() const              { return fADC;     } // MCM ADC channel and Time Bin of word 1
  64     Int_t  GetTimeBin() const          { return fTB - 3;  } // MCM ADC channel and Time Bin of word 1
  65     Int_t  GetEventNumber() const      { return fEv;      } // MCM Event number and position of current MCM
  66     Int_t  GetROB() const              { return fROB;     } // MCM Event number and position of current MCM
  67     Int_t  GetMCM() const              { return fMCM;     } // MCM Event number and position of current MCM
  68     Int_t  GetSM() const               { return fSM;      } // Position of CURRENT half chamber in full TRD
  69     Int_t  GetLayer() const            { return fLAYER;   } // PLANE = Position of CURRENT half chamber in full TRD
  70     Int_t  GetStack() const            { return fSTACK;   } // CHAMBER = Position of CURRENT half chamber in full TRD
  71     Int_t  GetROC() const              { return fROC;     } // Position of CURRENT half chamber in full TRD
  72     Int_t  GetSide() const             { return fSIDE;    } // Position of CURRENT half chamber in full TRD
  73     Int_t  GetDCS() const              { return fDCS;     } // DCS board number read from data (HC header)
  74     Int_t  GetRow() const              { return fROW;     }
  75     Int_t  GetCol() const              { return fCOL;     } // Detector Pad coordinates
  76     Int_t  GetDet() const              { return fDET;     } // Helper
  77     Int_t  GetLastDet() const          { return fLastDET; } // Helper
  78     Int_t  GetMaxRow() const           { return fRowMax;  }
  79     Int_t  GetMaxCol() const           { return fColMax;  }
  80     Int_t  GetNumberOfTimeBins() const { return fTBins;   }
  81
  82  protected:
  83
  84     AliTRDgeometry *fGeo;                                   // TRD geometry
  85
  86     void   DecodeHCheader(Int_t timeBins);
  87     void   DecodeMCMheader();
  88     void   DecodeTracklet();
  89     void   DecodeGTUlinkMask();
  90     Int_t  DecodeDataWord();
  91     Int_t  DecodeDataWordV1V2();                            // Valid for fRawversion = 1, 2, ...
  92     Int_t  DecodeDataWordV3();                              // Valid for fRawversion = 3, ...
  93
  94     Int_t  NextData();                                      // Get the next piece of memory
  95
  96     enum { kStart
  97          , kStop
  98          , kWordOK
  99          , kNoMoreData
 100          , kNextSM
 101          , kNextHC
 102          , kSeekNonEoTracklet
 103          , kDecodeHC
 104          , kNextMCM
 105          , kNextData
 106          , kReading };
 107
 108   private :
 109
 110     Int_t    fSig[3];                         //  Signals in the three time bins from Data Word
 111     Int_t    fADC;                            //  MCM ADC channel and Time Bin of word 1
 112     Int_t    fTB;                             //  MCM ADC channel and Time Bin of word 1
 113     Int_t    fEv;                             //  MCM Event number and position of current MCM on TRD chamber
 114     Int_t    fROB;                            //  MCM Event number and position of current MCM on TRD chamber
 115     Int_t    fMCM;                            //  MCM Event number and position of current MCM on TRD chamber
 116     Int_t    fSM;                             //  Position of CURRENT half chamber in full TRD
 117     Int_t    fLAYER;                          //  Position of CURRENT half chamber in full TRD
 118     Int_t    fSTACK;                          //  Position of CURRENT half chamber in full TRD
 119     Int_t    fROC;                            //  Position of CURRENT half chamber in full TRD
 120     Int_t    fSIDE;                           //  Position of CURRENT half chamber in full TRD
 121     Int_t    fDCS;                            //  DCS board number read from data (HC header)
 122     Int_t    fROW;                            //  Detector Row coordinates
 123     Int_t    fCOL;                            //  Detector Pad coordinates
 124     Int_t    fDET;                            //  Current detector - version > 1
 125     Int_t    fLastDET;                        //  Previous detector - version > 1
 126
 127     Int_t    fBCctr;                          //  Counters from HC header (>=V2)
 128     Int_t    fPTctr;                          //  Counters from HC header (>=V2)
 129     Int_t    fPTphase;                        //  Counters from HC header (>=V2)
 130     Int_t    fRVmajor;                        //  Raw version numbers and number of additional HC headerwords (>=V2)
 131     Int_t    fRVminor;                        //  Raw version numbers and number of additional HC headerwords (>=V2)
 132     Int_t    fHCHWords;                       //  Raw version numbers and number of additional HC headerwords (>=V2)
 133     Int_t    fTBins;                          //  Number of time bins read from HC header (>=V2)
 134     Bool_t   fTCon;                           //  Filter settings read from HC header (>=V2)
 135     Bool_t   fPEDon;                          //  Filter settings read from HC header (>=V2)
 136     Bool_t   fGAINon;                         //  Filter settings read from HC header (>=V2)
 137     Bool_t   fXTon;                           //  Filter settings read from HC header (>=V2)
 138     Bool_t   fNonLinOn;                       //  Filter settings read from HC header (>=V2)
 139     Bool_t   fBypass;                         //  Filter settings read from HC header (>=V2)
 140     Int_t    fCommonAdditive;                 //  Common baseline additive read from HC header (>=V2)
 141
 142     Bool_t   fZeroSuppressed;                 // Data is zero suppressed
 143
 144     Int_t    fHCHctr1;                        //  HC and MCM Header counter
 145     Int_t    fHCHctr2;                        //  HC and MCM Header counter
 146     Int_t    fMCMHctr1;                       //  HC and MCM Header counter
 147     Int_t    fMCMHctr2;                       //  HC and MCM Header counter
 148     Int_t    fGTUctr1;                        //  GTU LinkMask Counter
 149     Int_t    fGTUctr2;                        //  GTU LinkMask Counter
 150     Int_t    fHCdataCtr;                      //  Data Counter for half chamber
 151
 152     Float_t  fTracklPID;                      //  Tracklet parameters
 153     Float_t  fTracklDefL;                     //  Tracklet parameters
 154     Float_t  fTracklPadPos;                   //  Tracklet parameters
 155     Int_t    fTracklPadRow;                   //  Tracklet parameters
 156
 157     UShort_t fGTUlinkMask[18][5];             //  Mask with active links
 158
 159     AliTRDRawStream(const AliTRDRawStream &stream);
 160     AliTRDRawStream &operator=(const AliTRDRawStream &stream);
 161
 162     AliRawReader *fRawReader;              //  Object for reading the raw data
 163
 164     Int_t    fRawVersion;                  //  Which version of raw data decoding is used
 165
 166     Int_t    fNextStatus;                  //  Navigation in raw versions > 1
 167     UInt_t   fTbSwitch;                    //  Time Bin Switch for internal use
 168     UInt_t   fTbSwitchCtr;                 //  Counter for internal use
 169     UInt_t   fTimeWords;                   //  Number of Words needed to store the data of 1 ADC ch.
 170     UInt_t   fWordCtr;                     //  Word Counter
 171
 172     Int_t    fRowMax;                      //  Maximum number of pad rows and columns
 173     Int_t    fColMax;                      //  Maximum number of pad rows and columns
 174
 175     Bool_t   fADCmask[21];                 //  Mask of active ADCs for zero suppression
 176     UShort_t fChamberDone[540];            //  Chamber was processed already (1=1HC, 2=full chamber)
 177
 178     Int_t    fRetVal;                      //  Datadecode return
 179     Int_t    fEqID;                        //  Equipment id
 180     UInt_t   fDataSize;                    //  Size of the data available in the current buffer
 181     Bool_t   fSizeOK;                      //  Did we read anything
 182     UInt_t   fCountBytes;                  //  Bytes traversed in the buffer
 183     UInt_t   fBufSize;                     //  Size of the current RawReader buffer
 184     Bool_t   fBufferSet;                   //  Is the RawReader buffer available
 185     UChar_t *fPos;                         //  Position in the buffer of the RawReader
 186     UInt_t  *fDataWord;                    //  The pointer to the current 32 bit data word
 187     UInt_t   fTimeBinsCalib;               //  N of time bins retrieved from calibration
 188
 189     enum ETRDzRawStreamError {
 190        kHCWordMissing = 1                  //
 191       ,kMCMADCMaskMissing = 2              //
 192       ,kWrongMCMorROB = 3                  //
 193       ,kGTULinkMaskMissing = 4             //
 194       ,kHCHeaderCorrupt = 5                //
 195       ,kHCHeaderMissing = 6                //
 196       ,kROBSideMismatch = 7                //
 197       ,kWrongPadrow = 8                    //
 198       ,kWrongPadcolumn = 9                 //
 199       ,kTrackletRowMismatch = 10           //
 200       ,kDataMaskError = 11                 //
 201       ,kADCNumberOverflow = 12             //
 202       ,kADCChannelOverflow = 13            //
 203     };
 204
 205     ClassDef(AliTRDRawStream, 6)           // Class for reading TRD raw digits
 206
 207 };
 208 #endif