NSCL DAQ Software Documentation
PrevNext

VhsWidgets

Name

VhsWidgets -- User interface components for VHS 404 power supplies.

Synopsis

package require VhsWidgets

set name [VhsWidgets::environment create ?options?]

set name [VhsWidgets::channel create ?options?]

set name [VhsWidgets::channelStatus ?options?]

name method parameters...

DESCRIPTION

This package contains a set of widgets that allow Tcl/Tk programmers to construct control panels for the iSeg VHS 404 and similar modules. See as well, vhqPanel(1tcl) for one such panel.

Three widgets are included. VhsWidgets::environment provides a display of the environment of the board as sensed by the onboard sensors. This widget includes a display of the power on board power supply sensors as well as the temperature sensor. VhsWidgets::channel provides a voltage and current meter as well as the ability set the voltage set points, the currentl limits to initiate ramps and to kill the channel. Finally VhsWidgets::channelStatus provides access to the stauts and events in the modules as well as the ability to attempt a reset of interlocking events and status bits.

In general a complete control panel will require the use of all of these widgets. The separation of these widgets provides the programmer with increased flexibility in control panel layout.

OPTIONS

Each widget has its owns set of options although they all support and require the -device option whose parameter is an object that was botten by creating a vhs object. All widgets will also accept any option that is recognized by the Tk frame widget and pass that option on to the top level frame that enapsulates the megawidget.

VhsWidgets::environment options

This widget only supports the -device option. This option is mandatory.

VhsWidgets::channel

In addition to the mandatory -device option, this widget supports the following options:

-channel n

Indicates the wiget should monitor channel n this parameter can be dynamically modified after widget creation. The default, if this option is not specified is to monitor channel 0.

-statuscommand script

The user interface features a status button that monitors the state ofthe channel. This button is colored green if there are no faults and red if there are faults. The script specified here will be executed when this button is clicked.

On use of this button in a control panel application might be to display a VhsWidgets::channelStatus widget that shows the status of the channel.

VhsWidgets::channelStatus options

In addition to the -device option which is mandatory on creation, this widget supports the -channel option whose parameter specifies the specific channel to monitor/control. If not supplied this defaults to 0. The channel can be dynamically modified using the configure method.

OBJECT METHODS

All of the widgets in this package support a single method; update that refreshes the display from the device. In normal control applications this is hooked to a recurring timer via code like:

Example 1. Hooking update methods to recurring timer


proc updateVhs {interval widget} {
    $widget update
    after $interval "updateVhs $interval $widget"
}
...
updateVhs 1000 $someWidget;  #   update every second.

SEE ALSO

vhs(3tcl) vhsPanel(1tcl)

PrevHomeNext
iSegVhsUpportAllocator