]>
Commit | Line | Data |
---|---|---|
f8e5b5a0 | 1 | #ifndef ALIALTRORAWSTREAMV3_H |
2 | #define ALIALTRORAWSTREAMV3_H | |
3 | /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. * | |
4 | * See cxx source for full Copyright notice */ | |
5 | ||
6 | /////////////////////////////////////////////////////////////////////////////// | |
7 | /// | |
8 | /// This is a base class for reading raw data digits in Altro format. | |
9 | /// The class is able to read the RCU v3 and above formats. | |
10 | /// The main difference between the format V3 and older ones is in | |
11 | /// the coding of the 10-bit Altro payload words. In V3 3 10-bit words | |
12 | /// are coded in one 32-bit word. The bits 30 and 31 are used to identify | |
13 | /// the payload, altro header and RCU trailer contents. | |
14 | /// | |
15 | /// | |
16 | /// cvetan.cheshkov@cern.ch 1/04/2009 | |
17 | /////////////////////////////////////////////////////////////////////////////// | |
18 | ||
19 | #include <TObject.h> | |
20 | ||
21 | class AliRawReader; | |
22 | ||
23 | class AliAltroRawStreamV3: public TObject { | |
24 | public : | |
25 | AliAltroRawStreamV3(AliRawReader* rawReader); | |
26 | virtual ~AliAltroRawStreamV3(); | |
27 | ||
28 | AliAltroRawStreamV3& operator = (const AliAltroRawStreamV3& stream); | |
29 | AliAltroRawStreamV3(const AliAltroRawStreamV3& stream); | |
30 | ||
31 | void SelectRawData(Int_t detId); // Select raw data for specific detector id | |
32 | void SelectRawData(const char *detName); // Select raw data for specific detector name | |
33 | ||
34 | virtual void Reset(); // Reset the raw-stream object | |
35 | ||
36 | virtual Bool_t NextDDL(); // Iterate over DDLs/RCUs | |
37 | virtual Bool_t NextChannel(); // Iterate over altro channels | |
38 | virtual Bool_t NextBunch(); // Iterate over altro bunches | |
39 | ||
40 | Int_t GetDDLNumber() const { return fDDLNumber; } // Provide current DDL number | |
41 | Int_t GetHWAddress() const { return fHWAddress; } // Provide current hardware address | |
42 | Int_t GetRCUId() const { return fRCUId; } // Provide current RCU identifier | |
43 | ||
44 | UInt_t GetStartTimeBin() const { return fStartTimeBin; } // Provide the index if the first time-bin in current bunch | |
6d4dd848 | 45 | UInt_t GetEndTimeBin() const { return fStartTimeBin-fBunchLength+1; } // Provide the index of the last time-bin in current bunch |
f8e5b5a0 | 46 | Int_t GetBunchLength() const { return fBunchLength; } // Provide the current bunch length |
6d4dd848 | 47 | const UShort_t* GetSignals() const { return fBunchDataPointer; } // Provide access to altro data itself |
f8e5b5a0 | 48 | Bool_t IsChannelBad() const { return fBadChannel; } // Is the channel data bad or not |
49 | ||
50 | ||
51 | Int_t GetBranch() const; // Provide the branch index for the current hardware address | |
52 | Int_t GetFEC() const; // Provide the front-end card index for the current hardware address | |
53 | Int_t GetAltro() const; // Provide the altro chip index for the current hardware address | |
54 | Int_t GetChannel() const; // Provide the channel index for the current hardware address | |
55 | ||
56 | Bool_t GetRCUTrailerData(UChar_t*& data) const; // Provide a pointer to RCU trailer | |
57 | Int_t GetRCUTrailerSize() const { return fRCUTrailerSize; } // Provide size of RCU trailer | |
58 | ||
59 | // RCU trailer related getters | |
60 | UInt_t GetFECERRA() const { return fFECERRA; } | |
61 | UInt_t GetFECERRB() const { return fFECERRB; } | |
62 | UShort_t GetERRREG2() const { return fERRREG2; } | |
63 | UShort_t GetNChAddrMismatch() const { return fERRREG3; } | |
64 | UShort_t GetNChLengthMismatch() const { return fERRREG4; } | |
65 | ||
66 | UShort_t GetActiveFECsA() const { return fActiveFECsA; } | |
67 | UShort_t GetActiveFECsB() const { return fActiveFECsB; } | |
68 | ||
69 | UInt_t GetAltroCFG1() const { return fAltroCFG1; } | |
70 | UChar_t GetBaselineCorr() const { return fAltroCFG1 & 0xF; } | |
71 | Bool_t GetPolarity() const { return (fAltroCFG1 >> 4) & 0x1; } | |
72 | UChar_t GetNPresamples() const { return (fAltroCFG1 >> 5) & 0x3; } | |
73 | UChar_t GetNPostsamples() const { return (fAltroCFG1 >> 7) & 0xF; } | |
74 | Bool_t GetSecondBaselineCorr() const { return (fAltroCFG1 >> 11) & 0x1; } | |
75 | UChar_t GetGlitchFilter() const { return (fAltroCFG1 >> 12) & 0x3; } | |
76 | UChar_t GetNNonZSPostsamples() const { return (fAltroCFG1 >> 14) & 0x7; } | |
77 | UChar_t GetNNonZSPresamples() const { return (fAltroCFG1 >> 17) & 0x3; } | |
78 | Bool_t GetZeroSupp() const { return (fAltroCFG1 >> 19) & 0x1; } | |
79 | ||
80 | UInt_t GetAltroCFG2() const { return fAltroCFG2; } | |
81 | Bool_t GetNAltroBuffers() const { return (fAltroCFG2 >> 24) & 0x1; } | |
82 | UChar_t GetNPretriggerSamples() const{ return (fAltroCFG2 >> 20) & 0xF; } | |
83 | UShort_t GetNSamplesPerCh() const { return (fAltroCFG2 >> 10) & 0x3FF; } | |
84 | Bool_t GetSparseRO() const { return (fAltroCFG2 >> 9) & 0x1; } | |
85 | Double_t GetTSample() const; | |
86 | Double_t GetL1Phase() const; | |
87 | void PrintRCUTrailer() const; | |
88 | ||
89 | void SetShortDataHeader(Bool_t flag) { fIsShortDataHeader = flag; } // Specify whenever to assume or not a short CDH format | |
90 | ||
91 | enum EAltroRawStreamV3Error { | |
92 | kRCUTrailerErr = 1, | |
93 | kRCUVerErr = 2, | |
94 | kRCUTrailerSizeErr = 3, | |
95 | kAltroBunchHeadErr = 4, | |
96 | kBunchLengthErr = 5, | |
97 | kAltroPayloadErr = 6, | |
98 | kBadAltroMapping = 7 | |
99 | }; | |
100 | ||
101 | enum {kMaxNTimeBins = 1024}; | |
102 | ||
103 | protected: | |
104 | ||
105 | void AddMappingErrorLog(const char *message = NULL); | |
106 | ||
107 | Bool_t fIsShortDataHeader; // flag used to select between normal and short CDH format | |
108 | ||
109 | private: | |
110 | ||
111 | UInt_t Get32bitWord(Int_t index) const; | |
112 | Bool_t ReadRCUTrailer(UChar_t rcuVer); | |
113 | ||
114 | Int_t fDDLNumber; // index of current DDL number | |
115 | Int_t fRCUId; // current RCU identifier | |
116 | Short_t fHWAddress; // current hardware address | |
117 | ||
118 | AliRawReader* fRawReader; // object for reading the raw data | |
119 | ||
120 | UChar_t* fData; // raw data | |
121 | ||
122 | Int_t fPosition; // current position (32-bit words) in fData | |
123 | Int_t fCount; // | |
124 | Int_t fStartTimeBin; // | |
125 | Int_t fBunchLength; // | |
126 | ||
127 | Bool_t fBadChannel; // | |
128 | Int_t fPayloadSize; // | |
129 | ||
6d4dd848 | 130 | UShort_t fBunchData[kMaxNTimeBins]; // cache for the decoded altro payload |
131 | UShort_t* fBunchDataPointer; // pointer to the current bunch samples | |
132 | Int_t fBunchDataIndex; // current position in the payload | |
f8e5b5a0 | 133 | |
134 | UChar_t* fRCUTrailerData; // pointer to RCU trailer data | |
135 | Int_t fRCUTrailerSize; // size of RCU trailer data in bytes | |
136 | ||
137 | // RCU trailer contents | |
138 | UInt_t fFECERRA; // contains errors related to ALTROBUS transactions | |
139 | UInt_t fFECERRB; // contains errors related to ALTROBUS transactions | |
140 | UShort_t fERRREG2; // contains errors related to ALTROBUS transactions or trailer of ALTRO channel block | |
141 | UShort_t fERRREG3; // contains number of altro channels skipped due to an address mismatch | |
142 | UShort_t fERRREG4; // contains number of altro channels skipped due to a block length mismatch | |
143 | UShort_t fActiveFECsA; // bit pattern of active FECs in branch A | |
144 | UShort_t fActiveFECsB; // bit pattern of active FECs in branch B | |
145 | UInt_t fAltroCFG1; // ALTROCFG1 register | |
146 | UInt_t fAltroCFG2; // ALTROCFG2 and ALTROIF registers | |
147 | ||
148 | ClassDef(AliAltroRawStreamV3, 0) // base class for reading Altro raw digits | |
149 | }; | |
150 | ||
151 | #endif |