/data/refman/pasoursint/CMSSW_6_1_2_SLHC2/src/EventFilter/CastorRawToDigi/interface/CastorCTDCHeader.h

Go to the documentation of this file.

/* -*- C++ -*- */
#ifndef CastorCTDCHeader_H
#define CastorCTDCHeader_H

#include <iostream>
class CastorCORData;
class CastorMergerData;

class CastorCTDCHeader {
 public:
  static const int SPIGOT_COUNT;

  CastorCTDCHeader();

  unsigned int getTotalLengthBytes() const; 


  inline bool thereIsASecondCDFHeaderWord() const {return ((commondataformat0>>3) & 0x0001); }
  inline short getCDFversionNumber() const {return ((commondataformat0>>4) & 0x0F); }
  inline int getSourceId() const { return (commondataformat0>>8)&0xFFF; }
  inline int getBunchId() const { return (commondataformat0>>20)&0xFFF; }
  inline unsigned long getDCCEventNumber() const { return (commondataformat1 & 0x00FFFFFF); }
  inline unsigned short getCDFEventType() const { return ( (commondataformat1>>24) & 0x0F ); }
  inline unsigned short BOEshouldBe5Always() const { return ( (commondataformat1>>28) & 0x0F ); }


  inline bool thereIsAThirdCDFHeaderWord() const {return ((commondataformat2>>3) & 0x0001); }
  inline unsigned int getOrbitNumber() const { return (commondataformat2>>4); }
  inline unsigned int getSlink64ReservedBits() const { return (  (commondataformat3>>4)&0x00FFFFFF ); }
  inline short BOEshouldBeZeroAlways() const { return ( (commondataformat3>>28) & 0x0F); }

  inline short getDCCDataFormatVersion() const { return (ctdch0 & 0xFF); }
  inline int getAcceptTimeTTS() const { return ((ctdch0>>8)& 0x0000000F); }
  inline int getByte1Zeroes() const {  return ((ctdch0>>12)& 0x00000003); }
  inline int getHTRStatusBits () const { return ((ctdch0>>14)& 0x00007FFF); }
  inline int getByte3Zeroes() const {  return ((ctdch0>>29)& 0x00000007); }
  inline int getDCCStatus() const {return (ctdch1 & 0x000003FF);}
  inline int getByte567Zeroes() const {  return (ctdch1 & 0xFF00FC00); }

  inline bool getSpigotErrorFlag(int nspigot) const { 
    return (( ctdch0>>(14+nspigot) )&0x0001);  }

  inline bool SawTTS_OFW()        const { return ((getDCCStatus()>>0) & 0x00000001);}
  inline bool SawTTS_BSY()        const { return ((getDCCStatus()>>1) & 0x00000001);}
  inline bool SawTTS_SYN()        const { return ((getDCCStatus()>>2) & 0x00000001);}
  inline bool SawL1A_EvN_MxMx()   const { return ((getDCCStatus()>>3) & 0x00000001);}
  inline bool SawL1A_BcN_MxMx()   const { return ((getDCCStatus()>>4) & 0x00000001);}
  inline bool SawCT_EvN_MxMx()    const { return ((getDCCStatus()>>5) & 0x00000001);}
  inline bool SawCT_BcN_MxMx()    const { return ((getDCCStatus()>>6) & 0x00000001);}
  inline bool SawOrbitLengthErr() const { return ((getDCCStatus()>>7) & 0x00000001);}
  inline bool SawTTC_SingErr()    const { return ((getDCCStatus()>>8) & 0x00000001);}
  inline bool SawTTC_DoubErr()    const { return ((getDCCStatus()>>9) & 0x00000001);}

  inline int getSpigotSummary(int nspigot) const { return spigotInfo[nspigot]; }

  int getSpigotData(int nspigot, CastorCORData& decodeTool, int validSize) const;

  inline unsigned int getSpigotDataLength(int nspigot) const { return (nspigot>=3)?(0):(spigotInfo[nspigot]&0x3ff); }

  inline bool getSpigotEnabled(unsigned int nspigot) const { return (nspigot>=3)?(false):(spigotInfo[nspigot]&0x8000); }
  inline bool getSpigotPresent(unsigned int nspigot) const { return (nspigot>=3)?(false):(spigotInfo[nspigot]&0x4000); }
  inline bool getBxMismatchWithDCC(unsigned int nspigot) const { return (nspigot>=3)?(false):(spigotInfo[nspigot]&0x2000); }
  inline bool getSpigotValid(unsigned int nspigot) const { return (nspigot>=3)?(false):(spigotInfo[nspigot]&0x1000); }
  inline bool getSpigotDataTruncated(unsigned int nspigot) const { return (nspigot>=3)?(false):(spigotInfo[nspigot]&0x0800); }
  inline bool getSpigotCRCError(unsigned int nspigot) const { return (nspigot>=3)?(false):(spigotInfo[nspigot]&0x0400); }
  inline unsigned char getSpigotErrorBits(unsigned int nspigot) const { return (nspigot>=3)?(0):((unsigned char)(spigotInfo[nspigot]>>24)); }
  inline unsigned char getLRBErrorBits(unsigned int nspigot) const { return (nspigot>=3)?(0):((unsigned char)(spigotInfo[nspigot]>>16)); }

  /* (for packing only) */
  void copySpigotData(unsigned int spigot_id, const CastorCORData& data, bool valid=true, unsigned char LRB_error_word=0);

  void copyMergerData(const CastorMergerData& data, bool valid) ;

  void clear();
  void setHeader(int sourceid, int bcn, int l1aN, int orbN);

 private:
  // CURRENTLY VALID FOR LITTLE-ENDIAN (LINUX/x86) ONLY
  unsigned int commondataformat0;
  unsigned int commondataformat1;
  unsigned int commondataformat2;
  unsigned int commondataformat3;
  unsigned int ctdch0;
  unsigned int ctdch1;
  unsigned int spigotInfo[4];   //The last of these 32bit words should be "end header pattern"

};

std::ostream& operator<<(std::ostream&, const CastorCTDCHeader& head);

#endif