Class containning control, module, detector and connection information, at the level of a FED channel. More...

#include <FedChannelConnection.h>

Public Member Functions
uint16_t	apvPairNumber () const
const uint16_t &	ccuAddr () const
const uint16_t &	ccuChan () const
void	consistencyCheck () const
const bool &	dcu () const
const uint32_t &	dcuId () const
const uint32_t &	detId () const
const uint16_t &	fecCrate () const
const uint16_t &	fecRing () const
const uint16_t &	fecSlot () const
const uint16_t &	fedCh () const
void	fedCh (uint16_t &fed_ch)
	FedChannelConnection (const uint16_t &fec_crate, const uint16_t &fec_slot, const uint16_t &fec_ring, const uint16_t &ccu_addr, const uint16_t &ccu_chan, const uint16_t &apv0=0, const uint16_t &apv1=0, const uint32_t &dcu_id=0, const uint32_t &det_id=0, const uint16_t &pairs=0, const uint16_t &fed_id=0, const uint16_t &fed_ch=0, const uint16_t &length=0, const bool &dcu=false, const bool &pll=false, const bool &mux=false, const bool &lld=false)
	FedChannelConnection ()
void	fedCrate (uint16_t &fed_crate)
const uint16_t &	fedCrate () const
const uint16_t &	fedId () const
void	fedId (uint16_t &fed_id)
const uint16_t &	fedSlot () const
void	fedSlot (uint16_t &fed_slot)
const uint16_t &	fiberLength () const
const uint16_t &	i2cAddr (const uint16_t &apv0_or_1) const
bool	isConnected () const
const bool &	lld () const
uint16_t	lldChannel () const
const bool &	mux () const
const uint16_t &	nApvPairs () const
uint16_t	nApvs () const
uint16_t	nDetStrips () const
const bool &	pll () const
void	print (std::stringstream &) const
void	terse (std::stringstream &) const
	~FedChannelConnection ()
Private Attributes
uint16_t	apv0_
uint16_t	apv1_
uint16_t	ccuAddr_
uint16_t	ccuChan_
bool	dcu0x00_
uint32_t	dcuId_
uint32_t	detId_
uint16_t	fecCrate_
uint16_t	fecRing_
uint16_t	fecSlot_
uint16_t	fedCh_
uint16_t	fedCrate_
uint16_t	fedId_
uint16_t	fedSlot_
uint16_t	length_
bool	lld0x60_
bool	mux0x43_
uint16_t	nApvPairs_
bool	pll0x44_

Detailed Description

Class containning control, module, detector and connection information, at the level of a FED channel.

Author:: R.Bainbridge

Definition at line 24 of file FedChannelConnection.h.

Constructor & Destructor Documentation

FedChannelConnection::FedChannelConnection	(	const uint16_t &	fec_crate,
		const uint16_t &	fec_slot,
		const uint16_t &	fec_ring,
		const uint16_t &	ccu_addr,
		const uint16_t &	ccu_chan,
		const uint16_t &	apv0 = `0`,
		const uint16_t &	apv1 = `0`,
		const uint32_t &	dcu_id = `0`,
		const uint32_t &	det_id = `0`,
		const uint16_t &	pairs = `0`,
		const uint16_t &	fed_id = `0`,
		const uint16_t &	fed_ch = `0`,
		const uint16_t &	length = `0`,
		const bool &	dcu = `false`,
		const bool &	pll = `false`,
		const bool &	mux = `false`,
		const bool &	lld = `false`
	)

Constructor requires at least information to uniquely identify a front-end module: ie, crate + FEC + ring + CCU + module.

Definition at line 11 of file FedChannelConnection.cc.

                                                              :
  fecCrate_(fec_crate), 
  fecSlot_(fec_slot), 
  fecRing_(fec_ring), 
  ccuAddr_(ccu_addr), 
  ccuChan_(ccu_chan),
  apv0_(apv0), 
  apv1_(apv1),
  dcuId_(dcu_id), 
  detId_(det_id), 
  nApvPairs_(pairs), 
  fedCrate_(sistrip::invalid_),
  fedSlot_(sistrip::invalid_),
  fedId_(fed_id), 
  fedCh_(fed_ch), 
  length_(length),
  dcu0x00_(dcu), 
  mux0x43_(mux), 
  pll0x44_(pll), 
  lld0x60_(lld)
{;}

FedChannelConnection::FedChannelConnection ( )

Default constructor.

Definition at line 51 of file FedChannelConnection.cc.

                                           :
  fecCrate_(sistrip::invalid_), 
  fecSlot_(sistrip::invalid_), 
  fecRing_(sistrip::invalid_), 
  ccuAddr_(sistrip::invalid_), 
  ccuChan_(sistrip::invalid_),
  apv0_(sistrip::invalid_), 
  apv1_(sistrip::invalid_),
  dcuId_(sistrip::invalid32_), 
  detId_(sistrip::invalid32_), 
  nApvPairs_(sistrip::invalid_), 
  fedCrate_(sistrip::invalid_),
  fedSlot_(sistrip::invalid_),
  fedId_(sistrip::invalid_), 
  fedCh_(sistrip::invalid_), 
  length_(sistrip::invalid_),
  dcu0x00_(false), 
  mux0x43_(false), 
  pll0x44_(false), 
  lld0x60_(false)
{;}

FedChannelConnection::~FedChannelConnection ( ) [inline]

Default destructor.

Definition at line 54 of file FedChannelConnection.h.

{;}

Member Function Documentation

uint16_t FedChannelConnection::apvPairNumber ( ) const

Returns APV pair number for this connection object. This can be either 0->1 or 0->2, depending on number of detector strips.

Definition at line 118 of file FedChannelConnection.cc.

References apv0_, apv1_, sistrip::invalid_, edm::isDebugEnabled(), sistrip::mlCabling_, and nApvPairs_.

Referenced by SiStripFEDErrorsDQM::addBadAPV(), SiStripDetCabling::addDevices(), SiStripSpyMonitorModule::analyze(), NoiseTask::book(), CalibrationScanTask::CalibrationScanTask(), CalibrationTask::CalibrationTask(), SiStripShotFilter::filter(), print(), sistrip::FEDEmulatorModule::produce(), SiStripCondObjBuilderFromDb::setValuesCabling(), terse(), PedsOnlyTask::update(), and NoiseTask::update().

                                                   {
  if ( nApvPairs_ == 2 ) {
    if      ( apv0_ == 32 || apv1_ == 33 ) { return 0; }
    else if ( apv0_ == 36 || apv1_ == 37 ) { return 1; }
    else { 
      if ( edm::isDebugEnabled() ) {
        edm::LogWarning(mlCabling_)
          << "[FedChannelConnection::" << __func__ << "]"
          << " APV I2C addresses (" 
          << apv0_ << "/" << apv1_
          << ") are incompatible with"
          << " number of APV pairs (" 
          << nApvPairs_ << ") found for this module!";
      }
    }
  } else if ( nApvPairs_ == 3 ) {
    if      ( apv0_ == 32 || apv1_ == 33 ) { return 0; }
    else if ( apv0_ == 34 || apv1_ == 35 ) { return 1; }
    else if ( apv0_ == 36 || apv1_ == 37 ) { return 2; }
    else { 
      if ( edm::isDebugEnabled() ) {
        edm::LogWarning(mlCabling_)
          << "[FedChannelConnection::" << __func__ << "]"
          << " APV I2C addresses (" 
          << apv0_ << "/" << apv1_
          << ") are incompatible with"
          << " number of APV pairs (" 
          << nApvPairs_ << ") found for this module!";
      }
    }
  } else { 
    if ( edm::isDebugEnabled() ) {
      edm::LogWarning(mlCabling_) 
        << "[FedChannelConnection::" << __func__ << "]"
        << " Unexpected number of APV pairs: " << nApvPairs_;
    }
  }
  return sistrip::invalid_;
}

const uint16_t & FedChannelConnection::ccuAddr ( ) const [inline]

Returns CCU address.

Definition at line 204 of file FedChannelConnection.h.

References ccuAddr_.

Referenced by CommissioningHistosUsingDb::addDcuDetIds(), SiStripModule::addDevices(), SiStripRing::addDevices(), CommissioningTask::CommissioningTask(), SiStripGainCosmicCalculator::getNewObject(), SiStripFecCabling::module(), print(), SiStripCondObjBuilderFromDb::setValuesApvLatency(), terse(), NoiseHistosUsingDb::update(), PedsFullNoiseHistosUsingDb::update(), PedsOnlyHistosUsingDb::update(), PedestalsHistosUsingDb::update(), ApvTimingHistosUsingDb::update(), and CommissioningTask::~CommissioningTask().

{ return ccuAddr_; }

const uint16_t & FedChannelConnection::ccuChan ( ) const [inline]

Returns CCU channel.

Definition at line 205 of file FedChannelConnection.h.

References ccuChan_.

Referenced by CommissioningHistosUsingDb::addDcuDetIds(), SiStripModule::addDevices(), SiStripCcu::addDevices(), CommissioningTask::CommissioningTask(), SiStripGainCosmicCalculator::getNewObject(), SiStripFecCabling::module(), print(), SiStripCondObjBuilderFromDb::setValuesApvLatency(), terse(), NoiseHistosUsingDb::update(), PedsFullNoiseHistosUsingDb::update(), PedsOnlyHistosUsingDb::update(), PedestalsHistosUsingDb::update(), ApvTimingHistosUsingDb::update(), and CommissioningTask::~CommissioningTask().

{ return ccuChan_; }

void FedChannelConnection::consistencyCheck ( ) const [inline]

Performs consistency check for this connection object.

Definition at line 62 of file FedChannelConnection.h.

{;} //@@ TO BE IMPLEMENTED...

const bool & FedChannelConnection::dcu ( ) const [inline]

Indicates whether DCU ASIC is found.

Definition at line 207 of file FedChannelConnection.h.

References dcu0x00_.

Referenced by SiStripModule::addDevices(), and print().

{ return dcu0x00_; }

const uint32_t & FedChannelConnection::dcuId ( ) const [inline]

Returns DCUid for this module.

Definition at line 212 of file FedChannelConnection.h.

References dcuId_.

Referenced by CommissioningHistosUsingDb::addDcuDetIds(), SiStripModule::addDevices(), SiStripFecCabling::dcuId(), print(), and terse().

{ return dcuId_; }

const uint32_t & FedChannelConnection::detId ( ) const [inline]

Returns DetId for this module.

Definition at line 213 of file FedChannelConnection.h.

References detId_.

Referenced by SiStripFEDErrorsDQM::addBadAPV(), CommissioningHistosUsingDb::addDcuDetIds(), SiStripModule::addDevices(), SiStripDetCabling::addDevices(), SiStripCMMonitorPlugin::analyze(), SiStripSpyMonitorModule::analyze(), NoiseTask::book(), CalibrationScanTask::CalibrationScanTask(), CalibrationTask::CalibrationTask(), SiStripFecCabling::detId(), SiStripShotFilter::filter(), print(), sistrip::FEDEmulatorModule::produce(), SiStripFEDErrorsDQM::readBadAPVs(), terse(), and NoiseTask::update().

{ return detId_; }

const uint16_t & FedChannelConnection::fecCrate ( ) const [inline]

Returns FEC crate number.

Definition at line 201 of file FedChannelConnection.h.

References fecCrate_.

Referenced by CommissioningHistosUsingDb::addDcuDetIds(), SiStripModule::addDevices(), SiStripFecCabling::addDevices(), CommissioningTask::CommissioningTask(), SiStripGainCosmicCalculator::getNewObject(), SiStripFecCabling::module(), print(), SiStripCondObjBuilderFromDb::setValuesApvLatency(), terse(), NoiseHistosUsingDb::update(), PedsFullNoiseHistosUsingDb::update(), PedsOnlyHistosUsingDb::update(), PedestalsHistosUsingDb::update(), ApvTimingHistosUsingDb::update(), and CommissioningTask::~CommissioningTask().

{ return fecCrate_; }

const uint16_t & FedChannelConnection::fecRing ( ) const [inline]

Returns FEC ring number.

Definition at line 203 of file FedChannelConnection.h.

References fecRing_.

Referenced by CommissioningHistosUsingDb::addDcuDetIds(), SiStripModule::addDevices(), SiStripFec::addDevices(), CommissioningTask::CommissioningTask(), SiStripGainCosmicCalculator::getNewObject(), SiStripFecCabling::module(), print(), SiStripCondObjBuilderFromDb::setValuesApvLatency(), terse(), NoiseHistosUsingDb::update(), PedsFullNoiseHistosUsingDb::update(), PedsOnlyHistosUsingDb::update(), PedestalsHistosUsingDb::update(), ApvTimingHistosUsingDb::update(), and CommissioningTask::~CommissioningTask().

{ return fecRing_; }

const uint16_t & FedChannelConnection::fecSlot ( ) const [inline]

Returns slot number of FEC.

Definition at line 202 of file FedChannelConnection.h.

References fecSlot_.

Referenced by CommissioningHistosUsingDb::addDcuDetIds(), SiStripModule::addDevices(), SiStripFecCrate::addDevices(), CommissioningTask::CommissioningTask(), SiStripGainCosmicCalculator::getNewObject(), SiStripFecCabling::module(), print(), SiStripCondObjBuilderFromDb::setValuesApvLatency(), terse(), NoiseHistosUsingDb::update(), PedsFullNoiseHistosUsingDb::update(), PedsOnlyHistosUsingDb::update(), PedestalsHistosUsingDb::update(), ApvTimingHistosUsingDb::update(), and CommissioningTask::~CommissioningTask().

{ return fecSlot_; }

void FedChannelConnection::fedCh ( uint16_t & fed_ch ) [inline]

Sets FED id for this channel.

Definition at line 226 of file FedChannelConnection.h.

References fedCh_.

{ fedCh_ = fed_ch; }

const uint16_t & FedChannelConnection::fedCh ( ) const [inline]

Returns FED id for this channel.

Definition at line 221 of file FedChannelConnection.h.

References fedCh_.

Referenced by SiStripFEDErrorsDQM::addBadStrips(), CommissioningHistosUsingDb::addDcuDetIds(), SiStripModule::addDevices(), APVShotsAnalyzer::analyze(), CommissioningTask::CommissioningTask(), operator<(), print(), SiStripCondObjBuilderFromDb::setValuesApvTiming(), SiStripCondObjBuilderFromDb::setValuesCabling(), terse(), NoiseHistosUsingDb::update(), PedsFullNoiseHistosUsingDb::update(), PedsOnlyHistosUsingDb::update(), PedestalsHistosUsingDb::update(), ApvTimingHistosUsingDb::update(), and CommissioningTask::~CommissioningTask().

{ return fedCh_; }

void FedChannelConnection::fedCrate ( uint16_t & fed_crate ) [inline]

Sets FED crate for this channel.

Definition at line 227 of file FedChannelConnection.h.

References fedCrate_.

{ fedCrate_ = fed_crate; }

const uint16_t & FedChannelConnection::fedCrate ( ) const [inline]

Returns FED crate for this channel.

Definition at line 218 of file FedChannelConnection.h.

References fedCrate_.

Referenced by SiStripModule::addDevices(), SiStripFedCablingBuilderFromDb::buildFecCablingFromDevices(), SiStripFedCablingBuilderFromDb::buildFecCablingFromFedConnections(), print(), and terse().

{ return fedCrate_; }

void FedChannelConnection::fedId ( uint16_t & fed_id ) [inline]

Sets FED id for this channel.

Definition at line 225 of file FedChannelConnection.h.

References fedId_.

{ fedId_ = fed_id; }

const uint16_t & FedChannelConnection::fedId ( ) const [inline]

void FedChannelConnection::fedSlot ( uint16_t & fed_slot ) [inline]

Sets FED slot for this channel.

Definition at line 228 of file FedChannelConnection.h.

References fedSlot_.

{ fedSlot_ = fed_slot; }

const uint16_t & FedChannelConnection::fedSlot ( ) const [inline]

Returns FED slot for this channel.

Definition at line 219 of file FedChannelConnection.h.

References fedSlot_.

Referenced by SiStripModule::addDevices(), SiStripFedCablingBuilderFromDb::buildFecCablingFromDevices(), SiStripFedCablingBuilderFromDb::buildFecCablingFromFedConnections(), print(), and terse().

{ return fedSlot_; }

const uint16_t & FedChannelConnection::fiberLength ( ) const [inline]

Returns the length of the optical fiber

Definition at line 223 of file FedChannelConnection.h.

References length_.

{ return length_; }

const uint16_t & FedChannelConnection::i2cAddr ( const uint16_t & apv0_or_1 ) const

Indicates whether APV0 or APV1 of the pair has been found: a non-zero value indicates the I2C address; a null value signifies a problematic APV.

Definition at line 83 of file FedChannelConnection.cc.

References apv0_, apv1_, edm::isDebugEnabled(), and sistrip::mlCabling_.

Referenced by SiStripModule::addDevices(), print(), SiStripCondObjBuilderFromDb::setValuesApvLatency(), and terse().

                                                                         { 
  if      ( apv == 0 ) { return apv0_; }
  else if ( apv == 1 ) { return apv1_; }
  else {
    if ( edm::isDebugEnabled() ) {
      edm::LogWarning(mlCabling_)
        << "[FedChannelConnection::" << __func__ << "]"
        << " Unexpected APV I2C address!" << apv;
    }
    static const uint16_t i2c_addr = 0;
    return i2c_addr;
  }
}

bool FedChannelConnection::isConnected ( ) const [inline]

Identifies a valid connection.

Definition at line 196 of file FedChannelConnection.h.

References fedCh_, fedId_, and sistrip::invalid_.

Referenced by SiStripFEDErrorsDQM::addBadAPV(), APVShotsAnalyzer::analyze(), SiStripCMMonitorPlugin::analyze(), SiStripSpyMonitorModule::analyze(), SiStripFEDErrorsDQM::readBadAPVs(), and SiStripFEDErrorsDQM::readHistogram().

                                                    { 
  return ( fedId_ != sistrip::invalid_ && 
           fedCh_ != sistrip::invalid_ );
}

const bool & FedChannelConnection::lld ( ) const [inline]

Indicates whether Linear Laser Driver ASIC is found.

Definition at line 210 of file FedChannelConnection.h.

References lld0x60_.

Referenced by SiStripModule::addDevices(), and print().

{ return lld0x60_; }

uint16_t FedChannelConnection::lldChannel ( ) const

Returns Laser Driver channel (1->3) for this channel.

Definition at line 99 of file FedChannelConnection.cc.

References apv0_, apv1_, sistrip::invalid_, edm::isDebugEnabled(), and sistrip::mlCabling_.

Referenced by CommissioningHistosUsingDb::addDcuDetIds(), CommissioningTask::CommissioningTask(), print(), NoiseHistosUsingDb::update(), PedsFullNoiseHistosUsingDb::update(), PedsOnlyHistosUsingDb::update(), PedestalsHistosUsingDb::update(), ApvTimingHistosUsingDb::update(), and CommissioningTask::~CommissioningTask().

                                                {
  if      ( apv0_ == 32 || apv1_ == 33 ) { return 1; }
  else if ( apv0_ == 34 || apv1_ == 35 ) { return 2; }
  else if ( apv0_ == 36 || apv1_ == 37 ) { return 3; }
  else if ( apv0_ != sistrip::invalid_ ||
            apv1_ != sistrip::invalid_ ) {
    if ( edm::isDebugEnabled() ) {
      edm::LogWarning(mlCabling_)
        << "[FedChannelConnection::" << __func__ << "]"
        << " Unexpected APV I2C addresses!" 
        << " Apv0: " << apv0_
        << " Apv1: " << apv1_;
    }
  }
  return sistrip::invalid_;
}

const bool & FedChannelConnection::mux ( ) const [inline]

Indicates whether APV-MUX ASIC is found.

Definition at line 208 of file FedChannelConnection.h.

References mux0x43_.

Referenced by SiStripModule::addDevices(), and print().

{ return mux0x43_; }

const uint16_t & FedChannelConnection::nApvPairs ( ) const [inline]

Returns number of APV pairs for this module.

Definition at line 215 of file FedChannelConnection.h.

References nApvPairs_.

Referenced by SiStripModule::addDevices(), SiStripCMMonitorPlugin::analyze(), SiStripFecCabling::nApvPairs(), nApvs(), print(), sistrip::FEDEmulatorModule::produce(), and terse().

{ return nApvPairs_; }

uint16_t FedChannelConnection::nApvs ( ) const [inline]

Returns number of APVs for this module.

Definition at line 216 of file FedChannelConnection.h.

References nApvPairs().

{ return 2*nApvPairs(); }

uint16_t FedChannelConnection::nDetStrips ( ) const [inline]

Returns number of detector strips for this module.

Definition at line 214 of file FedChannelConnection.h.

References nApvPairs_.

{ return 256*nApvPairs_; }

const bool & FedChannelConnection::pll ( ) const [inline]

Indicates whether PLL ASIC is found.

Definition at line 209 of file FedChannelConnection.h.

References pll0x44_.

Referenced by SiStripModule::addDevices(), and print().

{ return pll0x44_; }

void FedChannelConnection::print ( std::stringstream & ss ) const

Prints all information for this connection object.

Definition at line 160 of file FedChannelConnection.cc.

References apvPairNumber(), ccuAddr(), ccuChan(), dcu(), dcuId(), detId(), fecCrate(), SiStripFedKey::feChan(), fecRing(), fecSlot(), fedCh(), fedCrate(), fedId(), fedSlot(), SiStripFedKey::feUnit(), i2cAddr(), lld(), lldChannel(), mux(), nApvPairs(), and pll().

Referenced by operator<<().

                                                            {
  ss << " [FedChannelConnection::" << __func__ << "]" << std::endl
     << " FedCrate/FedSlot/FedId/FeUnit/FeChan/FedCh : "
     << fedCrate() << "/"
     << fedSlot() << "/"
     << fedId() << "/"
     << SiStripFedKey::feUnit( fedCh() ) << "/" 
     << SiStripFedKey::feChan( fedCh() ) << "/" 
     << fedCh() << std::endl
     << " FecCrate/FecSlot/FecRing/CcuAddr/CcuChan   : "
     << fecCrate() << "/"
     << fecSlot() << "/"
     << fecRing() << "/"
     << ccuAddr() << "/"
     << ccuChan() << std::endl
     << " DcuId/DetId                                : "
     << std::hex
     << "0x" << std::setfill('0') << std::setw(8) << dcuId() << "/"
     << "0x" << std::setfill('0') << std::setw(8) << detId() << std::endl
     << std::dec
     << " LldChan/APV0/APV1                          : "
     << lldChannel() << "/" 
     << i2cAddr(0) << "/"
     << i2cAddr(1) << std::endl
     << " pairNumber/nPairs/nStrips                  : "
     << apvPairNumber() << "/"
     << nApvPairs() << "/"
     << 256*nApvPairs() << std::endl
     << " DCU/MUX/PLL/LLD found                      : "
     << std::boolalpha
     << dcu() << "/"
     << mux() << "/"
     << pll() << "/"
     << lld()
     << std::noboolalpha;
}

void FedChannelConnection::terse ( std::stringstream & ss ) const

Prints terse information for this connection object.

Definition at line 199 of file FedChannelConnection.cc.

References apvPairNumber(), ccuAddr(), ccuChan(), dcuId(), detId(), fecCrate(), SiStripFedKey::feChan(), fecRing(), fecSlot(), fedCh(), fedCrate(), fedId(), fedSlot(), SiStripFedKey::feUnit(), i2cAddr(), and nApvPairs().

                                                            {
  ss << " FED:cr/sl/id/fe/ch/chan=" 
     << fedCrate() << "/" 
     << fedSlot() << "/" 
     << fedId() << "/" 
     << SiStripFedKey::feUnit( fedCh() ) << "/" 
     << SiStripFedKey::feChan( fedCh() ) << "/" 
     << fedCh() << "," 
     << " FEC:cr/sl/ring/ccu/mod="
     << fecCrate() << "/"
     << fecSlot() << "/" 
     << fecRing() << "/"
     << ccuAddr() << "/" 
     << ccuChan() << ","
     << " apvs=" 
     << i2cAddr(0) << "/" 
     << i2cAddr(1) << "," 
     << " pair=" << apvPairNumber()+1
     << " (from " << nApvPairs() << "),"
     << " dcu/detid=" 
     << std::hex
     << "0x" << std::setfill('0') << std::setw(8) << dcuId() << "/"
     << "0x" << std::setfill('0') << std::setw(8) << detId() 
     << std::dec;
}