TotemFramePosition Class Reference

#include <TotemFramePosition.h>

Public Types
enum	SubSystemType {   ssNone =0, ssT1 =1, ssT2 =2, ssRP =3,   ssTrigger =4, ssTTC =5, ssFEC =6 }
	the official enumeration of DAQ subsystems More...

Public Member Functions
unsigned short	getFullOptoRxId () const
unsigned short	getGOHId () const
unsigned short	getIdxInFiber () const
unsigned short	getOptoRxId () const
unsigned int	getRawPosition () const
	don't use this method unless you have a good reason More...
unsigned short	getSubSystemId () const
unsigned short	getTOTFEDId () const
bool	operator< (const TotemFramePosition &pos) const
bool	operator== (const TotemFramePosition &pos) const
void	printXML ()
	prints XML formatted DAQ channel to stdout More...
void	setAllIDs (unsigned short SubSystemId, unsigned short TOTFEDId, unsigned short OptoRxId, unsigned short GOHId, unsigned short IdxInFiber)
void	setGOHId (unsigned short v)
void	setIdxInFiber (unsigned short v)
void	setOptoRxId (unsigned short v)
void	setSubSystemId (unsigned short v)
void	setTOTFEDId (unsigned short v)
unsigned char	setXMLAttribute (const std::string &attribute, const std::string &value, unsigned char &flag)
	TotemFramePosition (unsigned short SubSystemId, unsigned short TOTFEDId, unsigned short OptoRxId, unsigned short GOHId, unsigned short IdxInFiber)
	the preferred constructor More...
	TotemFramePosition (unsigned int pos=0)
	don't use this constructor unless you have a good reason More...
	~TotemFramePosition ()

Static Public Member Functions
static bool	checkXMLAttributeFlag (unsigned char flag)
	returns true if all attributes have been set More...

Static Public Attributes
static const unsigned int	maskGOHId = 0xF
static const unsigned int	maskIdxInFiber = 0xF
static const unsigned int	maskOptoRxId = 0x3
static const unsigned int	maskSubSystemId = 0x7
static const unsigned int	maskTOTFEDId = 0x1F
static const unsigned int	offsetGOHId = 4
static const unsigned int	offsetIdxInFiber = 0
static const unsigned int	offsetOptoRxId = 8
static const unsigned int	offsetSubSystemId = 15
static const unsigned int	offsetTOTFEDId = 10
static const std::string	tagSSFEC = "FEC"
static const std::string	tagSSNone = "None"
	XML sub-system tags. More...
static const std::string	tagSSRP = "RP"
static const std::string	tagSST1 = "T1"
static const std::string	tagSST2 = "T2"
static const std::string	tagSSTrigger = "Trigger"
static const std::string	tagSSTTC = "TTC"

Protected Attributes
unsigned int	rawPosition

Friends
std::ostream &	operator<< (std::ostream &s, const TotemFramePosition &fp)

Detailed Description

Uniquely identifies the DAQ channel through which a VFAT frame has been received.

The internal representation has the following structure:

* |                               32 bits raw position                                 |
* | 12 bits | 2 bits |  3 bits   |  5 bits   |  2 bits   | 4 bits |       4 bits       |
* |  empty  | empty  | SubSystem | TOTFED ID | OptoRx ID | GOH ID | index within fiber |
* |         |   (this part is encoded in OptoRx header)  |                             |
* 

According to the convention SubSystemId goes from 1 to 6, TOTFEDId from 1 to 21 and OptoRx from 1 to 3.

Definition at line 27 of file TotemFramePosition.h.

Member Enumeration Documentation

enum TotemFramePosition::SubSystemType

the official enumeration of DAQ subsystems

Enumerator
ssNone
ssT1
ssT2
ssRP
ssTrigger
ssTTC
ssFEC

Definition at line 31 of file TotemFramePosition.h.

{ssNone=0, ssT1=1, ssT2=2, ssRP=3, ssTrigger=4, ssTTC=5, ssFEC=6};

Constructor & Destructor Documentation

TotemFramePosition::TotemFramePosition ( unsigned short  SubSystemId, unsigned short  TOTFEDId, unsigned short  OptoRxId, unsigned short  GOHId, unsigned short  IdxInFiber  )

inline

the preferred constructor

Definition at line 40 of file TotemFramePosition.h.

                                                                                                                                                      :
      rawPosition(IdxInFiber<<offsetIdxInFiber | GOHId<<offsetGOHId | OptoRxId<<offsetOptoRxId | TOTFEDId<<offsetTOTFEDId | SubSystemId<<offsetSubSystemId)
    {
    }

TotemFramePosition::TotemFramePosition ( unsigned int  pos = 0 )

inline

don't use this constructor unless you have a good reason

Definition at line 46 of file TotemFramePosition.h.

                                             : rawPosition(pos)
    {
    }

TotemFramePosition::~TotemFramePosition ( )

inline

Definition at line 50 of file TotemFramePosition.h.

    {
    }

Member Function Documentation

static bool TotemFramePosition::checkXMLAttributeFlag ( unsigned char  flag )

inlinestatic

returns true if all attributes have been set

Definition at line 121 of file TotemFramePosition.h.

Referenced by TotemDAQMappingESSourceXML::ChipFramePosition().

    {
      return ((flag == 0x1f) | (flag == 0x20) | (flag == 0x40));
    }

unsigned short TotemFramePosition::getFullOptoRxId ( ) const

inline

Definition at line 126 of file TotemFramePosition.h.

References rawPosition.

    {
      return (rawPosition >> 8) & 0xFFF;
    }

unsigned short TotemFramePosition::getGOHId ( ) const

inline

Definition at line 57 of file TotemFramePosition.h.

References maskGOHId, offsetGOHId, and rawPosition.

Referenced by operator<<().

{ return (rawPosition >> offsetGOHId) & maskGOHId; }

unsigned short TotemFramePosition::getIdxInFiber ( ) const

inline

Definition at line 58 of file TotemFramePosition.h.

References maskIdxInFiber, offsetIdxInFiber, and rawPosition.

Referenced by operator<<().

{ return (rawPosition >> offsetIdxInFiber) & maskIdxInFiber; }

unsigned short TotemFramePosition::getOptoRxId ( ) const

inline

Definition at line 56 of file TotemFramePosition.h.

References maskOptoRxId, offsetOptoRxId, and rawPosition.

Referenced by operator<<().

{ return (rawPosition >> offsetOptoRxId) & maskOptoRxId; }

unsigned int TotemFramePosition::getRawPosition ( ) const

inline

don't use this method unless you have a good reason

Definition at line 82 of file TotemFramePosition.h.

References rawPosition.

    {
      return rawPosition;
    }

unsigned short TotemFramePosition::getSubSystemId ( ) const

inline

Definition at line 54 of file TotemFramePosition.h.

References maskSubSystemId, offsetSubSystemId, and rawPosition.

Referenced by operator<<().

{ return (rawPosition >> offsetSubSystemId) & maskSubSystemId; }

unsigned short TotemFramePosition::getTOTFEDId ( ) const

inline

Definition at line 55 of file TotemFramePosition.h.

References maskTOTFEDId, offsetTOTFEDId, and rawPosition.

Referenced by operator<<().

{ return (rawPosition >> offsetTOTFEDId) & maskTOTFEDId;}

bool TotemFramePosition::operator< ( const TotemFramePosition &  pos ) const

inline

Definition at line 88 of file TotemFramePosition.h.

References rawPosition.

    {
      return (rawPosition < pos.rawPosition);
    }

bool TotemFramePosition::operator== ( const TotemFramePosition &  pos ) const

inline

Definition at line 93 of file TotemFramePosition.h.

References rawPosition.

    {
      return (rawPosition == pos.rawPosition);
    }

void TotemFramePosition::printXML

(

)

prints XML formatted DAQ channel to stdout

Definition at line 40 of file TotemFramePosition.cc.

References gather_cfg::cout, TauDecayModes::dec, and contentValuesCheck::ss.

{
  cout << dec << "SubSystemId=\"";

  const unsigned char &ss = getSubSystemId();
  switch (ss)
  {
    case ssT1: cout << "T1"; break;
    case ssT2: cout << "T2"; break;
    case ssRP: cout << "RP"; break;
    case ssTrigger: cout << "Trigger"; break;
    case ssTTC: cout << "TTC"; break;
    case ssFEC: cout << "FEC"; break;
    default: cout << "None";
  }

  cout << "\" TOTFEDId=\"" << getTOTFEDId()
    << "\" OptoRxId=\"" << getOptoRxId()
    << "\" GOHId=\"" << getGOHId()
    << "\" IdxInFiber=\"" << getIdxInFiber()
    << "\"";
}

void TotemFramePosition::setAllIDs ( unsigned short  SubSystemId, unsigned short  TOTFEDId, unsigned short  OptoRxId, unsigned short  GOHId, unsigned short  IdxInFiber  )

inline

Definition at line 75 of file TotemFramePosition.h.

References offsetGOHId, offsetIdxInFiber, offsetOptoRxId, offsetSubSystemId, offsetTOTFEDId, and rawPosition.

    {
      rawPosition = (IdxInFiber<<offsetIdxInFiber | GOHId<<offsetGOHId | OptoRxId<<offsetOptoRxId
        | TOTFEDId<<offsetTOTFEDId | SubSystemId<<offsetSubSystemId);
    }

void TotemFramePosition::setGOHId ( unsigned short  v )

inline

Definition at line 69 of file TotemFramePosition.h.

References maskGOHId, offsetGOHId, and rawPosition.

    { v &= maskGOHId; rawPosition &= 0xFFFFFFFF - (maskGOHId << offsetGOHId); rawPosition |= (v << offsetGOHId); }

void TotemFramePosition::setIdxInFiber ( unsigned short  v )

inline

Definition at line 72 of file TotemFramePosition.h.

References maskIdxInFiber, offsetIdxInFiber, and rawPosition.

    { v &= maskIdxInFiber; rawPosition &= 0xFFFFFFFF - (maskIdxInFiber << offsetIdxInFiber); rawPosition |= (v << offsetIdxInFiber); }

void TotemFramePosition::setOptoRxId ( unsigned short  v )

inline

Definition at line 66 of file TotemFramePosition.h.

References maskOptoRxId, offsetOptoRxId, and rawPosition.

    { v &= maskOptoRxId; rawPosition &= 0xFFFFFFFF - (maskOptoRxId << offsetOptoRxId); rawPosition |= (v << offsetOptoRxId); }

void TotemFramePosition::setSubSystemId ( unsigned short  v )

inline

Definition at line 60 of file TotemFramePosition.h.

References maskSubSystemId, offsetSubSystemId, and rawPosition.

    { v &= maskSubSystemId; rawPosition &= 0xFFFFFFFF - (maskSubSystemId << offsetSubSystemId); rawPosition |= (v << offsetSubSystemId); }

void TotemFramePosition::setTOTFEDId ( unsigned short  v )

inline

Definition at line 63 of file TotemFramePosition.h.

References maskTOTFEDId, offsetTOTFEDId, and rawPosition.

    { v &= maskTOTFEDId; rawPosition &= 0xFFFFFFFF - (maskTOTFEDId << offsetTOTFEDId); rawPosition |= (v << offsetTOTFEDId); }

unsigned char TotemFramePosition::setXMLAttribute	(	const std::string &	attribute,
		const std::string &	value,
		unsigned char &	flag
	)

Sets attribute with XML name 'attribute' and value 'value'. Also turns on attribute presents bit in the flag parameter returns 0 if the attribute is known, non-zero value else

Definition at line 65 of file TotemFramePosition.cc.

References NULL, contentValuesCheck::ss, and findQualityFiles::v.

Referenced by TotemDAQMappingESSourceXML::ChipFramePosition().

{
  if (attribute == "DAQPosition")
  {
    size_t dd1 = value.find(':', 0);
    size_t dd2 = value.find(':', dd1+1);
    size_t dd3 = value.find(':', dd2+1);
    size_t dd4 = value.find(':', dd3+1);
    size_t dd5 = value.find(':', dd4+1);

    if (dd1 == string::npos || dd2 == string::npos || dd3 == string::npos || dd4 == string::npos ||
        dd5 != string::npos)
      return 3;
    
    unsigned short ss = strtol(value.substr(0, dd1).c_str(), NULL, 16);
    unsigned short ti = strtol(value.substr(dd1+1, dd2-dd1).c_str(), NULL, 16);
    unsigned short oi = strtol(value.substr(dd2+1, dd3-dd2).c_str(), NULL, 16);
    unsigned short gi = strtol(value.substr(dd3+1, dd4-dd3).c_str(), NULL, 16);
    unsigned short fi = strtol(value.substr(dd4+1).c_str(), NULL, 16);

    setAllIDs(ss, ti, oi, gi, fi);
    flag |= 0x40;
    return 0;
  }

  unsigned int v = atoi(value.c_str());

  if (attribute == "SubSystemId")
  {
    if (value == tagSSNone) setSubSystemId(ssNone);
    else if (value == tagSST1) setSubSystemId(ssT1);
    else if (value == tagSST2) setSubSystemId(ssT2);
    else if (value == tagSSRP) setSubSystemId(ssRP);
    else if (value == tagSSTrigger) setSubSystemId(ssTrigger);
    else if (value == tagSSTTC) setSubSystemId(ssTTC);
    else if (value == tagSSFEC) setSubSystemId(ssFEC);
      else setSubSystemId(v);

    flag |= 0x10;
    return 0;
  }

  if (attribute == "TOTFEDId")
  {
    setTOTFEDId(v);
    flag |= 0x8;
    return 0;
  }

  if (attribute == "OptoRxId")
  {
    setOptoRxId(v);
    flag |= 0x4;
    return 0;
  }

  if (attribute == "GOHId")
  {
    setGOHId(v);
    flag |= 0x2;
    return 0;
  }

  if (attribute == "IdxInFiber")
  {
    setIdxInFiber(v);
    flag |= 0x1;
    return 0;
  }

  return 1;
}

Friends And Related Function Documentation

std::ostream& operator<< ( std::ostream &  s, const TotemFramePosition &  fp  )

friend

Condensed representation of the DAQ channel. prints 5-digit hex number, the digits correspond to SubSystem, TOTFED ID, OptoRx ID, GOH ID, index within fiber in this order

Definition at line 26 of file TotemFramePosition.cc.

{
  return s << std::hex
    << fp.getSubSystemId() << ":"
    << std::setw(2) << std::setfill('0')
    << fp.getTOTFEDId() << ":"
    << fp.getOptoRxId() << ":"
    << fp.getGOHId() << ":"
    << fp.getIdxInFiber()
    << std::dec;
}

Member Data Documentation

const unsigned int TotemFramePosition::maskGOHId = 0xF

static

Definition at line 34 of file TotemFramePosition.h.

Referenced by getGOHId(), and setGOHId().

const unsigned int TotemFramePosition::maskIdxInFiber = 0xF

static

Definition at line 33 of file TotemFramePosition.h.

Referenced by getIdxInFiber(), and setIdxInFiber().

const unsigned int TotemFramePosition::maskOptoRxId = 0x3

static

Definition at line 35 of file TotemFramePosition.h.

Referenced by getOptoRxId(), and setOptoRxId().

const unsigned int TotemFramePosition::maskSubSystemId = 0x7

static

Definition at line 37 of file TotemFramePosition.h.

Referenced by getSubSystemId(), and setSubSystemId().

const unsigned int TotemFramePosition::maskTOTFEDId = 0x1F

static

Definition at line 36 of file TotemFramePosition.h.

Referenced by getTOTFEDId(), and setTOTFEDId().

const unsigned int TotemFramePosition::offsetGOHId = 4

static

Definition at line 34 of file TotemFramePosition.h.

Referenced by getGOHId(), setAllIDs(), and setGOHId().

const unsigned int TotemFramePosition::offsetIdxInFiber = 0

static

Definition at line 33 of file TotemFramePosition.h.

Referenced by getIdxInFiber(), setAllIDs(), and setIdxInFiber().

const unsigned int TotemFramePosition::offsetOptoRxId = 8

static

Definition at line 35 of file TotemFramePosition.h.

Referenced by getOptoRxId(), setAllIDs(), and setOptoRxId().

const unsigned int TotemFramePosition::offsetSubSystemId = 15

static

Definition at line 37 of file TotemFramePosition.h.

Referenced by getSubSystemId(), setAllIDs(), and setSubSystemId().

const unsigned int TotemFramePosition::offsetTOTFEDId = 10

static

Definition at line 36 of file TotemFramePosition.h.

Referenced by getTOTFEDId(), setAllIDs(), and setTOTFEDId().

unsigned int TotemFramePosition::rawPosition

protected

Definition at line 132 of file TotemFramePosition.h.

Referenced by getFullOptoRxId(), getGOHId(), getIdxInFiber(), getOptoRxId(), getRawPosition(), getSubSystemId(), getTOTFEDId(), operator<(), operator==(), setAllIDs(), setGOHId(), setIdxInFiber(), setOptoRxId(), setSubSystemId(), and setTOTFEDId().

const string TotemFramePosition::tagSSFEC = "FEC"

static

Definition at line 110 of file TotemFramePosition.h.

const string TotemFramePosition::tagSSNone = "None"

static

XML sub-system tags.

Definition at line 104 of file TotemFramePosition.h.

const string TotemFramePosition::tagSSRP = "RP"

static

Definition at line 108 of file TotemFramePosition.h.

const string TotemFramePosition::tagSST1 = "T1"

static

Definition at line 106 of file TotemFramePosition.h.

const string TotemFramePosition::tagSST2 = "T2"

static

Definition at line 107 of file TotemFramePosition.h.

const string TotemFramePosition::tagSSTrigger = "Trigger"

static

Definition at line 105 of file TotemFramePosition.h.

const string TotemFramePosition::tagSSTTC = "TTC"

static

Definition at line 109 of file TotemFramePosition.h.