L1GtfeWord.h

Go to the documentation of this file.

#ifndef L1GlobalTrigger_L1GtfeWord_h
#define L1GlobalTrigger_L1GtfeWord_h

// system include files
#include <boost/cstdint.hpp>
#include <iosfwd>

// user include files
#include "DataFormats/L1GlobalTrigger/interface/L1GlobalTriggerReadoutSetupFwd.h"
#include "DataFormats/L1GlobalTrigger/interface/L1GlobalTriggerReadoutSetup.h"

// forward declarations

// class interface

class L1GtfeWord
{

public:

    L1GtfeWord();    // empty constructor, all members set to zero;

    L1GtfeWord(
        boost::uint16_t boardIdValue,
        boost::uint16_t recordLength1Value,
        boost::uint16_t recordLengthValue,
        boost::uint16_t bxNrValue,
        boost::uint32_t setupVersionValue,
        boost::uint16_t activeBoardsValue,
        boost::uint16_t altNrBxBoardValue,
        boost::uint32_t totalTriggerNrValue
    );


    virtual ~L1GtfeWord();

    bool operator==(const L1GtfeWord&) const;

    bool operator!=(const L1GtfeWord&) const;

public:


    inline const boost::uint16_t boardId() const
    {
        return m_boardId;
    }

    void setBoardId(boost::uint16_t boardIdValue)
    {
        m_boardId = boardIdValue;
    }

    void setBoardId(const boost::uint64_t& word64);

    void setBoardIdWord64(boost::uint64_t& word64, int iWord);


    inline const boost::uint16_t recordLength1() const
    {
        return m_recordLength1;
    }

    void setRecordLength1(boost::uint16_t recordLengthValue)
    {
        m_recordLength1 = recordLengthValue;
    }

    void setRecordLength1(const boost::uint64_t& word64);

    void setRecordLength1Word64(boost::uint64_t& word64, int iWord);



    inline const boost::uint16_t recordLength() const
    {
        return m_recordLength;
    }

    void setRecordLength(boost::uint16_t recordLengthValue)
    {
        m_recordLength = recordLengthValue;
    }

    void setRecordLength(const boost::uint64_t& word64);

    void setRecordLengthWord64(boost::uint64_t& word64, int iWord);


    inline const boost::uint16_t bxNr() const
    {
        return m_bxNr;
    }

    void setBxNr(boost::uint16_t bxNrValue)
    {
        m_bxNr = bxNrValue;
    }

    void setBxNr(const boost::uint64_t& word64);

    void setBxNrWord64(boost::uint64_t& word64, int iWord);


    inline const boost::uint32_t setupVersion() const
    {
        return m_setupVersion;
    }

    void setSetupVersion(boost::uint32_t setupVersionValue)
    {
        m_setupVersion = setupVersionValue;
    }

    void setSetupVersion(const boost::uint64_t& word64);

    void setSetupVersionWord64(boost::uint64_t& word64, int iWord);


    const int bstFlag() const;
    void setBstFlag(const int);


    inline const boost::uint16_t activeBoards() const
    {
        return m_activeBoards;
    }

    void setActiveBoards(boost::uint16_t activeBoardsValue)
    {
        m_activeBoards = activeBoardsValue;
    }

    void setActiveBoards(const boost::uint64_t& word64);

    void setActiveBoardsWord64(boost::uint64_t& word64, int iWord);

    void setActiveBoardsWord64(boost::uint64_t& word64, int iWord,
                               boost::int16_t activeBoardsValue);



    inline const boost::uint16_t altNrBxBoard() const
    {
        return m_altNrBxBoard;
    }

    void setAltNrBxBoard(boost::uint16_t altNrBxBoardValue)
    {
        m_altNrBxBoard = altNrBxBoardValue;
    }

    void setAltNrBxBoard(const boost::uint64_t& word64);

    void setAltNrBxBoardWord64(boost::uint64_t& word64, int iWord);

    void setAltNrBxBoardWord64(boost::uint64_t& word64, int iWord,
                               boost::int16_t altNrBxBoardValue);



    inline const boost::uint32_t totalTriggerNr() const
    {
        return m_totalTriggerNr;
    }

    void setTotalTriggerNr(boost::uint32_t totalTriggerNrValue)
    {
        m_totalTriggerNr = totalTriggerNrValue;
    }

    void setTotalTriggerNr(const boost::uint64_t& word64);

    void setTotalTriggerNrWord64(boost::uint64_t& word64, int iWord);


    inline const unsigned int getSize() const
    {
        int unitLengthBits = L1GlobalTriggerReadoutSetup::UnitLength;

        return BlockSize*unitLengthBits;
    }

public:

    virtual void reset();

    virtual void print(std::ostream& myCout) const;

    virtual void unpack(const unsigned char* gtfePtr);

private:

    // block description in the raw GT record

    // block size in 64bits words
    static const int BlockSize;

    static const int BoardIdWord;
    static const int RecordLength1Word;
    static const int RecordLengthWord;
    static const int BxNrWord;
    static const int SetupVersionWord;

    static const boost::uint64_t BoardIdMask;
    static const boost::uint64_t RecordLength1Mask;
    static const boost::uint64_t RecordLengthMask;
    static const boost::uint64_t BxNrMask;
    static const boost::uint64_t SetupVersionMask;

    static const boost::uint32_t BstFlagMask;

    // shifts could be computed from masks...
    static const int BoardIdShift;
    static const int RecordLength1Shift;
    static const int RecordLengthShift;
    static const int BxNrShift;
    static const int SetupVersionShift;

    //
    static const int ActiveBoardsWord;
    static const int AltNrBxBoardWord;
    static const int TotalTriggerNrWord;

    static const boost::uint64_t ActiveBoardsMask;
    static const boost::uint64_t AltNrBxBoardMask;
    static const boost::uint64_t TotalTriggerNrMask;

    static const int ActiveBoardsShift;
    static const int AltNrBxBoardShift;
    static const int TotalTriggerNrShift;


private:

    boost::uint16_t m_boardId;

    boost::uint16_t m_recordLength1;

    boost::uint16_t m_recordLength;

    boost::uint16_t m_bxNr;
    boost::uint32_t m_setupVersion;

    boost::uint16_t m_activeBoards;

    boost::uint16_t m_altNrBxBoard;

    boost::uint32_t m_totalTriggerNr;

};

#endif /*L1GlobalTrigger_L1GtfeWord_h*/