mdpp32padc create name -base base [option1 value1 option2 value2 ...]
mdpp32padc config name option value ...
mdpp32padc cget name
This command creates, configures and retrieves the configuration of Mesytec MDPP-32 module with PADC firmware.
Use the create subcommand to create a new module instance
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. Options and corresponding values can be provided with the
create subcommand instead of using config
subcommand to configure.
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.
-base value
Allows you to reconfigure the base address of a module.
This defaults to 0. The required
-base parameter of the create
option for this device overrides the default value.
-id vsn
vsn will be used as the module's
identifier or virtual slot number.
The vsn will be encoded into the
event data that is returned by the module. This, in turn
is normally used by event decoders to determine which parameters
the channels of the module should be unpacked into.
Each module should be given a unique vsn.
By default, the value is 0.
-ipl 0-7The interrupt priority level the module should use to request a VME bus interrupt. Normally interrupts will be used to trigger an interrupt triggered stack.
By default, the value is 0.
-vector 0-255The interrupt vector the module should use. The vector value is ignored if the module interrupts are disabled.
Note that the VMUSB processes 16 bit vectors, but the
vector produced by this module is 8 bits wide.
The VME standard is ambiguous about how such modules
produce the top eight bits of the vector under these
circumstances. Mesytec modules set those top bits
to 0xFF. E.g. -vector 0x80
produces a vector, as see by the VMUSB of 0xFF80.
One important thing to note in this case is that one must pass
-vector option to the stack as 0xFF80
to use interrupt-triggered stack. 0x0080 won't work.
By default, the value is 0.
-irqeventthreshold 0-32767(From MDPP-32 PADC documentation) Every time the number of events in the FIFO exceeds this threshold, an IRQ is emitted.
The register length is 15 bit. Thus, the maximum number it can take should be 0x3FFF (32757)
By default, the value is 3.
-irqdatathreshold 0-32256(From MDPP-32 PADC documentation) Every time the number of 32 bit words in the FIFO exceeds this threshold, an IRQ is emitted. Maximum allowed threshold is "FIFO size".
"FIFO size" in the PADC documentation is 32k-512=32256.
By default, the value is 1.
-irqsource event|data
Use the value provided with -irqeventthreshold as
the IRQ threshold.
Use the value provided with -irqdatathreshold as
the IRQ threshold.
By default, the value is event
-maxtransfer 0-32256
(From MDPP-32 PADC documentation) With
"-multievent 3", the value specifies
the amount of data read from FIFO before Berr is emitted. Transfer stops
only after full events.
e.g. With "-maxtransfer 1", 1 event
per transfer is emitted.
With "-multievent 0xb", the value specifies
the number of events read from FIFO before Berr is emitted.
Setting this option to 0 allows unlimited transfer.
By default, the value is 1.
-datalenformat
8bit | 16bit | 32bit | 64bit | numeventsShow number of events in FIFO
(From MDPP-32 PADC documnetation) The number of 32 bit words is always even. If necessary the fill word "0" is added. For the setting 0 and 1, the max value 0xFFFF is shown when number exceeds the 16 bit format. The FIFO is not affected.
By default, the value is 32bit.
-multievent See detailBy default, the value is 0xb.
+-----------------------------------------+
| Bit[3] | Bit[2] | Bit[1:0] |
+-----------------------------------------+
| count events | skip Berr, | mode[1:0] |
| not words | send EOB | |
| (reg. 0x601A) | | |
+-----------------------------------------+
(From MDPP-32 PADC documentation)
Allow multi event buffering.
Not allowing multi event buffering
Register 0x6034 clears events allowing new conversion.
Allowing multi event buffering
Unlimited transfer. No readout reset required. Register 0x6034 can be written after block readout. Don't use for CBLT.
Allowing multi event buffering, but MDPP transfers limited amount of data.
The number of data words can be specified via register 0x601A After word limit is reached, the next end of event mark terminates transfer by emitting Berr. So, register 0x601A=1 means event by event transfer (Berr after each event).
The next data block can be transferred after writing the register 0x6034 (resets Berr).
Berr handling. If set, send EOB=bit[31:30]=bx10 instead of Berr.
Compare number of transmitted events (not words!) with the register
0x601A value (-maxtransfer value)
for Berr condition.
-marktype
eventcount | timestamp | extended-timestampBy default, the value is timestamp.
The last 32 bit word in the data contains either event counts or timestamp according to the setting.
Following 32 bit word will be added to the data.
-tdcresolution
24ps | 49ps | 98ps | 195ps | 391ps | 781psJust for your information, TDC resolution is calculated using the raw register value with formula: 25ns/pow(2, 10-value)
By default, the value is 24ps.
-outputformat 0 | 1 | 2Time and peak amplitude data
Time only data
Peak amplitude only data
By default, the value is 0.
-windowstart int 0-32767 (0-0x7fff)(From MDPP-32 documentation) Unit: 1.56 ns (=25ns/16)
Start window of interest: 0x0000 start at -25.56us, 0x7FFF start at +25.56us, 0x4000 = 16k no delay.
< 16k, window starts before Trigger, > 16k, window is delayed.
By default, this parameter is 0x3fbe(=16318).
-windowwidth int 0-16383 (0-0x3fff)(From MDPP-32 documentation) Unit: 1.56 ns, max 16k = 25.56 us
By default, this parameter is 0x80(=128).
-firsthit 0 | 1transmit all hits in the window
only transmit first hit
-testpulser 0 | 1Switch for the internal test pulser.
-pulseramplitude int 0-4095 (0-0xfff)(From MDPP-32 documentation) Max value corresponds to about 30% at gain=1. Gain jumpers are situated before pulser coupling, so have no effect on the pulser amplitude.
This value has no effect unless -testpulser is set 1.
-triggersource int 0-1023 (0-0x3ff)(From MDPP-32 documentation) Defines the trigger which creates the window of interest. This can be: one or both of the trigger inputs, lower 16 channels(B0), upper 16 channels(B1), or both banks (all channels).
MDPPTriggerControl GUI is included in the FRIBDAQ package. This value needs to be set to 0x400 to use the GUI controller. In this case, the last setting is preserved while start/stop runs.
+-------------------------------------------+
| Whole bank | 16 channels | trig |
| 2 bits | 6 bits | 2 bits |
+-------------------------------------------+
| B1 | B0 | active | Chan[4:0] | T1 | T0 |
+-------------------------------------------+
The default value is 0x400.
-triggersource int 0-1023 (0-0x3ff)(From MDPP-32 documentation) Defines the trigger which creates output trigger. This can be: one or both of the trigger inputs, lower 16 channels(B0), upper 16 channels(B1), or both banks (all channels).
MDPPTriggerControl GUI is included in the FRIBDAQ package. This value needs to be set to 0x400 to use the GUI controller. In this case, the last setting is preserved while start/stop runs.
+-----------------------------------------+
| Whole bank | 16 channels | 00 |
+-----------------------------------------+
| B1 | B0 | active | Chan[4:0] | 0 | 0 |
+-----------------------------------------+
The default value is 0x400.
-signalwidth
int[8] 8-2000 (in unit of 12.5 ns)FWHM value of the input pulse in unit of 12.5 ns.
The parameter provided must be a list of 8 integers. The value of an element at index[0-7] is applied to the channels [4*index, 4*index+3].
By default, the value is [list 80 80 80 80 80 80 80 80], which is 6.4ns (80/12.5) for all channels.
-threshold int[32] 1-65535
The parameter provided must be a list of 32 integers. Each element sets the threshold to each channel.
By default, the value is [list 0x4FF 0x4FF 0x4FF 0x4FF ... 0x4FF 0x4FF 0x4FF 0x4FF], which is 1279 (~1.95%) for all channels.
-printregisters 0 | 1Print out register values from the module. The values are not from the user input, but from the actual register values read from the module after processing the input.
Example 1. Sample MDPP-32 PADC commands
set signalWidth [list 80 80 80 80 80 80 80 80]
set threshold [list 0xfff 0xfff 0xfff 0xfff 0xfff 0xfff 0xfff 0xfff \
0xfff 0xfff 0xfff 0xfff 0xfff 0xfff 0xfff 0xfff \
0xfff 0xfff 0xfff 0xfff 0xfff 0xfff 0xfff 0xfff \
0xfff 0xfff 0xfff 0xfff 0xfff 0xfff 0xfff 0xfff]
set windowStart 16368
set windowWidth 32
set firstHit 1
set testPulser 1
set pulserAmplitude 400
set triggerSource 0x100
set triggerOutput 0x100
mdpp32padc create padc -base 0x00030000
mdpp32padc config padc -signalwidth $signalWidth \
-threshold $threshold \
-windowstart $windowStart \
-windowwidth $windowWidth \
-firsthit $firstHit \
-testpulser $testPulser \
-pulseramplitude $pulserAmplitude \
-triggersource $triggerSource \
-triggeroutput $triggerOutput \
-printregisters 1
Defines a module with base address 0x00030000. While many register values are defined with lists, not all of them are used to configure the module (padcJumper is not used).
If any of the parameters are not specified in config, it uses the default values. It is recommeneded only define variables need to change and omit others for taking default values.