VFATFrame Class Reference

#include <VFATFrame.h>

Public Types
typedef uint16_t	word

Public Member Functions
virtual bool	channelActive (unsigned char channel) const
virtual bool	checkCRC () const
bool	checkFootprint () const
virtual std::vector< unsigned char >	getActiveChannels () const
VFATFrame::word	getBC () const
	Returns Bunch Crossing number (BC<11:0>). More...
VFATFrame::word	getChipID () const
	Returns ChipID (ChipID<11:0>). More...
VFATFrame::word	getCRC () const
	Returns the CRC. More...
VFATFrame::word *	getData ()
const VFATFrame::word *	getData () const
VFATFrame::word	getEC () const
	Returns Event Counter (EV<7:0>). More...
VFATFrame::word	getFlags () const
	Returns flags. More...
uint8_t	getNumberOfClusters () const
bool	isBCPresent () const
	Returns true if the BC word is present in the frame. More...
bool	isCRCPresent () const
	Returns true if the CRC word is present in the frame. More...
bool	isECPresent () const
	Returns true if the EC word is present in the frame. More...
bool	isIDPresent () const
	Returns true if the ID word is present in the frame. More...
bool	isNumberOfClustersPresent () const
	Returns true if the CRC word is present in the frame. More...
void	Print (bool binary=false) const
void	setDAQErrorFlags (uint8_t v)
	Sets DAQ error flags. More...
void	setData (const word *_data)
	Copies a memory block to data buffer. More...
void	setNumberOfClusters (uint8_t v)
void	setPresenceFlags (uint8_t v)
	Sets presence flags. More...
	VFATFrame (const VFATFrame &copy)
	VFATFrame (const word *_data=nullptr)
virtual	~VFATFrame ()

Static Public Member Functions
static word	calculateCRC (word crc_in, word dato)
	internaly used to check CRC More...

Protected Attributes
word	data [12]

Private Attributes
uint8_t	daqErrorFlags
	Error flag as given by certain versions of DAQ. More...
uint8_t	numberOfClusters
uint8_t	presenceFlags

Detailed Description

Representation of VFAT frame plus extra info added by DAQ.

Definition at line 18 of file VFATFrame.h.

Member Typedef Documentation

word

typedef uint16_t VFATFrame::word

Definition at line 25 of file VFATFrame.h.

Constructor & Destructor Documentation

VFATFrame() [1/2]

VFATFrame::VFATFrame

(

const word *

_data = nullptr

)

Definition at line 15 of file VFATFrame.cc.

    : presenceFlags(15),   // by default BC, EC, ID and CRC are present
      daqErrorFlags(0),    // by default, no DAQ error
      numberOfClusters(0)  // no clusters by default
{
  if (_data)
    setData(_data);
  else
    memset(data, 0, 12 * sizeof(word));

References data, and setData().

VFATFrame() [2/2]

VFATFrame::VFATFrame ( const VFATFrame &  copy )

inline

Definition at line 30 of file VFATFrame.h.

                       {}
 

~VFATFrame()

virtual VFATFrame::~VFATFrame ( )

inlinevirtual

Definition at line 37 of file VFATFrame.h.

References data.

Member Function Documentation

calculateCRC()

VFATFrame::word VFATFrame::calculateCRC ( VFATFrame::word  crc_in, VFATFrame::word  dato  )

static

internaly used to check CRC

Definition at line 79 of file VFATFrame.cc.

                                                                              {
  word v = 0x0001;
  word mask = 0x0001;
  bool d = false;
  word crc_temp = crc_in;
  unsigned char datalen = 16;
 
  for (int i = 0; i < datalen; i++) {
    if (dato & v)
      d = true;
    else
      d = false;
 
    if ((crc_temp & mask) ^ d)
      crc_temp = crc_temp >> 1 ^ 0x8408;
    else
      crc_temp = crc_temp >> 1;
 
    v <<= 1;
  }
 
  return crc_temp;

References ztail::d, mps_fire::i, and findQualityFiles::v.

Referenced by checkCRC(), and CTPPSTotemDataFormatter::formatRawData().

channelActive()

virtual bool VFATFrame::channelActive ( unsigned char  channel ) const

inlinevirtual

Checks if channel number 'channel' was active. Returns positive number if it was active, 0 otherwise.

Definition at line 99 of file VFATFrame.h.

         :

checkCRC()

bool VFATFrame::checkCRC ( ) const

virtual

Checks the validity of frame (CRC and daqErrorFlags). Returns false if daqErrorFlags is non-zero. Returns false if the CRC is present and invalid.

Definition at line 61 of file VFATFrame.cc.

                               {
  // check DAQ error flags
  if (daqErrorFlags != 0)
    return false;
 
  // return true if CRC not present
  if (!isCRCPresent())
    return true;
 
  // compare CRC
  word crc_fin = 0xffff;
 
  for (int i = 11; i >= 1; i--)
    crc_fin = calculateCRC(crc_fin, data[i]);
 
  return (crc_fin == data[0]);

References calculateCRC(), daqErrorFlags, data, mps_fire::i, and isCRCPresent().

Referenced by Print().

checkFootprint()

bool VFATFrame::checkFootprint

(

)

const

Checks the fixed bits in the frame. Returns false if any of the groups (in BC, EC and ID words) is present but wrong.

Definition at line 48 of file VFATFrame.cc.

                                     {
  if (isIDPresent() && (data[9] & 0xF000) != 0xE000)
    return false;
 
  if (isECPresent() && (data[10] & 0xF000) != 0xC000)
    return false;
 
  if (isBCPresent() && (data[11] & 0xF000) != 0xA000)
    return false;
 
  return true;

References data, isBCPresent(), isECPresent(), and isIDPresent().

Referenced by Print().

getActiveChannels()

std::vector< unsigned char > VFATFrame::getActiveChannels ( ) const

virtual

Returns list of active channels. It's more efficient than the channelActive(char) for events with low channel occupancy.

Definition at line 28 of file VFATFrame.cc.

                                                            {
  std::vector<unsigned char> channels;
 
  for (int i = 0; i < 8; i++) {
    // quick check
    if (!data[1 + i])
      continue;
 
    // go throug bits
    word mask;
    char offset;
    for (mask = 1 << 15, offset = 15; mask; mask >>= 1, offset--) {
      if (data[1 + i] & mask)
        channels.push_back(i * 16 + offset);
    }
  }
 
  return channels;

References ewkTauDQM_cfi::channels, data, mps_fire::i, and hltrates_dqm_sourceclient-live_cfg::offset.

getBC()

VFATFrame::word VFATFrame::getBC ( ) const

inline

Returns Bunch Crossing number (BC<11:0>).

Definition at line 47 of file VFATFrame.h.

References data.

Referenced by Print().

getChipID()

VFATFrame::word VFATFrame::getChipID ( ) const

inline

Returns ChipID (ChipID<11:0>).

Definition at line 56 of file VFATFrame.h.

{ presenceFlags = v; }

References presenceFlags, and findQualityFiles::v.

Referenced by VFATFrameCollection::GetFrameByIndexID(), and Print().

getCRC()

VFATFrame::word VFATFrame::getCRC ( ) const

inline

Returns the CRC.

Definition at line 59 of file VFATFrame.h.

{ return presenceFlags & 0x1; }

References presenceFlags.

Referenced by Print().

getData() [1/2]

VFATFrame::word* VFATFrame::getData ( void  )

inline

Definition at line 42 of file VFATFrame.h.

Referenced by RawToDigiConverter::run().

getData() [2/2]

const VFATFrame::word* VFATFrame::getData ( void  ) const

inline

Definition at line 44 of file VFATFrame.h.

References data.

getEC()

VFATFrame::word VFATFrame::getEC ( ) const

inline

Returns Event Counter (EV<7:0>).

Definition at line 50 of file VFATFrame.h.

References data.

Referenced by Print().

getFlags()

VFATFrame::word VFATFrame::getFlags ( ) const

inline

Returns flags.

Definition at line 53 of file VFATFrame.h.

References data.

Referenced by Print().

getNumberOfClusters()

uint8_t VFATFrame::getNumberOfClusters ( ) const

inline

Returns the number of clusters as given by the "0xD0 frame". Returns 0, if not available.

Definition at line 86 of file VFATFrame.h.

{

isBCPresent()

bool VFATFrame::isBCPresent ( ) const

inline

Returns true if the BC word is present in the frame.

Definition at line 65 of file VFATFrame.h.

{ return presenceFlags & 0x4; }

References presenceFlags.

Referenced by checkFootprint().

isCRCPresent()

bool VFATFrame::isCRCPresent ( ) const

inline

Returns true if the CRC word is present in the frame.

Definition at line 74 of file VFATFrame.h.

{ daqErrorFlags = v; }

References daqErrorFlags, and findQualityFiles::v.

Referenced by checkCRC().

isECPresent()

bool VFATFrame::isECPresent ( ) const

inline

Returns true if the EC word is present in the frame.

Definition at line 68 of file VFATFrame.h.

{ return presenceFlags & 0x8; }

References presenceFlags.

Referenced by checkFootprint().

isIDPresent()

bool VFATFrame::isIDPresent ( ) const

inline

Returns true if the ID word is present in the frame.

Definition at line 71 of file VFATFrame.h.

{ return presenceFlags & 0x10; }

References presenceFlags.

Referenced by checkFootprint().

isNumberOfClustersPresent()

bool VFATFrame::isNumberOfClustersPresent ( ) const

inline

Returns true if the CRC word is present in the frame.

Definition at line 77 of file VFATFrame.h.

{ numberOfClusters = v; }

References numberOfClusters, and findQualityFiles::v.

Print()

void VFATFrame::Print

(

bool

binary = false

)

const

Prints the frame. If binary is true, binary format is used.

Definition at line 103 of file VFATFrame.cc.

                                       {
  if (binary) {
    for (int i = 0; i < 12; i++) {
      const word &w = data[11 - i];
      word mask = (1 << 15);
      for (int j = 0; j < 16; j++) {
        if (w & mask)
          printf("1");
        else
          printf("0");
        mask = (mask >> 1);
        if ((j + 1) % 4 == 0)
          printf("|");
      }
      printf("\n");
    }
  } else {
    printf("ID = %03x, BC = %04u, EC = %03u, flags = %2u, CRC = %04x ",
           getChipID(),
           getBC(),
           getEC(),
           getFlags(),
           getCRC());
 
    if (checkCRC())
      printf("(  OK), footprint ");
    else
      printf("(FAIL), footprint ");
 
    if (checkFootprint())
      printf("  OK");
    else
      printf("FAIL");
 
    printf(", frame = %04x|%04x|%04x|", data[11], data[10], data[9]);
    for (int i = 8; i > 0; i--)
      printf("%04x", data[i]);
    printf("|%04x", data[0]);
 
    printf(", presFl=%x", presenceFlags);
    printf(", daqErrFl=%x", daqErrorFlags);
 
    printf("\n");
  }

References checkCRC(), checkFootprint(), daqErrorFlags, data, getBC(), getChipID(), getCRC(), getEC(), getFlags(), mps_fire::i, dqmiolumiharvest::j, presenceFlags, and w.

setDAQErrorFlags()

void VFATFrame::setDAQErrorFlags ( uint8_t  v )

inline

Sets DAQ error flags.

Definition at line 80 of file VFATFrame.h.

{ return numberOfClusters; }

setData()

void VFATFrame::setData

(

const word *

_data

)

Copies a memory block to data buffer.

Definition at line 26 of file VFATFrame.cc.

References data.

Referenced by VFATFrame().

setNumberOfClusters()

void VFATFrame::setNumberOfClusters ( uint8_t  v )

inline

Definition at line 82 of file VFATFrame.h.

{ return numberOfClusters; }

References numberOfClusters.

setPresenceFlags()

void VFATFrame::setPresenceFlags ( uint8_t  v )

inline

Sets presence flags.

Definition at line 62 of file VFATFrame.h.

{ return presenceFlags & 0x2; }

References presenceFlags.

Member Data Documentation

daqErrorFlags

uint8_t VFATFrame::daqErrorFlags

private

Error flag as given by certain versions of DAQ.

Definition at line 139 of file VFATFrame.h.

Referenced by checkCRC(), isCRCPresent(), and Print().

data

word VFATFrame::data[12]

protected

Raw data frame as sent by electronics. The container is organized as follows (reversed Figure 8 at page 23 of VFAT2 manual):

* buffer index   content       size
* ---------------------------------------------------------------
*   0            CRC           16 bits
*   1->8         Channel data  128 bits, channel 0 first
*   9            ChipID        4 constant bits (1110) + 12 bits
*   10           EC, Flags     4 constant bits (1100) + 8, 4 bits
*   11           BC            4 constant bits (1010) + 12 bits
* 

Definition at line 127 of file VFATFrame.h.

Referenced by data_sources.node::__str__(), confdb.HLTProcess::_fix_parameter(), confdb.HLTProcess::addEras(), confdb.HLTProcess::addGlobalOptions(), confdb.HLTProcess::append_filenames(), data_sources.json_list::as_dicts(), data_sources.json_list::as_table(), confdb.HLTProcess::build_source(), checkCRC(), checkFootprint(), confdb.HLTProcess::customize(), confdb.HLTProcess::dump(), confdb.HLTProcess::fixPrescales(), data_sources.json_list::get_members(), getActiveChannels(), getBC(), getData(), getEC(), getFlags(), confdb.HLTProcess::getRawConfigurationFromDB(), confdb.HLTProcess::instrumentDQM(), confdb.HLTProcess::instrumentOpenMode(), confdb.HLTProcess::instrumentTiming(), data_sources.json_list::last(), confdb.HLTProcess::loadAdditionalConditions(), confdb.HLTProcess::loadCff(), confdb.HLTProcess::loadSetupCff(), confdb.HLTProcess::overrideGlobalTag(), confdb.HLTProcess::overrideL1MenuXml(), confdb.HLTProcess::overrideOutput(), confdb.HLTProcess::overrideParameters(), confdb.HLTProcess::overrideProcessName(), Print(), confdb.HLTProcess::runL1Emulator(), setData(), confdb.HLTProcess::specificCustomize(), cuy.FindIssue::startElement(), edmStreamStallGrapher.Stack::update(), confdb.HLTProcess::updateMessageLogger(), VFATFrame(), and ~VFATFrame().

numberOfClusters

uint8_t VFATFrame::numberOfClusters

private

Number of clusters. Only available in cluster mode and if the number of clusters exceeds a limit (10).

Definition at line 143 of file VFATFrame.h.

Referenced by isNumberOfClustersPresent(), and setNumberOfClusters().

presenceFlags

uint8_t VFATFrame::presenceFlags

private

Flag indicating the presence of various components. bit 1: "BC word" (buffer index 11) bit 2: "EC word" (buffer index 10) bit 3: "ID word" (buffer index 9) bit 4: "CRC word" (buffer index 0) bit 5: "number of clusters word" (prefix 0xD0)

Definition at line 136 of file VFATFrame.h.

Referenced by getChipID(), getCRC(), isBCPresent(), isECPresent(), isIDPresent(), Print(), and setPresenceFlags().