org.lsst.ccs.subsystem.power

Class RebPsDevice

java.lang.Object

org.lsst.ccs.monitor.Device

org.lsst.ccs.subsystem.power.RebPsDevice

All Implemented Interfaces:

org.lsst.ccs.framework.HardwareController, org.lsst.ccs.framework.HasLifecycle

public class RebPsDevice
extends org.lsst.ccs.monitor.Device

Interface to a REB power supply board.

Author:

Owen Saxton

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RebPsDevice.ChanName
static interface	RebPsDevice.Event Interface for open/close event listener.
static class	RebPsDevice.PsName Public constants.

Field Summary

Fields

Modifier and Type	Field and Description
protected String	psPath

Fields inherited from class org.lsst.ccs.monitor.Device

alertOfflineId, alertService, configService, fullName, inited, lineMask, lineState, lineWarm, log, mon, name, online, path, s

Constructor Summary

Constructors

Constructor and Description
RebPsDevice()

Method Summary

Modifier and Type	Method and Description
void	build()
protected int[]	checkChannel(String name, int hwChan, String type, String subtype)
boolean	checkPsTripped() Checks whether a power supply has tripped.
void	clearListener() Clears the event listener.
protected void	close()
String	dumpInfo()
String	getBulkPsSwitchName() Get the name of the switch name controlling this PS board.
double[]	getDacs(boolean getHV) Gets a set of DPHI or HV bias DAC values.
int[]	getErrors() Gets the error counters.
org.lsst.ccs.drivers.auxelex.RebPS	getPs() Gets the power supply driver.
String	getPsId() Gets the power supply ID.
int	getPsType() Gets the power supply type.
int	getPsVersion() Gets the power supply version.
org.lsst.ccs.bus.states.StateBundle	getRebPsDeviceState()
protected void	initChannel(String name, int id, int hwChan, int type, int subtype)
protected void	initDevice()
protected void	initialize()
double[]	readChanExtrema(int reb, RebPsDevice.PsName psName, RebPsDevice.ChanName chan) Reads extrema for a power supply channel
protected double	readChannel(int hwChan, int type)
int[]	readRegs(int addr, int count)
void	resetChanExtrema(int reb, RebPsDevice.PsName psName, RebPsDevice.ChanName chan) Resets extrema for a power supply channel
void	sequencePower(boolean on) Sequences a whole power supply on or off.
void	sequencePower(int reb, boolean on) Sequences a power supply section on or off.
void	setBiasDac(int rebNum, double value) Sets a HV bias DAC value.
void	setConsecutiveExceptiionsToOffline(int nExceptions) Set the number of consecutive exceptions that will put the device offline.
void	setDphiDac(int rebNum, double value) Sets a DPHI DAC value.
void	setListener(RebPsDevice.Event listen) Sets an event listener.
protected void	setOnline(boolean online)
void	setPowerOn(int reb, int psNum, boolean on) Turns a power supply on or off.
void	setReadTimeout(long timeout) Set the timeout for the underlying driver.
void	togglePower(int reb, int psNum) Toggles the on/off state of a power supply.

Methods inherited from class org.lsst.ccs.monitor.Device

addLine, checkHardware, checkHwLine, checkLine, checkOnline, checkTimeout, configure, disable, dropChannel, enable, getDeviceMonitorUpdateTasks, getFullName, getGroupForChannel, getMonitorUpdateTasksForChannels, getName, getOutputLines, getPath, init, initChannel, initSensors, isHwLineSet, isLineSet, isOnline, isTimeout, readChannel, readChannelGroup, readChannelGroup, readChannelNow, setDisabled, setHwLine, setLine, setLineWarm, setOutputLines, testOnline

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.lsst.ccs.framework.HardwareController

checkStopped

Methods inherited from interface org.lsst.ccs.framework.HasLifecycle

postBuild, postInit, postShutdown, postStart, shutdown, start

Field Detail

psPath

@LookupPath
protected String psPath

Constructor Detail

RebPsDevice

public RebPsDevice()

Method Detail

build

public void build()

initDevice

protected void initDevice()

Overrides:

initDevice in class org.lsst.ccs.monitor.Device

initialize

protected void initialize()

Specified by:

initialize in class org.lsst.ccs.monitor.Device

setOnline

protected void setOnline(boolean online)

Overrides:

setOnline in class org.lsst.ccs.monitor.Device

close

protected void close()

Specified by:

close in class org.lsst.ccs.monitor.Device

setReadTimeout

public void setReadTimeout(long timeout)

Set the timeout for the underlying driver.

Parameters:

timeout - Read timeout in ms.

setConsecutiveExceptiionsToOffline

public void setConsecutiveExceptiionsToOffline(int nExceptions)

Set the number of consecutive exceptions that will put the device offline.

Parameters:

nExceptions - The number of consecutive exceptions.

checkChannel

protected int[] checkChannel(String name,
                             int hwChan,
                             String type,
                             String subtype)
                      throws Exception

Overrides:

checkChannel in class org.lsst.ccs.monitor.Device

Throws:

Exception

initChannel

protected void initChannel(String name,
                           int id,
                           int hwChan,
                           int type,
                           int subtype)

Overrides:

initChannel in class org.lsst.ccs.monitor.Device

readChannel

protected double readChannel(int hwChan,
                             int type)

Overrides:

readChannel in class org.lsst.ccs.monitor.Device

checkPsTripped

public boolean checkPsTripped()

Checks whether a power supply has tripped.

Returns:

Whether a trip has occurred

getRebPsDeviceState

public org.lsst.ccs.bus.states.StateBundle getRebPsDeviceState()

getDacs

public double[] getDacs(boolean getHV)

Gets a set of DPHI or HV bias DAC values.

Parameters:

getHV - If true, get HV Bias DACs; otherwise get DPHI DACs

Returns:

An array of DAC values

setBiasDac

public void setBiasDac(int rebNum,
                       double value)
                throws PowerException

Sets a HV bias DAC value.

Parameters:

rebNum - The REB number

value - The value to set

Throws:

PowerException

setDphiDac

public void setDphiDac(int rebNum,
                       double value)
                throws PowerException

Sets a DPHI DAC value.

Parameters:

rebNum - The REB number

value - The value to set

Throws:

PowerException

setPowerOn

public void setPowerOn(int reb,
                       int psNum,
                       boolean on)
                throws PowerException

Turns a power supply on or off. Currently the only allowed operations are turning the master on or off, the bias HV supply on, or the CR DPHI supply on; all others are ignored.

Parameters:

reb - The REB number

psNum - The power supply number, or -1 for master switch

on - Turn on if true, off if false

Throws:

PowerException

togglePower

public void togglePower(int reb,
                        int psNum)
                 throws PowerException

Toggles the on/off state of a power supply.

Parameters:

reb - The REB number

psNum - The power supply number, or -1 for master switch

Throws:

PowerException

sequencePower

public void sequencePower(int reb,
                          boolean on)
                   throws PowerException

Sequences a power supply section on or off.

Parameters:

reb - The REB number

on - Turns on if true, off if false

Throws:

PowerException

sequencePower

public void sequencePower(boolean on)
                   throws PowerException

Sequences a whole power supply on or off.

Parameters:

on - Turns on if true, off if false

Throws:

PowerException

readChanExtrema

public double[] readChanExtrema(int reb,
                                RebPsDevice.PsName psName,
                                RebPsDevice.ChanName chan)
                         throws PowerException

Reads extrema for a power supply channel

Parameters:

reb - The REB number

psName - The power supply enum

chan - The channel enum

Returns:

A two-element array containing the maximum (0) and minimum (1) values

Throws:

PowerException

resetChanExtrema

public void resetChanExtrema(int reb,
                             RebPsDevice.PsName psName,
                             RebPsDevice.ChanName chan)
                      throws PowerException

Resets extrema for a power supply channel

Parameters:

reb - The REB number

psName - The power supply enum

chan - The channel enum

Throws:

PowerException

setListener

public void setListener(RebPsDevice.Event listen)

Sets an event listener.

Parameters:

listen - The listener object

clearListener

public void clearListener()

Clears the event listener.

getErrors

public int[] getErrors()

Gets the error counters.

Returns:

A two-element array containing the number of network timeouts and the number of sequence errors

getPs

public org.lsst.ccs.drivers.auxelex.RebPS getPs()

Gets the power supply driver.

Returns:

The driver

getPsType

public int getPsType()

Gets the power supply type.

Returns:

The type

getPsVersion

public int getPsVersion()

Gets the power supply version.

Returns:

The version

getPsId

public String getPsId()

Gets the power supply ID.

Returns:

The ID

dumpInfo

@Command(name="dump",
         type=ACTION,
         level=1,
         description="Dump info about power supply")
public String dumpInfo()
                                                                                                                                   throws org.lsst.ccs.drivers.commons.DriverException

Throws:

org.lsst.ccs.drivers.commons.DriverException

readRegs

@Command(name="readReg",
         type=ACTION,
         level=1,
         description="Query one or more registers")
public int[] readRegs(int addr,
                                                                                                                                           @Argument(defaultValue="1")
                                                                                                                                           int count)
                                                                                                                                    throws org.lsst.ccs.drivers.commons.DriverException

Throws:

org.lsst.ccs.drivers.commons.DriverException

getBulkPsSwitchName

public String getBulkPsSwitchName()

Get the name of the switch name controlling this PS board.