c1205

Name

c1205 -- Manage CAEN C1205 QDC modules.

Synopsis

c1205 create module-name ?option...?

c1205 config module-name ?option...?

c1205 config module-name

DESCRIPTION

This command ensemble allows you to create and configure CAEN model C1205 QDC modules. The C1205 is a sixteen channel charge integrating ADC.

The create command allows you to create a new module and assign a module-name to it so that it can be referred to in subsequent configuration commands. You may optionally include configuration switch value pairs on the create command line.

The config subcommand allows you to set the configuration parameters for an existing module. module-name is the name assigned to that module whe it was created.

The cget command returns as its value the module configuration as a Tcl list where each list element is a sublist containing the name and value of a configuration parameter.

Configuration options are name/value pairs. The name of a configuration option is sometimes called a switch because it resembles the command line switches of command shell commands. For a full description of these options see OPTIONS below.

OPTIONS

The CAEN C1205 supports the following configuration option switches. The switches and values can be supplied to both the create and the config subcommands.

-slot n

Specifies the slot in which the module is installed to n. If this is not set correctly, the Readout program will not be able to communicate with the module and will emit a warning, if the slot n is empty. This parameter must be provided.

-id n

Sets the id of the module to n. The module id is placed as a marker word prior to the data from the module. It is used by the unpacking software to unambiguously identify The data from each module. For the C1205, the id value is also programmed into the lower 8 bits of the control status register and will therefore also appear in the bottom 8 bits of the header word read from the module.

While the -id value defaults to 0, and need not be unique, your data is most reliably decoded if each module in your system has a unique id value.

-usepedestals true|false

The value of this configuration parameter determines how bit 12 of the control status register is initialized. If true (default value), the bit is set to one which enables pedestal subtraction from the input signal.

-hires true|false

The value of this configuration parameter determins how bit 16 of the module control status register is initialized. If true (default value) the bit is set to zero enabling high resolution mode. If set false low resolution mode is selected. High resolution mode provides 12 bits of data resolution while low resolution mode provides only 10 bits of data resolution. High resolution comes at a cost of an additional 1.5 microseconds of conversion time (5.5 microseconds compared with 4 microseconds for low resolution).

-thresholds threshold-list

Provides the channel threshold registers. This is a Tcl list of 16 integers in the range 0-4095. Data is read from a module only if the data value for the module's low range is greater than the corresponding element of the list. The thresholds default to a list of 16 zeroes.

-lopedestals pedestal-list

Provides a list of 16 integers (0-4095) which are subtracted from the data values to produce the low range value.

-midpedestals pedestal-list

Same as -lopedestals but the pedestals are applied to the mid level conversion.

-hipedestal pedestal-list

Same as -lopedestals but the pedestals are applied to the low level conversion.

-rangemode mode

Sets the module range mode. The value for mode must be one of the following:

all

Conversions from all ranges appear in each event. In this mode, some of the conversions will likely have negative values.

auto

In this mode (default) only the range the conversion falls in will appear in the data fromt he mdule.

sparse

Same as auto, but only data from channels are above the channel thresholds set via the -thresholds option appear in the data from the module.