TotemFramePosition Class Reference

#include <TotemFramePosition.h>

Public Member Functions
unsigned short	getFEDId () const
	recomended getters and setters More...
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
	the getters and setters below are deprecated More...
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	setFEDId (unsigned short v)
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	maskFEDId = 0x3FF
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	offsetFEDId = 8
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

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 |  10 bits | 4 bits |       4 bits       |
* |  empty  | empty  |  FED ID  | GOH ID | index within fiber |
* 

In the old (TOTEM only) scheme, the FED ID was further split

* |  3 bits   |  5 bits   |  2 bits   |
* | SubSystem | TOTFED ID | OptoRx ID |
* 

IMPORTANT: This splitting is only supported for backward compatibility and should not be used anymore.

Definition at line 32 of file TotemFramePosition.h.

Constructor & Destructor Documentation

TotemFramePosition() [1/2]

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

inline

the preferred constructor

Definition at line 43 of file TotemFramePosition.h.

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

TotemFramePosition() [2/2]

TotemFramePosition::TotemFramePosition ( unsigned int  pos = 0 )

inline

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

Definition at line 52 of file TotemFramePosition.h.

: rawPosition(pos) {}

~TotemFramePosition()

TotemFramePosition::~TotemFramePosition ( )

inline

Definition at line 54 of file TotemFramePosition.h.

{}

Member Function Documentation

checkXMLAttributeFlag()

static bool TotemFramePosition::checkXMLAttributeFlag ( unsigned char  flag )

inlinestatic

returns true if all attributes have been set

Definition at line 129 of file TotemFramePosition.h.

References RemoveAddSevLevel::flag.

{ return (flag == 0x1f); }

getFEDId()

unsigned short TotemFramePosition::getFEDId ( ) const

inline

recomended getters and setters

Definition at line 58 of file TotemFramePosition.h.

References maskFEDId, offsetFEDId, and rawPosition.

{ return (rawPosition >> offsetFEDId) & maskFEDId; }

getGOHId()

unsigned short TotemFramePosition::getGOHId ( ) const

inline

Definition at line 66 of file TotemFramePosition.h.

References maskGOHId, offsetGOHId, and rawPosition.

Referenced by RawToDigiConverter::run().

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

getIdxInFiber()

unsigned short TotemFramePosition::getIdxInFiber ( ) const

inline

Definition at line 74 of file TotemFramePosition.h.

References maskIdxInFiber, offsetIdxInFiber, and rawPosition.

Referenced by RawToDigiConverter::run().

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

getOptoRxId()

unsigned short TotemFramePosition::getOptoRxId ( ) const

inline

Definition at line 100 of file TotemFramePosition.h.

References maskOptoRxId, offsetOptoRxId, and rawPosition.

Referenced by RawToDigiConverter::run().

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

getRawPosition()

unsigned int TotemFramePosition::getRawPosition ( ) const

inline

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

Definition at line 109 of file TotemFramePosition.h.

References rawPosition.

{ return rawPosition; }

getSubSystemId()

unsigned short TotemFramePosition::getSubSystemId ( ) const

inline

the getters and setters below are deprecated

Definition at line 84 of file TotemFramePosition.h.

References maskSubSystemId, offsetSubSystemId, and rawPosition.

Referenced by RawToDigiConverter::run().

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

getTOTFEDId()

unsigned short TotemFramePosition::getTOTFEDId ( ) const

inline

Definition at line 92 of file TotemFramePosition.h.

References maskTOTFEDId, offsetTOTFEDId, and rawPosition.

Referenced by RawToDigiConverter::run().

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

operator<()

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

inline

Definition at line 111 of file TotemFramePosition.h.

References rawPosition.

{ return (rawPosition < pos.rawPosition); }

operator==()

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

inline

Definition at line 113 of file TotemFramePosition.h.

References rawPosition.

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

printXML()

void TotemFramePosition::printXML

(

)

prints XML formatted DAQ channel to stdout

Definition at line 24 of file TotemFramePosition.cc.

References gather_cfg::cout.

                                  {
  cout << "\" FEDId=\"" << getFEDId() << "\" GOHId=\"" << getGOHId() << "\" IdxInFiber=\"" << getIdxInFiber() << "\"";
}

setFEDId()

void TotemFramePosition::setFEDId ( unsigned short  v )

inline

Definition at line 60 of file TotemFramePosition.h.

References maskFEDId, offsetFEDId, rawPosition, and findQualityFiles::v.

                                  {
    v &= maskFEDId;
    rawPosition &= 0xFFFFFFFF - (maskFEDId << offsetFEDId);
    rawPosition |= (v << offsetFEDId);
  }

setGOHId()

void TotemFramePosition::setGOHId ( unsigned short  v )

inline

Definition at line 68 of file TotemFramePosition.h.

References maskGOHId, offsetGOHId, rawPosition, and findQualityFiles::v.

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

setIdxInFiber()

void TotemFramePosition::setIdxInFiber ( unsigned short  v )

inline

Definition at line 76 of file TotemFramePosition.h.

References maskIdxInFiber, offsetIdxInFiber, rawPosition, and findQualityFiles::v.

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

setOptoRxId()

void TotemFramePosition::setOptoRxId ( unsigned short  v )

inline

Definition at line 102 of file TotemFramePosition.h.

References maskOptoRxId, offsetOptoRxId, rawPosition, and findQualityFiles::v.

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

setSubSystemId()

void TotemFramePosition::setSubSystemId ( unsigned short  v )

inline

Definition at line 86 of file TotemFramePosition.h.

References maskSubSystemId, offsetSubSystemId, rawPosition, and findQualityFiles::v.

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

setTOTFEDId()

void TotemFramePosition::setTOTFEDId ( unsigned short  v )

inline

Definition at line 94 of file TotemFramePosition.h.

References maskTOTFEDId, offsetTOTFEDId, rawPosition, and findQualityFiles::v.

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

setXMLAttribute()

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 30 of file TotemFramePosition.cc.

References RemoveAddSevLevel::flag, and findQualityFiles::v.

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

  if (attribute == "FEDId") {
    setFEDId(v);
    flag |= 0x1C;  // SubSystem + TOTFED + OptoRx
    return 0;
  }

  if (attribute == "SubSystemId") {
    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

operator<<

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 18 of file TotemFramePosition.cc.

                                                                    {
  return s << fp.getFEDId() << ":" << fp.getGOHId() << ":" << fp.getIdxInFiber();
}

Member Data Documentation

maskFEDId

const unsigned int TotemFramePosition::maskFEDId = 0x3FF

static

Definition at line 36 of file TotemFramePosition.h.

Referenced by getFEDId(), and setFEDId().

maskGOHId

const unsigned int TotemFramePosition::maskGOHId = 0xF

static

Definition at line 35 of file TotemFramePosition.h.

Referenced by getGOHId(), and setGOHId().

maskIdxInFiber

const unsigned int TotemFramePosition::maskIdxInFiber = 0xF

static

Definition at line 34 of file TotemFramePosition.h.

Referenced by getIdxInFiber(), and setIdxInFiber().

maskOptoRxId

const unsigned int TotemFramePosition::maskOptoRxId = 0x3

static

Definition at line 38 of file TotemFramePosition.h.

Referenced by getOptoRxId(), and setOptoRxId().

maskSubSystemId

const unsigned int TotemFramePosition::maskSubSystemId = 0x7

static

Definition at line 40 of file TotemFramePosition.h.

Referenced by getSubSystemId(), and setSubSystemId().

maskTOTFEDId

const unsigned int TotemFramePosition::maskTOTFEDId = 0x1F

static

Definition at line 39 of file TotemFramePosition.h.

Referenced by getTOTFEDId(), and setTOTFEDId().

offsetFEDId

const unsigned int TotemFramePosition::offsetFEDId = 8

static

Definition at line 36 of file TotemFramePosition.h.

Referenced by getFEDId(), and setFEDId().

offsetGOHId

const unsigned int TotemFramePosition::offsetGOHId = 4

static

Definition at line 35 of file TotemFramePosition.h.

Referenced by getGOHId(), and setGOHId().

offsetIdxInFiber

const unsigned int TotemFramePosition::offsetIdxInFiber = 0

static

Definition at line 34 of file TotemFramePosition.h.

Referenced by getIdxInFiber(), and setIdxInFiber().

offsetOptoRxId

const unsigned int TotemFramePosition::offsetOptoRxId = 8

static

Definition at line 38 of file TotemFramePosition.h.

Referenced by getOptoRxId(), and setOptoRxId().

offsetSubSystemId

const unsigned int TotemFramePosition::offsetSubSystemId = 15

static

Definition at line 40 of file TotemFramePosition.h.

Referenced by getSubSystemId(), and setSubSystemId().

offsetTOTFEDId

const unsigned int TotemFramePosition::offsetTOTFEDId = 10

static

Definition at line 39 of file TotemFramePosition.h.

Referenced by getTOTFEDId(), and setTOTFEDId().

rawPosition

unsigned int TotemFramePosition::rawPosition

protected

Definition at line 132 of file TotemFramePosition.h.

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