sistrip::FEDBSChannelUnpacker Class Reference

#include <SiStripFEDBuffer.h>

Public Member Functions
uint16_t	adc () const
	FEDBSChannelUnpacker ()
bool	hasData () const
FEDBSChannelUnpacker &	operator++ ()
FEDBSChannelUnpacker &	operator++ (int)
uint8_t	sampleNumber () const

Static Public Member Functions
static FEDBSChannelUnpacker	virginRawModeUnpacker (const FEDChannel &channel, uint16_t num_bits)
static FEDBSChannelUnpacker	zeroSuppressedLiteModeUnpacker (const FEDChannel &channel, uint16_t num_bits)
static FEDBSChannelUnpacker	zeroSuppressedModeUnpacker (const FEDChannel &channel, uint16_t num_bits)

Private Member Functions
	FEDBSChannelUnpacker (const uint8_t *payload, const uint16_t channelPayloadOffset, const int16_t channelPayloadLength, const uint16_t offsetIncrement, bool useZS)
void	readNewClusterInfo ()

Static Private Member Functions
static void	throwBadChannelLength (const uint16_t length)
static void	throwBadWordLength (const uint16_t word_length)
static void	throwUnorderedData (const uint8_t currentStrip, const uint8_t firstStripOfNewCluster)

Private Attributes
uint16_t	bitOffsetIncrement_
uint16_t	channelPayloadLength_
uint16_t	channelPayloadOffset_
uint16_t	currentBitOffset_
uint16_t	currentLocalBitOffset_
uint8_t	currentStrip_
uint16_t	currentWordOffset_
const uint8_t *	data_
uint16_t	oldWordOffset_
bool	useZS_
uint8_t	valuesLeftInCluster_

Detailed Description

Definition at line 137 of file SiStripFEDBuffer.h.

Constructor & Destructor Documentation

sistrip::FEDBSChannelUnpacker::FEDBSChannelUnpacker ( )

inline

Definition at line 207 of file SiStripFEDBuffer.h.

    : data_(nullptr),
      oldWordOffset_(0), currentWordOffset_(0),
      currentBitOffset_(0), currentLocalBitOffset_(0),
      bitOffsetIncrement_(10),
      currentStrip_(0),
      channelPayloadOffset_(0), channelPayloadLength_(0),
      useZS_(false), valuesLeftInCluster_(0)
    { }

sistrip::FEDBSChannelUnpacker::FEDBSChannelUnpacker ( const uint8_t *  payload, const uint16_t  channelPayloadOffset, const int16_t  channelPayloadLength, const uint16_t  offsetIncrement, bool  useZS  )

inlineprivate

Definition at line 217 of file SiStripFEDBuffer.h.

References bitOffsetIncrement_, and throwBadWordLength().

    : data_(payload),
      oldWordOffset_(0), currentWordOffset_(channelPayloadOffset),
      currentBitOffset_(0), currentLocalBitOffset_(0),
      bitOffsetIncrement_(offsetIncrement),
      channelPayloadOffset_(channelPayloadOffset),
      channelPayloadLength_(channelPayloadLength),
      useZS_(useZS), valuesLeftInCluster_(0)
    {
      if (bitOffsetIncrement_>16) throwBadWordLength(bitOffsetIncrement_); // more than 2 words... still to be implemented
    }

Member Function Documentation

uint16_t sistrip::FEDBSChannelUnpacker::adc ( ) const

inline

Definition at line 259 of file SiStripFEDBuffer.h.

References bitOffsetIncrement_, currentLocalBitOffset_, currentWordOffset_, data_, and oldWordOffset_.

Referenced by sistrip::RawToDigiUnpacker::createDigis().

    {
      uint16_t bits_missing = (bitOffsetIncrement_-8)+currentLocalBitOffset_;
      uint16_t adc = (data_[currentWordOffset_^7]<<bits_missing);
      if (currentWordOffset_>oldWordOffset_) {
        adc += ( (data_[(currentWordOffset_+1)^7]>>(8-bits_missing)) );
      }
      return (adc&((1<<bitOffsetIncrement_)-1));
    }

bool sistrip::FEDBSChannelUnpacker::hasData ( ) const

inline

Definition at line 269 of file SiStripFEDBuffer.h.

References channelPayloadLength_, channelPayloadOffset_, and currentWordOffset_.

Referenced by sistrip::RawToDigiUnpacker::createDigis(), and operator++().

    {
      return (currentWordOffset_<channelPayloadOffset_+channelPayloadLength_);
    }

FEDBSChannelUnpacker & sistrip::FEDBSChannelUnpacker::operator++ ( void  )

inline

Definition at line 274 of file SiStripFEDBuffer.h.

References bitOffsetIncrement_, currentBitOffset_, currentLocalBitOffset_, currentStrip_, currentWordOffset_, hasData(), oldWordOffset_, readNewClusterInfo(), throwUnorderedData(), useZS_, and valuesLeftInCluster_.

    {
      oldWordOffset_ = currentWordOffset_;
      currentBitOffset_ += bitOffsetIncrement_;
      currentLocalBitOffset_ += bitOffsetIncrement_;
      while (currentLocalBitOffset_>=8) {
        currentWordOffset_++;
        currentLocalBitOffset_ -= 8;
      }
      if (useZS_) {
    if (valuesLeftInCluster_) { currentStrip_++; valuesLeftInCluster_--; }
    else {
      if (hasData()) {
        const uint8_t oldStrip = currentStrip_;
        readNewClusterInfo();
        if ( !(currentStrip_ > oldStrip) ) throwUnorderedData(oldStrip,currentStrip_);
      }
    }
      } else { currentStrip_++; }
      return (*this);
    }

FEDBSChannelUnpacker & sistrip::FEDBSChannelUnpacker::operator++ ( int  )

inline

Definition at line 296 of file SiStripFEDBuffer.h.

    {
      ++(*this); return *this;
    }

void sistrip::FEDBSChannelUnpacker::readNewClusterInfo ( )

inlineprivate

Definition at line 301 of file SiStripFEDBuffer.h.

References currentStrip_, currentWordOffset_, data_, and valuesLeftInCluster_.

Referenced by operator++().

    {
      currentStrip_ = data_[(currentWordOffset_++)^7];
      valuesLeftInCluster_ = data_[(currentWordOffset_++)^7]-1;
    }

uint8_t sistrip::FEDBSChannelUnpacker::sampleNumber ( ) const

inline

Definition at line 254 of file SiStripFEDBuffer.h.

References currentStrip_.

Referenced by sistrip::RawToDigiUnpacker::createDigis().

    {
      return currentStrip_;
    }

void sistrip::FEDBSChannelUnpacker::throwBadChannelLength ( const uint16_t  length )

staticprivate

Definition at line 424 of file SiStripFEDBuffer.cc.

References Exception.

Referenced by virginRawModeUnpacker(), zeroSuppressedLiteModeUnpacker(), and zeroSuppressedModeUnpacker().

  {
    std::ostringstream ss;
    ss << "Channel length is invalid. "
       << "Channel length is " << uint16_t(length) << "."
       << std::endl;
    throw cms::Exception("FEDBuffer") << ss.str();
  }

void sistrip::FEDBSChannelUnpacker::throwBadWordLength ( const uint16_t  word_length )

staticprivate

Definition at line 433 of file SiStripFEDBuffer.cc.

References Exception.

Referenced by FEDBSChannelUnpacker(), and virginRawModeUnpacker().

  {
    std::ostringstream ss;
    ss << "Word length is invalid. "
       << "Word length is " << word_length << "."
       << std::endl;
    throw cms::Exception("FEDBuffer") << ss.str();
  }

void sistrip::FEDBSChannelUnpacker::throwUnorderedData ( const uint8_t  currentStrip, const uint8_t  firstStripOfNewCluster  )

staticprivate

Definition at line 442 of file SiStripFEDBuffer.cc.

References Exception.

Referenced by operator++().

  {
    std::ostringstream ss;
    ss << "First strip of new cluster is not greater than last strip of previous cluster. "
       << "Last strip of previous cluster is " << uint16_t(currentStrip) << ". "
       << "First strip of new cluster is " << uint16_t(firstStripOfNewCluster) << "."
       << std::endl;
    throw cms::Exception("FEDBuffer") << ss.str();
  }

FEDBSChannelUnpacker sistrip::FEDBSChannelUnpacker::virginRawModeUnpacker ( const FEDChannel &  channel, uint16_t  num_bits  )

inlinestatic

Definition at line 229 of file SiStripFEDBuffer.h.

References sistrip::FEDChannel::data(), sistrip::FEDChannel::length(), sistrip::FEDChannel::offset(), mps_fire::result, throwBadChannelLength(), and throwBadWordLength().

Referenced by sistrip::RawToDigiUnpacker::createDigis().

    {
      uint16_t length = channel.length();
      if (length & 0xF000) throwBadChannelLength(length);
      if (num_bits<=0 or num_bits>16) throwBadWordLength(num_bits);
      FEDBSChannelUnpacker result(channel.data(), channel.offset()+3, length-3, num_bits, false);
      return result;
    }

FEDBSChannelUnpacker sistrip::FEDBSChannelUnpacker::zeroSuppressedLiteModeUnpacker ( const FEDChannel &  channel, uint16_t  num_bits  )

inlinestatic

Definition at line 246 of file SiStripFEDBuffer.h.

References sistrip::FEDChannel::data(), sistrip::FEDChannel::length(), sistrip::FEDChannel::offset(), mps_fire::result, and throwBadChannelLength().

Referenced by sistrip::RawToDigiUnpacker::createDigis().

    {
      uint16_t length = channel.length();
      if (length & 0xF000) throwBadChannelLength(length);
      FEDBSChannelUnpacker result(channel.data(), channel.offset()+2, length-2, num_bits, true);
      return result;
    }

FEDBSChannelUnpacker sistrip::FEDBSChannelUnpacker::zeroSuppressedModeUnpacker ( const FEDChannel &  channel, uint16_t  num_bits  )

inlinestatic

Definition at line 238 of file SiStripFEDBuffer.h.

References sistrip::FEDChannel::data(), sistrip::FEDChannel::length(), sistrip::FEDChannel::offset(), mps_fire::result, and throwBadChannelLength().

    {
      uint16_t length = channel.length();
      if (length & 0xF000) throwBadChannelLength(length);
      FEDBSChannelUnpacker result(channel.data(), channel.offset()+7, length-7, num_bits, true);
      return result;
    }

Member Data Documentation

uint16_t sistrip::FEDBSChannelUnpacker::bitOffsetIncrement_

private

Definition at line 161 of file SiStripFEDBuffer.h.

Referenced by adc(), FEDBSChannelUnpacker(), and operator++().

uint16_t sistrip::FEDBSChannelUnpacker::channelPayloadLength_

private

Definition at line 164 of file SiStripFEDBuffer.h.

Referenced by hasData().

uint16_t sistrip::FEDBSChannelUnpacker::channelPayloadOffset_

private

Definition at line 163 of file SiStripFEDBuffer.h.

Referenced by hasData().

uint16_t sistrip::FEDBSChannelUnpacker::currentBitOffset_

private

Definition at line 159 of file SiStripFEDBuffer.h.

Referenced by operator++().

uint16_t sistrip::FEDBSChannelUnpacker::currentLocalBitOffset_

private

Definition at line 160 of file SiStripFEDBuffer.h.

Referenced by adc(), and operator++().

uint8_t sistrip::FEDBSChannelUnpacker::currentStrip_

private

Definition at line 162 of file SiStripFEDBuffer.h.

Referenced by operator++(), readNewClusterInfo(), and sampleNumber().

uint16_t sistrip::FEDBSChannelUnpacker::currentWordOffset_

private

Definition at line 158 of file SiStripFEDBuffer.h.

Referenced by adc(), hasData(), operator++(), and readNewClusterInfo().

const uint8_t* sistrip::FEDBSChannelUnpacker::data_

private

Definition at line 156 of file SiStripFEDBuffer.h.

Referenced by adc(), and readNewClusterInfo().

uint16_t sistrip::FEDBSChannelUnpacker::oldWordOffset_

private

Definition at line 157 of file SiStripFEDBuffer.h.

Referenced by adc(), and operator++().

bool sistrip::FEDBSChannelUnpacker::useZS_

private

Definition at line 165 of file SiStripFEDBuffer.h.

Referenced by operator++().

uint8_t sistrip::FEDBSChannelUnpacker::valuesLeftInCluster_

private

Definition at line 166 of file SiStripFEDBuffer.h.

Referenced by operator++(), and readNewClusterInfo().