org.lsst.ccs.subsystem.rafts

Class REBDevice

java.lang.Object

org.lsst.ccs.monitor.Device

org.lsst.ccs.subsystem.rafts.REBDevice

All Implemented Interfaces:

org.lsst.ccs.config.ConfigurationBulkChangeHandler, org.lsst.ccs.ConfigurationListener, org.lsst.ccs.framework.AlertHandler, org.lsst.ccs.framework.ClearAlertHandler, org.lsst.ccs.framework.HardwareController, org.lsst.ccs.framework.HasLifecycle

public class REBDevice
extends org.lsst.ccs.monitor.Device
implements org.lsst.ccs.ConfigurationListener, org.lsst.ccs.framework.ClearAlertHandler, org.lsst.ccs.config.ConfigurationBulkChangeHandler

Implements access to a REB device.

Author:

Owen Saxton

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	REBDevice.AdcData

Nested classes/interfaces inherited from interface org.lsst.ccs.ConfigurationListener

org.lsst.ccs.ConfigurationListener.ConfigurationOperation

Nested classes/interfaces inherited from interface org.lsst.ccs.framework.ClearAlertHandler

org.lsst.ccs.framework.ClearAlertHandler.ClearAlertCode

Field Summary

Fields

Modifier and Type	Field and Description
static int	CHAN_HTR_POWER
static int	CHAN_HTR_VOLTS
static int	CHAN_RTD_INT_TEMP
static int	CHAN_RTD_INT_VOLT
static int	CHAN_TOTAL_POWER
protected int	configCcdMask
protected int	hdwTypeI
protected int	hwVersion
static int	NUM_HTR_CHANS
static int	NUM_RTD_CHANS
static String	RAFTS
static String	RAFTS_LIMITS
static String	RAFTS_POWER
protected int	realCcdMask
static int	TYPE_ASP_TEMP
static int	TYPE_BD_POWER
static int	TYPE_BD_TEMP
static int	TYPE_BIAS_VOLT
static int	TYPE_CCD_CURR
static int	TYPE_CR_VOLT
static int	TYPE_HEATER
static int	TYPE_HV_SWITCH
static int	TYPE_RTD

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

disabled, fullName, inited, lineMask, lineState, lineWarm, log, mon, name, online, path, s

Constructor Summary

Constructors

Constructor and Description
REBDevice()

Method Summary

Modifier and Type	Method and Description
void	build() Early initialization (build phase).
org.lsst.ccs.framework.ClearAlertHandler.ClearAlertCode	canClearAlert(org.lsst.ccs.bus.data.Alert alert, org.lsst.ccs.bus.states.AlertState alertState) Callback to clear an Alert instance.
int	checkAspics() Checks loaded ASPIC configuration data.
protected int[]	checkChannel(String name, int hwChan, String type, String subtype) Checks a channel's parameters for validity.
String	checkDacsCalibration() Get voltage differences between setpoint and readback for Bias and Clock rails to assist with calibration of setpoint to raw ADC conversion
void	clearUpdateCCDsPowerState()
protected void	close() Closes the connection.
void	configurationChanged(org.lsst.ccs.bus.data.ConfigurationInfo newConfigurationInfo, org.lsst.ccs.bus.data.ConfigurationInfo oldConfigurationInfo, org.lsst.ccs.ConfigurationListener.ConfigurationOperation configOperation) Triggers activities when configuration is changed 1st use is to update CCDsPowerState if relevant parameters changed
static String	getAdcName(int adc) Gets the name of of a slow ADC.
int	getCcdMask() Gets the mask of CCDs being used.
String	getCCDsPowerState() measure power state of ccds, user version turns off CCDs on error
org.lsst.ccs.utilities.ccd.CCDType	getCcdType() Gets the CCD type.
protected String	getGroupForChannel(org.lsst.ccs.monitor.Channel ch)
int	getHdwType() Gets the hardware type.
org.lsst.ccs.utilities.ccd.CCDType	getHwCcdType() Gets the hardware CCD type.
int	getHwVersion() Gets the hardware version.
int	getId() Gets the REB ID.
String	getIfcName() Gets the network interface name.
ImageData	getImage(int offset, int count) Gets a portion of the current image.
ImageData	getImage(int ccd, int offset, int count) Gets a portion of the current image.
org.lsst.ccs.drivers.reb.ImageMetadata	getImageMetadata() Gets the DAQ metadata for the current image.
ImageProc	getImageProc() Gets the associated image processor.
double	getMaxDelta() Get config param maxDelta
double	getMaxStep() Get config param maxStep
double	getMinTol() Get config param minTol
String	getMonitorTasks()
int	getRaftNumber() Gets the raft number.
REB	getREBConfig() Gets the REB configuration data.
org.lsst.ccs.utilities.ccd.Reb	getRebGeometry()
int	getRebNumber() Gets the REB number.
StatusData	getRebStatus() Gets the REB status block.
int	getRebType() Gets the REB type.
RegisterData	getRegister(int address, int count) Gets the contents of REB registers.
SequencerProc	getSequencer() Gets the associated sequencer.
long	getSerialNumber() Gets the serial number.
long	getTime() Gets the time base as Unix time.
long	getTime(String rSet)
int	getUnders() Gets the bit mask of DAC channels under threshold
boolean	getUpdateCCDsPowerState()
protected void	initChannel(String name, int id, int hwChan, int type, int subtype) Initializes a channel (in this case only checks HW channel number).
protected void	initDevice() Performs basic initialization.
protected void	initialize() Performs full initialization.
boolean	isBackBiasOn() Gets the back bias on state.
boolean	isSerialNumValid() Gets whether the serial number is valid.
int	loadAspics(boolean all) Loads configuration data to the ASPICs.
int	loadDeltaDacs(boolean all) Loads configured bias and clcock DAC values.
void	pauseMonitorTasks(String... taskNames)
void	postStart()
void	powerCCDs(boolean on) Performs CCD power on/off sequences.
void	powerCCDsOff() Performs CCD power off sequence.
void	powerCCDsOn() Performs CCD power on sequence.
void	readAllAdcs(List<REBDevice.AdcData> dataList) Reads all the ADCs and adds them to data list.
protected double	readChannel(int hwChan, int type) Reads a channel.
protected void	readChannelGroup() Reads grouped channels.
protected void	readChannelGroup(String group)
double	readChannelNow(int hwChan, int type) Reads a channel immediately.
double[]	readPowerAdcs() Reads the board power ADCs.
double[]	readPowerAdcs(List<REBDevice.AdcData> dataList) Reads the board power ADCs and adds them to data list.
int	readSeqIdleState() Reads the sequencer idle state lines.
double[]	readSlowAdcs(List<REBDevice.AdcData> dataList) Reads the clock and bias voltage slow ADCs and adds them to data list.
int	resetAspics() Resets the ASPICs.
void	resetFrontEnd() Resets the front end.
void	resumeMonitorTasks(String... taskNames)
void	setAllAspic(String parmName, int val, boolean commit)
void	setAllAspicGain(int gain) Transversal setting of all Gains for the Aspics of this reb.
void	setAllAspicRc(int rc) Transversal setting of all Rcs for the Aspics of this reb.
void	setAllAspicTM(boolean tm) Transversal setting of all TM for the Aspics of this reb.
void	setBackBias(boolean value) Turns back bias on or off.
void	setCCDClocksLow() Sets Sequencer Clock lines to low state Corrupts the sequencer file -- needs strategy revision Needed in [WG]REB power management but incomplete
void	setCcdType(org.lsst.ccs.utilities.ccd.CCDType ccdType) Sets the CCD type.
void	setClientFactory(org.lsst.ccs.drivers.reb.ClientFactory factory) Sets the client factory.
void	setFitsConditions(String filter, double temperature, double wavelength) Sets the FITS file test conditions.
void	setHeater(int heater, double volts) Sets a heater voltage.
void	setHeaterPower(int heater, double power) Sets heater power.
protected void	setOnline(boolean online)
void	setREBConfig(REB reb) Sets the REB configuration data.
void	setRebGeometry(org.lsst.ccs.utilities.ccd.Reb reb)
void	setRegister(int address, int[] values) Sets the contents of REB registers.
void	setScienceCCD(boolean useScience) Sets whether a science CCD is being used on a WREB.
void	setTime() Sets the time base to the current system time.
void	setUpdateCCDsPowerState()
void	simulateDisconnection() Simulate a disconnect
void	testCCDShorts() Performs CCD shorts test.
void	triggerMonitorTasks(String... taskNames)
String	updateDacsCalibration() Get voltage differences between setpoint and readback for Bias and Clock rails to assist with calibration of setpoint to raw ADC conversion
void	validateBulkChange(Map<String,Object> params) Validates configuration parameter change.
void	writeSeqIdleState(int value) Writes the sequencer idle state lines.

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

addLine, checkHardware, checkHwLine, checkLine, checkOnline, checkTimeout, configure, disable, dropChannel, enable, getDeviceMonitorUpdateTasks, getFullName, getMonitorUpdateTasksForChannels, getName, getOutputLines, getPath, init, initChannel, initSensors, isHwLineSet, isLineSet, isOnline, isTimeout, readChannel, 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.ConfigurationListener

configurationChanged

Methods inherited from interface org.lsst.ccs.config.ConfigurationBulkChangeHandler

setParameterBulk

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

checkStopped

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

postBuild, postInit, postShutdown, shutdown, start

Field Detail

RAFTS

public static final String RAFTS

See Also:

Constant Field Values

RAFTS_LIMITS

public static final String RAFTS_LIMITS

See Also:

Constant Field Values

RAFTS_POWER

public static final String RAFTS_POWER

See Also:

Constant Field Values

TYPE_BD_TEMP

public static final int TYPE_BD_TEMP

See Also:

Constant Field Values

TYPE_BD_POWER

public static final int TYPE_BD_POWER

See Also:

Constant Field Values

TYPE_RTD

public static final int TYPE_RTD

See Also:

Constant Field Values

TYPE_ASP_TEMP

public static final int TYPE_ASP_TEMP

See Also:

Constant Field Values

TYPE_BIAS_VOLT

public static final int TYPE_BIAS_VOLT

See Also:

Constant Field Values

TYPE_CCD_CURR

public static final int TYPE_CCD_CURR

See Also:

Constant Field Values

TYPE_CR_VOLT

public static final int TYPE_CR_VOLT

See Also:

Constant Field Values

TYPE_HEATER

public static final int TYPE_HEATER

See Also:

Constant Field Values

TYPE_HV_SWITCH

public static final int TYPE_HV_SWITCH

See Also:

Constant Field Values

CHAN_TOTAL_POWER

public static final int CHAN_TOTAL_POWER

See Also:

Constant Field Values

CHAN_HTR_VOLTS

public static final int CHAN_HTR_VOLTS

See Also:

Constant Field Values

CHAN_HTR_POWER

public static final int CHAN_HTR_POWER

See Also:

Constant Field Values

NUM_HTR_CHANS

public static final int NUM_HTR_CHANS

See Also:

Constant Field Values

CHAN_RTD_INT_TEMP

public static final int CHAN_RTD_INT_TEMP

See Also:

Constant Field Values

CHAN_RTD_INT_VOLT

public static final int CHAN_RTD_INT_VOLT

See Also:

Constant Field Values

NUM_RTD_CHANS

public static final int NUM_RTD_CHANS

See Also:

Constant Field Values

hdwTypeI

protected int hdwTypeI

configCcdMask

protected int configCcdMask

realCcdMask

protected volatile int realCcdMask

hwVersion

protected volatile int hwVersion

Constructor Detail

REBDevice

public REBDevice()

Method Detail

build

public void build()

Early initialization (build phase).

Specified by:

build in interface org.lsst.ccs.framework.HasLifecycle

setRebGeometry

public void setRebGeometry(org.lsst.ccs.utilities.ccd.Reb reb)

getRebGeometry

public org.lsst.ccs.utilities.ccd.Reb getRebGeometry()

postStart

public void postStart()

Specified by:

postStart in interface org.lsst.ccs.framework.HasLifecycle

setUpdateCCDsPowerState

public void setUpdateCCDsPowerState()

clearUpdateCCDsPowerState

@Command(type=ACTION,
         description="Clear the updateCCDsPowerState flag")
public void clearUpdateCCDsPowerState()

getUpdateCCDsPowerState

@Command(type=QUERY,
         description="Get the value of the updateCCDsPowerState flag")
public boolean getUpdateCCDsPowerState()

validateBulkChange

public void validateBulkChange(Map<String,Object> params)

Validates configuration parameter change.

Specified by:

validateBulkChange in interface org.lsst.ccs.config.ConfigurationBulkChangeHandler

Parameters:

params - The map of configuration parameter values

configurationChanged

public void configurationChanged(org.lsst.ccs.bus.data.ConfigurationInfo newConfigurationInfo,
                                 org.lsst.ccs.bus.data.ConfigurationInfo oldConfigurationInfo,
                                 org.lsst.ccs.ConfigurationListener.ConfigurationOperation configOperation)

Triggers activities when configuration is changed 1st use is to update CCDsPowerState if relevant parameters changed

Specified by:

configurationChanged in interface org.lsst.ccs.ConfigurationListener

Parameters:

params - The map of configuration parameter values

getId

@Command(type=QUERY,
         description="Get the REB ID")
public int getId()

Gets the REB ID.

Returns:

The REB ID

getIfcName

@Command(type=QUERY,
         description="Get the network interface name")
public String getIfcName()

Gets the network interface name.

Returns:

The name of the network interface being used

getCcdMask

@Command(type=QUERY,
         description="Get the mask of CCDs being used")
public int getCcdMask()

Gets the mask of CCDs being used.

Returns:

The mask of active CCDs

setCcdType

public void setCcdType(org.lsst.ccs.utilities.ccd.CCDType ccdType)

Sets the CCD type.

Parameters:

ccdType - The CCD type

getCcdType

@Command(type=QUERY,
         description="Get the type of CCDs being used")
public org.lsst.ccs.utilities.ccd.CCDType getCcdType()

Gets the CCD type.

Returns:

The CCD type

getHwCcdType

@Command(type=QUERY,
         description="Get the hardware type of CCDs being used")
public org.lsst.ccs.utilities.ccd.CCDType getHwCcdType()

Gets the hardware CCD type.

Returns:

The hardware CCD type

setScienceCCD

@Command(type=ACTION,
         description="Set whether a WREB is using a science CCD")
public void setScienceCCD(@Argument(description="Whether a science CCD")
                                                                                                                  boolean useScience)

Sets whether a science CCD is being used on a WREB.

Parameters:

useScience - Whether it's a science CCD

setClientFactory

public void setClientFactory(org.lsst.ccs.drivers.reb.ClientFactory factory)

Sets the client factory.

Parameters:

factory - The client factory

getRebType

@Command(type=QUERY,
         description="Gets the REB type")
public int getRebType()

Gets the REB type.

Returns:

The REB type

getRebNumber

@Command(type=QUERY,
         description="Gets the REB number")
public int getRebNumber()

Gets the REB number.

Returns:

The REB number (0 - 2) within its raft

getRaftNumber

@Command(type=QUERY,
         description="Gets the raft number")
public int getRaftNumber()

Gets the raft number.

Returns:

The raft number (00 - 44) for the REB

getHdwType

@Command(type=QUERY,
         description="Gets the hardware type")
public int getHdwType()

Gets the hardware type.

Returns:

The hardware type

getHwVersion

@Command(type=QUERY,
         description="Get the hardware version")
public int getHwVersion()

Gets the hardware version.

Returns:

The hardware version, or 0 if the REB is not connected

getSerialNumber

@Command(type=QUERY,
         description="Get the serial number")
public long getSerialNumber()

Gets the serial number.

Returns:

The serial number, or 0 if the REB is not connected

isSerialNumValid

public boolean isSerialNumValid()

Gets whether the serial number is valid.

Returns:

The serial number validity

canClearAlert

public org.lsst.ccs.framework.ClearAlertHandler.ClearAlertCode canClearAlert(org.lsst.ccs.bus.data.Alert alert,
                                                                             org.lsst.ccs.bus.states.AlertState alertState)

Callback to clear an Alert instance. Return a ClearAlertCode for the provided Alert.

Specified by:

canClearAlert in interface org.lsst.ccs.framework.ClearAlertHandler

Parameters:

alert - The Alert instance to clear.

alertState - The AlertState for the provided Alert.

Returns:

A ClearAlertCode to indicate which action is to be taken by the framework.

initDevice

protected void initDevice()

Performs basic initialization. Invoked when HasLifecycle::init is called on Device class. Device fields that are initialized exclusively in this method don't need to be marked as volatile. Checks that Groovy specifications are consistent

Overrides:

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

initialize

protected void initialize()

Performs full initialization. Opens connection to the REB and obtains information about it

Specified by:

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

close

protected void close()

Closes the connection.

Specified by:

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

checkChannel

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

Checks a channel's parameters for validity.

Overrides:

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

Parameters:

name - The channel name

hwChan - The hardware channel

type - The channel type string

subtype - The channel subtype string

Returns:

Two-element array containing the encoded type [0] and subtype [1]

Throws:

Exception - If parameters are invalid

initChannel

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

Initializes a channel (in this case only checks HW channel number).

Overrides:

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

Parameters:

name - The channel name

id - The channel ID

hwChan - The hardware channel

type - The channel type

subtype - The channel subtype

getGroupForChannel

protected String getGroupForChannel(org.lsst.ccs.monitor.Channel ch)

Overrides:

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

readChannelGroup

protected void readChannelGroup(String group)

Overrides:

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

readChannelGroup

protected void readChannelGroup()

Reads grouped channels.

Overrides:

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

readChannel

protected double readChannel(int hwChan,
                             int type)

Reads a channel.

Overrides:

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

Parameters:

hwChan - The hardware channel number

type - The encoded channel type

Returns:

The read value

readChannelNow

public double readChannelNow(int hwChan,
                             int type)

Reads a channel immediately.

Overrides:

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

Parameters:

hwChan - The hardware channel number

type - The encoded channel type

Returns:

The read value

readPowerAdcs

public double[] readPowerAdcs()
                       throws RaftException

Reads the board power ADCs.

Returns:

The array of board voltages and currents

Throws:

RaftException

readPowerAdcs

public double[] readPowerAdcs(List<REBDevice.AdcData> dataList)
                       throws RaftException

Reads the board power ADCs and adds them to data list. This takes ~33 ms reading the 5 (V,I) pairs

Parameters:

dataList - List to receive the read values, etc

Returns:

The read values

Throws:

RaftException

readSlowAdcs

public double[] readSlowAdcs(List<REBDevice.AdcData> dataList)
                      throws RaftException

Reads the clock and bias voltage slow ADCs and adds them to data list.

Parameters:

dataList - List to receive the read values, etc

Returns:

Array of read values

Throws:

RaftException

readAllAdcs

public void readAllAdcs(List<REBDevice.AdcData> dataList)
                 throws RaftException

Reads all the ADCs and adds them to data list.

Parameters:

dataList - List to receive the read values, etc

Throws:

RaftException

getUnders

@Command(type=ACTION,
         description="get underMask protection register value")
public int getUnders()
                                                                                                    throws RaftException

Gets the bit mask of DAC channels under threshold

Throws:

RaftException

getAdcName

public static String getAdcName(int adc)

Gets the name of of a slow ADC.

Parameters:

adc - The ADC ID

Returns:

The ADC name

readSeqIdleState

public int readSeqIdleState()
                     throws RaftException

Reads the sequencer idle state lines.

Returns:

The lines value

Throws:

RaftException

writeSeqIdleState

public void writeSeqIdleState(int value)
                       throws RaftException

Writes the sequencer idle state lines.

Parameters:

value - The lines value

Throws:

RaftException

setREBConfig

@Command(type=ACTION,
         description="Sets the REB configuration data")
public void setREBConfig(@Argument(name="reb",description="REB configuration data")
                                                                                                       REB reb)
                                                                                                throws RaftException

Sets the REB configuration data.

Parameters:

reb - The REB configuration (object)

Throws:

RaftException

getREBConfig

@Command(type=QUERY,
         description="Gets the REB configuration data")
public REB getREBConfig()

Gets the REB configuration data.

Returns:

The REB configuration (object)

setAllAspicTM

@Command(type=CONFIGURATION,
         description="Set TM for all ASPICs on this REB")
public void setAllAspicTM(boolean tm)

Transversal setting of all TM for the Aspics of this reb. It internally uses the configuration service.

Parameters:

tm - true for TM, false for normal

setAllAspicGain

@Command(type=CONFIGURATION,
         description="Set gain for all ASPICs on this REB")
public void setAllAspicGain(int gain)

Transversal setting of all Gains for the Aspics of this reb. It internally uses the configuration service.

Parameters:

gain - the new gain value

setAllAspicRc

@Command(type=CONFIGURATION,
         description="Set RC for all ASPICs on this REB")
public void setAllAspicRc(int rc)

Transversal setting of all Rcs for the Aspics of this reb. It internally uses the configuration service.

Parameters:

rc - the new rc value

setAllAspic

public void setAllAspic(String parmName,
                        int val,
                        boolean commit)

powerCCDs

@Command(type=ACTION,
         description="Perform CCD power on/off sequence",
         level=3)
public void powerCCDs(@Argument(description="Whether to power on")
                                                                                                                        boolean on)
                                                                                                                 throws RaftException

Performs CCD power on/off sequences.

Parameters:

on - Whether to power on (true) or off (false)

Throws:

RaftException

getCCDsPowerState

@Command(type=ACTION,
         description="get CCD Power State",
         level=3)
public String getCCDsPowerState()
                                                                                                             throws RaftException

measure power state of ccds, user version turns off CCDs on error

Returns:

String representing CCDsPowerState

Throws:

RaftException

powerCCDsOn

@Command(type=ACTION,
         description="Perform CCD power on sequence",
         level=3)
public void powerCCDsOn()
                                                                                                               throws RaftException

Performs CCD power on sequence. CCDsPowerState is set to ON (success) or is set in powerCCDsOff() to OFF or FAULT 0

Throws:

RaftException

powerCCDsOff

@Command(type=ACTION,
         description="Perform CCD power off sequence",
         level=3)
public void powerCCDsOff()
                                                                                                                 throws RaftException

Performs CCD power off sequence.

Throws:

RaftException

setCCDClocksLow

@Command(type=ACTION,
         description="Set CCD Clock lines to low state",
         level=3)
public void setCCDClocksLow()
                                                                                                                      throws RaftException

Sets Sequencer Clock lines to low state Corrupts the sequencer file -- needs strategy revision Needed in [WG]REB power management but incomplete

Throws:

RaftException

checkDacsCalibration

@Command(type=ACTION,
         description="Report Bias, Clock lines set/read deltas and DAC calibration",
         level=3)
public String checkDacsCalibration()
                                                                                                                                                         throws RaftException

Get voltage differences between setpoint and readback for Bias and Clock rails to assist with calibration of setpoint to raw ADC conversion

Throws:

RaftException

updateDacsCalibration

@Command(type=ACTION,
         description="Report and update Bias, Clock lines set/read deltas and DAC calibration",
         level=3)
public String updateDacsCalibration()
                                                                                                                                                                     throws RaftException

Get voltage differences between setpoint and readback for Bias and Clock rails to assist with calibration of setpoint to raw ADC conversion

Throws:

RaftException

testCCDShorts

@Command(type=ACTION,
         description="Perform CCD shorts test",
         level=3)
public void testCCDShorts()
                                                                                                           throws RaftException

Performs CCD shorts test.

Throws:

RaftException

loadDeltaDacs

@Command(type=ACTION,
         description="Applies changed Bias and Clock DAC configuration values on Powered CCDs",
         level=3)
public int loadDeltaDacs(@Argument(description="reload all (true) or changes only (false)")
                                                                                                                                                                 boolean all)
                                                                                                                                                          throws RaftException

Loads configured bias and clcock DAC values.

Parameters:

all - If true, all data are loaded; otherwise only changes

Returns:

The number of Bias and Clock DACs loaded

Throws:

RaftException - This is the user command, checks to verify CCDs are ON/DELTA and only changes allowed by configuration system can be used Updates the CCDsPowerState on success (eg. DELTA -> ON)

loadAspics

@Command(type=ACTION,
         description="Load configuration data to the ASPICs")
public int loadAspics(boolean all)
                                                                                                   throws Exception

Loads configuration data to the ASPICs.

Parameters:

all - If true, all data are loaded; otherwise only changes

Returns:

The number of ASPICs loaded

Throws:

Exception

resetAspics

@Command(type=ACTION,
         description="Reset the ASPICs")
public int resetAspics()
                                                                               throws Exception

Resets the ASPICs.

Returns:

The number of ASPICs reset

Throws:

Exception

checkAspics

@Command(type=ACTION,
         description="Check loaded ASPIC configuration")
public int checkAspics()
                                                                                               throws Exception

Checks loaded ASPIC configuration data.

Returns:

The mask of mismatched fields

Throws:

Exception

isBackBiasOn

@Command(type=QUERY,
         description="Get the back bias on state")
public boolean isBackBiasOn()
                                                                                             throws RaftException

Gets the back bias on state.

Returns:

Whether back bias is turned on

Throws:

RaftException

setBackBias

@Command(type=ACTION,
         description="Turn back bias on or off")
public void setBackBias(@Argument(description="The on state")
                                                                                               boolean value)
                                                                                        throws RaftException

Turns back bias on or off.

Parameters:

value - The back bias on state to set (true or false)

Throws:

RaftException

setHeater

@Command(type=ACTION,
         description="Set heater voltage")
public void setHeater(@Argument(description="Heater number")
                                                                                       int heater,
                                                                                       @Argument(description="The voltage")
                                                                                       double volts)
                                                                                throws RaftException

Sets a heater voltage.

Parameters:

heater - The heater number: 0 or 1

volts - The voltage to set

Throws:

RaftException

setHeaterPower

@Command(type=ACTION,
         description="Set heater power")
public void setHeaterPower(@Argument(description="Heater number")
                                                                                          int heater,
                                                                                          @Argument(description="The power value")
                                                                                          double power)
                                                                                   throws RaftException

Sets heater power.

Parameters:

heater - The heater number: 0 or 1

power - The power value to set

Throws:

RaftException

setTime

@Command(type=ACTION,
         description="Sets the time base to the current system time")
public void setTime()
                                                                                                         throws RaftException

Sets the time base to the current system time.

Throws:

RaftException

getTime

@Command(type=QUERY,
         description="Gets the time base as Unix time")
public long getTime()
                                                                                          throws RaftException

Gets the time base as Unix time.

Returns:

The time base converted to Unix time

Throws:

RaftException

getTime

@Command(type=QUERY,
         description="Gets a trigger time as Unix time")
public long getTime(@Argument(name="regset",description="Register set name")
                                                                                                  String rSet)
                                                                                           throws RaftException

Throws:

RaftException

setFitsConditions

@Command(type=ACTION,
         description="Sets the FITS file test conditions")
public void setFitsConditions(@Argument(description="Filter name")
                                                                                                               String filter,
                                                                                                               @Argument(description="The temperature")
                                                                                                               double temperature,
                                                                                                               @Argument(description="The wavelength")
                                                                                                               double wavelength)

Sets the FITS file test conditions.

Parameters:

filter - The filter name

temperature - The temperature set point

wavelength - The monochromator wavelength

getImageMetadata

@Command(type=QUERY,
         description="Get the DAQ metadata for the current image")
public org.lsst.ccs.drivers.reb.ImageMetadata getImageMetadata()
                                                                                                                                                throws RaftException

Gets the DAQ metadata for the current image.

Returns:

The image metadata

Throws:

RaftException

getImage

@Command(type=QUERY,
         description="Gets a portion of the current image")
public ImageData getImage(@Argument(description="Offset to the pixel data")
                                                                                                           int offset,
                                                                                                           @Argument(description="Number of pixels")
                                                                                                           int count)
                                                                                                    throws RaftException

Gets a portion of the current image.

Parameters:

offset - The offset (in pixels) to the first pixel data to obtain.

count - The number of data pixels to obtain. If zero, all the data, starting at offset, is obtained.

Returns:

The returned pixel data

Throws:

RaftException

getImage

@Command(type=QUERY,
         description="Gets a portion of the current image")
public ImageData getImage(@Argument(description="CCD number")
                                                                                                           int ccd,
                                                                                                           @Argument(description="Offset to the pixel data")
                                                                                                           int offset,
                                                                                                           @Argument(description="Number of pixels")
                                                                                                           int count)
                                                                                                    throws RaftException

Gets a portion of the current image.

Parameters:

ccd - The CCD number

offset - The offset (in pixels) to the first pixel data to obtain.

count - The number of data pixels to obtain. If zero, all the data, starting at offset, is obtained.

Returns:

The returned pixel data

Throws:

RaftException

resetFrontEnd

@Command(type=ACTION,
         description="Resets the front end")
public void resetFrontEnd()
                                                                                      throws RaftException

Resets the front end. This is the only way to stop a running sequencer program

Throws:

RaftException

getRegister

@Command(type=QUERY,
         description="Gets the contents of REB registers")
public RegisterData getRegister(@Argument(description="Address of the first register")
                                                                                                                int address,
                                                                                                                @Argument(description="Number of registers to read")
                                                                                                                int count)
                                                                                                         throws RaftException

Gets the contents of REB registers.

Parameters:

address - The address of the first register to read

count - The number of registers to read

Returns:

The block of register values

Throws:

RaftException

setRegister

@Command(type=ACTION,
         description="Sets the contents of REB registers")
public void setRegister(@Argument(description="Address of the first register")
                                                                                                         int address,
                                                                                                         @Argument(description="Values to write")
                                                                                                         int[] values)
                                                                                                  throws RaftException

Sets the contents of REB registers.

Parameters:

address - The address of the first register to write

values - The array of values to write to consecutive registers

Throws:

RaftException

getRebStatus

@Command(type=QUERY,
         description="Gets the REB status block")
public StatusData getRebStatus()
                                                                                               throws RaftException

Gets the REB status block.

Returns:

The REB status block

Throws:

RaftException

getImageProc

public ImageProc getImageProc()

Gets the associated image processor.

Returns:

The image

getSequencer

public SequencerProc getSequencer()

Gets the associated sequencer.

Returns:

The sequencer

getMaxDelta

public double getMaxDelta()

Get config param maxDelta

Returns:

The value

getMaxStep

public double getMaxStep()

Get config param maxStep

Returns:

The value

getMinTol

public double getMinTol()

Get config param minTol

Returns:

The value

simulateDisconnection

@Command(simulation=true)
public void simulateDisconnection()

Simulate a disconnect

setOnline

protected void setOnline(boolean online)

Overrides:

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

getMonitorTasks

@Command(type=QUERY,
         description="Show list of monitor-update task names")
public String getMonitorTasks()

pauseMonitorTasks

@Command(type=QUERY,
         description="Pause \"all\" or selected monitoring tasks")
public void pauseMonitorTasks(@Argument(description="tasks...")
                                                                                                                      String... taskNames)

resumeMonitorTasks

@Command(type=QUERY,
         description="Resume \"all\" or selected monitoring tasks")
public void resumeMonitorTasks(@Argument(description="tasks...")
                                                                                                                        String... taskNames)

triggerMonitorTasks

@Command(type=QUERY,
         description="Trigger \"all\" or selected monitoring tasks")
public void triggerMonitorTasks(@Argument(description="tasks...")
                                                                                                                          String... taskNames)