TileDigits2Bytes Class Reference

This class converts TileDigits to and from bytestream in ROD format. More...

#include <TileDigits2Bytes.h>

Collaboration diagram for TileDigits2Bytes:

Public Member Functions
	TileDigits2Bytes ()
int	getBytes (const TileDigits *digi, const TileHWID *tileHWID, std::vector< unsigned int > &v)
std::array< std::vector< float >, 3 >	getDigits (const uint32_t *data, int dataWordsPerChip) const
	Extract samples(digits) for 3 channels, stored in 9 words.
int	getBCID (const uint32_t *data, int chipCount, int wordsPerChip) const
	Get BCID from Chip header, bit 0-11.
int	getDigiMode (const uint32_t *data, int chipCount, int wordsPerChip) const
	Determine digitizer mode for a number of channels.
int	getGain (const uint32_t *data, int chan) const
	Extract gain for <chip> in chip header.
bool	checkWordParity (const uint32_t *data) const
	Verify ODD parity for one word.
uint32_t	calculateParity (const uint32_t *data) const
	Calculate parity for one word.
uint32_t	checkParity (const uint32_t *data, int length) const
	Verify parity for <length> words.
bool	checkStartBit (const uint32_t *data, int length, uint32_t startbit) const
	Check that the MSB of <length> words are equal to LSB of <startbit>
void	setVerbose (bool verbose)

Private Attributes
bool	m_verbose

Detailed Description

This class converts TileDigits to and from bytestream in ROD format.

Author

Alexander Solodkov

Definition at line 20 of file TileDigits2Bytes.h.

Constructor & Destructor Documentation

TileDigits2Bytes()

TileDigits2Bytes::TileDigits2Bytes ( )

inline

Definition at line 24 of file TileDigits2Bytes.h.

: m_verbose(false) {}

Member Function Documentation

calculateParity()

uint32_t TileDigits2Bytes::calculateParity ( const uint32_t * data ) const

inline

Calculate parity for one word.

Parameters

data	Pointer to word

Returns

Parity as LSB

Definition at line 133 of file TileDigits2Bytes.cxx.

                                                            {
  uint32_t res = *data;
  res ^= ((*data) >> 1);
  res ^= (res >> 2);
  res ^= (res >> 4);
  res ^= (res >> 8);
  res ^= (res >> 16);
  
  return (res & 0x1);
}

checkParity()

uint32_t TileDigits2Bytes::checkParity ( const uint32_t * data, int length ) const

inline

Verify parity for <length> words.

The parity bit for each word is stored in an unsigned int LSB is parity bit from first word and so on.

Parameters

data	Pointer to first data word
length	Number of data words

Returns

Result of check.

Definition at line 145 of file TileDigits2Bytes.cxx.

                                                                    {
  uint32_t result = 0, tmp;
  for(int n=0;n<length;++n) {
    tmp = data[n] ^ (data[n]>> 1);
    tmp ^= (tmp >> 2);
    tmp ^= (tmp >> 4);
    tmp ^= (tmp >> 8);
    tmp ^= (tmp >> 16);
    result |= (tmp & 0x1)<<n;
  }
  return result;
}

checkStartBit()

bool TileDigits2Bytes::checkStartBit ( const uint32_t * data, int length, uint32_t startbit ) const

inline

Check that the MSB of <length> words are equal to LSB of <startbit>

MSB of datawords should is checked.

Parameters

data	Pointer to forst data word
length	Number of words to check
startbit	Word with LSB to check against

Returns

If all words were correct

Definition at line 162 of file TileDigits2Bytes.cxx.

                                                                                         {
  bool result = true;
  for(int i=0;result && (i<length);++i) {
    result = (data[i]>>31 == startbit);
  }
  return result;
}

checkWordParity()

bool TileDigits2Bytes::checkWordParity ( const uint32_t * data ) const

inline

Verify ODD parity for one word.

Parameters

data	Pointer to data word

Returns

If word has even parity (bool)

Definition at line 128 of file TileDigits2Bytes.cxx.

                                                            {
  return (calculateParity(data) == 1);
} 

getBCID()

int TileDigits2Bytes::getBCID	(	const uint32_t *	data,
		int	chipCount,
		int	wordsPerChip ) const

Get BCID from Chip header, bit 0-11.

Go through all chip headers, check their parity and extract BCID from them (bits 0-11)

Parameters

data	Pointer to first word
chipCount	Number of chips
wordsPerChip	Number of data words per chip

Returns

BCID from chip header with good parity

Definition at line 65 of file TileDigits2Bytes.cxx.

                                                                                     {
  int BCID = 0, n;
  int modeFound = 0;
  const uint32_t *wordPtr = data;
 
  for(n=0; modeFound<5 && n<chipCount;++n) {
    if(checkWordParity(wordPtr)) {
      BCID = (*wordPtr) & 0xfff;
      // this is correct if header has MSB 1 and next word has MSB 0
      if (((wordPtr[0]>>31) == 1) && ((wordPtr[1]>>31) == 0)) ++modeFound; 
    }
    wordPtr += wordsPerChip;
  }
  // if no valid mode found, take BCID from first chip
  if(0 == modeFound) BCID = (*data & 0xfff);
    
  return BCID;
}

getBytes()

int TileDigits2Bytes::getBytes	(	const TileDigits *	digi,
		const TileHWID *	tileHWID,
		std::vector< unsigned int > &	v )

Definition at line 12 of file TileDigits2Bytes.cxx.

                                                                                                           {  // Salukvadze
  int chID = tileHWID->channel(digi->adc_HWID());
  int gain = (tileHWID->is_low_gain(digi->adc_HWID()) ? 0 : 1);
  std::vector<float> digits = digi->samples();
  unsigned int w;
  w = (gain << 15) + (digits.size() << 8) + chID;
  for (unsigned int i=0; i+1<digits.size(); i+=2) {
    w += (int)digits[i] << 16;
    v.push_back(w);
    w = (int)digits[i+1];
    }
  if (digits.size() % 2 != 0) {
    w += (int)digits[digits.size()-1] << 16;
    v.push_back(w);
  } else {
    v.push_back(w);
  }
  return digits.size() / 2 + 1;
      
}

getDigiMode()

int TileDigits2Bytes::getDigiMode	(	const uint32_t *	data,
		int	chipCount,
		int	wordsPerChip ) const

Determine digitizer mode for a number of channels.

Go through all chip headers, check their parity and extract digi mode from them (bit 15,16)

Parameters

data	Pointer to first word
chipCount	Number of chips
wordsPerChip	Number of data words per chip

Returns

Digitizer mode

Definition at line 89 of file TileDigits2Bytes.cxx.

                                                                                         {
  int digiMode = -1, n;
  bool modeFound = false;
  const uint32_t *wordPtr = data;
 
  for(n=0;!modeFound && n<chipCount;++n) {
    if(checkWordParity(wordPtr)) {
      digiMode = ((*wordPtr)>>15) & 0x3;
      // this is correct if header has MSB 1 and next word has MSB 0
      modeFound = ((wordPtr[0]>>31) == 1) && ((wordPtr[1]>>31) == 0); 
    }
    wordPtr += wordsPerChip;
  }
  // if no valid mode found, ignore parity
  if(!modeFound) {
    wordPtr = data;
    for(n=0;!modeFound && n<chipCount;++n) {
      digiMode = ((*wordPtr)>>15) & 0x3;
      // this is correct if header has MSB 1 and next word has MSB 0
      modeFound = ((wordPtr[0]>>31) == 1) && ((wordPtr[1]>>31) == 0); 
      wordPtr += wordsPerChip;
    }
  }
  // if still no valid mode found
  if(!modeFound) {
    if(m_verbose) std::cout<<"<TileD2B> No valid header found, assuming normal mode!"<<std::endl;
    digiMode = -1;
  }
  else if(m_verbose) {
    if(digiMode > 0) n <<= 1;
    if(checkWordParity(wordPtr)) std::cout<<"<TileD2B> DigiMode "<<digiMode<<" found in chip header "<<n<<std::endl;
    else std::cout<<"<TileD2B> DigiMode "<<digiMode<<" found in chip header "<<n<<" with BAD PARITY"<<std::endl;
    if(digiMode > 0) std::cout<<"<TileD2B> Calibration mode selected!"<<std::endl;
  }
  
  return digiMode;
}

getDigits()

std::array< std::vector< float >, 3 > TileDigits2Bytes::getDigits	(	const uint32_t *	data,
		int	dataWordsPerChip ) const

Extract samples(digits) for 3 channels, stored in 9 words.

Parameters

data	Pointer to ROD-data

Definition at line 35 of file TileDigits2Bytes.cxx.

                                                                            {
  // create new containers on the heap
  std::array< std::vector<float>, 3 > digiVec;
 
  digiVec[0].reserve(dataWordsPerChip);
  digiVec[1].reserve(dataWordsPerChip);
  digiVec[2].reserve(dataWordsPerChip);
 
  for(int sampl=0;sampl<dataWordsPerChip;++sampl) {
    int word = (*data); ++data;
    digiVec[0].push_back((float)(word & 0x3ff));
    digiVec[1].push_back((float)((word>>10) & 0x3ff));
    digiVec[2].push_back((float)((word>>20) & 0x3ff));
  }
  return digiVec;
}

getGain()

int TileDigits2Bytes::getGain	(	const uint32_t *	data,
		int	chan ) const

Extract gain for <chip> in chip header.

Gain bits are bit 12-14 in chip header.

Parameters

data	Pointer to chip header word
chan	is channel number in chip (0-2) return 0-low gain, 1-high gain

Bit 12 corresponds to chan with lowest #.

Definition at line 56 of file TileDigits2Bytes.cxx.

                                                              {
  return ((*data)>>(12+chan)) & 0x1;
}

setVerbose()

void TileDigits2Bytes::setVerbose ( bool verbose )

inline

Definition at line 92 of file TileDigits2Bytes.h.

{ m_verbose=verbose; }  

Member Data Documentation

m_verbose

bool TileDigits2Bytes::m_verbose

private

Definition at line 96 of file TileDigits2Bytes.h.

---

The documentation for this class was generated from the following files:

• TileDigits2Bytes.h
• TileDigits2Bytes.cxx