org.lsst.ccs.subsystem.airwatch.main

Class AirwatchMain

java.lang.Object

java.util.Observable

org.lsst.ccs.framework.Module

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

All Implemented Interfaces:

Observer, org.lsst.ccs.framework.Configurable, org.lsst.ccs.framework.HardwareController, org.lsst.ccs.framework.SignalHandler

public class AirwatchMain
extends org.lsst.ccs.framework.Module
implements org.lsst.ccs.framework.HardwareController

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

environment, name, nObserverThreads, tickMillis

Constructor Summary

Constructors

Constructor and Description
AirwatchMain(String name) Constructor.

Method Summary

Modifier and Type	Method and Description
org.lsst.ccs.framework.TreeWalkerDiag	checkHardware() Attempts to start all configured instruments.
void	checkStarted() Checks whether all the instruments are running.
void	checkStopped() Checks whether future readouts have been canceled.
String	disable(String ident) Prevents an instrument from being read until further notice.
String	enable(String ident, String newLocation) Sets a new location for an instrument then enables periodic readout for it.
void	initModule() Checks whether all the subsystem components have been constructed and registers the ClearAlertHandler.
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() Does nothing.

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

getComponentTree, getEnvironment, getName, getNObserverThreads, getObservables, getSubsystem, getTickMillis, init, listens, processUpdate, sendSignal, sendSignalWithTimeLimit, setEnvironment, setName, setNObserverThreads, setObservables, setTickMillis, shutdownNow, startTicking, tick, 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, getCheckedValueFromConfiguration, getChildren, getComponentByName, getParent, getParentObject, getSubmittedChanges, isParameterConfigurable, notifyChange, notifyChangeWithoutPreliminaryChecks, printConfigurableParameters, setBulkParameter, submitChange, submitChanges, validateBulkChange

Constructor Detail

AirwatchMain

public AirwatchMain(String name)

Constructor.

Parameters:

name - The module name.

Method Detail

instruments

@Command(type=QUERY,
         description="Displays a short report on instrument status.")
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")
public String disable(@Argument(description="Instrument index number or location.")
                                                                                                              String ident)
                                                                                                       throws Exception

Prevents an instrument from being read until further notice.

Parameters:

ident - Either an instrument number or a location name.

Returns:

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

Throws:

IllegalArgumentException - if ident is invalid or ambiguous.

Exception

See Also:

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

enable

@Command(type=ACTION,
         description="Sets new location for and enables instrument.")
public String enable(@Argument(description="Instrument index number or current location.")
                                                                                                                 String ident,
                                                                                                                 @Argument(description="New location.")
                                                                                                                 String newLocation)
                                                                                                          throws Exception

Sets a new location for an instrument then enables periodic readout for it.

Parameters:

ident - Either an instrument number or a location name.

newLocation - The name of the new location to be monitored.

Returns:

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

Throws:

IllegalArgumentException - if ident is invalid or ambiguous.

IllegalArgumentException - if newLocation 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

Overrides:

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

Parameters:

sig - The signal.

Returns:

TreeWalkerDiag.GO.

initModule

public void initModule()

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

Overrides:

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

Throws:

Error - if anything is missing.

start

public void start()

Does nothing. Called at the start of the initialization phase.

Specified by:

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

checkHardware

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

Attempts to start all configured instruments. Called in the middle of the initialization phase after 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.

checkStarted

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

Checks whether all the instruments are running. Called after checkHardware().

Specified by:

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

Throws:

org.lsst.ccs.HardwareException - if any aren't.

postStart

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

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

Overrides:

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

Throws:

org.lsst.ccs.HardwareException - never.

checkStopped

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

Checks whether future readouts have been canceled. 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:

#stop()