adc

Name

adc -- Manage CAEN V785, V775 and V792 digitizers

Synopsis


adc create name ?option value...?
adc config name option  value ?...?        
adc cget name ?option?
        

DESCRIPTION

The adc script command allows you to create and configure the readout of CAEN V785 (adc), V775 (tdc) and V792 (qdc) modules. These modules can also be used in a chain block readout using the caenchain module command.

One important difference between the VMUSBReadout and mvlcgenerate support for these modules is the offline nature of mvlcgenerate. The VMUSBReadout could do module type specific initialization by querying the module itself for its type. This is not possible for the mvlcgenerate command. Therefore the additional option -type was added to the configurable options to allow you to specify the module type. See OPTIONS below for more information about this.

OPTIONS

-base vme-address

Specifies the base address selected in the module's rotary switches. Note that due to an error in the module's readout firmware, base addresses of the form 00xx0000 are rejected with an error message.

-geo 9-bit-value

Specifies the value of the id placed in the id field of the data. Note that this value is ignored in modules/backplanes with the CERN P3 extensions. Modules/backplanes of that sort will have three connecters (adding a small middle connector to the standard 2 larger VME connectors). These modules/backplanes get a physical slot number through that extra connector and use that for the module id.

Furthermore, Modules that have a middle connector get power through that connector and cannot be used in crates that do not have it without modification. Modules without a middle connector can be used with extended backplanes but they must have a -geo specified.

-thresholds list-of-32-integers

THe value of this option is the Tcl list of threshold values (between 0 and 0xff) for the module channels. The first element of the list is the threshold for channel 0, the second for channel 1 and so on. Note that the "N" series of these modules have 16 channels but are essentially the same module with every other channel connected. Therefore, those modules still require 32 integer threshold but the first element is for channel 0, the second element ignored and the third element for channel 1 and so on. If not configured the thresholds for all channels are zero.

Note that the thresholds are only used if zero supression is enbabled. See the -supressunderthreshold option.

It is important to fully understand how threshold values are used and how they interact with the -smallthresholds option. See section 2.3 of the manual for these digitizers at e.g. https://groups.frib.msu.edu/nscl_library/manuals/caen/MOD.V785.pdf

-smallthresholds enable|disable

Boolean value. When enabled, The threshold value is multiplied by two and compared with the digitized value. When disabled (the default), It is multiplied by 16 before comparison. For exmaple, consider a conversion of 0x0004 And a threshold value of 1. With -smallthresholds enabled, this value is above the applied threshold value (of 2), and with it disbled, it is not above the applied threshold value of 16.

-ipl integer-0-7

If the module is used in interrupt triggered mode, this is the VME bus interrupt priority level. This can be used to trigger an interrupt triggered readout stack. Note that typically when used in NSCLDAQ, this shoulid be 0, which disables interrupts. 0 is the value if not explicitly configured.

-vector status-id

This 8 bit status id is the interrupt vector the module will use when used in interrupt mode. This is not normally used and can be allowed to default. If not confitured the value is 0x80.

-highwater integer0-32

When the module is used in interrupt mode, it will interrupt when the multi-event memory (MEB) has at least this number of events. If not configured this defaults to 24 which represents the MEB (maximum events 32) 3/4 full. In normal FRIB use, this does not need to be configured.

-fastclear integer0-0x3ff

Defines the module fast clear window. This defaults to 0 This parameter defines the width of the fast clear window. IF v is the value of this parameter, the actual fast clear window width is v/32 + 7 microseconds. See section 2.9 of the module manual at e.g.: https://groups.frib.msu.edu/nscl_library/manuals/caen/MOD.V785.pdf

-suppressrange enable|disable

Enables range checking for zero-suppression. The actual checks that will be done are determined by -supressunderthreshold and -supressoverflow. See below. If not configured, this defaults to enabled. Note that if disabled, no zero suppression is performed, no matter the values of -supressunderthreshold and -supressoverflow. It is recomended that, while setting up this is disabled until you know how to program the module thresholds after which, you can turn this on again.

-supressunderthreshold enable | disable

When enabled, channels with conversions that are under the final threshold value (see the information in -smallthresholds above), are not included in the data for this module. If not configured, this option is disbaled. Note that this also requires -suppressrange to be enabled.

-supressoverflow enable |disable

This is only relevent for the V775 TDC. If enabled, time are ommitted from the data from this module. Note that for this to be operative, -supressrange must also have been enabled. For modules that are not V775 or V775N, this option has no effect.

-timescale integer-140-1200

This option is only meaningful for V775 (and V775N) modules. It determines the time range and time granulatiry of the module. The value of this parameter is the full scale range in ns. If not configured, the module is programmed with a full scale range of 600ns. This option is ignored if -type is not tdc.

-iped integer0-255

This option is only meaningful if -type is qdc. It is the current pedestal that is applied to the charge collection circuit of the module. If not configured the parameter defaults to 180. The charge collection circuit can leak charge if the gate lenght is long. iped an compensate for this charge leakage ensuring that small currents integrate to something that is non-zero. For more information on this, see section 2.1.2 in the manual at e.g. http://pen.phys.virginia.edu/daq/vme/v792ac_usersmanual.pdf. 2.1.3 in the same document describes limits on the gate width that are a result of this leakage current as well as providing guidance for how to set this parameter.

-requiredata enabled | disabled

If this is enabled, even if all of the module's channels would be supressed the module will still emit a header and trailer value. If disabled, modules that are fully suppressed contribute nothing to the data.

-type adc | tdc | qdc

Describes the module type so that type specific initialization is properly done. If not configured, this defaults to adc.

SEE ALSO