///////////////////////////////////////////////////////////////////////////////
///
/// This is a base class for reading raw data digits in Altro format
+/// The class is able to read both old and new RCU trailer formats
+/// Switch between formats is done automatically using the last payload word.
+/// In case the Common Data Header is 7 32-bit words long, one
+/// can use the fIsShortDataHeader flag.
///
///////////////////////////////////////////////////////////////////////////////
class AliRawReader;
-
class AliAltroRawStream: public TObject {
public :
AliAltroRawStream(AliRawReader* rawReader);
virtual ~AliAltroRawStream();
- virtual Bool_t Next();
+ virtual void Reset();
+ virtual Bool_t Next();
+
+ virtual Bool_t NextDDL(UChar_t* data = NULL); // Iterate over DDLs/RCUs
+ virtual Bool_t NextChannel(); // Iterate over altro channels
+ virtual Bool_t NextBunch(UShort_t *bunchData,
+ Int_t &bunchLength,
+ Int_t &startTimeBin); // Iterate over altro bunches
+
+ Int_t GetDDLNumber() const { return fDDLNumber; } // Provide current DDL number
+ Int_t GetPrevDDLNumber() const { return fPrevDDLNumber; }// Provide previous DDL number
+ Bool_t IsNewDDLNumber() const {return (fDDLNumber != fPrevDDLNumber);};
+ Int_t GetRCUId() const { return fRCUId; } // Provide current RCU identifier
+ Int_t GetPrevRCUId() const { return fPrevRCUId; } // Provide previous RCU identifier
+ Bool_t IsNewRCUId() const {return (fRCUId != fPrevRCUId);};
+ Int_t GetHWAddress() const { return fHWAddress; } // Provide current hardware address
+ Int_t GetPrevHWAddress() const { return fPrevHWAddress; } // Provide previous hardware address
+ Bool_t IsNewHWAddress() const {return (fHWAddress != fPrevHWAddress) || IsNewDDLNumber();};
+ Int_t GetTime() const { return fTime; } // Provide index of current time bin
+ Int_t GetPrevTime() const { return fPrevTime; } // Provide index of previous time bin
+ Bool_t IsNewTime() const {return (fTime != fPrevTime) || IsNewHWAddress();};
+ Int_t GetSignal() const { return fSignal; } // Provide signal in ADC counts
+ Int_t GetTimeLength() const { return fTimeBunch; } // Provide total length of current time bunch
+
+ Int_t GetChannelPayloadSize() const { return fChannelPayloadSize; }
+ Int_t GetRCUPayloadSizeInSOD() const;
+
+ Int_t GetBranch() const; // Provide the branch index for the current hardware address
+ Int_t GetFEC() const; // Provide the front-end card index for the current hardware address
+ Int_t GetAltro() const; // Provide the altro chip index for the current hardware address
+ Int_t GetChannel() const; // Provide the channel index for the current hardware address
+
+ Bool_t GetRCUTrailerData(UChar_t*& data) const; // Provide a pointer to RCU trailer
+ Int_t GetRCUTrailerSize() const { return fRCUTrailerSize; } // Provide size of RCU trailer
+
+ // RCU trailer related getters
+ UInt_t GetFECERRA() const { return fFECERRA; }
+ UInt_t GetFECERRB() const { return fFECERRB; }
+ UShort_t GetERRREG2() const { return fERRREG2; }
+ UShort_t GetNChAddrMismatch() const { return fERRREG3; }
+ UShort_t GetNChLengthMismatch() const { return fERRREG4; }
+
+ UShort_t GetActiveFECsA() const { return fActiveFECsA; }
+ UShort_t GetActiveFECsB() const { return fActiveFECsB; }
+
+ UInt_t GetAltroCFG1() const { return fAltroCFG1; }
+ UChar_t GetBaselineCorr() const { return fAltroCFG1 & 0xF; }
+ Bool_t GetPolarity() const { return (fAltroCFG1 >> 4) & 0x1; }
+ UChar_t GetNPresamples() const { return (fAltroCFG1 >> 5) & 0x3; }
+ UChar_t GetNPostsamples() const { return (fAltroCFG1 >> 7) & 0xF; }
+ Bool_t GetSecondBaselineCorr() const { return (fAltroCFG1 >> 11) & 0x1; }
+ UChar_t GetGlitchFilter() const { return (fAltroCFG1 >> 12) & 0x3; }
+ UChar_t GetNNonZSPostsamples() const { return (fAltroCFG1 >> 14) & 0x7; }
+ UChar_t GetNNonZSPresamples() const { return (fAltroCFG1 >> 17) & 0x3; }
+ Bool_t GetZeroSupp() const { return (fAltroCFG1 >> 19) & 0x1; }
+
+ UInt_t GetAltroCFG2() const { return fAltroCFG2; }
+ Bool_t GetNAltroBuffers() const { return (fAltroCFG2 >> 24) & 0x1; }
+ UChar_t GetNPretriggerSamples() const{ return (fAltroCFG2 >> 20) & 0xF; }
+ UShort_t GetNSamplesPerCh() const { return (fAltroCFG2 >> 10) & 0x3FF; }
+ Bool_t GetSparseRO() const { return (fAltroCFG2 >> 9) & 0x1; }
+ Double_t GetTSample() const;
+ Double_t GetL1Phase() const;
+ void PrintRCUTrailer() const;
+
+ void SelectRawData(Int_t detId); // Select raw data for specific detector id
+ void SelectRawData(const char *detName); // Select raw data for specific detector name
+
+ void SetShortDataHeader(Bool_t flag) { fIsShortDataHeader = flag; } // Specify whenever to assume or not a short CDH format
+
+ void PrintDebug() const; // Print debug information in case of decoding errors
+ void AddMappingErrorLog(const char *message = NULL);
+
+ enum EAltroRawStreamError {
+ kRCUTrailerSizeErr = 1,
+ kAltroTrailerErr = 2,
+ kBunchLengthReadErr = 3,
+ kTimeBinReadErr = 4,
+ kAmplitudeReadErr = 5,
+ k32bitWordReadErr = 6,
+ kBadAltroMapping = 7,
+ kRCUTrailerErr = 8
+ };
+
+ AliAltroRawStream& operator = (const AliAltroRawStream& stream);
+ AliAltroRawStream(const AliAltroRawStream& stream);
protected:
- Int_t fSector; // index of current sector
- Int_t fPrevSector; // index of previous sector
- Int_t fRow; // index of current row
- Int_t fPrevRow; // index of previous row
- Int_t fPad; // index of current pad
- Int_t fPrevPad; // index of previous pad
+
+ Bool_t fIsShortDataHeader; // flag used to select between normal and short CDH format
+
+ private :
+
+ UShort_t GetNextWord();
+ Bool_t ReadTrailer();
+ void ReadBunch();
+ void ReadAmplitude();
+ Int_t GetPosition();
+ UInt_t Get32bitWord(Int_t &index);
+ Int_t ReadRCUTrailer(Int_t &index, Int_t trailerSize);
+
+ Int_t fDDLNumber; // index of current DDL number
+ Int_t fPrevDDLNumber;// index of previous DDL number
+ Int_t fRCUId; // current RCU identifier
+ Int_t fPrevRCUId; // previous RCU identifier
+ Short_t fHWAddress; // current hardware address
+ Short_t fPrevHWAddress;// previous hardware address
Int_t fTime; // index of current time bin
+ Int_t fPrevTime; // index of previous time bin
Int_t fSignal; // signal in ADC counts
Int_t fTimeBunch; // total length of the current time bunch
AliRawReader* fRawReader; // object for reading the raw data
- private :
- AliAltroRawStream(const AliAltroRawStream& stream);
- AliAltroRawStream& operator = (const AliAltroRawStream& stream);
-
- UShort_t Get10BitWord(UChar_t* buffer, Int_t position) const;
UChar_t* fData; // raw data
+
Int_t fPosition; // current (10 bit) position in fData
Int_t fCount; // counter of words to be read for current trailer
+ Int_t fChannelPayloadSize; //
Int_t fBunchLength; // remaining number of signal bins in the current bunch
+ UChar_t* fRCUTrailerData; // pointer to RCU trailer data
+ Int_t fRCUTrailerSize; // size of RCU trailer data in bytes
+
+ // RCU trailer contents
+ UInt_t fFECERRA; // contains errors related to ALTROBUS transactions
+ UInt_t fFECERRB; // contains errors related to ALTROBUS transactions
+ UShort_t fERRREG2; // contains errors related to ALTROBUS transactions or trailer of ALTRO channel block
+ UShort_t fERRREG3; // contains number of altro channels skipped due to an address mismatch
+ UShort_t fERRREG4; // contains number of altro channels skipped due to a block length mismatch
+ UShort_t fActiveFECsA; // bit pattern of active FECs in branch A
+ UShort_t fActiveFECsB; // bit pattern of active FECs in branch B
+ UInt_t fAltroCFG1; // ALTROCFG1 register
+ UInt_t fAltroCFG2; // ALTROCFG2 and ALTROIF registers
+
ClassDef(AliAltroRawStream, 0) // base class for reading Altro raw digits
};