org.lsst.ccs.subsystems.fcs.singlefiltertest

Class SftMainModule

java.lang.Object

java.util.Observable

org.lsst.ccs.framework.Module

org.lsst.ccs.subsystems.fcs.MainModule

org.lsst.ccs.subsystems.fcs.singlefiltertest.SftMainModule

All Implemented Interfaces:

Observer, org.lsst.ccs.config.ConfigurationBulkChangeHandler, org.lsst.ccs.framework.Configurable, org.lsst.ccs.framework.HasLifecycle, org.lsst.ccs.framework.SignalHandler, AlertRaiser, org.lsst.ccs.UsesSubsystem

public class SftMainModule
extends MainModule

The Main Module for the single-filter-test. It raises an alert : - FCS006 in start.

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

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

name, nObserverThreads, tickMillis

Constructor Summary

Constructors

Constructor and Description
SftMainModule(BridgeToHardware bridge, Filter dummyFilter) Build a SftMainModule with a bridge and a filter.

Method Summary

Modifier and Type	Method and Description
void	checkPreConditionsForUnlockClamps() Check if the carousel is ready to unlock the clamps in a safe way for the filter.
String	displayData()
String	executeSequence1() This method is the main sequence of commands that we want to test on the Single Filter Test.
String	executeSequence1(int nb) This method will execute nb times the Sequence1 : the parameter nb is given by the user at the console.
Filter	getDummyFilter()
String	goToInitialState() Initial state for sequence1 : autochanger is in highposition and trucks are empty carousel holds a filter and its clamps are in CLAMPEDONFILTER state.
void	initModule() ***********************************************************************************************
void	locateFilter() Read the sensors and update location of the filter and state of Carousel and Autochanger.
void	start()
String	toString()
void	updateStateWithSensors() This command updates the state of the carousel and of the autochanger in reading the sensors.

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

controlRealHardware, getFilterNames, isCANDevicesReady, isHaltRequired, isStopRequired, listHardwareNames, listLoaderHardwareNames, postStart, signal, updateFCSState

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

getNObserverThreads, getObservables, getTickMillis, init, listens, processUpdate, sendSignal, sendSignalWithTimeLimit, 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.subsystems.fcs.common.AlertRaiser

raiseAlarm, raiseAlarm, raiseAlarm, raiseAlarm, raiseWarning, raiseWarning, raiseWarning, raiseWarning

Methods inherited from interface org.lsst.ccs.UsesSubsystem

getComponentConfigurationEnvironment, getComponentLookup, getName, getSubsystem

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

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

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

setParameterBulk

Constructor Detail

SftMainModule

public SftMainModule(BridgeToHardware bridge,
                     Filter dummyFilter)

Build a SftMainModule with a bridge and a filter.

Parameters:

bridge -

dummyFilter -

Method Detail

getDummyFilter

public Filter getDummyFilter()

Returns:

the dummyFilter

initModule

public void initModule()

***********************************************************************************************

Overrides:

initModule in class MainModule

start

public void start()

locateFilter

@Command(type=QUERY,
         level=0,
         description="Read the sensors and update location of the filter and state of Carousel and Autochanger.")
public void locateFilter()

Read the sensors and update location of the filter and state of Carousel and Autochanger.

Throws:

FcsHardwareException

checkPreConditionsForUnlockClamps

@Command(type=QUERY,
         level=1,
         description="Check if the carousel is ready to unlock the clamps in a safe way for the filter.",
         alias="checkUnlock")
public void checkPreConditionsForUnlockClamps()

Check if the carousel is ready to unlock the clamps in a safe way for the filter.

Throws:

FcsHardwareException

displayData

@Command(type=QUERY,
         level=1,
         description="To display at a console the status of the hardware.")
public String displayData()

goToInitialState

@Command(type=ACTION,
         level=1,
         description="Move the hardware to the initial state : ")
public String goToInitialState()

Initial state for sequence1 : autochanger is in highposition and trucks are empty carousel holds a filter and its clamps are in CLAMPEDONFILTER state.

Returns:

Throws:

FcsHardwareException

executeSequence1

@Command(type=ACTION,
         level=0,
         description="The world famous sequence 1",
         alias="es1")
public String executeSequence1()

This method is the main sequence of commands that we want to test on the Single Filter Test. It executes this sequence of commands once. From the initial position (autochanger trucks empty in the higher position) :

• the autochanger trucks go down along the rails to standby position,
• the autochanger grabs the filter at standby position,
• the carousel ungrabs the filter at standby position,
• the autochanger moves the filter to the higher position,
• the carousel releases the clamps to be ready to clamp a filter again,
• the autochanger moves back the filter at standby position,
• the carousel checks if the filter is clamped at standby position,
• the autochanger ReleaseBrakes the filter latches,
• the autochanger trucks go empty to the higher position.

Returns:

a message for the operator

Throws:

FcsHardwareException

CanOpenException

executeSequence1

@Command(type=ACTION,
         level=0,
         description="The world famous sequence 1 (with number of repetitions)",
         alias="es1")
public String executeSequence1(@Argument(name="nExecutions",description="Number of executions")
                                                                                                                                                                              int nb)

This method will execute nb times the Sequence1 : the parameter nb is given by the user at the console.

Parameters:

nb - : number of times we want to execute the Sequence1

Returns:

Throws:

FcsHardwareException

CanOpenException

toString

public String toString()

Overrides:

toString in class Object

updateStateWithSensors

@Command(type=QUERY,
         level=1,
         description="Read the sensors and update the state of the carousel and the autochanger.")
public void updateStateWithSensors()

This command updates the state of the carousel and of the autochanger in reading the sensors. It has to be used in Engineering mode at the console when we send commands step by step.

Overrides:

updateStateWithSensors in class MainModule

Throws:

FcsHardwareException