package require SIS330XDriver
sis3300 name ?options?
name configure options
name cget option
addtcldriver name
Provides support for the SIS 3300/3301 flash adc module. This is a Tcl driver, hence the need for a package require command to load the driver and a addtcldriver command to connect a driver instance with the framework.
The driver support restricting the readout to a subset of the
channels. See the -groupsread
option for
more information in OPTIONS below.
The structure of data read from the SIS3300/3301 is shown below (all elements are 32 bit integers unless otherwise indicated):
+-------------------------------+ | Group Mask | (16 bits) +-------------------------------+ | Group size | +-------------------------------+ | Group data | | ... | +-------------------------------+
Group data that follow are in order of low numbered group to high numbered group for each group whose bit is set in this group mask.
-base
base-addressModule base address in VME.
-clocksource
clocksourceModule clock source. This must be a value chosen from one of the following strings: 100Mhz, 50Mhz, 25Mhz, 12.5Mhz, 6.25Mhz, 3.125Mhz FrontPanel P2Connector. The clock source determines the sampling rate of the ADC (or when data are clocked in in the case of HiRA Mode.
-startdelay
boolean
If true the start delay is enabled and. See
-startdelayticks
to see how this delay
is controlled. Note that the start delay determines when
the first sample is saved relative to the start.
-startdelayticks
integerNumber of samples in the start delay. If
-startdelay
is
false, this parameter is not used.
-stopdelay
boolean
If true, the stop delay is enabled. See
-stopdelayticks
to set the actual
stop delay.
-stopdelayticks
This is the number of samples in the stop delay.
If -stopdelay
is true,
when a stop occurs, data will be taken for this
number of samples more. Note that this value is
completely ignored if -stopdelay
is false.
-stoptrigger
boolean
If true the module stop is the trigger.
This pretty much has to be used with
-stopdelay
and
-stopdelayticks
-gatemode
booleanModule is or is not in gate mode. In gate mode the module is started from the falling edge of the gate input and stopped by the rising edge of that signal.
-lemostartstop
booleanStart/Stop come from lemo inputs. This is enabled by default.
-p2startstop
boolean
Backplane signals on the p2 connector
provide start/stop. Note that this and
lemostartstop
are not
mutually exlusive.
-hirarandomclock
booleanIf true, HiRA random clock mode is enabled. HiRA Random clock is normally used with the Washington University Chip board readouts when the readout is done with an XLM other than the XLM-VV when the analog information is collected by an SIS 3301 board.
-randomclock
booleanIf true front panel provides a random clock with a symmetric pulse shape See section2.5.3 of the module documentation.
-samplesize
enum valueSize of sample buffers. This is one of the following text strings: 128K, 16K, 4K, 2K, 1K, 512, 256 128.
-wrap
booleanBuffers are in wrap mode (normally used if start/stop is longer than the samplesize. Once sampling runs off the end of the buffer sampling continues writing at the low memory location (wraps). Please note that at present, the readout method used does not support this. If you have a need to use this mode, please contact the NSCL software development group to arrange further development.
-thresholdslt
booleanIf true, channel thresholds represent a level _below_ which the conversion must fall. This is normally used with negative going pulses since the data are represented as half-scale offset unsigned integers.
-thresholds
8 element int listThreshold values for all 8 channels. This parameter,
if provided is an 8 element integer list of
threshold values. See as well
thresholdslt
which can modify
how this value is interpreted.
-groupsread
4 element bool listList of flags indicating which groups of ADCs will be read. The module is organized into 4 groups of 2 ADCs each). The manual refers to them as groups 1,2,3,4. The first list element allows or disables the readout of group 1 and so on.