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 */
6 ///////////////////////////////////////////////////////////////////////////////
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.
16 /// cvetan.cheshkov@cern.ch 1/04/2009
17 ///////////////////////////////////////////////////////////////////////////////
22 class AliAltroRawStream;
24 class AliAltroRawStreamV3: public TObject {
26 AliAltroRawStreamV3(AliRawReader* rawReader);
27 virtual ~AliAltroRawStreamV3();
29 AliAltroRawStreamV3& operator = (const AliAltroRawStreamV3& stream);
30 AliAltroRawStreamV3(const AliAltroRawStreamV3& stream);
32 void SelectRawData(Int_t detId); // Select raw data for specific detector id
33 void SelectRawData(const char *detName); // Select raw data for specific detector name
35 virtual void Reset(); // Reset the raw-stream object
37 virtual Bool_t NextDDL(); // Iterate over DDLs/RCUs
38 virtual Bool_t NextChannel(); // Iterate over altro channels
39 virtual Bool_t NextBunch(); // Iterate over altro bunches
41 Int_t GetDDLNumber() const { return fDDLNumber; } // Provide current DDL number
42 Int_t GetHWAddress() const { return fHWAddress; } // Provide current hardware address
43 Int_t GetRCUId() const { return fRCUId; } // Provide current RCU identifier
45 UInt_t GetStartTimeBin() const { return fStartTimeBin; } // Provide the index if the first time-bin in current bunch
46 UInt_t GetEndTimeBin() const { return fStartTimeBin-fBunchLength+1; } // Provide the index of the last time-bin in current bunch
47 Int_t GetBunchLength() const { return fBunchLength; } // Provide the current bunch length
48 const UShort_t* GetSignals() const { return fBunchDataPointer; } // Provide access to altro data itself
49 Bool_t IsChannelBad() const { return fBadChannel; } // Is the channel data bad or not
51 Int_t GetChannelPayloadSize() const { return fChannelPayloadSize; }
52 UChar_t *GetRCUPayloadInSOD() const;
53 Int_t GetRCUPayloadSizeInSOD() const;
55 Int_t GetBranch() const; // Provide the branch index for the current hardware address
56 Int_t GetFEC() const; // Provide the front-end card index for the current hardware address
57 Int_t GetAltro() const; // Provide the altro chip index for the current hardware address
58 Int_t GetChannel() const; // Provide the channel index for the current hardware address
60 Bool_t GetRCUTrailerData(UChar_t*& data) const; // Provide a pointer to RCU trailer
61 Int_t GetRCUTrailerSize() const { return fRCUTrailerSize; } // Provide size of RCU trailer
63 // RCU trailer related getters
64 UInt_t GetFECERRA() const { return fFECERRA; }
65 UInt_t GetFECERRB() const { return fFECERRB; }
66 UShort_t GetERRREG2() const { return fERRREG2; }
67 UShort_t GetNChAddrMismatch() const { return (fERRREG3 & 0xFFF); }
68 UShort_t GetNChLengthMismatch() const { return ((fERRREG3 >> 12) & 0x1FFF); }
70 UShort_t GetActiveFECsA() const { return fActiveFECsA; }
71 UShort_t GetActiveFECsB() const { return fActiveFECsB; }
73 UInt_t GetAltroCFG1() const { return fAltroCFG1; }
74 UChar_t GetBaselineCorr() const { return fAltroCFG1 & 0xF; }
75 Bool_t GetPolarity() const { return (fAltroCFG1 >> 4) & 0x1; }
76 UChar_t GetNPresamples() const { return (fAltroCFG1 >> 5) & 0x3; }
77 UChar_t GetNPostsamples() const { return (fAltroCFG1 >> 7) & 0xF; }
78 Bool_t GetSecondBaselineCorr() const { return (fAltroCFG1 >> 11) & 0x1; }
79 UChar_t GetGlitchFilter() const { return (fAltroCFG1 >> 12) & 0x3; }
80 UChar_t GetNNonZSPostsamples() const { return (fAltroCFG1 >> 14) & 0x7; }
81 UChar_t GetNNonZSPresamples() const { return (fAltroCFG1 >> 17) & 0x3; }
82 Bool_t GetZeroSupp() const { return (fAltroCFG1 >> 19) & 0x1; }
84 UInt_t GetAltroCFG2() const { return fAltroCFG2; }
85 Bool_t GetNAltroBuffers() const { return (fAltroCFG2 >> 24) & 0x1; }
86 UChar_t GetNPretriggerSamples() const{ return (fAltroCFG2 >> 20) & 0xF; }
87 UShort_t GetNSamplesPerCh() const { return (fAltroCFG2 >> 10) & 0x3FF; }
88 Bool_t GetSparseRO() const { return (fAltroCFG2 >> 9) & 0x1; }
89 Double_t GetTSample() const;
90 Double_t GetL1Phase() const;
91 void PrintRCUTrailer() const;
93 void SetShortDataHeader(Bool_t flag) { fIsShortDataHeader = flag; } // Specify whenever to assume or not a short CDH format
95 void SetCheckAltroPayload(Bool_t check) { fCheckAltroPayload = check; }
97 void HexDumpChannel() const;
99 enum EAltroRawStreamV3Error {
102 kRCUTrailerSizeErr = 3,
103 kAltroBunchHeadErr = 4,
105 kAltroPayloadErr = 6,
109 enum {kMaxNTimeBins = 1024};
113 void AddMappingErrorLog(const char *message = NULL);
115 Bool_t fIsShortDataHeader; // flag used to select between normal and short CDH format
119 UInt_t Get32bitWord(Int_t index) const;
120 Bool_t ReadRCUTrailer(UChar_t rcuVer);
122 Int_t fDDLNumber; // index of current DDL number
123 Int_t fRCUId; // current RCU identifier
124 Short_t fHWAddress; // current hardware address
126 AliRawReader* fRawReader; // object for reading the raw data
128 UChar_t* fData; // raw data
130 Int_t fPosition; // current position (32-bit words) in fData
132 Int_t fStartTimeBin; //
133 Int_t fBunchLength; //
135 Bool_t fBadChannel; //
136 Int_t fPayloadSize; //
138 Int_t fChannelPayloadSize; //
140 UShort_t fBunchData[kMaxNTimeBins]; // cache for the decoded altro payload
141 UShort_t* fBunchDataPointer; // pointer to the current bunch samples
142 Int_t fBunchDataIndex; // current position in the payload
144 UChar_t* fRCUTrailerData; // pointer to RCU trailer data
145 Int_t fRCUTrailerSize; // size of RCU trailer data in bytes
147 // RCU trailer contents
148 UInt_t fFECERRA; // contains errors related to ALTROBUS transactions
149 UInt_t fFECERRB; // contains errors related to ALTROBUS transactions
150 UShort_t fERRREG2; // contains errors related to ALTROBUS transactions or trailer of ALTRO channel block
151 UInt_t fERRREG3; // contains number of altro channels skipped due to an address mismatch
152 UShort_t fActiveFECsA; // bit pattern of active FECs in branch A
153 UShort_t fActiveFECsB; // bit pattern of active FECs in branch B
154 UInt_t fAltroCFG1; // ALTROCFG1 register
155 UInt_t fAltroCFG2; // ALTROCFG2 and ALTROIF registers
157 AliAltroRawStream* fOldStream; // streamer for old altro format
159 Bool_t fCheckAltroPayload; // check altro payload correctness or not?
161 ClassDef(AliAltroRawStreamV3, 0) // base class for reading Altro raw digits