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/canev895

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.