[u/mrichter/AliRoot.git] / TRD / AliTRDRawStream.h

#ifndef ALITRDRAWSTREAM_H
#define ALITRDRAWSTREAM_H
/* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
 * See cxx source for full Copyright notice                               */

/* $Id$ */

///////////////////////////////////////////////////////////////////////////////
//                                                                           //
// This class provides access to TRD digits in raw data.                     //
//                                                                           //
///////////////////////////////////////////////////////////////////////////////

#include <TObject.h>

class AliTRDgeometry;
class AliRawReader;
class AliTRDdigitsManager;
class AliTRDdataArrayI;

// Some constants:
const UInt_t endoftrackletmarker = 0xAAAAAAAA; /*This marks the end of tracklet data words*/
const UInt_t endofeventmarker    = 0x00000000; /*This marks the end of half-chamber-data*/

class AliTRDRawStream: public TObject {

  public :

    AliTRDRawStream();
    AliTRDRawStream(AliRawReader *rawReader);
    AliTRDRawStream(AliRawReader *rawReader, AliTRDdigitsManager *man, AliTRDdataArrayI *dig);
    virtual ~AliTRDRawStream();

    virtual Bool_t       Next();              // Next function (for fRawVersion = 0 (Bogdans first version))
    virtual Bool_t       ReadAll();           // Read function (for fRawVersion > 0)

    Int_t                GetDetector() const                        { return fDetector;       };
    Int_t                GetPrevDetector() const                    { return fPrevDetector;   };
    Bool_t               IsNewDetector() const                      { return fDetector != fPrevDetector; };
    Int_t                GetNPads() const                           { return fNPads;          };
    Int_t                GetRow() const                             { return fRow;            };
    Int_t                GetPrevRow() const                         { return fPrevRow;        };
    Bool_t               IsNewRow() const                           { return (fRow != fPrevRow) || IsNewDetector();  };
    Int_t                GetColumn() const                          { return fColumn;         };
    Int_t                GetPrevColumn() const                      { return fPrevColumn;     };
    Bool_t               IsNewColumn() const                        { return (fColumn != fPrevColumn) || IsNewRow(); };
    Int_t                GetTime() const                            { return fTime-1;         };
    Int_t                GetSignal() const                          { return fSignal;         };

    enum { kDDLOffset = 0x400 };              // Offset for DDL numbers

    void                 SetDigitsManager(AliTRDdigitsManager *man) { fDigitsManager   = man; };
    void                 SetDigits(AliTRDdataArrayI *dig)           { fDigits          = dig; };

    AliTRDdigitsManager *GetDigitsManager() const                   { return fDigitsManager;  };

    Bool_t               SetRawVersion(Int_t rv);
    Int_t                GetRawVersion() const                      { return fRawVersion;     };

    // Get Filter settings:
    Int_t                TRAPfilterTCon() const                     { return fTCon;           };
    Int_t                TRAPfilterPEDon() const                    { return fPEDon;          };
    Int_t                TRAPfilterGAINon() const                   { return fGAINon;         };
    Int_t                TRAPsendsFilterdData() const               { return fFiltered;       };

    // Get Tracklet parameters:
    Float_t              GetTrackletPID() const                     { return fTracklPID;      };
    Float_t              GetTrackletDeflLength() const              { return fTracklDefL;     };
    Float_t              GetTrackletPadPos() const                  { return fTracklPadPos;   };
    Int_t                getTrackletPadRow() const                  { return fTracklPadRow;   };

    // Check if the link has optical power (HC sends data)
    Bool_t               IsGTULinkActive(Int_t sm, Int_t la, Int_t sta, Int_t side)
      { return ( ((fGTUlinkMask[sm][sta]) >> (2*la+side)) & 0x1 ); };


  private :

    Int_t    fSig[3];                         //  Signals in the three time bins from Data Word
    Int_t    fADC;                            //  MCM ADC channel and Time Bin of word 1
    Int_t    fTB;                             //  MCM ADC channel and Time Bin of word 1
    Int_t    fEv;                             //  MCM Event number and position of current MCM on TRD chamber
    Int_t    fROB;                            //  MCM Event number and position of current MCM on TRD chamber
    Int_t    fMCM;                            //  MCM Event number and position of current MCM on TRD chamber
    Int_t    fSM;                             //  Position of CURRENT half chamber in full TRD
    Int_t    fLAYER;                          //  Position of CURRENT half chamber in full TRD
    Int_t    fSTACK;                          //  Position of CURRENT half chamber in full TRD
    Int_t    fROC;                            //  Position of CURRENT half chamber in full TRD
    Int_t    fSIDE;                           //  Position of CURRENT half chamber in full TRD
    Int_t    fDCS;                            //  DCS board number read from data (HC header)
    Int_t    fROW;
    Int_t    fCOL;                            //  Detector Pad coordinates

    Int_t    fBCctr;                          //  Counters from HC header (>=V2)
    Int_t    fPTctr;                          //  Counters from HC header (>=V2)
    Int_t    fPTphase;                        //  Counters from HC header (>=V2)
    Int_t    fRVmajor;                        //  Raw version numbers and number of additional HC headerwords (>=V2)
    Int_t    fRVminor;                        //  Raw version numbers and number of additional HC headerwords (>=V2)
    Int_t    fHCHWords;                       //  Raw version numbers and number of additional HC headerwords (>=V2)
    Int_t    fTBins;                          //  Number of time bins read from HC header (>=V2)
    Int_t    fTCon;                           //  Filter settings read from HC header (>=V2)
    Int_t    fPEDon;                          //  Filter settings read from HC header (>=V2)
    Int_t    fGAINon;                         //  Filter settings read from HC header (>=V2)
    Int_t    fFiltered;                       //  Filter settings read from HC header (>=V2)

    Int_t    fHCHctr1;                        //  HC and MCM Header counter
    Int_t    fHCHctr2;                        //  HC and MCM Header counter
    Int_t    fMCMHctr1;                       //  HC and MCM Header counter
    Int_t    fMCMHctr2;                       //  HC and MCM Header counter
    Int_t    fGTUctr1;                        //  GTU LinkMask Counter
    Int_t    fGTUctr2;                        //  GTU LinkMask Counter

    Float_t  fTracklPID;                      //  Tracklet parameters
    Float_t  fTracklDefL;                     //  Tracklet parameters
    Float_t  fTracklPadPos;                   //  Tracklet parameters
    Int_t    fTracklPadRow;                   //  Tracklet parameters

    UShort_t fGTUlinkMask[18][5];             //  Mask with active links

    AliTRDRawStream(const AliTRDRawStream &stream);
    AliTRDRawStream &operator=(const AliTRDRawStream &stream);

    AliRawReader *fRawReader;              //  Object for reading the raw data

    // The following is used for v0:
    Int_t    fCount;                       //  Counter of bytes to be read for current detector
    Int_t    fDetector;                    //  Index of current detector
    Int_t    fPrevDetector;                //  Index of previous detector
    Int_t    fNPads;                       //  Number of active pads
    Int_t    fRow;                         //  Index of current pad row
    Int_t    fPrevRow;                     //  Index of previous pad row
    Int_t    fColumn;                      //  Index of current pad column
    Int_t    fPrevColumn;                  //  Index of previous pad column
    Int_t    fTime;                        //  Index of current time bin
    Int_t    fSignal;                      //  Signal in ADC counts

    // This is again new:
    Int_t    fRawVersion;                  //  Which version of raw data decoding is used
    UInt_t   fDataWord;                    //  The current 32 bit data word
    Int_t    fStatus;                      //  Status of Raw data Reading

    Int_t    fRowMax;                      //  Maximum number of pad rows and columns
    Int_t    fColMax;                      //  Maximum number of pad rows and columns
    Bool_t   fChamberDone[540];            //  Chamber was processed already?

 protected:

    AliTRDgeometry *fGeo;                  //  TRD geometry

    AliTRDdigitsManager *fDigitsManager;   //! Manager for the output digits
    AliTRDdataArrayI    *fDigits;          //! Output digits
    AliTRDdataArrayI    *fTrack0;          //! Track dictionary
    AliTRDdataArrayI    *fTrack1;          //! Track dictionary
    AliTRDdataArrayI    *fTrack2;          //! Track dictionary

    void  DecodeHCheader(Int_t timeBins);
    void  DecodeHCheaderV1();              // Valid for fRawversion = 1
    void  DecodeHCheaderV2(Int_t imeBins); // Valid for fRawversion = 2,3,4

    void  DecodeMCMheader();
    void  DecodeMCMheaderV1();             // Valid for fRawversion = 1,2,3,4

    void  DecodeTracklet();
    void  DecodeTrackletV1();              // Valid for fRawversion = 1,2,3,4

    void  DecodeGTUlinkMask();
    void  DecodeGTUlinkMaskV1();           // Valid for fRawversion = 1,2,3,4

    ClassDef(AliTRDRawStream, 2)           // Class for reading TRD raw digits

};
#endif
Commit	Line	Data
b864d801	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	///////////////////////////////////////////////////////////////////////////////
2745a409	9	// //
	10	// This class provides access to TRD digits in raw data. //
	11	// //
b864d801	12	///////////////////////////////////////////////////////////////////////////////
	13
	14	#include <TObject.h>
	15
7925de54	16	class AliTRDgeometry;
b864d801	17	class AliRawReader;
7925de54	18	class AliTRDdigitsManager;
	19	class AliTRDdataArrayI;
	20
	21	// Some constants:
41235089	22	const UInt_t endoftrackletmarker = 0xAAAAAAAA; /This marks the end of tracklet data words/
41235089	23	const UInt_t endofeventmarker = 0x00000000; /This marks the end of half-chamber-data/
b864d801	24
b864d801	25	class AliTRDRawStream: public TObject {
2745a409	26
b864d801	27	public :
2745a409	28
2745a409	29	AliTRDRawStream();
7925de54	30	AliTRDRawStream(AliRawReader *rawReader);
7925de54	31	AliTRDRawStream(AliRawReader rawReader, AliTRDdigitsManager man, AliTRDdataArrayI *dig);
b864d801	32	virtual ~AliTRDRawStream();
b864d801	33
7925de54	34	virtual Bool_t Next(); // Next function (for fRawVersion = 0 (Bogdans first version))
	35	virtual Bool_t ReadAll(); // Read function (for fRawVersion > 0)
	36
	37	Int_t GetDetector() const { return fDetector; };
	38	Int_t GetPrevDetector() const { return fPrevDetector; };
	39	Bool_t IsNewDetector() const { return fDetector != fPrevDetector; };
	40	Int_t GetNPads() const { return fNPads; };
	41	Int_t GetRow() const { return fRow; };
	42	Int_t GetPrevRow() const { return fPrevRow; };
	43	Bool_t IsNewRow() const { return (fRow != fPrevRow) \|\| IsNewDetector(); };
	44	Int_t GetColumn() const { return fColumn; };
	45	Int_t GetPrevColumn() const { return fPrevColumn; };
	46	Bool_t IsNewColumn() const { return (fColumn != fPrevColumn) \|\| IsNewRow(); };
	47	Int_t GetTime() const { return fTime-1; };
	48	Int_t GetSignal() const { return fSignal; };
	49
	50	enum { kDDLOffset = 0x400 }; // Offset for DDL numbers
	51
	52	void SetDigitsManager(AliTRDdigitsManager *man) { fDigitsManager = man; };
	53	void SetDigits(AliTRDdataArrayI *dig) { fDigits = dig; };
	54
	55	AliTRDdigitsManager *GetDigitsManager() const { return fDigitsManager; };
	56
	57	Bool_t SetRawVersion(Int_t rv);
	58	Int_t GetRawVersion() const { return fRawVersion; };
	59
41235089	60	// Get Filter settings:
	61	Int_t TRAPfilterTCon() const { return fTCon; };
	62	Int_t TRAPfilterPEDon() const { return fPEDon; };
	63	Int_t TRAPfilterGAINon() const { return fGAINon; };
	64	Int_t TRAPsendsFilterdData() const { return fFiltered; };
	65
	66	// Get Tracklet parameters:
	67	Float_t GetTrackletPID() const { return fTracklPID; };
	68	Float_t GetTrackletDeflLength() const { return fTracklDefL; };
	69	Float_t GetTrackletPadPos() const { return fTracklPadPos; };
	70	Int_t getTrackletPadRow() const { return fTracklPadRow; };
	71
7925de54	72	// Check if the link has optical power (HC sends data)
7925de54	73	Bool_t IsGTULinkActive(Int_t sm, Int_t la, Int_t sta, Int_t side)
41235089	74	{ return ( ((fGTUlinkMask[sm][sta]) >> (2*la+side)) & 0x1 ); };
41235089	75
7925de54	76
41235089	77	private :
7925de54	78
	79	Int_t fSig[3]; // Signals in the three time bins from Data Word
	80	Int_t fADC; // MCM ADC channel and Time Bin of word 1
	81	Int_t fTB; // MCM ADC channel and Time Bin of word 1
	82	Int_t fEv; // MCM Event number and position of current MCM on TRD chamber
	83	Int_t fROB; // MCM Event number and position of current MCM on TRD chamber
	84	Int_t fMCM; // MCM Event number and position of current MCM on TRD chamber
	85	Int_t fSM; // Position of CURRENT half chamber in full TRD
	86	Int_t fLAYER; // Position of CURRENT half chamber in full TRD
	87	Int_t fSTACK; // Position of CURRENT half chamber in full TRD
	88	Int_t fROC; // Position of CURRENT half chamber in full TRD
	89	Int_t fSIDE; // Position of CURRENT half chamber in full TRD
	90	Int_t fDCS; // DCS board number read from data (HC header)
	91	Int_t fROW;
	92	Int_t fCOL; // Detector Pad coordinates
	93
	94	Int_t fBCctr; // Counters from HC header (>=V2)
	95	Int_t fPTctr; // Counters from HC header (>=V2)
	96	Int_t fPTphase; // Counters from HC header (>=V2)
	97	Int_t fRVmajor; // Raw version numbers and number of additional HC headerwords (>=V2)
	98	Int_t fRVminor; // Raw version numbers and number of additional HC headerwords (>=V2)
	99	Int_t fHCHWords; // Raw version numbers and number of additional HC headerwords (>=V2)
	100	Int_t fTBins; // Number of time bins read from HC header (>=V2)
	101	Int_t fTCon; // Filter settings read from HC header (>=V2)
	102	Int_t fPEDon; // Filter settings read from HC header (>=V2)
	103	Int_t fGAINon; // Filter settings read from HC header (>=V2)
	104	Int_t fFiltered; // Filter settings read from HC header (>=V2)
	105
	106	Int_t fHCHctr1; // HC and MCM Header counter
	107	Int_t fHCHctr2; // HC and MCM Header counter
	108	Int_t fMCMHctr1; // HC and MCM Header counter
	109	Int_t fMCMHctr2; // HC and MCM Header counter
	110	Int_t fGTUctr1; // GTU LinkMask Counter
	111	Int_t fGTUctr2; // GTU LinkMask Counter
	112
	113	Float_t fTracklPID; // Tracklet parameters
	114	Float_t fTracklDefL; // Tracklet parameters
	115	Float_t fTracklPadPos; // Tracklet parameters
	116	Int_t fTracklPadRow; // Tracklet parameters
	117
	118	UShort_t fGTUlinkMask[18][5]; // Mask with active links
b864d801	119
2745a409	120	AliTRDRawStream(const AliTRDRawStream &stream);
	121	AliTRDRawStream &operator=(const AliTRDRawStream &stream);
	122
7925de54	123	AliRawReader *fRawReader; // Object for reading the raw data
2745a409	124
41235089	125	// The following is used for v0:
7925de54	126	Int_t fCount; // Counter of bytes to be read for current detector
	127	Int_t fDetector; // Index of current detector
	128	Int_t fPrevDetector; // Index of previous detector
	129	Int_t fNPads; // Number of active pads
	130	Int_t fRow; // Index of current pad row
	131	Int_t fPrevRow; // Index of previous pad row
	132	Int_t fColumn; // Index of current pad column
	133	Int_t fPrevColumn; // Index of previous pad column
	134	Int_t fTime; // Index of current time bin
	135	Int_t fSignal; // Signal in ADC counts
b864d801	136
7925de54	137	// This is again new:
	138	Int_t fRawVersion; // Which version of raw data decoding is used
	139	UInt_t fDataWord; // The current 32 bit data word
	140	Int_t fStatus; // Status of Raw data Reading
b864d801	141
7925de54	142	Int_t fRowMax; // Maximum number of pad rows and columns
	143	Int_t fColMax; // Maximum number of pad rows and columns
	144	Bool_t fChamberDone[540]; // Chamber was processed already?
b864d801	145
7925de54	146	protected:
	147
	148	AliTRDgeometry *fGeo; // TRD geometry
	149
	150	AliTRDdigitsManager *fDigitsManager; //! Manager for the output digits
41235089	151	AliTRDdataArrayI *fDigits; //! Output digits
	152	AliTRDdataArrayI *fTrack0; //! Track dictionary
	153	AliTRDdataArrayI *fTrack1; //! Track dictionary
	154	AliTRDdataArrayI *fTrack2; //! Track dictionary
b864d801	155
7925de54	156	void DecodeHCheader(Int_t timeBins);
	157	void DecodeHCheaderV1(); // Valid for fRawversion = 1
	158	void DecodeHCheaderV2(Int_t imeBins); // Valid for fRawversion = 2,3,4
	159
	160	void DecodeMCMheader();
	161	void DecodeMCMheaderV1(); // Valid for fRawversion = 1,2,3,4
	162
	163	void DecodeTracklet();
	164	void DecodeTrackletV1(); // Valid for fRawversion = 1,2,3,4
	165
	166	void DecodeGTUlinkMask();
	167	void DecodeGTUlinkMaskV1(); // Valid for fRawversion = 1,2,3,4
	168
	169	ClassDef(AliTRDRawStream, 2) // Class for reading TRD raw digits
	170
	171	};
b864d801	172	#endif