org.lsst.ccs.subsystem.airwatch.main

Class AirwatchMain

java.lang.Object

org.lsst.ccs.subsystem.airwatch.main.AirwatchMain

All Implemented Interfaces:

org.lsst.ccs.framework.AlertHandler, org.lsst.ccs.framework.ClearAlertHandler, org.lsst.ccs.framework.HardwareController, org.lsst.ccs.framework.HasLifecycle, org.lsst.ccs.framework.SignalHandler

public final class AirwatchMain
extends Object
implements org.lsst.ccs.framework.ClearAlertHandler, org.lsst.ccs.framework.HardwareController, org.lsst.ccs.framework.HasLifecycle, org.lsst.ccs.framework.SignalHandler

The main module for the Airwatch subsystem. This module is responsible for:

• Establishing initial contact with the configured instruments.
• Providing and managing the periodic readout task.
• Alert management.
• Instrument management and status reporting.

* @author tether

Nested Class Summary

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 String	DEW_POINT_KEY
static String	N_DEW_HUMIDS_KEY
static String	N_DEW_TEMPS_KEY

Constructor Summary

Constructors

Constructor and Description
AirwatchMain() Constructor.

Method Summary

Modifier and Type	Method and Description
org.lsst.ccs.framework.ClearAlertHandler.ClearAlertCode	canClearAlert(org.lsst.ccs.bus.data.Alert alert, org.lsst.ccs.bus.states.AlertState state) Handles all alerts by allowing them to be cleared.
org.lsst.ccs.framework.TreeWalkerDiag	checkHardware() Attempts to start all configured instruments that are operational.
void	checkStopped() Cancels periodic readout if this hasn't already been done (part of shutdown).
String	disable(int index) Prevents an instrument from being read until further notice.
String	enable(int index) Enables periodic readout for an instrument.
void	init() Checks whether all the subsystem components have been constructed.
String	instruments() Gives the status of each of the instruments.
void	postStart() Does nothing.
org.lsst.ccs.framework.TreeWalkerDiag	signal(org.lsst.ccs.framework.Signal sig) Signal handler for stop and abort.
void	start() Creates the email sender.

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

build, postBuild, postInit, postShutdown, shutdown

Field Detail

N_DEW_TEMPS_KEY

public static final String N_DEW_TEMPS_KEY

See Also:

Constant Field Values

N_DEW_HUMIDS_KEY

public static final String N_DEW_HUMIDS_KEY

See Also:

Constant Field Values

DEW_POINT_KEY

public static final String DEW_POINT_KEY

See Also:

Constant Field Values

Constructor Detail

AirwatchMain

public AirwatchMain()

Constructor.

Method Detail

instruments

@Command(type=QUERY,
         description="Displays a short report on instrument status.",
         level=0)
public String instruments()

Gives the status of each of the instruments. Includes instrument number, location, enable flag and the timestamp of the last record read.

Returns:

A string with a heading line followed by one line per instrument.

disable

@Command(type=ACTION,
         description="Prevents further readout of an instrument",
         level=1,
         timeout=120100)
public String disable(@Argument(description="Instrument index number.")
                                                                                                                                                         int index)
                                                                                                                                                  throws Exception

Prevents an instrument from being read until further notice.

Parameters:

index - An instrument number.

Returns:

"OK", or "BUSY" if a readout is in progress.

Throws:

IndexOutOfBoundsException - if index is invalid.

org.lsst.ccs.HardwareException - if device operations fail.

Exception - if ident is invalid or ambiguous.

See Also:

#enable(java.lang.String, java.lang.String)

enable

@Command(type=ACTION,
         description="Enables an instrument for readout.",
         level=1,
         timeout=121000)
public String enable(@Argument(description="Instrument index number.")
                                                                                                                                                 int index)
                                                                                                                                          throws Exception

Enables periodic readout for an instrument.

Parameters:

index - An instrument number.

Returns:

"OK", or "BUSY" if a readout is in progress.

Throws:

IndexOutOfBoundsException - if index is invalid.

org.lsst.ccs.HardwareException - if device operations fail.

Exception

See Also:

#disable(java.lang.String)

signal

public org.lsst.ccs.framework.TreeWalkerDiag signal(org.lsst.ccs.framework.Signal sig)

Signal handler for stop and abort.

Specified by:

signal in interface org.lsst.ccs.framework.SignalHandler

Parameters:

sig - The signal.

Returns:

TreeWalkerDiag.GO.

init

public void init()

Checks whether all the subsystem components have been constructed. Called just after the subsystem component tree has been built.

Specified by:

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

Throws:

Error - if anything is missing.

checkHardware

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

Attempts to start all configured instruments that are operational. Called in the middle of the initialization phase after start() has been called for all configurable components. All instruments are stopped and re-started with correct configurations for their assigned locations.

Specified by:

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

Returns:

TreeWalkerDiag.GO.

Throws:

org.lsst.ccs.HardwareException - if any fail to respond or if any report hardware faults.

start

public void start()

Creates the email sender. Called at the start of the initialization phase.

Specified by:

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

postStart

public void postStart()

Does nothing. Called at the end of the initialization phase after start() has been called for all configurable components and after checkHardware() and checkStarted() have been called for all hardware controllers.

Specified by:

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

checkStopped

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

Cancels periodic readout if this hasn't already been done (part of shutdown). The instruments themselves are not stopped and continue to collect data. Called at the beginning of the shutdown phase.

Specified by:

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

Throws:

org.lsst.ccs.HardwareException - if periodic readout is still scheduled.

See Also:

signal(org.lsst.ccs.framework.Signal)

canClearAlert

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

Handles all alerts by allowing them to be cleared.

Specified by:

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

Parameters:

alert - The alert to be cleared.

state - The current state (severity) of the alert.

Returns:

CLEAR_ALERT.