org.lsst.ccs.subsystems.fcs

Class FcsMainModule

java.lang.Object

java.util.Observable

org.lsst.ccs.framework.Module

org.lsst.ccs.subsystems.fcs.MainModule

org.lsst.ccs.subsystems.fcs.FcsMainModule

All Implemented Interfaces:

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

public class FcsMainModule
extends MainModule

The main module in FCS. Commands can be sent to the FcsMainModule from the CCS Master Control Module (MCM) in normal operation mode or from a Console (org.lsst.ccs.subsystem.console.TestConsole).

Example of commands that can be sent to the FcsMainModule :
Console> invoke fcs-test MoveFilterToOnline filtername

The main goals of the FcsMainModule is :

• Receive commands from MCM for the whole subsystem.
• Execute commands received from MCM in invoking methods on the Carousel Module on the Autochanger Module and on Loader Module.
• Handle the logic of the whole subsystem.
• Publish on the status bus the status of the whole subsystem.

Author:

virieux

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.subsystems.fcs.MainModule

bridge, haltRequired, hardwareReady, stopRequired

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

environment, log, name, nObserverThreads, tickMillis

Constructor Summary

Constructors

Constructor and Description
FcsMainModule(String aName, int aTickMillis, BridgeToHardware bridge)

Method Summary

Modifier and Type	Method and Description
protected void	controlFilterName(Object o) This method controls if the filter name given at the console by an operator is correct.
String	displayData() This method can be invoked from the Console to display at the Console status data of the whole subsystem.
Filter	getFilterAtStandby()
Filter	getFilterByName(String filterName)
Map<String,Filter>	getFilters()
Double	getStandbyPosition()
void	initModule() In the initialisation, we want to do some software initialization, and some hardware initialization.
boolean	isEmptyOnline()
boolean	isEmptyStandBy()
void	loadFilter(Filter aFilter) Load a filter from the loader to the camera.
String	moveFilterToOnline(Object filterName) Move a filter to online position.
String	moveFilterToStandby(Object filterName) Move a filter to standby position.
void	processUpdate(Observable source, org.lsst.ccs.framework.Module.ValueUpdate v) What to do when the Modules we observe (carousel and autochanger) update their data to publish : we publish on status bus.
void	setFilters(Map<String,Filter> filters)
void	setStandbyPosition(Double standbyPosition)
String	toString()
void	unloadFilter(Filter aFilter) Unload a filter from the camera to the loader.
void	updateStateWithSensors()

Methods inherited from class org.lsst.ccs.subsystems.fcs.MainModule

controlRealHardware, getFilterNames, getHaltRequired, getStopRequired, getTcpProxy, isHardwareReady, listHardware, listHardwareNames, postStart, signal, simulateAlert, simulateWarning

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

getComponentTree, getEnvironment, getModule, getName, getNObserverThreads, getObservables, getSubsystem, getTickMillis, init, listens, 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, wait, wait, wait

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

change, getCheckedValueFromConfiguration, getChildren, getComponentByName, getFullPath, getParent, getParentObject, injectResources, listChildren, notifyChange, notifyChangeWithoutPreliminaryChecks, setBulkParameter, start, submitChange, submitChanges, validateBulkChange

Constructor Detail

FcsMainModule

public FcsMainModule(String aName,
                     int aTickMillis,
                     BridgeToHardware bridge)

Method Detail

initModule

public void initModule()

In the initialisation, we want to do some software initialization, and some hardware initialization. We publish the initial data for each piece of hardware : carousel and autochanger.

Overrides:

initModule in class MainModule

processUpdate

public void processUpdate(Observable source,
                          org.lsst.ccs.framework.Module.ValueUpdate v)

What to do when the Modules we observe (carousel and autochanger) update their data to publish : we publish on status bus.

Overrides:

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

Parameters:

source -

v -

displayData

public String displayData()

This method can be invoked from the Console to display at the Console status data of the whole subsystem.

Returns:

toString

public String toString()

Overrides:

toString in class MainModule

moveFilterToOnline

public String moveFilterToOnline(Object filterName)
                          throws InterruptedException,
                                 IllegalArgumentException,
                                 org.lsst.ccs.messaging.BadCommandException,
                                 org.lsst.ccs.messaging.ErrorInCommandExecutionException,
                                 FcsHardwareException,
                                 CanOpenException

Move a filter to online position. The filter must be in the camera. It can be on the carousel or on the autochanger. This method can be called by the end-user at the console.

Parameters:

filterName - name of the filter to move

Returns:

message for the user

Throws:

InterruptedException, - IllegalArgumentException

org.lsst.ccs.messaging.BadCommandException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

InterruptedException

IllegalArgumentException

FcsHardwareException

CanOpenException

moveFilterToStandby

public String moveFilterToStandby(Object filterName)
                           throws InterruptedException,
                                  IllegalArgumentException,
                                  org.lsst.ccs.messaging.BadCommandException,
                                  org.lsst.ccs.messaging.ErrorInCommandExecutionException

Move a filter to standby position. The filter must be in the camera. The filter can be on carousel or on autochanger. This method can be called by the end-user at the console.

Parameters:

filterName - name of the filter to move

Returns:

message for the user

Throws:

InterruptedException, - IllegalArgumentException

org.lsst.ccs.messaging.BadCommandException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

InterruptedException

IllegalArgumentException

getFilterAtStandby

public Filter getFilterAtStandby()

controlFilterName

protected void controlFilterName(Object o)
                          throws IllegalArgumentException

This method controls if the filter name given at the console by an operator is correct.

Parameters:

o - the object we receive from the command line at the Console.

Throws:

IllegalArgumentException - in this case :

• the name is not a String,
• the name is unknown in the map filters,
• the name is known in the map filters, but the filter location is unknown,
• the name is known in the map filters, but the filter is out of the camera.

getFilterByName

public Filter getFilterByName(String filterName)

isEmptyStandBy

public boolean isEmptyStandBy()

Returns:

true if the socket at standby position on the carousel is empty (contains no filter)

isEmptyOnline

public boolean isEmptyOnline()

Returns:

true if there is no filter at online position. This can be because :

• the autochanger truck is not at online position.
• or the autochanger truck is at online position but it's empty.

getFilters

public Map<String,Filter> getFilters()

setFilters

public void setFilters(Map<String,Filter> filters)

getStandbyPosition

public Double getStandbyPosition()

setStandbyPosition

public void setStandbyPosition(Double standbyPosition)

loadFilter

public void loadFilter(Filter aFilter)
                throws org.lsst.ccs.messaging.BadCommandException,
                       org.lsst.ccs.messaging.ErrorInCommandExecutionException,
                       FcsHardwareException

Load a filter from the loader to the camera. At the end of this operation the filter is grabbed on the autochanger at Handoff position.

Parameters:

aFilter -

Throws:

org.lsst.ccs.messaging.BadCommandException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

FcsHardwareException

unloadFilter

public void unloadFilter(Filter aFilter)
                  throws org.lsst.ccs.messaging.BadCommandException,
                         org.lsst.ccs.messaging.ErrorInCommandExecutionException,
                         FcsHardwareException

Unload a filter from the camera to the loader. The camera has to be at horizontal position. The filter has to be on Carousel at STANDBY. The trucks of the autochanger have to be empty at STANDOFF position.

Parameters:

aFilter -

Throws:

org.lsst.ccs.messaging.BadCommandException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

FcsHardwareException

updateStateWithSensors

public void updateStateWithSensors()
                            throws FcsHardwareException,
                                   org.lsst.ccs.messaging.ErrorInCommandExecutionException,
                                   org.lsst.ccs.messaging.BadCommandException

Overrides:

updateStateWithSensors in class MainModule

Throws:

FcsHardwareException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

org.lsst.ccs.messaging.BadCommandException