adc

Name

adc -- Create/configure CAEN V775, V785, V792, V862 modules.

Synopsis

adc create name base

caenv965 create name base

adc config name option value ...

caenv956 config name option value ...

adc cget name

caenv956 cget name

DESCRIPTION

This command creates, configures and retrieves the configuration of CAEN V775, V785, V792, and V862, V965 digitizer modules.

Use the create subcommand to create a new adc providing it with a unique name that will be used to identify it in future commands. The base parameter is the base address of the module as set in the module rotary switches.

Use the config subcommand to configure a module named name the option options and legal values are described in the section OPTIONS below.

The cget subcommand returns as its value the configuration of the module name. The configuration is returned as a list of two element sublists where each sublist contains, in order, an option from OPTIONS below, and its value. Note that some values may themselves be lists.

When used with the CAEN V965 or other dual range digitizers via the caenv956 command, each parameter specified in the adcChannels array will result in two SpecTcl channels and corresponding raw spectra. The first will have .h appended to the name and will be the high range conversion while the second will have .l appended to the name and will be the low range value.

OPTIONS

-base value

Allows you to reconfigure the base address of a module.

-commonstop value

This is only usable with a V775. value is a boolean value which, if true runs the module in common stop mode. If false (the default), the module is run in common start mode.

-thresholds values

The value is a list of 32 values that are the module thresholds. Unless -smallthresholds has been configured to be true, these values are multiplied by 16 before being applied as the channel threshold values.

-smallthresholds bool

The value is a boolean (e.g. on or off). A true boolean means that the threshold is applied as is a false boolean means the threshold value is multiplied by 16 and then applied.

-ipl 0-7

The interrupt priority level the module should use to request a VME bus interrupt. This defaults to 6 and should be set to zero to disable interrupts. Normally interrupts will be used to trigger an interrupt triggered stack. The default of 6 is historical in nature, in most cases for, the default should be overridden to zero.

-vector 0-255

The interrupt vector the module should use. This is an integer and defaults to 0x80. The vector value is ignored if the module interrupts are disabled.

-highwater 0-31

Defines how many events the module should accumulate before it interrutps. A value of zero also disables interrupts. The default value is 24 evetns. This is best suited for singles applications where allowing the module to accumulate a few events before being read is a good thing. This value will be ignored if the -ipl option has been configured to zero as that also disables module interrupts.

-geo 0-31

Defines the geographical address that will be set in the module. If the module has a PAUX connector, this must be set to be the module's physical location in the crate. This option must be correctly programmed in order to help SpecTcl form a mapping between data values and parameter names.

-fastclear value

Defines the fast clear window for the module.

-supressrange bool

If true the module will supress overflows and underthreshold conversions. If not all channels will supply data for an event. In most cases, this should be set to false.

-timescale ns

Sets the full scale range of the module if it is a V775. If the module is not a V775 TDC, this configuration parameter is silently ignored (the hardware allows the software to determine the module type). ns is the range of the TDC in nanoseconds and must be between 140 and 1200.

-iped value

Sets the Iped register. See section 4.34 of e.g. the CAEN V965 manual. This register controls the amount of charge initially injected into the conversion circuit and is used to compensate for leakage current that may lower the conversion of a signal during the gate. The default value is 180. Valid values are 0 - 255, however see the description of the Iped register and pedestal injections in the manual.

EXAMPLES

Example 1. Sample ADC commands


adc create adc1    0x04000000
adc config adc1    -geo 12 -supressrange off  -ipl 0 -vector 0
         

Defines a module with base address 0x04000000 to be in geographical address 12. Range supression and interrupts are disabled.

NOTES

This command can actually initialize/configure V775 TDCs and V792, V862 QDCs in addition to the V785 ADC.