package require SIS330XDriver
sis3300 name ?options?
name configure options
name cget option
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):
This driver is known to work properly for HiRA for a simpler driver, known to work in all use cases, see sis3300
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.
Module base address in VME.
This defaults to 0
Module 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.
Defaults to 100Mhz
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.
Defaults to off
Number of samples in the start delay. If
false, this parameter is not used.
Defaults to 0
If true, the stop delay is enabled. See
-stopdelayticks to set the actual
stop delay. Defaults to
This is the number of samples in the stop delay.
-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
Defaults to 0
If true the module stop is the trigger.
This pretty much has to be used with
Implies that the module start will be via the VME. Defaults to off
Module 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.
Defaults to off
Start/Stop come from lemo inputs. This is enabled by default.
Backplane signals on the p2 connector
provide start/stop. Note that this and
lemostartstop are not
mutually exlusive. Defaults to
If 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.
Defaults to off. If true, the -clocksource must be set to FrontPanel e.g.
If true front panel provides a random clock with a symmetric pulse shape See section2.5.3 of the module documentation.
Defaults to off. If enabled,
-clocksource must be
set to e.g. FrontPanel.
Size of sample buffers. This is one of the following text strings: 128K, 16K, 4K, 2K, 1K, 512, 256 128.
Defaults to 128K
Buffers 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.
If 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.
Defaults to false. Note that while the SIS3300/1 supports, different values for this parameter for each group (of two) ADCs, this driver only supports a common value.
-thresholds8 element int list
Threshold 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.
Defaults to a list of eight 0x3fff values.
-groupsread4 element bool list
List 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.
Defaults to a list of four true values.