ITS/AliITSRawStreamSPD.h

   1 #ifndef ALIITSRAWSTREAMSPD_H
   2 #define ALIITSRAWSTREAMSPD_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 ITS SPD digits in raw data.
  11 ///
  12 ///////////////////////////////////////////////////////////////////////////////
  13
  14 #include "AliITSRawStream.h"
  15 #include "AliITSRawStreamSPDErrorLog.h"
  16
  17 class AliITSRawStreamSPD: public AliITSRawStream {
  18   public :
  19     AliITSRawStreamSPD(AliRawReader* rawReader);
  20     AliITSRawStreamSPD(const AliITSRawStreamSPD& rstream);
  21     AliITSRawStreamSPD& operator=(const AliITSRawStreamSPD& rstream);
  22     virtual ~AliITSRawStreamSPD() {};
  23
  24     virtual Bool_t  Next();
  25     virtual Int_t   ReadCalibHeader();
  26
  27     // the 2 methods below are equivalent to AliITSRawStream::GetCoord1 and GetCoord2
  28     // together with the AliITSRawStream::GetModuleID these are the "offline" coordinates
  29     Int_t    GetColumn() const {return fCoord1;};
  30     Int_t    GetRow() const {return fCoord2;};
  31
  32     // together with the AliRawReader::GetDDLID() these are the "online" coordinates
  33     UShort_t GetHalfStaveNr() const {return fHalfStaveNr;}
  34     UShort_t GetChipAddr() const {return fChipAddr;}
  35     Int_t    GetChipCol() const {return fCol;};
  36     Int_t    GetChipRow() const {return fRow;};
  37
  38     // module mapping
  39     static Int_t GetModuleNumber(UInt_t iDDL, UInt_t iModule);
  40     static Int_t GetModuleNumber(UInt_t iDDL, UInt_t iHS, UInt_t iChip)
  41       {return GetOfflineModuleFromOnline(iDDL,iHS,iChip);}
  42
  43     // coordinate conversions:
  44     static Bool_t OfflineToOnline(UInt_t module, UInt_t colM, UInt_t RowM, UInt_t& eq, UInt_t& hs, UInt_t& chip, UInt_t& col, UInt_t& row);
  45     static Bool_t OnlineToOffline(UInt_t eq, UInt_t hs, UInt_t chip, UInt_t col, UInt_t row, UInt_t& module, UInt_t& colM, UInt_t& rowM);
  46     // coordinate conversions - offline->online
  47     static UInt_t GetOnlineEqIdFromOffline(UInt_t module);
  48     static UInt_t GetOnlineHSFromOffline(UInt_t module);
  49     static UInt_t GetOnlineChipFromOffline(UInt_t module, UInt_t colM);
  50     static UInt_t GetOnlineColFromOffline(UInt_t module, UInt_t colM);
  51     static UInt_t GetOnlineRowFromOffline(UInt_t module, UInt_t rowM);
  52     // coordinate conversions - online->offline
  53     static UInt_t GetOfflineModuleFromOnline(UInt_t eqId, UInt_t hs, UInt_t chip);
  54     static UInt_t GetOfflineChipKeyFromOnline(UInt_t eqId, UInt_t hs, UInt_t chip);
  55     static UInt_t GetOfflineColFromOnline(UInt_t eqId, UInt_t hs, UInt_t chip, UInt_t col);
  56     static UInt_t GetOfflineRowFromOnline(UInt_t eqId, UInt_t hs, UInt_t chip, UInt_t row);
  57
  58     Bool_t  GetFastOrSignal(UInt_t eq, UInt_t hs, UInt_t chip);
  59
  60     Int_t   GetEventCounter() const {return fEventCounter;}    // get last read event counter value
  61     Short_t GetEventCounterFullEq(UInt_t eq) const;
  62     Short_t GetEventCounterFullHS(UInt_t eq, UInt_t hs) const;
  63     Short_t GetEventCounterFullChip(UInt_t eq, UInt_t hs, UInt_t chip) const;
  64     Bool_t  IsEventCounterFullConsistent() const;
  65
  66     Bool_t IsActiveEq(UInt_t eq) const;
  67     Bool_t IsActiveHS(UInt_t eq, UInt_t hs) const;
  68     Bool_t IsActiveChip(UInt_t eq, UInt_t hs, UInt_t chip) const;
  69
  70     Bool_t GetHalfStavePresent(UInt_t hs);
  71
  72     Int_t  GetHword(UInt_t index);
  73     // use the methods below to extract the information from the scan calibration header:
  74     UInt_t GetHrouterNr() const {return (fCalHeadWord[0] & 0x0000003f);}
  75     Bool_t GetHhalfStaveScanned(UInt_t hs) const;
  76     UInt_t GetHtype() const {return (Int_t)((fCalHeadWord[1]) & 0x000000ff);}
  77     Bool_t GetHdataFormat() const {return (Bool_t)(((fCalHeadWord[1]) & 0x00000100)>>8);}
  78     UInt_t GetHtriggers() const {return fCalHeadWord[2];}
  79     Bool_t GetHchipPresent(UInt_t hs, UInt_t chip) const;
  80     UInt_t GetHdacStart() const {return ((fCalHeadWord[5]>>24) & 0x000000ff);}
  81     UInt_t GetHdacEnd() const {return ((fCalHeadWord[5]>>16) & 0x000000ff);}
  82     UInt_t GetHdacStep() const {return ((fCalHeadWord[5]>>8) & 0x000000ff);}
  83     UInt_t GetHdacId() const {return ((fCalHeadWord[5]) & 0x000000ff);}
  84     UInt_t GetHrowStart() const {return (UInt_t) ((fCalHeadWord[6]>>24) & 0x000000ff);}
  85     UInt_t GetHrowEnd() const {return (UInt_t) ((fCalHeadWord[6]>>16) & 0x000000ff);}
  86     UInt_t GetHrowValue() const {return (UInt_t) ((fCalHeadWord[6]>> 8) & 0x000000ff);}
  87     UInt_t GetHdacValue() const {return (Int_t) ((fCalHeadWord[6]) & 0x000000ff);}
  88     UInt_t GetHdacHigh(UInt_t hs) const;
  89     UInt_t GetHdacLow(UInt_t hs) const;
  90     UInt_t GetHTPAmp(UInt_t hs) const;
  91     Bool_t GetHminTHchipPresent(UInt_t chip) const;
  92     // use the methods below to extract the information from the fo calibration header:
  93     UInt_t GetFOHrouterNr() const {return GetHrouterNr();}
  94     UInt_t GetFOHtype() const {return GetHtype();}
  95     UInt_t GetFOHtriggers() const {return GetHtriggers();}
  96     Bool_t GetFOHchipPresent(UInt_t hs, UInt_t chip) const {return GetHchipPresent(hs,chip);}
  97     UInt_t GetFOHglobalDBversion() const {return fCalHeadWord[5];}
  98     UInt_t GetFOHMatrixID() const {return fCalHeadWord[6] & 0x0000000f;}
  99     UInt_t GetFOHpixelCol() const {return (fCalHeadWord[6] >> 20) & 0x0000001f;}
 100     UInt_t GetFOHpixelRow() const {return (fCalHeadWord[6] >> 10) & 0x000000ff;}
 101     UInt_t GetFOHnumDacs() const;
 102     UInt_t GetFOHdacIndex(UInt_t index) const;
 103     UInt_t GetFOHdacValue(UInt_t index) const;
 104     UInt_t GetFOHchipCount(UInt_t hs, UInt_t chip) const;
 105
 106     void   ActivateAdvancedErrorLog(Bool_t activate, AliITSRawStreamSPDErrorLog* advLogger = NULL);
 107     AliITSRawStreamSPDErrorLog* GetAdvancedErrorLog() {return fAdvLogger;}
 108
 109     static const Char_t* GetErrorName(UInt_t errorCode);
 110
 111     enum {kDDLsNumber = 20};      // number of DDLs in SPD
 112     enum {kModulesPerDDL = 12};   // number of modules in each DDL
 113     enum {kCalHeadLenMax = 64};   // maximum number of calib header words
 114     enum ESPDRawStreamError {
 115       kTotal,
 116       kHeaderMissingErr,
 117       kTrailerMissingErr,
 118       kTrailerWithoutHeaderErr,
 119       kHeaderCountErr,
 120       kTrailerCountErr,
 121       kFillUnexpectErr,
 122       kFillMissingErr,
 123       kWrongFillWordErr,
 124       kNumberHitsErr,
 125       kEventCounterErr,
 126       kDDLNumberErr,
 127       kHSNumberErr,
 128       kChipAddrErr,
 129       kCalHeaderLengthErr,
 130       kAdvEventCounterErr,     // used by SPDmood
 131       kAdvEventCounterOrderErr,// used by SPDmood
 132       kTrailerErrorBitErr,
 133       kLinkRxDetectorFatalErr,
 134       kTSMtriggerErr,
 135       kBCdiffErr
 136     };
 137
 138   private :
 139     static const Int_t fgkDDLModuleMap[kDDLsNumber][kModulesPerDDL];  // mapping DDL/module -> module number
 140
 141     Bool_t      ReadNextShort();
 142     Bool_t      ReadNextInt();
 143     void        NewEvent();
 144     void        CheckHeaderAndTrailerCount(Int_t ddlID);
 145
 146     Int_t       fEventCounter;                // chip event counter
 147     Short_t     fEventCounterFull[20][6][10]; // chip event counter
 148
 149     UShort_t    fChipAddr;                    // chip nr
 150     UShort_t    fHalfStaveNr;                 // half stave nr
 151     UInt_t      fCol;                         // chip column nr
 152     UInt_t      fRow;                         // chip row nr
 153     UInt_t      fCalHeadWord[kCalHeadLenMax]; // calibration header words
 154     UInt_t      fCalHeadLen;                  // calibration header length
 155
 156     UShort_t    fData;            // 16 bit data word read
 157     UInt_t      fOffset;          // offset for cell column
 158     UInt_t      fHitCount;        // counter of hits
 159     UChar_t     fDataChar1, fDataChar2, fDataChar3, fDataChar4; // temps part of a 32bit word
 160     Bool_t      fFirstWord;       // keeps track of which of the two 16bit words out of the 32bit word to read when ReadNextShort is called
 161     Bool_t      fCalHeadRead[20];            // calibration header read flags (reset at new event)
 162     UInt_t      fPrevEventId;                // previous event id (needed to know if there is a new event)
 163
 164     UInt_t      fEqPLBytesRead;              // bytes read for current equipment payload
 165     UInt_t      fEqPLChipHeadersRead;        // number of chip headers found in current equipment payload
 166     UInt_t      fEqPLChipTrailersRead;       // number of chip trailers found in current equipment payload
 167     Bool_t      fHeaderOrTrailerReadLast;    // in previous words, was a header (true) or a trailer (false) read last
 168     UInt_t      fExpectedHeaderTrailerCount; // expected number of headers and trailers for the current equipment payload
 169     Bool_t      fFillOutOfSynch;             // has a fill word been put in the wrong place?
 170     Int_t       fDDLID;                      // ddl id
 171     Int_t       fLastDDLID;                  // ddl id for equipment read in previous words
 172
 173     Bool_t      fAdvancedErrorLog;           // is the advanced error logging activated?
 174     AliITSRawStreamSPDErrorLog *fAdvLogger;  // pointer to special error logger object
 175
 176     Bool_t      fFastOrSignal[20][6][10];    // fastor signal bit (one per chip)
 177
 178     Bool_t      fActiveEq[20];               // which equipments are active (found in data)
 179     Bool_t      fActiveHS[20][6];            // which half-staves are active (blockattribute bits)
 180     Bool_t      fActiveChip[20][6][10];      // which chips are active (found in data)
 181
 182     ClassDef(AliITSRawStreamSPD, 0) // class for reading ITS SPD raw digits
 183 };
 184
 185 #endif