SiStripFedCabling Class Reference

Contains cabling info at the device level, including DetId, APV pair numbers, hardware addresses, DCU id... More...

#include <SiStripFedCabling.h>

Classes
class	ConnsRange
	Builds range of iterators from pair of offsets. More...

Public Types
typedef std::vector < FedChannelConnection >	Conns
typedef Conns::const_iterator	ConnsConstIter
typedef boost::iterator_range < ConnsConstIter >	ConnsConstIterRange
typedef Conns::iterator	ConnsIter
typedef boost::iterator_range < ConnsIter >	ConnsIterRange
typedef std::pair< uint32_t, uint32_t >	ConnsPair
typedef std::vector< uint16_t >	Feds
typedef Feds::const_iterator	FedsConstIter
typedef boost::iterator_range < FedsConstIter >	FedsConstIterRange
typedef Feds::iterator	FedsIter
typedef boost::iterator_range < FedsIter >	FedsIterRange
typedef std::vector< ConnsPair >	Registry

Public Member Functions
void	buildFedCabling (ConnsConstIterRange connections)
ConnsConstIterRange	detectedDevices () const
FedChannelConnection	fedConnection (uint16_t fed_id, uint16_t fed_ch) const
ConnsConstIterRange	fedConnections (uint16_t fed_id) const
FedsConstIterRange	fedIds () const
void	print (std::stringstream &ss) const
	LEFT FOR COMPATIBILITY. SHOULD BE REPLACED BY PRINTDEBUG. More...
void	printDebug (std::stringstream &) const
void	printSummary (std::stringstream &) const
ConnsRange	range (ConnsPair) const
	Builds range of iterators from pair of offsets. More...
	SiStripFedCabling (ConnsConstIterRange)
	SiStripFedCabling (const SiStripFedCabling &)
	SiStripFedCabling ()
void	summary (std::stringstream &ss) const
	LEFT FOR COMPATIBILITY. SHOULD BE REPLACED BY PRINTSUMMARY. More...
void	terse (std::stringstream &) const
ConnsConstIterRange	undetectedDevices () const
	~SiStripFedCabling ()

Private Attributes
	COND_SERIALIZABLE
Conns	connections_
	Container of connection objects. More...
Conns	detected_
	Connections to FE devices that are not detected. More...
Feds	feds_
	"Active" FEDs that have connected FE devices More...
Registry	registry_
	Container of "ranges" indexed by FED id. More...
Conns	undetected_
	FE devices that are detected. More...

Detailed Description

Contains cabling info at the device level, including DetId, APV pair numbers, hardware addresses, DCU id...

Definition at line 27 of file SiStripFedCabling.h.

Member Typedef Documentation

typedef std::vector<FedChannelConnection> SiStripFedCabling::Conns

Definition at line 43 of file SiStripFedCabling.h.

typedef Conns::const_iterator SiStripFedCabling::ConnsConstIter

Definition at line 47 of file SiStripFedCabling.h.

typedef boost::iterator_range<ConnsConstIter> SiStripFedCabling::ConnsConstIterRange

Definition at line 51 of file SiStripFedCabling.h.

typedef Conns::iterator SiStripFedCabling::ConnsIter

Definition at line 45 of file SiStripFedCabling.h.

typedef boost::iterator_range<ConnsIter> SiStripFedCabling::ConnsIterRange

Definition at line 49 of file SiStripFedCabling.h.

typedef std::pair<uint32_t,uint32_t> SiStripFedCabling::ConnsPair

Definition at line 53 of file SiStripFedCabling.h.

typedef std::vector<uint16_t> SiStripFedCabling::Feds

Definition at line 33 of file SiStripFedCabling.h.

typedef Feds::const_iterator SiStripFedCabling::FedsConstIter

Definition at line 37 of file SiStripFedCabling.h.

typedef boost::iterator_range<FedsConstIter> SiStripFedCabling::FedsConstIterRange

Definition at line 41 of file SiStripFedCabling.h.

typedef Feds::iterator SiStripFedCabling::FedsIter

Definition at line 35 of file SiStripFedCabling.h.

typedef boost::iterator_range<FedsIter> SiStripFedCabling::FedsIterRange

Definition at line 39 of file SiStripFedCabling.h.

typedef std::vector<ConnsPair> SiStripFedCabling::Registry

Definition at line 55 of file SiStripFedCabling.h.

Constructor & Destructor Documentation

SiStripFedCabling::SiStripFedCabling

(

ConnsConstIterRange

input

)

Constructor taking FED channel connection objects as input.

Definition at line 13 of file SiStripFedCabling.cc.

References buildFedCabling(), LogTrace, and sistrip::mlCabling_.

  : feds_(),
    registry_(),
    connections_(),
    detected_(),
    undetected_()
{
  LogTrace(mlCabling_)
    << "[SiStripFedCabling::" << __func__ << "]"
    << " Constructing object from connection range...";
  buildFedCabling( input );
}

SiStripFedCabling::SiStripFedCabling

(

const SiStripFedCabling &

input

)

Copy constructor.

Definition at line 28 of file SiStripFedCabling.cc.

References LogTrace, and sistrip::mlCabling_.

  : feds_( input.feds_ ),
    registry_( input.registry_ ),
    connections_( input.connections_ ),
    detected_( input.detected_ ),
    undetected_( input.undetected_ )
{
  LogTrace(mlCabling_)
    << "[SiStripFedCabling::" << __func__ << "]"
    << " Copy constructing object...";
}

SiStripFedCabling::SiStripFedCabling

(

)

Public default constructor.

Definition at line 42 of file SiStripFedCabling.cc.

References LogTrace, and sistrip::mlCabling_.

  : feds_(),
    registry_(),
    connections_(),
    detected_(),
    undetected_()
{
  LogTrace(mlCabling_) 
    << "[SiStripFedCabling::" << __func__ << "]"
    << " Default constructing object...";
}

SiStripFedCabling::~SiStripFedCabling

(

)

Default destructor.

Definition at line 56 of file SiStripFedCabling.cc.

References LogTrace, and sistrip::mlCabling_.

                                      {
  LogTrace(mlCabling_)
    << "[SiStripFedCabling::" << __func__ << "]"
    << " Destructing object...";
}

Member Function Documentation

void SiStripFedCabling::buildFedCabling

(

ConnsConstIterRange

connections

)

Builds FED cabling from vector of FED connections.

Definition at line 64 of file SiStripFedCabling.cc.

References SiStripFedCabling::ConnsRange::begin(), results_mgr::conn, connections_, filterCSVwithJSON::copy, SiStripFedCabling::ConnsRange::emptyPair(), feds_, spr::find(), cuy::ii, cmsHarvester::index, getDQMSummary::iter, findQualityFiles::jj, LogTrace, FEDNumbering::MAXSiStripFEDID, FEDNumbering::MINSiStripFEDID, sistrip::mlCabling_, range(), registry_, python.multivaluedict::sort(), contentValuesCheck::ss, and groupFilesInBlocks::temp.

Referenced by SiStripFedCablingBuilderFromDb::getFedCabling(), and SiStripFedCabling().

                                                                   {
  
  // Check input
  if ( input.empty() ) {
    edm::LogError(mlCabling_)
      << "[SiStripFedCabling::" << __func__ << "]"
      << " Input vector of FedChannelConnections is of zero size!"
      << " Unable to populate FED cabling object!"; 
    return;
  }
  
  std::stringstream ss;
  ss << "[SiStripFedCabling::" << __func__ << "]"
     << " Building FED cabling from " 
     << input.size()
     << " connections...";
  LogTrace(mlCabling_) << ss.str();
  
  // Sort input vector by FED id and channel
  Conns temp( input.size() );
  std::copy( input.begin(), input.end(), temp.begin() );
  std::sort( temp.begin(), temp.end() );
  
  // Strip FED ids
  uint16_t min_id = static_cast<uint16_t>( FEDNumbering::MINSiStripFEDID );
  uint16_t max_id = static_cast<uint16_t>( FEDNumbering::MAXSiStripFEDID );
  uint16_t nfeds  = max_id - min_id + 1;
  
  // Initialise containers
  connections_.clear();
  connections_.reserve( 96 * nfeds );
  registry_.clear();
  feds_.clear();
  registry_.resize( nfeds, ConnsRange::emptyPair() );
  
  // Populate container
  ConnsIter ii = temp.begin(); 
  ConnsIter jj = temp.end(); 
  for ( ; ii != jj; ++ii ) {
    
    uint16_t fed_id = ii->fedId();
    uint16_t fed_ch = ii->fedCh();
    uint16_t index  = fed_id - min_id;
    
    if ( fed_id < min_id || fed_id > max_id ) { continue; }
    if ( index >= registry_.size() ) { continue; }
    if ( !ii->isConnected() ) { continue; }
    
    FedsConstIter iter = find( feds_.begin(), feds_.end(), fed_id );
    if ( iter == feds_.end() ) { feds_.push_back( fed_id ); }
    
    if ( registry_[index] == ConnsRange::emptyPair() ) {
      ConnsPair conns_pair;
      conns_pair.first = std::distance( connections_.begin(), connections_.end() );
      connections_.insert( connections_.end(), 96, FedChannelConnection() ); 
      conns_pair.second = std::distance( connections_.begin(), connections_.end() );
      registry_[index] = conns_pair;
    } 

    ConnsRange conns = range( registry_[index] );
    ConnsConstIter iconn = conns.begin() + fed_ch;
    FedChannelConnection& conn = const_cast<FedChannelConnection&>(*iconn);
    conn = *ii;

  }
  
}

SiStripFedCabling::ConnsConstIterRange SiStripFedCabling::detectedDevices ( ) const

inline

Returns information for "detected, but unconnected" devices.

Definition at line 172 of file SiStripFedCabling.h.

References detected_.

Referenced by SiStripDetCabling::SiStripDetCabling().

                                                                                     { 
  return ConnsConstIterRange( detected_.begin(), detected_.end() ); 
}

FedChannelConnection SiStripFedCabling::fedConnection	(	uint16_t	fed_id,
		uint16_t	fed_ch
	)		const

Returns connection object for a given FED id and channel.

Definition at line 207 of file SiStripFedCabling.cc.

References fedConnections().

Referenced by CommissioningHistosUsingDb::addDcuDetIds(), SiStripSpyMonitorModule::analyze(), SiStripCMMonitorPlugin::analyze(), SiStripShotFilter::filter(), sistrip::FEDEmulatorModule::produce(), SiStripFEDErrorsDQM::readHistogram(), PedsOnlyHistosUsingDb::update(), NoiseHistosUsingDb::update(), PedestalsHistosUsingDb::update(), PedsFullNoiseHistosUsingDb::update(), and ApvTimingHistosUsingDb::update().

                                                       {
  ConnsConstIterRange conns = fedConnections( fed_id );
  if ( !conns.empty() && conns.size() == 96 && fed_ch < 96 ) {
    return *( conns.begin() + fed_ch ); 
  } else { return FedChannelConnection(); }
}

SiStripFedCabling::ConnsConstIterRange SiStripFedCabling::fedConnections

(

uint16_t

fed_id

)

const

Returns all connection objects for a given FED id.

Definition at line 198 of file SiStripFedCabling.cc.

References cmsHarvester::index, SiStripFedCabling::ConnsRange::invalid(), FEDNumbering::MINSiStripFEDID, SiStripFedCabling::ConnsRange::range(), range(), and registry_.

Referenced by SiStripFecCabling::buildFecCabling(), ViewTranslator::buildMaps(), FineDelayHistosUsingDb::computeDelays(), sistrip::SpyUnpacker::createDigis(), sistrip::RawToDigiUnpacker::createDigis(), SiStripCommissioningSource::createTasks(), SiStripCommissioningSource::endJob(), fedConnection(), SiStripCommissioningSource::fillHistos(), LaserAlignmentEventFilter::filter(), SiStripFedCablingManipulator::manipulate(), sistrip::SpyDigiConverter::mergeModuleChannels(), sistrip::ExcludedFEDListProducer::produce(), SiStripFEDErrorsDQM::readBadAPVs(), SiStripDetCabling::SiStripDetCabling(), TrackerMap::TrackerMap(), LatencyHistosUsingDb::update(), and FineDelayHistosUsingDb::update().

                                                                                              {
  uint16_t index = fed_id - FEDNumbering::MINSiStripFEDID;
  if ( index < registry_.size() ) { 
    return range( registry_[ index ] ).range();
  } else { return range( registry_[ index ] ).invalid(); }
}

SiStripFedCabling::FedsConstIterRange SiStripFedCabling::fedIds ( ) const

inline

Retrieve vector of active FED ids.

Definition at line 168 of file SiStripFedCabling.h.

References feds_.

Referenced by SiStripCommissioningSource::beginRun(), SiStripFecCabling::buildFecCabling(), ViewTranslator::buildMaps(), FineDelayHistosUsingDb::computeDelays(), sistrip::SpyUnpacker::createDigis(), sistrip::RawToDigiUnpacker::createDigis(), SiStripCommissioningSource::createTasks(), SiStripCommissioningSource::endJob(), SiStripCommissioningSource::fillCablingHistos(), SiStripCommissioningSource::fillHistos(), SiStripFedCablingManipulator::manipulate(), sistrip::SpyDigiConverter::mergeModuleChannels(), sistrip::ExcludedFEDListProducer::produce(), SiStripFEDErrorsDQM::readBadAPVs(), SiStripDetCabling::SiStripDetCabling(), TrackerMap::TrackerMap(), ApvTimingHistosUsingDb::update(), LatencyHistosUsingDb::update(), and FineDelayHistosUsingDb::update().

                                                                           {
  return FedsConstIterRange( feds_.begin(), feds_.end() );
}

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

inline

LEFT FOR COMPATIBILITY. SHOULD BE REPLACED BY PRINTDEBUG.

Definition at line 97 of file SiStripFedCabling.h.

References printDebug().

Referenced by operator<<().

                                          {
    printDebug(ss);
  }

void SiStripFedCabling::printDebug

(

std::stringstream &

ss

)

const

Prints all connection information for this FED cabling object.

Definition at line 217 of file SiStripFedCabling.cc.

References SiStripFedCabling::ConnsRange::begin(), detected_, SiStripFedCabling::ConnsRange::end(), feds_, cuy::ii, cmsHarvester::index, sistrip::invalid_, findQualityFiles::jj, FEDNumbering::MINSiStripFEDID, range(), registry_, SiStripFedCabling::ConnsRange::size(), pileupDistInMC::total, and undetected_.

Referenced by print().

                                                              {

  uint16_t total = 0;
  uint16_t nfeds = 0;
  uint16_t cntr = 0;

  if ( feds_.empty() ) {
    ss << "[SiStripFedCabling::" << __func__ << "]"
       << " No FEDs found! Unable to  print cabling map!";
    return;
  } else {
    ss << "[SiStripFedCabling::" << __func__ << "]"
       << " Printing cabling map for " << feds_.size()
       << " FEDs with following ids: ";
  }
  
  std::vector<uint16_t>::const_iterator ii = feds_.begin(); 
  std::vector<uint16_t>::const_iterator jj = feds_.end(); 
  for ( ; ii != jj; ++ii ) { ss << *ii << " "; }
  ss << std::endl << std::endl;
  
  std::vector<uint16_t>::const_iterator ifed = feds_.begin(); 
  std::vector<uint16_t>::const_iterator jfed = feds_.end(); 
  for ( ; ifed != jfed; ++ifed ) {
    
    uint16_t index = *ifed - FEDNumbering::MINSiStripFEDID;
    if ( index < registry_.size() ) { 
      ConnsRange conns = range( registry_[ index ] );
      
      ss << " Printing cabling information for FED id " << *ifed 
     << " (found " << conns.size() 
     << " FedChannelConnection objects...)"
     << std::endl;
      
      uint16_t ichan = 0;
      uint16_t connected = 0;
      ConnsConstIter iconn = conns.begin();
      ConnsConstIter jconn = conns.end();
      for ( ; iconn != jconn; ++iconn ) { 
    if ( iconn->fedId() != sistrip::invalid_ ) { 
      connected++; 
      ss << *iconn << std::endl;
    } else {
      ss << "  (FedId/Ch " << *ifed << "/" << ichan 
         << ": unconnected channel...)" << std::endl;
      cntr++;
    }
    ichan++;
      } 
      
      ss << " Found " << connected 
     << " connected channels for FED id " << *ifed << std::endl
     << std::endl;
      if ( connected ) { nfeds++; total += connected; }
      
    }
    
  }
  
  float percent = (100.*cntr) / (96.*nfeds);
  percent = static_cast<uint16_t>( 10.*percent );
  percent /= 10.;
  ss << " Found " << total 
     << " APV pairs that are connected to a total of " 
     << nfeds << " FEDs" << std::endl
     << " " << detected_.size() 
     << " APV pairs have been detected, but are not connected" << std::endl
     << " " << undetected_.size()
     << " APV pairs are undetected (wrt DCU-DetId map)" << std::endl
     << " " << cntr
     << " FED channels out of a possible " << (96*nfeds)
     << " (" << nfeds << " FEDs) are unconnected (" 
     << percent << "%)" << std::endl
     << std::endl;
  
}

void SiStripFedCabling::printSummary

(

std::stringstream &

ss

)

const

Prints summary information for this FED cabling object.

Definition at line 345 of file SiStripFedCabling.cc.

References SiStripFedCabling::ConnsRange::begin(), detected_, feds_, SiStripFedKey::feUnit(), cuy::ii, cmsHarvester::index, findQualityFiles::jj, FEDNumbering::MINSiStripFEDID, sistrip::mlCabling_, range(), registry_, SiStripFedCabling::ConnsRange::size(), pileupDistInMC::total, undetected_, csvLumiCalc::unit, and sistrip::valid_.

Referenced by summary().

                                                                {

  ss << "[SiStripFedCabling::" << __func__ << "]";
  
  if ( feds_.empty() ) {
    ss << " No FEDs found!";
    return;
  } 
  
  ss << " Found " << feds_.size() << " FEDs"
     << " with number of connected channels per front-end unit: " 
     << std::endl
     << " FedId FeUnit1 FeUnit2 FeUnit3 FeUnit4 FeUnit5 FeUnit6 FeUnit7 FeUnit8 Total" 
     << std::endl;
  
  uint16_t total = 0;
  uint16_t nfeds = 0;
  
  // iterate through fed ids
  std::vector<uint16_t>::const_iterator ii = feds_.begin(); 
  std::vector<uint16_t>::const_iterator jj = feds_.end(); 
  for ( ; ii != jj; ++ii ) { 

    // check number of connection objects
    uint16_t index = *ii - FEDNumbering::MINSiStripFEDID;
    if ( index < registry_.size() ) { 
      ConnsRange conns = range( registry_[ index ] ); 

      if ( conns.size() < 96 ) { 
    edm::LogError(mlCabling_) 
      << "[SiStripFedCabling::" << __func__ << "]"
      << " Unexpected size for FedChannelConnection vector! " 
      << conns.size();
    return;
      }

      // count connected channels at level of fe unit
      std::vector<uint16_t> connected;
      connected.resize(8,0);
      for ( uint16_t ichan = 0; ichan < 96; ++ichan ) {
    ConnsConstIter iconn = conns.begin() + ichan;
    if ( iconn->fedId() < sistrip::valid_ ) { 
      uint16_t unit = SiStripFedKey::feUnit(ichan);
      if ( unit > 8 ) { continue; }
      connected[unit-1]++; 
    } 
      }
      
      // increment counters
      uint16_t tot = 0 ;
      ss << " " << std::setw(5) << *ii;
      if ( !connected.empty() ) { nfeds++; }
      for ( uint16_t unit = 0; unit < 8; ++unit ) {
    ss << " " << std::setw(7) << connected[unit];
    if ( !connected.empty() ) { tot += connected[unit]; }
      }
      ss << " " << std::setw(5) << tot << std::endl;
      total += tot;
      
    } 
  
  }
  
  // print out
  float percent = (100.*total) / (96.*nfeds);
  percent = static_cast<uint16_t>( 10.*percent );
  percent /= 10.;
  ss << " Found: " << std::endl 
     << " " << nfeds << " out of " << feds_.size()
     << " FEDs with at least one connected channel " << std::endl 
     << " " << feds_.size() - nfeds << " out of " << feds_.size()
     << " FEDs with no connected channels." << std::endl 
     << " " << total << " connected channels in total" << std::endl
     << " " << detected_.size() 
     << " APV pairs have been detected, but are not connected" << std::endl
     << " " << undetected_.size() 
     << " APV pairs are undetected (wrt DCU-DetId map)" << std::endl
     << " " << percent
     << "% of FED channels are connected"  << std::endl;
  
}

SiStripFedCabling::ConnsRange SiStripFedCabling::range ( SiStripFedCabling::ConnsPair  p ) const

inline

Builds range of iterators from pair of offsets.

Definition at line 216 of file SiStripFedCabling.h.

References connections_.

Referenced by buildFedCabling(), fedConnections(), printDebug(), printSummary(), and terse().

                                                                                                {
  return ConnsRange( connections_, p );
}

void SiStripFedCabling::summary ( std::stringstream &  ss ) const

inline

LEFT FOR COMPATIBILITY. SHOULD BE REPLACED BY PRINTSUMMARY.

Definition at line 107 of file SiStripFedCabling.h.

References printSummary().

Referenced by CommissioningHistosUsingDb::CommissioningHistosUsingDb(), and sistrip::RawToDigiModule::updateCabling().

                                            {
    printSummary(ss);
  }

void SiStripFedCabling::terse

(

std::stringstream &

ss

)

const

Prints terse information for this FED cabling object.

Definition at line 296 of file SiStripFedCabling.cc.

References SiStripFedCabling::ConnsRange::begin(), SiStripFedCabling::ConnsRange::end(), feds_, cmsHarvester::index, sistrip::invalid_, FEDNumbering::MINSiStripFEDID, range(), registry_, and SiStripFedCabling::ConnsRange::size().

Referenced by CommissioningHistosUsingDb::CommissioningHistosUsingDb(), and sistrip::RawToDigiModule::updateCabling().

                                                         {
  

  ss << "[SiStripFedCabling::" << __func__ << "]";
    
  if ( feds_.empty() ) {
    ss << " No FEDs found! Unable to print cabling map!";
    return;
  } 
  
  ss << " Printing cabling map for " << feds_.size()
     << " FEDs: " << std::endl << std::endl;
  
  std::vector<uint16_t>::const_iterator ifed = feds_.begin(); 
  std::vector<uint16_t>::const_iterator jfed = feds_.end(); 
  for ( ; ifed != jfed; ++ifed ) {
    
    uint16_t index = *ifed - FEDNumbering::MINSiStripFEDID;
    if ( index < registry_.size() ) { 
      ConnsRange conns = range( registry_[ index ] ); 
      
      ss << " Printing cabling information for FED id " << *ifed 
     << " (found " << conns.size() 
     << " FedChannelConnection objects...)"
     << std::endl;
      
      uint16_t connected = 0;
      ConnsConstIter iconn = conns.begin();
      ConnsConstIter jconn = conns.end();
      for ( ; iconn != jconn; ++iconn ) { 
    if ( iconn->fedId() != sistrip::invalid_ ) { 
      connected++; 
      iconn->terse(ss); 
      ss << std::endl;
    }
      } 
      
      ss << " Found " << connected 
     << " connected channels for FED id " << *ifed << std::endl
     << std::endl;
      
    }
    
  }
  
}

SiStripFedCabling::ConnsConstIterRange SiStripFedCabling::undetectedDevices ( ) const

inline

Returns information for all "undetected" devices.

Definition at line 176 of file SiStripFedCabling.h.

References undetected_.

Referenced by SiStripDetCabling::SiStripDetCabling().

                                                                                      { 
  return ConnsConstIterRange( undetected_.begin(), undetected_.end() ); 
}

Member Data Documentation

SiStripFedCabling::COND_SERIALIZABLE

private

Definition at line 163 of file SiStripFedCabling.h.

Conns SiStripFedCabling::connections_

private

Container of connection objects.

Definition at line 154 of file SiStripFedCabling.h.

Referenced by buildFedCabling(), and range().

Conns SiStripFedCabling::detected_

private

Connections to FE devices that are not detected.

Definition at line 157 of file SiStripFedCabling.h.

Referenced by detectedDevices(), printDebug(), and printSummary().

Feds SiStripFedCabling::feds_

private

"Active" FEDs that have connected FE devices

Definition at line 148 of file SiStripFedCabling.h.

Referenced by buildFedCabling(), fedIds(), printDebug(), printSummary(), and terse().

Registry SiStripFedCabling::registry_

private

Container of "ranges" indexed by FED id.

Definition at line 151 of file SiStripFedCabling.h.

Referenced by buildFedCabling(), fedConnections(), printDebug(), printSummary(), and terse().

Conns SiStripFedCabling::undetected_

private

FE devices that are detected.

Definition at line 160 of file SiStripFedCabling.h.

Referenced by printDebug(), printSummary(), and undetectedDevices().