vme::V792 Class Reference

#include <Vme.hxx>

Public Member Functions
	V792 ()
	Calls reset(),.
bool	unpack (const midas::Event &event, const char *bankName, bool reportMissing=false)
	Unpack ADC data from a midas event. More...
void	reset ()
	Reset data fields to default values.
int32_t	get_data (int16_t ch) const
	Get a data value, with bounds checking. More...

Public Attributes
int16_t	n_ch
	Number of channels present in an event.
int32_t	count
	Event counter.
bool	overflow
	Is any channel an overflow?
bool	underflow
	Is any channel under threshold?
int16_t	data [MAX_CHANNELS]
	Array of event data.

Static Public Attributes
static const uint16_t	DATA_BITS = 0x0
	Code to specify a data buffer.
static const uint16_t	HEADER_BITS = 0x2
	Code to specify a header buffer.
static const uint16_t	FOOTER_BITS = 0x4
	Code to specify a footer buffer.
static const uint16_t	INVALID_BITS = 0x6
	Code to specify an invalid buffer.
static const uint16_t	MAX_CHANNELS = 32
	Number of data channels availible in the ADC.

Private Member Functions
bool	unpack_data_buffer (const uint32_t *const pbuffer)
	Unpack event data from a caen 32 channel adc. More...
bool	unpack_buffer (const uint32_t *const pbuffer, const char *bankName)
	Unpack a Midas data buffer from a CAEN ADC. More...

Detailed Description

CAEN v792 ADC

Definition at line 194 of file Vme.hxx.

Member Function Documentation

get_data()

int32_t vme::V792::get_data

(

int16_t

ch

)

const

Get a data value, with bounds checking.

Parameters

ch	Channel number to get data from Returns the data value stored at ch. If ch is out of bounds of the internal array, prints a warning message and returns dragon::DR_NO_DATA.

Definition at line 383 of file Vme.cxx.

References dragon::NoData< T >::value().

{
  /*!
   * \param ch Channel number to get data from
   * Returns the data value stored at \e ch. If \e ch is out of bounds
   * of the internal array, prints a warning message and returns dragon::DR_NO_DATA.
   */
  if (ch >= 0 && ch < MAX_CHANNELS) return data [ch];
  else {
    dutils::Warning("V792::get_data")
      << "Channel number " << ch << " out of bounds (valid range: [0, "
      << MAX_CHANNELS -1 << "]\n";
    return dragon::NoData<int32_t>::value();
  }
}

Here is the call graph for this function:

unpack()

bool vme::V792::unpack	(	const midas::Event &	event,
		const char *	bankName,
		bool	reportMissing = false
	)

Unpack ADC data from a midas event.

Searches for a bank tagged by bankName and then proceeds to loop over the data contained in the bank and extract into the appropriate class data fields.

Parameters

[in]	event	The midas event to unpack
[in]	bankName	Name of the bank to unpack
[in]	reportMissing	False specifies to silently return if bankName isn't found in the event. True specifies to print a warning message if this is the case.

Returns

True if the event was successfully unpacked, false otherwise

Definition at line 459 of file Vme.cxx.

{
  /*!
   * Searches for a bank tagged by \e bankName and then proceeds to loop over the data contained
   * in the bank and extract into the appropriate class data fields.
   *
   * \param [in] event The midas event to unpack
   * \param [in] bankName Name of the bank to unpack
   * \param [in] reportMissing False specifies to silently return if \e bankName isn't found in
   *             the event. True specifies to print a warning message if this is the case.
   * \returns True if the event was successfully unpacked, false otherwise
   */
  int bank_len;
  uint32_t* pbank32 =
    event.GetBankPointer<uint32_t>(bankName, &bank_len, reportMissing, true);

  // Loop over all data words in the bank
  bool ret = true;
  for (int i=0; i< bank_len; ++i) {
    bool success = unpack_buffer(pbank32++, bankName);
    if(!success) ret = false;
  }
  return ret;
}

unpack_buffer()

bool vme::V792::unpack_buffer ( const uint32_t *const  pbuffer, const char *  bankName  )

private

Unpack a Midas data buffer from a CAEN ADC.

Parameters

[in]	pbuffer	Pointer to the buffer word
[in]	bank	Name of the midas bank being unpacked

Returns

True if the buffer was successfully unpacked, false otherwise

V792 buffers are 32 bit words. Bits 24-26 specify the type of data contained in the buffer. In this function, we read the buffer type and then handle appropriately.

case DATA_BITS : See unpack_data_buffer()

case HEADER_BITS: read number of channels (n_ch) in the event from bits 6 - 13

case FOOTER_BITS: read event counter (count) from bits 0 - 23

case INVALID_BITS: bail out

Bail out if we read an unknown buffer code

Definition at line 420 of file Vme.cxx.

{
  /*!
   * \param [in] pbuffer Pointer to the buffer word
   * \param [in] bank Name of the midas bank being unpacked
   * \returns True if the buffer was successfully unpacked, false otherwise
   *
   * V792 buffers are 32 bit words. Bits 24-26 specify the type of data contained
   * in the buffer. In this function, we read the buffer type and then handle appropriately.
   */
  bool success = true;
  uint32_t type = (*pbuffer >> 24) & READ3;

  switch (type) {
  case DATA_BITS:    /// case DATA_BITS : See unpack_data_buffer()
    success = unpack_data_buffer(pbuffer);
    break;
  case HEADER_BITS:  /// case HEADER_BITS: read number of channels (n_ch) in the event from bits 6 - 13
    n_ch  = (*pbuffer >> 6) & READ8;
    break;
  case FOOTER_BITS:  /// case FOOTER_BITS: read event counter (count) from bits 0 - 23
    count = (*pbuffer >> 0) & READ24;
    break;
  case INVALID_BITS: /// case INVALID_BITS: bail out
    dutils::Error("vme::V792::unpack_buffer", __FILE__, __LINE__)
      << DRAGON_ERR_FILE_LINE << "Bank name: \"" << bankName
      << "\": Read INVALID_BITS code from a CAEN ADC output buffer. Skipping...\n";
    success = false;
    break;
  default: /// Bail out if we read an unknown buffer code
    dutils::Error("vme::V792::unpack_buffer", __FILE__, __LINE__)
      << DRAGON_ERR_FILE_LINE << "Bank name: \"" << bankName
      << "\": Unknown ADC buffer code: 0x" << std::hex << type << ". Skipping...\n";
    success = false;
    break;
  }
  return success;
}

unpack_data_buffer()

bool vme::V792::unpack_data_buffer ( const uint32_t *const  pbuffer )

private

Unpack event data from a caen 32 channel adc.

Parameters

[in]

pbuffer

Pointer to the data buffer word.

A data buffer encodes the conversion value (i.e. integrated charge or peak pulse height) for a single ADC channel. See below for bitpacking instructions.

Bit 12 is an overflow tag

Bit 13 is an underflow tag

Bits 16-20 tell the channel number of the conversion

Bits 0 - 11 encode the converted value

Definition at line 399 of file Vme.cxx.

{
  /*!
   * \param [in] pbuffer Pointer to the data buffer word.
   *
   * A data buffer encodes the conversion value (i.e. integrated charge or peak pulse height)
   * for a single ADC channel. See below for bitpacking instructions.
   */
  overflow     = (*pbuffer >> 12) & READ1; /// Bit 12 is an overflow tag
  underflow    = (*pbuffer >> 13) & READ1; /// Bit 13 is an underflow tag
  uint16_t ch  = (*pbuffer >> 16) & READ5; /// Bits 16-20 tell the channel number of the conversion
  if (ch >= MAX_CHANNELS) {
    dutils::Error("vme::V792::unpack_data_buffer", __FILE__, __LINE__)
      << DRAGON_ERR_FILE_LINE << "Read a channel number (" << ch
      << ") which is >= the maximum (" << MAX_CHANNELS << "). Skipping...\n";
    return false;
  }
  data[ch]  = (*pbuffer >> 0) & READ12; /// Bits 0 - 11 encode the converted value
  return true;
}

---

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

• /Volumes/Data/Users/elzoido238/packages/dragon/analyzer/src/Vme.hxx
• /Volumes/Data/Users/elzoido238/packages/dragon/analyzer/src/Vme.cxx