HcalHTRData.h

Go to the documentation of this file.

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

#include <cstdint>

class HcalHTRData {
 public:
  static const int CHANNELS_PER_SPIGOT         = 24;
  static const int MAXIMUM_SAMPLES_PER_CHANNEL = 20;
  static const int FORMAT_VERSION_COMPACT_DATA =  6;
  
  HcalHTRData();
  ~HcalHTRData() { if (m_ownData!=nullptr) delete [] m_ownData; }
  HcalHTRData(int version_to_create);
  HcalHTRData(const unsigned short* data, int length);
  HcalHTRData(const HcalHTRData&);
  
  HcalHTRData& operator=(const HcalHTRData&);
  void allocate(int version_to_create=0);
  void adoptData(const unsigned short* data, int length);
  
  inline int getFormatVersion() const { return m_formatVersion; }
  
  inline const unsigned short* getRawData() const { return m_rawConst; }
  
  inline const int getRawLength() const { return m_rawLength; }
  
  bool check() const;

  bool isEmptyEvent() const;
  bool isOverflowWarning() const;
  bool isBusy() const;

  
  void dataPointers(const unsigned short** daq_first,
            const unsigned short** daq_last,
            const unsigned short** tp_first,
            const unsigned short** tp_last) const;
  
  
  void unpack(unsigned char* daq_lengths, unsigned short* daq_samples,
          unsigned char* tp_lengths, unsigned short* tp_samples) const;
  
  bool unpackHistogram(int fiber, int fiberchan, int capid, unsigned
               short* histogram) const;

  static bool unpack_per_channel_header(unsigned short, int& flav, int& error_flags, int& capid0, int& channelid);
  
  static bool is_channel_header(unsigned short value) { return (value&0x8000)!=0; }

  void pack(unsigned char* daq_lengths, unsigned short* daq_samples,
        unsigned char* tp_lengths, unsigned short* tp_samples, bool
        do_capid=false);
  void packHeaderTrailer(int L1Anumber, int bcn, int submodule, int
             orbitn, int pipeline, int ndd, int nps, int firmwareRev=0,
             int firmwareFlav=0);

  void packUnsuppressed(const bool* mp);
  
  
  inline unsigned int getL1ANumber() const { 
    return (m_rawConst[0]&0xFF)+(m_rawConst[1]<<8); 
  }
  inline unsigned int getBunchNumber() const { 
    return (m_rawConst[4]&0xFFF); 
  }
  unsigned int getOrbitNumber() const;
  unsigned int getSubmodule() const;
  // get the htr slot
  unsigned int htrSlot() const;
  // get the htr top/bottom (1=top/0=bottom)
  unsigned int htrTopBottom() const;
  // get the readout VME crate number
  unsigned int readoutVMECrateId() const;
  bool isCalibrationStream() const;
  bool isUnsuppressed() const;
  bool wasMarkAndPassZS(int fiber, int fiberchan) const;
  bool wasMarkAndPassZSTP(int slb, int slbchan) const;
  uint32_t zsBunchMask() const;
  
  bool isPatternRAMEvent() const;
  bool isHistogramEvent() const;
  void getHistogramFibers(int& a, int& b) const;
  unsigned int getPipelineLength() const;
  unsigned int getFirmwareRevision() const;
  int getFirmwareFlavor() const;
  inline unsigned int getErrorsWord() const { 
    return m_rawConst[2]&0xFFFF; }
  int getNPrecisionWords() const;
  int getNDD() const;
  int getNTP() const;
  int getNPS() const;

  inline unsigned int getDLLunlock() const { 
    return (m_rawConst[5]>>1)&0x3; }

  inline unsigned int getTTCready() const { 
    return m_rawConst[5]&0x1; }

  inline unsigned int getFibOrbMsgBCN(int fiber) const {
    return (m_formatVersion==-1 || fiber<1 || fiber>8)?(0):(m_rawConst[m_rawLength-12+(fiber-1)]&0xFFF);
  }

  inline unsigned int getFib1OrbMsgBCN() const {
  return (m_formatVersion==-1)?(0):(m_rawConst[m_rawLength-12]&0xFFF);
}
  inline unsigned int getFib2OrbMsgBCN() const {
  return (m_formatVersion==-1)?(0):(m_rawConst[m_rawLength-11]&0xFFF);
}

  inline unsigned int getFib3OrbMsgBCN() const {
  return (m_formatVersion==-1)?(0):(m_rawConst[m_rawLength-10]&0xFFF);
}

  inline unsigned int getFib4OrbMsgBCN() const {
  return (m_formatVersion==-1)?(0):(m_rawConst[m_rawLength-9]&0xFFF);
}

  inline unsigned int getFib5OrbMsgBCN() const {
  return (m_formatVersion==-1)?(0):(m_rawConst[m_rawLength-8]&0xFFF);
}

  inline unsigned int getFib6OrbMsgBCN() const {
  return (m_formatVersion==-1)?(0):(m_rawConst[m_rawLength-7]&0xFFF);
}

  inline unsigned int getFib7OrbMsgBCN() const {
  return (m_formatVersion==-1)?(0):(m_rawConst[m_rawLength-6]&0xFFF);
}

  inline unsigned int getFib8OrbMsgBCN() const {
  return (m_formatVersion==-1)?(0):(m_rawConst[m_rawLength-5]&0xFFF);
}



  inline unsigned int getExtHdr1() const { 
    return (m_rawConst[0]);}
  inline unsigned int getExtHdr2() const { 
    return (m_rawConst[1]); }
  inline unsigned int getExtHdr3() const { 
    return (m_rawConst[2]);} 
  inline unsigned int getExtHdr4() const { 
    return (m_rawConst[3]); }
  inline unsigned int getExtHdr5() const { 
    return (m_rawConst[4]);} 
  inline unsigned int getExtHdr6() const { 
    return (m_rawConst[5]);} 
  inline unsigned int getExtHdr7() const { 
    return (m_rawConst[6]);} 
  inline unsigned int getExtHdr8() const { 
    return (m_rawConst[7]);}  

  /* unsigned int getFib1OrbMsgBCN() const;
  unsigned int getFib2OrbMsgBCN() const;
  unsigned int getFib3OrbMsgBCN() const;
  unsigned int getFib4OrbMsgBCN() const;
  unsigned int getFib5OrbMsgBCN() const;
  unsigned int getFib6OrbMsgBCN() const;
  unsigned int getFib7OrbMsgBCN() const;
  unsigned int getFib8OrbMsgBCN() const;
  */

  bool wasHistogramError(int ifiber) const;
  
protected:
  void determineSectionLengths(int& tpWords, int& daqWords, int&
                   headerWords, int& trailerWords) const;
  void determineStaticLengths(int& headerWords, int& trailerWords) const;
  int m_formatVersion;
  int m_rawLength;
  const unsigned short* m_rawConst;
  unsigned short* m_ownData;
};

#endif