org.lsst.ccs.subsystem.teststand

Class TSSubSys

java.lang.Object

java.util.Observable

org.lsst.ccs.framework.Module

org.lsst.ccs.subsystem.teststand.TSSubSys

All Implemented Interfaces:

Observer, org.lsst.ccs.config.ConfigurationBulkChangeHandler, org.lsst.ccs.framework.Configurable, org.lsst.ccs.framework.HardwareController, org.lsst.ccs.framework.HasLifecycle, org.lsst.ccs.framework.SignalHandler, org.lsst.ccs.subsystem.monitor.Monitor.AlarmHandler, org.lsst.ccs.UsesSubsystem

public class TSSubSys
extends org.lsst.ccs.framework.Module
implements org.lsst.ccs.framework.HardwareController, org.lsst.ccs.subsystem.monitor.Monitor.AlarmHandler

Implements the test stand EO sensor modular subsystem.

Author:

Homer Neal * *****************************************************************************

Nested Class Summary

Nested classes/interfaces inherited from class org.lsst.ccs.framework.Module

org.lsst.ccs.framework.Module.ValueUpdate

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

org.lsst.ccs.framework.Configurable.Environment

Field Summary

Fields inherited from class org.lsst.ccs.framework.Module

name, nObserverThreads, tickMillis

Constructor Summary

Constructors

Constructor and Description
TSSubSys(String name, int tickMillis, String configName) Main constructor.

Method Summary

Modifier and Type	Method and Description
org.lsst.ccs.framework.TreeWalkerDiag	checkHardware()
void	checkStarted()
void	checkStopped()
void	disconnectVQM()
int	eoSetupPostCfg(int vac_outlet) Perform setup actions needed after powering on the CCD **************************************************************************
int	eoSetupPostCfg(int vac_outlet, String state2) Perform setup actions needed after powering on the CCD **************************************************************************
int	eoSetupPreCfg() Perform setup actions needed before powering on the CCD **************************************************************************
int	eoSetupPreCfg(String state1) Perform setup actions needed before powering on the CCD **************************************************************************
TSFullState	getFullState() Gets the full state of the test stand module.
double	getPressure() return the last pressure reading from whatever gauge is active **************************************************************************
int	getReqSlitWidth(double wl) Returns the required slit width for a given wavelength * **************************************************************************
int	getState() Gets the operating state word.
TSConfig	getTeststandc()
int	goTestStand() put system in mode for acquisition
void	initModule() Initializes the test stand subsystem.
boolean	isDoTestStandReadyCheck()
int	isTestStandReady() Tells if the subsystem is ready for acquisition go step **************************************************************************
void	postStart()
void	powerOutageAction() Put the system in a safe mode when a power outage has been signaled **************************************************************************
String	printFullState() Prints the full state of test stand * * **************************************************************************
void	processAlarm(int event, int parm) Handles alarm events.
void	publishState() Publishes the state of the test stand This is intended to be called whenever any element of the state is * changed.
void	raiseTSAlert(String alertmsg, org.lsst.ccs.bus.states.AlertState severity)
void	reconnectVQM()
void	reinit() reinit devices
void	resetTrip()
void	saveConfiguration() Saves the configuration data.
protected Object	sendSyncTSCommand(String name, Object... params)
void	setCfgBiasVAcq(double Vacq, int cfgstate) set configured bias target
void	setCfgCryoTAcq(double Tacq, int cfgstate) set configured cryo T target
void	setDoTestStandReadyCheck(boolean doTestStandReadyCheck)
void	setSlitWidthFile(String fl) set the source file path for the slit width data **************************************************************************
void	setState(int state) Sets the TS state word.
void	setTickMillis(int value) Sets the tick period.
int	setTSAcq1() Set the subsystem to the acquisition 1 state * **************************************************************************
int	setTSEXPERT() Set the subsystem to the EXPERT state * **************************************************************************
int	setTSIdle() Set the subsystem to the idle state * **************************************************************************
int	setTSReady() Set the subsystem to the ready state * **************************************************************************
int	setTSStateByName(String statename) Set the subsystem to the idle state * **************************************************************************
int	setTSTEST() Set the subsystem to the TEST state * **************************************************************************
int	setTSWarm() Set the subsystem to the acquisition 2 state * **************************************************************************
double	showBiasVAcq() Returns the configured set point for the acquisition CCD bias voltage * **************************************************************************
void	Sleep(double secs) Sleep - what a waste **************************************************************************
void	soundAlarm()
void	soundBleep()
void	startSubSys() startSubSys: put TS sub system into the ready state * * @param value The enabled state value to set: 0 = off, ~0 = on.
void	stopSubSys() stopSubSys: put TS sub system into the ready state **************************************************************************
void	tick() Performs periodic trending data broadcast.

Methods inherited from class org.lsst.ccs.framework.Module

getNObserverThreads, getObservables, getTickMillis, init, listens, processUpdate, sendSignal, sendSignalWithTimeLimit, setNObserverThreads, setObservables, shutdownNow, signal, startTicking, update

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

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.Configurable

change, dropSubmittedChanges, getChildren, getComponentByName, getEnvironment, getParent, getParentObject, getSubmittedChanges, isParameterConfigurable, printConfigurableParameters, setBulkParameter, start, submitChange, submitChanges, validateBulkChange

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

setParameterBulk

Methods inherited from interface org.lsst.ccs.UsesSubsystem

getComponentConfigurationEnvironment, getComponentLookup, getName, getSubsystem

Constructor Detail

TSSubSys

public TSSubSys(String name,
                int tickMillis,
                String configName)

Main constructor. * **************************************************************************

Method Detail

reinit

@Command(type=ACTION,
         description="reinit devices")
public void reinit()

reinit devices

initModule

public void initModule()

Initializes the test stand subsystem. ccdDevc; BiasDevice biasDevc; PhotoDiodeDevice pdDevc; CryoDevice cryoDevc; VacuumGaugeDevice vacDevc; MonochromatorDevice monoDevc; Fe55Device fe55Devc; EnviroDevice envDevc;

Overrides:

initModule in class org.lsst.ccs.framework.Module

checkHardware

public org.lsst.ccs.framework.TreeWalkerDiag checkHardware()

Specified by:

checkHardware in interface org.lsst.ccs.framework.HardwareController

checkStarted

public void checkStarted()

Specified by:

checkStarted in interface org.lsst.ccs.framework.HardwareController

checkStopped

public void checkStopped()

Specified by:

checkStopped in interface org.lsst.ccs.framework.HardwareController

postStart

public void postStart()
               throws org.lsst.ccs.HardwareException

Specified by:

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

Specified by:

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

Throws:

org.lsst.ccs.HardwareException

tick

public void tick()

Performs periodic trending data broadcast. * **************************************************************************

Overrides:

tick in class org.lsst.ccs.framework.Module

powerOutageAction

@Command(type=ACTION,
         description="Put system in safe mode")
public void powerOutageAction()

Put the system in a safe mode when a power outage has been signaled **************************************************************************

setTickMillis

@Command(type=ACTION,
         description="Sets the tick interval")
public void setTickMillis(int value)

Sets the tick period. * * Overrides the method in Module in order to publish a status update. * * @param value The tick period (milliseconds) to set. * **************************************************************************

Overrides:

setTickMillis in class org.lsst.ccs.framework.Module

Parameters:

value -

raiseTSAlert

@Command(type=QUERY,
         description="raise subsystem alert")
public void raiseTSAlert(String alertmsg,
                                                                                            org.lsst.ccs.bus.states.AlertState severity)

processAlarm

public void processAlarm(int event,
                         int parm)

Handles alarm events. * **************************************************************************

Specified by:

processAlarm in interface org.lsst.ccs.subsystem.monitor.Monitor.AlarmHandler

soundAlarm

@Command(name="soundAlarm")
public void soundAlarm()

soundBleep

@Command(name="soundBleep")
public void soundBleep()

resetTrip

@Command(name="resetTrip",
         description="reset trips etc...")
public void resetTrip()

startSubSys

@Command(type=ACTION,
         description="Start the TS sub system in the ready state")
public void startSubSys()
                                                                                                          throws Exception

startSubSys: put TS sub system into the ready state * * @param value The enabled state value to set: 0 = off, ~0 = on. * * @param publish If true, publish the new state on the status bus. * **************************************************************************

Throws:

Exception

isTestStandReady

@Command(name="isTestStandReady",
         description="returns 1 if the teststand subsystem is ready for acquisition")
public int isTestStandReady()
                                                                                                                                             throws Exception

Tells if the subsystem is ready for acquisition go step **************************************************************************

Throws:

Exception

setCfgBiasVAcq

@Command(description="set configured bias target")
public void setCfgBiasVAcq(double Vacq,
                                                                              int cfgstate)
                                                                       throws Exception

set configured bias target

Throws:

Exception - **************************************************************************

setCfgCryoTAcq

@Command(description="set configured cryo T target")
public void setCfgCryoTAcq(double Tacq,
                                                                                int cfgstate)
                                                                         throws Exception

set configured cryo T target

Throws:

Exception - **************************************************************************

goTestStand

@Command(name="goTestStand",
         description="put in mode for acquisition")
public int goTestStand()
                                                                                                 throws Exception

put system in mode for acquisition

Throws:

Exception - **************************************************************************

getPressure

@Command(name="getPressure",
         description="return the last pressure reading from whatever gauge is active")
public double getPressure()

return the last pressure reading from whatever gauge is active **************************************************************************

setTSStateByName

@Command(name="setTSStateByName",
         description="set TS subsystem to state indicated by the string")
public int setTSStateByName(String statename)

Set the subsystem to the idle state * **************************************************************************

setTSIdle

@Command(type=QUERY,
         name="setTSIdle",
         description="set TS subsystem to the idle state")
public int setTSIdle()
                                                                                                                         throws Exception

Set the subsystem to the idle state * **************************************************************************

Throws:

Exception

setTSReady

@Command(type=QUERY,
         name="setTSReady",
         description="set TS subsystem to the ready state")
public int setTSReady()
                                                                                                                            throws Exception

Set the subsystem to the ready state * **************************************************************************

Throws:

Exception

setTSAcq1

@Command(type=QUERY,
         name="setTSAcq1",
         description="set TS subsystem to the ACQ1 state")
public int setTSAcq1()
                                                                                                                         throws Exception

Set the subsystem to the acquisition 1 state * **************************************************************************

Throws:

Exception

setTSWarm

@Command(type=QUERY,
         name="setTSWarm",
         description="set TS subsystem to the WARM state")
public int setTSWarm()
                                                                                                                         throws Exception

Set the subsystem to the acquisition 2 state * **************************************************************************

Throws:

Exception

setTSTEST

@Command(type=QUERY,
         name="setTSTEST",
         description="set TS subsystem to the TEST state")
public int setTSTEST()
                                                                                                                         throws Exception

Set the subsystem to the TEST state * **************************************************************************

Throws:

Exception

setTSEXPERT

@Command(type=QUERY,
         name="setTSEXPERT",
         description="EXPERTS ONLY!!")
public int setTSEXPERT()
                                                                                                         throws Exception

Set the subsystem to the EXPERT state * **************************************************************************

Throws:

Exception

eoSetupPreCfg

@Command(type=QUERY,
         name="eoSetupPreCfg",
         description="prepare for eo acquisition")
public int eoSetupPreCfg()

Perform setup actions needed before powering on the CCD **************************************************************************

eoSetupPreCfg

@Command(type=QUERY,
         name="eoSetupPreCfg",
         description="prepare for eo acquisition")
public int eoSetupPreCfg(@Argument(name="state1",description="IDLE,WARM,READY,TEST,ACQ1")
                                                                                                                                String state1)

Perform setup actions needed before powering on the CCD **************************************************************************

eoSetupPostCfg

@Command(type=QUERY,
         name="eoSetupPostCfg",
         description="prepare for eo acquisition")
public int eoSetupPostCfg(@Argument(name="vac_outlet",description="PDU outlet number for the vacuum gauge")
                                                                                                                                  int vac_outlet)
                                                                                                                           throws Exception

Perform setup actions needed after powering on the CCD **************************************************************************

Throws:

Exception

eoSetupPostCfg

@Command(type=QUERY,
         name="eoSetupPostCfg",
         description="prepare for eo acquisition")
public int eoSetupPostCfg(@Argument(name="vac_outlet",description="PDU outlet number for the vacuum gauge")
                                                                                                                                  int vac_outlet,
                                                                                                                                  @Argument(name="state2",description="IDLE,WARM,READY,TEST,ACQ1")
                                                                                                                                  String state2)
                                                                                                                           throws Exception

Perform setup actions needed after powering on the CCD **************************************************************************

Parameters:

vac_outlet -

Throws:

Exception

showBiasVAcq

@Command(name="showBiasVAcq",
         description="returns the acquisition bias voltage set point")
public double showBiasVAcq()

Returns the configured set point for the acquisition CCD bias voltage * **************************************************************************

Returns:

getReqSlitWidth

@Command(name="getReqSlitWidth",
         description="returns the req. slit width for a given wl")
public int getReqSlitWidth(double wl)

Returns the required slit width for a given wavelength * **************************************************************************

Returns:

setSlitWidthFile

@Command(name="setSlitWidthFile",
         description="sets the slit width data file")
public void setSlitWidthFile(String fl)

set the source file path for the slit width data **************************************************************************

disconnectVQM

@Command(name="disconnectVQM",
         description="disconnect from the VQM port")
public void disconnectVQM()
                                                                                                       throws org.lsst.ccs.drivers.commons.DriverException

Throws:

org.lsst.ccs.drivers.commons.DriverException

reconnectVQM

@Command(name="reconnectVQM",
         description="reconnect to the VQM port")
public void reconnectVQM()
                                                                                                  throws org.lsst.ccs.drivers.commons.DriverException

Throws:

org.lsst.ccs.drivers.commons.DriverException

stopSubSys

@Command(name="stopsubsys",
         type=ACTION,
         description="Stop and set the TS sub system into the ready state")
public void stopSubSys()

stopSubSys: put TS sub system into the ready state **************************************************************************

saveConfiguration

@Command(name="saveconfig",
         type=ACTION,
         description="Saves the current configuration")
public void saveConfiguration()
                                                                                                                                 throws IOException

Saves the configuration data. * **************************************************************************

Throws:

IOException

getFullState

@Command(type=QUERY,
         description="Gets the full test stand state")
public TSFullState getFullState()

Gets the full state of the test stand module. * * This is intended to be called by GUIs during initialization * **************************************************************************

printFullState

@Command(name="printfullstate",
         type=QUERY,
         description="Prints the full test stand state")
public String printFullState()

Prints the full state of test stand * * **************************************************************************

getState

@Command(name="getstate",
         type=QUERY,
         description="Returns the current value of the TS state")
public int getState()

Gets the operating state word. * * @return The current value of the operating state * **************************************************************************

getTeststandc

public TSConfig getTeststandc()

setState

@Command(name="setstate",
         type=QUERY,
         description="sets the current value of the TS state")
public void setState(int state)

Sets the TS state word. **************************************************************************

Sleep

public void Sleep(double secs)

Sleep - what a waste **************************************************************************

publishState

@Command(name="publishState",
         type=QUERY,
         description="publishes the TS state")
public void publishState()

Publishes the state of the test stand This is intended to be called whenever any element of the state is * changed. **************************************************************************

isDoTestStandReadyCheck

@Command(name="isDoTestStandReadyCheck",
         type=QUERY,
         description="check whether the test stand ready check is being done")
public boolean isDoTestStandReadyCheck()

setDoTestStandReadyCheck

@Command(name="setDoTestStandReadyCheck",
         type=QUERY,
         description="set the test stand ready check on(true)/off(false)")
public void setDoTestStandReadyCheck(boolean doTestStandReadyCheck)

sendSyncTSCommand

protected Object sendSyncTSCommand(String name,
                                   Object... params)