TOF LV Operations Manual

Last modified: October 27th 2009, by Bertrand H.J. Biritz

The TOF LV system is comprised of eleven Wiener PL512, which provide a maximum of 8V and 25A per channel (12 in total).

The main control interface EPICS consists of two components, the underlying Input/Output Controller (IOC) and then the MEDM GUI interface. The later provides a graphical overview of the Process Variables (PV's) which the former supplies. This means there need to be two processes running for the normal operation of the LV controller. This interface was written by me (Bertrand H.J. Biritz) - so you know whom to complain to :)

There also are some shell scripts for easier use of the terminal commands - this is considered a back up to the GUI interface. These scripts are in the ~/bin directory which is included in the terminal path.

EPICS Interface

Starting the light weight GUI

There are two ways to launch this interface. From the alarm handler main window click on the button labeled P to the right of the LV group button - read the overview section if you don't understand the instructions. Alternatively, from the TOF main window you can click on the THUB located towards the center of the window.

Main Window

Either method should launch the following GUI

Main Window

Depending upon the status of the LV, the display colors might be a little different (i.e. red, yellow, blue or white instead of green).

Using the light weight GUI

With the above interface one can control the power to the TOF start detector, THUBs and also the power for all the trays associated with a particular THUB. In addition clicking on one of the dots in a THUB group brings up a small interface to control that particular channel

Main Window

Starting the PowerSupply GUI

From the TOF main GUI you can also launch a window which shows the status for an entire LV power supply by clicking on one of the LV buttons next to a particular sector.

Main Window

Using the PowerSupply GUI

Besides seeing the present channel values and supply status, this interface also allows one to see whether the supply is accidentally in inhibit mode. Not only would the Uninhibit Switch be off but also instead of saying mainOn it would read mainInhibit.

Command Line Interface

For these commands to be useful one needs to know the supply name associated with a particular sector
SectorHostnameIP Address
West 1tof-lvps2130.199.60.72
West 2tof-lvps8130.199.60.111
West 3tof-lvps9130.199.60.112
West 4tof-lvps0130.199.60.87
West 5tof-lvps10130.199.60.113
East 1tof-lvps7130.199.60.110
East 2tof-lvps4130.199.60.107
East 3tof-lvps6130.199.60.109
East 4tof-lvps5130.199.60.108
East 5tof-lvps11130.199.60.129

Get Commands

There are 14 shell scripts which allow you to get values for the PL512. You use them as follows:

getcommand -a hostname

where hostname is either the network name (tof-lvps1) or IP address ( of the PL512 and the -a option tells the command to list all channels (getMainSwitch is the only exception).

If one just wants to look at one channel:

getcommand hostname U[0-11]

Giving no arguments will output the usage prompt.

The complete list is

getCurrentU0 - U11Real time output current
getMainSwitchFront panel on/off switch
getMaxCurrentU0 - U11Trip point output current
getMaxSenseVoltageU0 - U11Maximum sense voltage
getMaxVoltageU0 - U11Trip point output voltage
getMinSenseVoltageU0 - U11Minimum sense output voltage
getSenseVoltageU0 - U11Real time sense voltage
getTemperatureU0 - U11Real time temperature
getTerminalVoltageU0 - U11Real time terminal voltage
getoutputCurrentU0 - U11Maximum output current
getoutputGroupU0 - U11Group channel belongs to
getoutputStatusU0 - U11Real time status of channel
getoutputSwitchU0 - U11On/off switch for channel
getoutputVoltageU0 - U11Demand voltage

Set Commands

There are 9 shell scripts which allow you to set values for the PL512. You use them as follows:

setcommand hostname U[0-11] value

where hostname is either the network name (tof-lvps1) or IP address ( of the PL512.

Giving no arguments will output the usage prompt.

The complete list is

setGroupSwitch0-20-1Turn on/off a particular group
setMaxCurrentU0 - U110-25Set the trip point current
setMaxSenseVoltageU0 - U110-8Set the maximum sense voltage
setMaxVoltageU0 - U110-8Set the trip point voltage
setMinSenseVoltageU0 - U110-8Set the minimum sense voltage
setoutputCurrentU0 - U110-25Set the maximum current
setoutputGroupU0 - U110-2Set the channel's group
setoutputSwitchU0 - U110-1Turn on/off the channel
setoutputVoltageU0 - U110-8Set the demand voltage


The first and foremost rule is

Don't get creative, call for backup

If you run into any of the problems listed below the expert should be contacted - doubly so for ones which aren't listed! I have compiled these trouble shooting items for a couple of reasons:

get/set command not found

All the get and set commands are actually shell scripts in order to cut down on the amount of typing one has to do. The originals reside in ~/TOF/LV/shell_scripts, but copies have been placed in ~/bin.
If you receive a command not found error message then type the following:

cd ~/TOF/LV/shell_scripts

you can then execute any of the get/set commands as usual, expect for needing to place a ./ in front of each - i.e.

./ tof-lvps1 U0


In order to verify that the communication is working launch a terminal and type the following: tof-lvps1


Unknown Object Identifier

If you get Unknown Object Identifier error messages with the get/set commands:

sysMainSwitch.0: Unknown Object Identifier (Sub-id not found: (top) -> sysMainSwitch)

then either the environmental variable $MIBS is not set properly or the MIB file is actually missing. This can be checked by typing

echo $MIBS

Checking MIBS environmental variable

If you do not get the above response, then type the following in the terminal


The other possibility is the MIB file WIENER-CRATE-MIB.TXT is not located in the place /usr/local/share/snmp/mibs. To check this type

ls /usr/local/share/snmp/mibs/WIENER-CRATE-MIB.txt

Checking MIB status

If you do not get the above response, then you will need to become root and type the following

cp ~tof/TOF/WIENER-CRATE-MIB.txt /usr/local/share/snmp/mibs/WIENER-CRATE-MIB.txt

Copying MIB