Module

Name

Module -- control config command: create/configure modules.

Synopsis


          

Module create type name

Module config name ?option value? ...

Module cget name

DESCRIPTION

This command is processed by the Tcl slow controls server when it processes the control configuration file. It is used to create, configure and query the configuration of slow controls modules.

The create subcommand creates a new module assigned the name by which it can be referred to by remote control panels, and the remainder of the cofiguration file. The module will be of type type. See MODULE TYPES below for information about the module types supported.

The config subcommand configures the module name, setting the configuration options provided on the command line to the specified values. See MODULE TYPES below for information about the configuration options accepted by each module.

The cget subcommand returns the configuration of the nameed module. The configuration is returned as a list of pairs where each pair consists of the configuration parameter name and value.

MODULE TYPES

This section describes the module types that are supported currently and the device specific configuration options and settable/readable parameters each supports. Device support includes both the driver and a control panel for the device.

jtecgdg

This module is actually a general purpose logic module. The only support for it at this time is as a multi-channel gate and delay generator.

Options

The only option supported by the jtecgdg is the -base option which sets the VME base address for the module (must match the rotary switch settings).

Parameters

delayn

The delay register value for register n. There are 8 registers numbered [0..7]

widthn

The width of channel n

caenv812/caen895

The CAEN V812 is a VME 16 channel constant fraction disriminator while the V895 is a software compatible leading edge discriminator.

Options

-base

The value of this parameter is the base address of the module as set by the on-board rotary switches.

-file

The value of this parameter is the path to a configuration file whose contents are used to initialize the state of the device. Note that these modules are write-only so writing their initial state is the only way to put them into a known state.

The contents of this file are described in CAENV812Config(5)

Parameters

thresholdn

The threshold register value for channel n

widthi

The width register value for bank i. The module is divided into two banks of 8 modules. the banks are numbered 0 and 1.

vmusb

This slow control module supports remote execution of arbitrary VM-USB lists. Full documentation of this facility will be produced in a later version of this document. The idea is, however that the module, which has no configuration options, has exactly one parameter, list

list is a set only parameter. It's value is a Tcl list. The first element of thel ist specifies the maximum input buffer size required by the list. The second value of the list is a Tcl list containing the VM-USB stack. The Set operation executes the stack and returns the text Ok - followed by a Tcl list whose elements are the bytes of data put in the read buffer by the stack.

v6553

This is a CAEN bias supply controller. It makes use of the slow controls monitor facility to maintain an up-to-date module state without interrupting data acquisition.

Options

The module supports only the -base option which describes to the software the base address of the bias supply as encoded in the module rotary switches.

Parameters

The following parameters can be Set:

>vi

Sets the requested voltage on channel i in floating point volts.

ii

Sets the current limit on channel i in floating point micro-amps.

oni

Turns channel on or off. The value of this parameter is a legal boolean value.

ttripi

Sets the number of seconds (floating point) for which channel i is allowed to be out of specification before it trips off.

svmaxi

Sets the maximum voltage allowed for channel i in floating point volts. If a voltage setting is made that is larger than this, the actual requested voltage will be limited to this value.

rdowni

Sets the ramp down rate of channel i in floating point volts per second.

rupi

Sets the ramp up rate of channel i in floating point volts per second.

pdownmodei

Sets the power down mode of channel i. The value of this parameter can be either kill which abruptly drops the voltage to zero, or ramp which ramps the channels down at the ramp down rate.

Note that if you want to monitor key components of this device periodically you should use the Mon command as that will retrieve data without temporarily halting data taking.

The following parameters can be retrieved via Get:

globalmaxv

Returns the global maximum voltage for the module.

globalmaxI

Returns the global maximum current for the module.

v

Returns a list of the requested voltages from all channels.

i

Returns a list consisting of the requested maximum currents from all channels.

on

Returns a list that contains the requested channel states (on or off for each channel).

vact

Returns a list contaning the actual voltage reading from each channel.

iact

Returns a list containing the actual current readings from each channel.

status

Returns a list of status values for each channel. See sections 3.2.2.6 for a bit b bit description of the valuesthat can be set in each list element.

ttrip

Returns the trip times for each channel.

svmax

Returns the software maximum voltage for each channel.

rdown

Returns a list of ramp down rates for each channel.

rup

Returns a list of the ramp up rates for each channel.

pdownmode

Returns a list of the power down modes for each channel.

polarities

Returns a list of the channel polarity values. Each channel polarity is represented by a + or a -

temp

Returns a list of the temperaturs for each channel.

Monitored variables

Bias supplies must normally be monitored periodically so that operators can be informed of trip and alarm conditions. The VM-USB framework provides for each slow control device to contribut to a list that is triggered periodically via the action register. This allows this monitoring to be done without pausing data taking.

The V5633 driver uses this capability and the mon command should be used to retrieve the most recent values of the monitored variables.

The mon protocol command will return the the string OK followed by a Tcl list of lists. The first list will be the channel status values. The second list will be the channel actual voltages. The third list will be the actual channel currents. The fourth and last list will be the channel temperatures.

mdgg16

This slow-controls module provides support for the Wiener MDGG-16 device as used as a fourfold 16-channel configurable OR. It sets up the device to output NIM logic signals according to four separately defined OR definitions.

Options

-base

The value of the base address of the Wiener MDGG-16 must be provided via this option.

-mode

This is an enumerated option that only accepts two parameter values: explicit, file. The "explicit" value will use the values of the -or_a, -or_b, -or_c, and -or_d parameters to set up the ORs. The "file" value will read an input file defined by the -configfile parameter to load the definitions. Default = explicit.

-or_a

This is a 16-bit integer that represents the 16-bit mask identifying which input channels will contribute to the NIM 0 output (OR A). A bit that is set indicates that its corresponding channel will contribute to the OR A output. Bit 0 corresponds to the first input channel and bit 15 corresponds to the last input channel. Default value is 65535 (i.e. all 16 channels contribute to output).

-or_b

This is the same as the -or_a parameter except that it corresponds to the OR B definition controlling the NIM 1 output.

-or_c

This is the same as the -or_a parameter except that it corresponds to the OR C definition controlling the NIM 2 output.

-or_d

This is the same as the -or_a parameter except that it corresponds to the OR D definition controlling the NIM 3 output.

-configfile

The value of this parameter should be a valid path to a configuration file. The configuration file should be in the same form as the one generated by the MDGG16Control program. In general, it should have the following form:


                         or_a  value_a  
                         or_b  value_b  
                         or_c  value_c  
                         or_d  value_d  
                        

where value_a, value_b, value_c, and value_d are the 16-bit integers defining the bit masks for OR A, OR B, OR C, and OR D, respectively.

Parameters

The following parameters can be Set:

or_ab

Provides the bit masks for the OR A and the OR B definitions. See the description of the -or_a option for how each of these are defined individually. The value to provide for this parameter should be a combination of the two individual masks. It is a 32-bit integer where the least significant 16-bits are the OR A definition and the upper 16-bits are the OR B definition.

The return value of this should be the response of the device when successful. Any failure will result in a return value beginning with "ERROR - " and is followed by a description of the error.

or_cd

This is the same as the or_ab parameter except that it is formed by OR C and OR D bit masks. The least significant 16-bits are the OR C definition and the upper 16-bits are the OR D definition.

The return value of this should be the response of the device when successful. Any failure will result in a return value beginning with "ERROR - " and is followed by a description of the error.

The following parameters can be retrieved via Get:

or_ab

Reads the values of the OR A and OR B bit masks from the device. The returned value will have both 16-bit masks encoded into a 32-bit integer. The least significant 16 bits define the OR A mask and the upper 16 bits define the OR B mask.

If an error occurs while communicating with the device, the response will begin with "ERROR - " and will be followed by a description of the error.

or_cd

Reads the values of the OR C and OR D bit masks from the device. The returned value will have both 16-bit masks encoded into a 32-bit integer. The least significant 16 bits define the OR C mask and the upper 16 bits define the OR D mask.

If an error occurs while communicating with the device, the response will begin with "ERROR - " and will be followed by a description of the error.

marker

This module inserts a marker in the monitor list. The main use is to get data buffers periodically flushed for slow data rate applications.

The module has no gettable or settable parameters. It has a single configuration option -value which sets the of the marker word. Normally you don't need to modify this as the marker word will never make it outside the VMUSBReadout program.