Merger Struct Reference

unpacker for the merger reader (TSF which reads the merger output) More...

Inheritance diagram for Merger:

Public Member Functions
	Merger (StoreArray< MergerBits > *inArrayPtr, const std::string &inName, unsigned inEventWidth, unsigned inOffset, int inHeaderSize, const std::vector< int > &inNodeID, const std::vector< int > &inNodeID_pcie40, unsigned inNInnerMergers, int &inDelay, int &inCnttrg, int inDebugLevel)
	Constructor.
void	reserve (int subDetectorId, std::array< int, nFinesse > nWords, bool pciedata) override
	reserve enough number of clocks (entries) in the Bitstream StoreArray
void	unpack (int subDetectorId, std::array< int *, 48 > data32tab, std::array< int, 48 > nWords, bool pciedata) override
	Unpack function.
virtual void	unpack (int, std::array< int *, nFinesse >, std::array< int, nFinesse >, bool)
	Unpack the Belle2Link data and fill the Bitstream.
virtual int	getHeaders (int subDetectorId, std::array< int *, 48 > data32tab, std::array< int, 48 > nWords, bool pciedata)
	Get the Belle2Link header information.

Public Attributes
StoreArray< MergerBits > *	arrayPtr
	pointer to the merger output Bitstream
unsigned	nInnerMergers
	number of merger units in the inner super layer than this one
std::string	name
	Name of the UT3.
unsigned	eventWidth
	Size of an event in the Belle2Link data in 32-bit words.
unsigned	offset
	The starting point of the data in an event.
int	headerSize
	Size of the B2L header in words.
int	iNode
	COPPER id of the board.
int	iFinesse
	FINESSE (HSLB) id) of the board.
int	iNode_pcie40
	PCIe40 id of the board.
int	iFinesse_pcie40
	PCIe40 ch id of the board.
std::string	firmwareType
	type of the FPGA firmware
std::string	firmwareVersion
	version of the FPGA firmware
int &	delay
	Reference to the variable of its Belle2Link delay.
int &	cnttrg
	counter of trgger signal, total 32 bits, the 20 LSBs recorded in the event header
int	debugLevel
	debug level in the steering file

Detailed Description

unpacker for the merger reader (TSF which reads the merger output)

Definition at line 54 of file CDCTriggerUnpackerModule.cc.

Constructor & Destructor Documentation

Merger()

Merger ( StoreArray< MergerBits > *  inArrayPtr, const std::string &  inName, unsigned  inEventWidth, unsigned  inOffset, int  inHeaderSize, const std::vector< int > &  inNodeID, const std::vector< int > &  inNodeID_pcie40, unsigned  inNInnerMergers, int &  inDelay, int &  inCnttrg, int  inDebugLevel  )

inline

Constructor.

Definition at line 56 of file CDCTriggerUnpackerModule.cc.

                             :
      SubTrigger(inName, inEventWidth, inOffset,
                 inHeaderSize, inNodeID, inNodeID_pcie40, inDelay, inCnttrg, inDebugLevel),
      arrayPtr(inArrayPtr),
      nInnerMergers(inNInnerMergers) {};

Member Function Documentation

getHeaders()

virtual int getHeaders ( int  subDetectorId, std::array< int *, 48 >  data32tab, std::array< int, 48 >  nWords, bool  pciedata  )

inlinevirtualinherited

Get the Belle2Link header information.

Parameters

subDetectorId	COPPER id of the current data
data32tab	list of pointers to the Belle2Link data buffers
nWords	Number of words of each FINESSE in the COPPER
pciedata	Switch between PCIe 40 and COPPER

Returns

1 if there are data other than the header

Definition at line 128 of file CDCTriggerUnpackerModule.h.

    {
 
      int iNode_i = 0;
      int iFinesse_i = 0;
      if (pciedata) {
        iNode_i = iNode_pcie40;
        iFinesse_i = iFinesse_pcie40;
      } else {
        iNode_i = iNode;
        iFinesse_i = iFinesse;
      }
 
      if (subDetectorId != iNode_i) {
        return 0;
      }
      // int nWordsize = 3075;  // temporary solution to hard coded the correct event size (for 2D only?)
      // empty data buffer
      if (nWords[iFinesse_i] < headerSize) {
        B2WARNING("The module " << name << " does not have enough data (" <<
                  nWords[iFinesse_i] << "). Nothing will be unpacked.");
        return 0;
      } else if (nWords[iFinesse_i] == headerSize) {
        B2DEBUG(20, "The module " << name <<
                " contains only the header. Nothing will be unpacked.");
        return 0;
      }
 
      // need one more check, give a warning if the event has wrong data size
 
      // event data block header:
      // 0xdddd  --> correct event data (for 2D only?)
      // 0xbbbb  --> dummy buffer supposed to be used for only suppressed events.
      if (nWords[iFinesse_i] > headerSize) {
        //dataHeader = CDCTriggerUnpacker::rawIntToAscii(data32tab.at(iFinesse)[headerSize]&0xFFFF0000 >> 16);
        //bool dataHeader = ( (data32tab.at(iFinesse)[headerSize]&0xffff0000) == 0xdddd0000);
        long dataHeader = (data32tab.at(iFinesse_i)[headerSize] & 0xffff0000);
        if (dataHeader != 0xdddd0000) {
          B2DEBUG(30, "The module " << name << " has an event data header " << std::hex << std::setfill('0') << std::setw(4) <<
                  (dataHeader >> 16) <<
                  " in this event. It will be ignore.");
          return 0;
        }
        B2DEBUG(50, "subdet and head size " <<  std::setfill('0') << std::hex << std::setw(8) << iNode_i << ", " << std::dec <<  std::setw(
                  0) << nWords[iFinesse_i] <<
                " : " << std::hex << std::setw(8) << data32tab.at(iFinesse_i)[0] << " " << data32tab.at(iFinesse_i)[1] << " " << data32tab.at(
                  iFinesse_i)[2] <<
                " " << data32tab.at(iFinesse_i)[3] << " dataheader = " << dataHeader);
      }
 
      /* get event header information
       * Ideally, these parameters should not change in the same run,
       * so it is more efficiency to do it in beginRun().
       * However, since they are present in all events,
       * let's check if they really remain unchanged.
       */
      if (headerSize >= 2) {
        // supposedly these two Words will stay for all the versions
        firmwareType = CDCTriggerUnpacker::rawIntToAscii(data32tab.at(iFinesse_i)[0]);
        firmwareVersion = CDCTriggerUnpacker::rawIntToString(data32tab.at(iFinesse_i)[1]);
        //int cnttrg = 0;    // temporary solution, this should be one as a reference for comparison
        int l1_revoclk = -1;
 
        if (headerSize >= 3) {
          std::bitset<wordWidth> thirdWord(data32tab.at(iFinesse_i)[2]);
          l1_revoclk = CDCTriggerUnpacker::subset<32, 0, 11>(thirdWord).to_ulong();
 
          if (firmwareType == "2D  ") {  // temporary solcuion, the following version number check is valid only for 2D
 
            if (firmwareVersion >  "19041700")  {  // started since 19041705
              // the third word is cnttrg and L1_revoclk
              int newCnttrg = CDCTriggerUnpacker::subset<32, 12, 31>(thirdWord).to_ulong();
              cnttrg = newCnttrg;
            } else if (firmwareVersion > "17121900") {  // upto that version, headerSize == 2?
              // the third word is b2l delay and L1_revoclk
              int newDelay = CDCTriggerUnpacker::subset<32, 12, 20>
                             (thirdWord).to_ulong();   // or should be <32,12,19>? bit 31-20 are for prescale?
              if (delay > 0 && delay != newDelay) {
                B2WARNING(" the Belle2Link delay for " << name <<
                          "has changed from " << delay << " to " << newDelay << "!");
              }
              delay = newDelay;
            }
          }
        }
 
        B2DEBUG(20, name << ": " << firmwareType << ", version " <<
                firmwareVersion << ", node " << std::hex << iNode_i <<
                ", finesse " << iFinesse_i << ", delay: " << delay <<
                ", cnttrg: " << cnttrg << std::dec << " == " << cnttrg <<  ", L1_revoclk " << l1_revoclk);
 
 
      }
      return 1;
    };

reserve()

void reserve ( int  subDetectorId, std::array< int, nFinesse >  nWords, bool  pciedata  )

inlineoverridevirtual

reserve enough number of clocks (entries) in the Bitstream StoreArray

Reimplemented from SubTrigger.

Definition at line 72 of file CDCTriggerUnpackerModule.cc.

    {
      int iNode_i = 0;
      int iFinesse_i = 0;
      if (pciedata) {
        iNode_i = iNode_pcie40;
        iFinesse_i = iFinesse_pcie40;
      } else {
        iNode_i = iNode;
        iFinesse_i = iFinesse;
      }
 
      if (subDetectorId != iNode_i) {
        return;
      }
      if (nWords[iFinesse_i] < headerSize) {
        return;
      }
      size_t nClocks = (nWords[iFinesse_i] - headerSize) / eventWidth;
      size_t entries = arrayPtr->getEntries();
      if (entries == 0) {
        for (unsigned i = 0; i < nClocks; ++i) {
          arrayPtr->appendNew();
        }
        B2DEBUG(20, name << ": " << nClocks << " clocks");
      } else if (entries != nClocks) {
        B2DEBUG(20, "Number of clocks in " << name << " conflicts with others!");
      }
    };

unpack() [1/2]

void unpack ( int  subDetectorId, std::array< int *, 48 >  data32tab, std::array< int, 48 >  nWords, bool  pciedata  )

inlineoverride

Unpack function.

Definition at line 103 of file CDCTriggerUnpackerModule.cc.

    {
      int iNode_i = 0;
      int iFinesse_i = 0;
      if (pciedata) {
        iNode_i = iNode_pcie40;
        iFinesse_i = iFinesse_pcie40;
      } else {
        iNode_i = iNode;
        iFinesse_i = iFinesse;
      }
 
      if (subDetectorId != iNode_i) {
        return;
      }
      if (nWords[iFinesse_i] < headerSize) {
        B2DEBUG(20, "The module " << name << " does not have enough data (" <<
                nWords[iFinesse_i] << "). Nothing will be unpacked.");
        // TODO: need to clear the output bitstream because we return early here
        return;
      }
      // make bitstream
      // loop over all clocks
      for (int i = headerSize; i < nWords[iFinesse_i]; i += eventWidth) {
        int iclock = (i - headerSize) / eventWidth;
        auto mergerClock = (*arrayPtr)[iclock];
        B2DEBUG(100, "clock " << iclock);
        // loop over all mergers
        for (unsigned j = offset; j < eventWidth; ++j) {
          int iMerger = (eventWidth - j - 1) / 8 + nInnerMergers;
          int pos = (eventWidth - j - 1) % 8;
          dataWord word(data32tab[iFinesse_i][i + j]);
          for (int k = 0; k < wordWidth; ++k) {
            mergerClock->m_signal[iMerger].set(pos * wordWidth + k, word[k]);
          }
        }
      }
      if (debugLevel >= 300) {
        printBuffer(data32tab[iFinesse_i] + headerSize, eventWidth);
        B2DEBUG(20, "");
        printBuffer(data32tab[iFinesse_i] + headerSize + eventWidth, eventWidth);
      }
      for (int i = 0; i < std::accumulate(nMergers.begin(), nMergers.end(), 0); ++i) {
        B2DEBUG(99, (*arrayPtr)[0]->m_signal[i].to_string());
      }
    }

unpack() [2/2]

virtual void unpack ( int  , std::array< int *, nFinesse >  , std::array< int, nFinesse >  , bool    )

inlinevirtualinherited

Unpack the Belle2Link data and fill the Bitstream.

Reimplemented in Neuro.

Definition at line 110 of file CDCTriggerUnpackerModule.h.

                              {};

Member Data Documentation

arrayPtr

StoreArray<MergerBits>* arrayPtr

pointer to the merger output Bitstream

Definition at line 68 of file CDCTriggerUnpackerModule.cc.

cnttrg

int& cnttrg

inherited

counter of trgger signal, total 32 bits, the 20 LSBs recorded in the event header

Definition at line 96 of file CDCTriggerUnpackerModule.h.

debugLevel

int debugLevel

inherited

debug level in the steering file

Definition at line 99 of file CDCTriggerUnpackerModule.h.

delay

int& delay

inherited

Reference to the variable of its Belle2Link delay.

Definition at line 94 of file CDCTriggerUnpackerModule.h.

eventWidth

unsigned eventWidth

inherited

Size of an event in the Belle2Link data in 32-bit words.

Definition at line 74 of file CDCTriggerUnpackerModule.h.

firmwareType

std::string firmwareType

inherited

type of the FPGA firmware

Definition at line 90 of file CDCTriggerUnpackerModule.h.

firmwareVersion

std::string firmwareVersion

inherited

version of the FPGA firmware

Definition at line 92 of file CDCTriggerUnpackerModule.h.

headerSize

int headerSize

inherited

Size of the B2L header in words.

Definition at line 78 of file CDCTriggerUnpackerModule.h.

iFinesse

int iFinesse

inherited

FINESSE (HSLB) id) of the board.

Definition at line 82 of file CDCTriggerUnpackerModule.h.

iFinesse_pcie40

int iFinesse_pcie40

inherited

PCIe40 ch id of the board.

Definition at line 86 of file CDCTriggerUnpackerModule.h.

iNode

int iNode

inherited

COPPER id of the board.

Definition at line 80 of file CDCTriggerUnpackerModule.h.

iNode_pcie40

int iNode_pcie40

inherited

PCIe40 id of the board.

Definition at line 84 of file CDCTriggerUnpackerModule.h.

name

std::string name

inherited

Name of the UT3.

Definition at line 72 of file CDCTriggerUnpackerModule.h.

nInnerMergers

unsigned nInnerMergers

number of merger units in the inner super layer than this one

Definition at line 70 of file CDCTriggerUnpackerModule.cc.

offset

unsigned offset

inherited

The starting point of the data in an event.

Definition at line 76 of file CDCTriggerUnpackerModule.h.

---

The documentation for this struct was generated from the following file:

• trg/cdc/modules/unpacker/src/CDCTriggerUnpackerModule.cc