QEleChannelConfig Class Reference

Inheritance diagram for QEleChannelConfig:

QLCBaseMeasurement QLCBoloCheckMeasurement QLCEleCheckMeasurement

List of all members.


Detailed Description

data collector for front end settings

Author:
sergio.didomizio@ge.infn.it
Front end parameters are represented by the integer value associated to the register binary configuration for that parameter, or by a bool value in case that setting is determined by a single bit. For each parameter 2 different getters exist: The real values are obtained exploiting the QEleConverter class

Public Member Functions

 QEleChannelConfig ()
 constructor
 QEleChannelConfig (const QEleChannelConfig &config)
 copy constructor
virtual ~QEleChannelConfig ()
 destructor
virtual QEleChannelConfigoperator= (const QEleChannelConfig &other)
 assignment operator
void Dump (std::ostream &o) const
 dump data on stream
bool operator< (const QEleChannelConfig &other) const
 operator< based on lg
bool operator== (const QEleChannelConfig &other) const
 operator== based on every member except fConfigId
unsigned int GetLg () const
 get logical channel number
unsigned int GetBias () const
 get bias voltage bitwise code
float GetRealBias () const
 get bias voltage in Volts
unsigned int GetGain () const
 get gain bitwise code
float GetRealGain () const
 get gain in real units
bool GetBiasPolarity () const
 get bias voltage polarity
bool GetLoadResistance () const
 get load resistance
float GetRealLoadResistance () const
 get load resistance (in GigaOhm)
bool GetIsCold () const
 determine whether this channel is connected to cold electronics. If true, the load resistance can't be modified
unsigned int GetOffsetDac () const
 get offset dac bits
unsigned int GetOffsetHiBits () const
 get offset Hi bits
bool GetOffsetSBit () const
 get offset dac bits
bool GetOffsetPolarity () const
 get offset polarity
float GetRealOffset () const
 get offset voltage
float GetExternalBias () const
 get nominal value of external bias in Volts
float GetRealExternalBias () const
 get real value of external bias in Volts
bool GetAdjustOffset () const
 check whether the adjustOffset flag is set
unsigned int GetId () const
 get Id associated to this electronics configuration
bool GetInput () const
 get input signal type
unsigned int GetTestSignalPos () const
 get logical channel number
unsigned int GetTestSignalNeg () const
 get logical channel number
void SetId (unsigned int id)
 set id associated to this configuration
bool SetLg (const unsigned int lg)
 set logical channel
bool SetBias (const unsigned int bias)
 set bias
bool SetGain (const unsigned int gain)
 set amplifier gain
void SetBiasPolarity (const bool polarity)
 set bias polarity
void InvertBiasPolarity ()
 invert bias polarity with respect to current status
bool SetLoadResistance (const bool resistance)
 set load resistance
void SetIsCold (bool isCold)
 declare that this channel is connected to cold electronics
bool SetOffset (const unsigned int dacBits, const unsigned int hBits, const bool polarity, const bool sBit)
 set offset bits and reset fAdjustOffset flag
bool SetOffsetDac (unsigned int dacBits)
 set offset dac bits and reset fAdjustOffset flag
bool SetOffsetHiBits (unsigned int hiBits)
 set offset hi bits and reset fAdjustOffset flag
void SetOffsetPolarity (bool polarity)
 set offset polarity and reset fAdjustOffset flag
void SetOffsetSBit (bool sBit)
 set offset special bit and reset fAdjustOffset flag
void SetAdjustOffset ()
 set offset to be adjusted by mean of automatic hw procedure
void SetExternalBias (float externalBias)
 set nominal value of external bias in Volts
void SetRealExternalBias (float realExtBias)
 set real value of external bias in Volts
void SetInput (bool input)
 set FE input type
bool SetTestSignalPos (unsigned int posValue)
 set test signal positive value
bool SetTestSignalNeg (unsigned int negValue)
 set test signal negative value

Protected Attributes

unsigned int fLgChannel
unsigned int fConfigId
unsigned int fBias
unsigned int fGain
bool fBiasPolarity
bool fLoadResistance
unsigned int fOffDac
unsigned int fOffHiBits
bool fOffSBit
bool fOffPolarity
float fExternalBias
float fRealExternalBias
bool fAdjustOffset
bool fInput
unsigned int fTestSigPos
unsigned int fTestSigNeg
bool fIsCold

Member Function Documentation

unsigned int QEleChannelConfig::GetLg (  )  const [inline]

float QEleChannelConfig::GetRealOffset (  )  const

get offset voltage

Returns:
an estimation of the offset voltage in mV before the preamplifier
The estimation of the offset is based on the assumption (not true) that when the offset bits are set to zero the output offset is zero, and that all the 14 bits that can be used to tune the offset are linear between 0 and 80 mV (or 0 and -80 mV, depending on the offset polarity). Actually the zero point is smaller than zero for positive polarity and bigger than zero for negative polarity, in order to avoid possible gaps. Moreover the range might be something different from 80 mV and the linearity of the 2 MSB is not guaranteed.

References fOffDac, fOffHiBits, fOffPolarity, fOffSBit, QEleConverter::GetInstance(), and QEleConverter::GetRealOffset().

bool QEleChannelConfig::GetInput (  )  const [inline]

get input signal type

Returns:
true for test signal, false for bolometer

References fInput.

Referenced by QWPSlowConfigHandler::ApplyConfig(), QEleChannelConfig(), QGEChannelFrame::ShowChannel(), and QEleInterface::WriteChannel().

unsigned int QEleChannelConfig::GetTestSignalPos (  )  const [inline]

get logical channel number

getters

References fTestSigPos.

Referenced by QEleCheckLoadCurve::ClassifyMeasurement(), QEleChannelConfig(), and QEleInterface::WriteChannel().

unsigned int QEleChannelConfig::GetTestSignalNeg (  )  const [inline]

get logical channel number

getters

References fTestSigNeg.

Referenced by QEleCheckLoadCurve::ClassifyMeasurement(), QEleChannelConfig(), and QEleInterface::WriteChannel().

bool QEleChannelConfig::SetBias ( const unsigned int  bias  ) 

set bias

Parameters:
bias detector bias bitwise code (0..31)
Returns:
true unless the requested value is out of range

References fBias.

Referenced by QLCConfigReader::Get(), MLCSlowController::InitConfig(), MWPSlowController::PopulateNextConfig(), QGEChannelFrame::ReadChannel(), and QEleInterface::ReadHardware().

bool QEleChannelConfig::SetGain ( const unsigned int  gain  ) 

set amplifier gain

Parameters:
gain amplifier gain bitwise code (0..31)
Returns:
true unless the requested value is out of range

References fGain.

Referenced by QLCConfigReader::Get(), MLCSlowController::InitConfig(), MWPSlowController::PopulateNextConfig(), QGEChannelFrame::ReadChannel(), and QEleInterface::ReadHardware().

void QEleChannelConfig::SetBiasPolarity ( const bool  polarity  )  [inline]

set bias polarity

Parameters:
polarity bias polarity (true positive, false negative)

References fBiasPolarity.

Referenced by QLCConfigReader::Get(), MLCSlowController::InitConfig(), MWPSlowController::PopulateNextConfig(), QGEChannelFrame::ReadChannel(), and QEleInterface::ReadHardware().

bool QEleChannelConfig::SetLoadResistance ( const bool  resistance  ) 

set load resistance

Returns:
true unless this channel is connected to cold electronics and the load resistance cannot be modified

References fIsCold, and fLoadResistance.

Referenced by QLCConfigReader::Get(), MLCSlowController::InitConfig(), MWPSlowController::PopulateNextConfig(), QGEChannelFrame::ReadChannel(), and QEleInterface::ReadHardware().

void QEleChannelConfig::SetIsCold ( bool  isCold  )  [inline]

declare that this channel is connected to cold electronics

If isCold is set to true, the load resistance is set to true (54GOhm) and cannot be modified.

References fIsCold, and fLoadResistance.

Referenced by QEleChannelConfig().

bool QEleChannelConfig::SetOffset ( const unsigned int  dacBits,
const unsigned int  hBits,
const bool  polarity,
const bool  sBit 
)

set offset bits and reset fAdjustOffset flag

Parameters:
dacBits offset DAC bits between (0..4095)
hBits high order bits (0..3)
polarity offset polarity (false=negative, true=positive)
sBit special bit
Returns:
true unless one of dacBits or hBits is out of range. in this case none of the offset values is modified

References fAdjustOffset, fOffDac, fOffHiBits, fOffPolarity, and fOffSBit.

Referenced by QWPSlowConfigHandler::ApplyConfig(), QLCSlowConfigHandler::ApplyConfig(), QLCConfigReader::Get(), and MWPSlowController::PopulateNextConfig().

bool QEleChannelConfig::SetOffsetDac ( unsigned int  dacBits  ) 

set offset dac bits and reset fAdjustOffset flag

Parameters:
dacBits 12-bit register value (0..4095)
Returns:
true unless the requested value is out of range

References fAdjustOffset, and fOffDac.

Referenced by QGEChannelFrame::ReadChannel(), and QEleInterface::ReadHardware().

bool QEleChannelConfig::SetOffsetHiBits ( unsigned int  hiBits  ) 

set offset hi bits and reset fAdjustOffset flag

Parameters:
hiBits 2-bit register value (0..3)
Returns:
true unless the requested value is out of range

References fAdjustOffset, and fOffHiBits.

Referenced by QGEChannelFrame::ReadChannel(), and QEleInterface::ReadHardware().

void QEleChannelConfig::SetOffsetPolarity ( bool  polarity  )  [inline]

set offset polarity and reset fAdjustOffset flag

Parameters:
polarity true means positive, false means negative

References fAdjustOffset, and fOffPolarity.

Referenced by QGEChannelFrame::ReadChannel(), and QEleInterface::ReadHardware().

void QEleChannelConfig::SetOffsetSBit ( bool  sBit  )  [inline]

set offset special bit and reset fAdjustOffset flag

Parameters:
sBit if true, the special bit is raised

References fAdjustOffset, and fOffSBit.

Referenced by QGEChannelFrame::ReadChannel(), and QEleInterface::ReadHardware().

void QEleChannelConfig::SetAdjustOffset (  ) 

set offset to be adjusted by mean of automatic hw procedure

Calling this function will reset all offset-related quantities that are stored into the object

References fAdjustOffset, fOffDac, fOffHiBits, fOffPolarity, and fOffSBit.

Referenced by QLCConfigReader::Get(), MLCSlowController::InitConfig(), and QEleChannelConfig().

void QEleChannelConfig::SetInput ( bool  input  )  [inline]

set FE input type

Parameters:
input use true for test signal, false for bolometer

References fInput.

Referenced by QLCConfigReader::Get(), MWPSlowController::PopulateNextConfig(), QGEChannelFrame::ReadChannel(), and QEleInterface::ReadHardware().

bool QEleChannelConfig::SetTestSignalPos ( unsigned int  posValue  ) 

set test signal positive value

Returns:
true unless the requested value is out of range

References fTestSigPos.

Referenced by QLCConfigReader::Get(), and QEleInterface::ReadHardware().

bool QEleChannelConfig::SetTestSignalNeg ( unsigned int  negValue  ) 

set test signal negative value

Returns:
true unless the requested value is out of range

References fTestSigNeg.

Referenced by QLCConfigReader::Get(), and QEleInterface::ReadHardware().

bool QEleChannelConfig::operator== ( const QEleChannelConfig other  )  const

operator== based on every member except fConfigId

The values of pos&neg test signal are considered only if input is set to test signal.

Reimplemented in QLCBaseMeasurement, QLCBoloCheckMeasurement, and QLCEleCheckMeasurement.

References fAdjustOffset, fBias, fBiasPolarity, fExternalBias, fInput, fIsCold, fLgChannel, fLoadResistance, fOffDac, fOffHiBits, fOffPolarity, fOffSBit, fRealExternalBias, fTestSigNeg, fTestSigPos, and GetLg().


Member Data Documentation

unsigned int QEleChannelConfig::fLgChannel [protected]

logical channel

Referenced by Dump(), GetLg(), operator<(), operator=(), operator==(), QEleChannelConfig(), and SetLg().

unsigned int QEleChannelConfig::fConfigId [protected]

front end settings identifier

Referenced by GetId(), operator=(), QLCBaseMeasurement::QLCBaseMeasurement(), and SetId().

unsigned int QEleChannelConfig::fBias [protected]

front end bias value (0..31)

Referenced by Dump(), GetBias(), operator=(), operator==(), QEleChannelConfig(), and SetBias().

unsigned int QEleChannelConfig::fGain [protected]

front end gain value (0..31)

Referenced by Dump(), GetGain(), operator=(), QEleChannelConfig(), and SetGain().

load resistance (2 possible values)

Referenced by Dump(), GetLoadResistance(), operator=(), operator==(), QEleChannelConfig(), SetIsCold(), and SetLoadResistance().

unsigned int QEleChannelConfig::fOffDac [protected]

unsigned int QEleChannelConfig::fOffHiBits [protected]

bool QEleChannelConfig::fOffSBit [protected]

offset s-bit: adds further ~ +40mV to the offset, no matter what the offset polarity is

Referenced by Dump(), GetOffsetSBit(), GetRealOffset(), operator=(), operator==(), QEleChannelConfig(), SetAdjustOffset(), SetOffset(), and SetOffsetSBit().

used request a call to the automatic offset adjustment procedure to be executed

Referenced by Dump(), GetAdjustOffset(), operator=(), operator==(), QEleChannelConfig(), SetAdjustOffset(), SetOffset(), SetOffsetDac(), SetOffsetHiBits(), SetOffsetPolarity(), and SetOffsetSBit().

bool QEleChannelConfig::fInput [protected]

put the FE to the ground resistances false = BOLO, true = TEST

Referenced by Dump(), GetInput(), operator=(), operator==(), QEleChannelConfig(), and SetInput().

unsigned int QEleChannelConfig::fTestSigPos [protected]

unsigned int QEleChannelConfig::fTestSigNeg [protected]

bool QEleChannelConfig::fIsCold [protected]

whether this channel is connected to cold electronics

Referenced by GetIsCold(), operator=(), operator==(), SetIsCold(), and SetLoadResistance().


The documentation for this class was generated from the following files:

Generated on Tue Nov 16 10:50:05 2010 for CUORE Software by  doxygen 1.5.6