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
virtual bool	checkCRCT2 () const
bool	checkFootprint () const
bool	checkFootprintT2 () 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	getCRCT2 () const
	Returns the CRC, for non-reversed TOTEM T2. 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	PrintT2 (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 word *_data=nullptr)
	VFATFrame (const VFATFrame &copy)
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 19 of file VFATFrame.h.

Member Typedef Documentation

word

typedef uint16_t VFATFrame::word

Definition at line 21 of file VFATFrame.h.

Constructor & Destructor Documentation

VFATFrame() [1/2]

VFATFrame::VFATFrame

(

const word *

_data = nullptr

)

Definition at line 16 of file VFATFrame.cc.

References data, and setData().

    : 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));
}

VFATFrame() [2/2]

VFATFrame::VFATFrame ( const VFATFrame &  copy )

inline

Definition at line 26 of file VFATFrame.h.

References filterCSVwithJSON::copy, daqErrorFlags, numberOfClusters, presenceFlags, and setData().

                                   {
    setData(copy.data);
    presenceFlags = copy.presenceFlags;
    daqErrorFlags = copy.daqErrorFlags;
    numberOfClusters = copy.numberOfClusters;
  }

~VFATFrame()

virtual VFATFrame::~VFATFrame ( )

inlinevirtual

Definition at line 33 of file VFATFrame.h.

{}

Member Function Documentation

calculateCRC()

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

static

internaly used to check CRC

Definition at line 107 of file VFATFrame.cc.

References ztail::d, mps_fire::i, ALPAKA_ACCELERATOR_NAMESPACE::pixelClustering::pixelStatus::mask, and findQualityFiles::v.

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

                                                                              {
  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;
}

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 106 of file VFATFrame.h.

References data, and funct::true.

                                                          {
    return (data[1 + (channel / 16)] & (1 << (channel % 16))) ? true : false;
  }

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 75 of file VFATFrame.cc.

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

Referenced by Print().

                               {
  // 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]);
}

checkCRCT2()

bool VFATFrame::checkCRCT2 ( ) const

virtual

Checks the validity of Totem T2 non-reversed CRC. Returns false if the CRC is present and invalid.

Definition at line 93 of file VFATFrame.cc.

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

Referenced by PrintT2().

                                 {
  // return true if CRC not present
  if (!isCRCPresent())
    return true;

  // compare CRC
  word crc_fin = 0xffff;

  for (int i = 0; i < 11; i++)
    crc_fin = calculateCRC(crc_fin, data[i]);

  return (crc_fin == data[11]);
}

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 49 of file VFATFrame.cc.

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

Referenced by Print().

                                     {
  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;
}

checkFootprintT2()

bool VFATFrame::checkFootprintT2

(

)

const

Checks the fixed bits in the frame, for the TOTEM T2 non-inverse word ordering. Returns false if any of the groups (in BC, EC and ID words) is present but wrong.

Definition at line 62 of file VFATFrame.cc.

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

Referenced by PrintT2().

                                       {
  if (isIDPresent() && (data[2] & 0xF000) != 0xE000)
    return false;

  if (isECPresent() && (data[1] & 0xF000) != 0xC000)
    return false;

  if (isBCPresent() && (data[0] & 0xF000) != 0xA000)
    return false;

  return true;
}

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 29 of file VFATFrame.cc.

References ewkTauDQM_cfi::channels, data, mps_fire::i, ALPAKA_ACCELERATOR_NAMESPACE::pixelClustering::pixelStatus::mask, and hltrates_dqm_sourceclient-live_cfg::offset.

                                                            {
  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;
}

getBC()

VFATFrame::word VFATFrame::getBC ( ) const

inline

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

Definition at line 43 of file VFATFrame.h.

References data.

Referenced by Print().

{ return data[11] & 0x0FFF; }

getChipID()

VFATFrame::word VFATFrame::getChipID ( ) const

inline

Returns ChipID (ChipID<11:0>).

Definition at line 52 of file VFATFrame.h.

References data.

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

{ return data[9] & 0x0FFF; }

getCRC()

VFATFrame::word VFATFrame::getCRC ( ) const

inline

Returns the CRC.

Definition at line 55 of file VFATFrame.h.

References data.

Referenced by Print().

{ return data[0]; }

getCRCT2()

VFATFrame::word VFATFrame::getCRCT2 ( ) const

inline

Returns the CRC, for non-reversed TOTEM T2.

Definition at line 58 of file VFATFrame.h.

References data.

Referenced by PrintT2().

{ return data[11]; }

getData() [1/2]

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

inline

Definition at line 38 of file VFATFrame.h.

References data.

Referenced by pps::RawDataUnpacker::processOptoRxFrameSerial(), and RawToDigiConverter::run().

{ return data; }

getData() [2/2]

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

inline

Definition at line 40 of file VFATFrame.h.

References data.

{ return data; }

getEC()

VFATFrame::word VFATFrame::getEC ( ) const

inline

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

Definition at line 46 of file VFATFrame.h.

References data.

Referenced by Print().

{ return (data[10] & 0x0FF0) >> 4; }

getFlags()

VFATFrame::word VFATFrame::getFlags ( ) const

inline

Returns flags.

Definition at line 49 of file VFATFrame.h.

References data.

Referenced by Print().

{ return data[10] & 0x000F; }

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 85 of file VFATFrame.h.

References numberOfClusters.

{ return numberOfClusters; }

isBCPresent()

bool VFATFrame::isBCPresent ( ) const

inline

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

Definition at line 64 of file VFATFrame.h.

References presenceFlags.

Referenced by checkFootprint(), and checkFootprintT2().

{ return presenceFlags & 0x1; }

isCRCPresent()

bool VFATFrame::isCRCPresent ( ) const

inline

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

Definition at line 73 of file VFATFrame.h.

References presenceFlags.

Referenced by checkCRC(), and checkCRCT2().

{ return presenceFlags & 0x8; }

isECPresent()

bool VFATFrame::isECPresent ( ) const

inline

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

Definition at line 67 of file VFATFrame.h.

References presenceFlags.

Referenced by checkFootprint(), and checkFootprintT2().

{ return presenceFlags & 0x2; }

isIDPresent()

bool VFATFrame::isIDPresent ( ) const

inline

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

Definition at line 70 of file VFATFrame.h.

References presenceFlags.

Referenced by checkFootprint(), and checkFootprintT2().

{ return presenceFlags & 0x4; }

isNumberOfClustersPresent()

bool VFATFrame::isNumberOfClustersPresent ( ) const

inline

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

Definition at line 76 of file VFATFrame.h.

References presenceFlags.

{ return presenceFlags & 0x10; }

Print()

void VFATFrame::Print

(

bool

binary = false

)

const

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

Definition at line 131 of file VFATFrame.cc.

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

                                       {
  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");
  }
}

PrintT2()

void VFATFrame::PrintT2

(

bool

binary = false

)

const

Definition at line 177 of file VFATFrame.cc.

References calculateCRC(), checkCRCT2(), checkFootprintT2(), data, getCRCT2(), mps_fire::i, dqmiolumiharvest::j, ALPAKA_ACCELERATOR_NAMESPACE::pixelClustering::pixelStatus::mask, and w().

                                         {
  if (binary) {
    for (int i = 0; i < 12; i++) {
      const word &w = data[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 {
    // print right CRC
    word crc_fin = 0xffff;

    for (int i = 0; i < 11; i++)
      crc_fin = calculateCRC(crc_fin, data[i]);

    printf("CRC = %04x ", getCRCT2());

    if (checkCRCT2())
      printf("(  OK), footprint ");
    else
      printf("(FAIL, right = %04x), footprint ", crc_fin);

    if (checkFootprintT2())
      printf("  OK");
    else
      printf("FAIL");

    printf("Frame = %04x|%04x|%04x|", data[0], data[1], data[2]);
    for (int i = 3; i < 11; i++)
      printf("%04x", data[i]);
    printf("|%04x", data[11]);

    printf("\n");
  }
}

setDAQErrorFlags()

void VFATFrame::setDAQErrorFlags ( uint8_t  v )

inline

Sets DAQ error flags.

Definition at line 79 of file VFATFrame.h.

References daqErrorFlags, and findQualityFiles::v.

{ daqErrorFlags = v; }

setData()

void VFATFrame::setData

(

const word *

_data

)

Copies a memory block to data buffer.

Definition at line 27 of file VFATFrame.cc.

References data.

Referenced by VFATFrame().

{ memcpy(data, _data, 24); }

setNumberOfClusters()

void VFATFrame::setNumberOfClusters ( uint8_t  v )

inline

Definition at line 81 of file VFATFrame.h.

References numberOfClusters, and findQualityFiles::v.

{ numberOfClusters = v; }

setPresenceFlags()

void VFATFrame::setPresenceFlags ( uint8_t  v )

inline

Sets presence flags.

Definition at line 61 of file VFATFrame.h.

References presenceFlags, and findQualityFiles::v.

{ presenceFlags = v; }

Member Data Documentation

daqErrorFlags

uint8_t VFATFrame::daqErrorFlags

private

Error flag as given by certain versions of DAQ.

Definition at line 149 of file VFATFrame.h.

Referenced by checkCRC(), Print(), setDAQErrorFlags(), and VFATFrame().

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 137 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(), channelActive(), checkCRC(), checkCRCT2(), checkFootprint(), checkFootprintT2(), confdb.HLTProcess::customize(), confdb.HLTProcess::dump(), confdb.HLTProcess::fixPrescales(), data_sources.json_list::get_members(), getActiveChannels(), getBC(), getChipID(), getCRC(), getCRCT2(), 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(), PrintT2(), confdb.HLTProcess::removeElementFromSequencesTasksAndPaths(), confdb.HLTProcess::runL1Emulator(), setData(), confdb.HLTProcess::specificCustomize(), cuy.FindIssue::startElement(), edmStreamStallGrapher.Stack::update(), confdb.HLTProcess::updateMessageLogger(), 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 153 of file VFATFrame.h.

Referenced by getNumberOfClusters(), setNumberOfClusters(), and VFATFrame().

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 146 of file VFATFrame.h.

Referenced by isBCPresent(), isCRCPresent(), isECPresent(), isIDPresent(), isNumberOfClustersPresent(), Print(), setPresenceFlags(), and VFATFrame().