org.lsst.ccs.subsystems.fcs

Class FilterLatchModule

java.lang.Object

java.util.Observable

org.lsst.ccs.framework.Module

org.lsst.ccs.subsystems.fcs.common.MobileItemModule

org.lsst.ccs.subsystems.fcs.FilterLatchModule

All Implemented Interfaces:

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

public class FilterLatchModule
extends MobileItemModule

This is a model for a latch. A latch is what holds a filter in the trucks of the autochanger. There is 2 latches : one on each side of the filter. The state of the latches are monitoring by digital sensors : one sensor to know if a filter is in the latch or not and 2 status sensors to know if the latch is EngageBrakeed or ReleaseBrakeed. If the 2 status sensors are inconsistent, the latch is in error.

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

Modifier and Type	Field and Description
protected NumericSensor	filterPresenceSensor
protected NumericSensor	lockSensor
protected NumericSensor	unlockSensor
protected boolean	updatingState This is used when we update the latch state with the values returned by the sensors.

Fields inherited from class org.lsst.ccs.subsystems.fcs.common.MobileItemModule

currentAction, fcslog, haltRequired, hasToWaitForEndOfAction, lock, motionCompleted, moving

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

environment, log, name, nObserverThreads, registry, tickMillis

Constructor Summary

Constructors

Constructor and Description
FilterLatchModule(String moduleName, int aTickMillis, long timeoutForClosing, long timeoutForOpening, String filterSensorsDIOName, NumericSensor lockSensor, NumericSensor unlockSensor, NumericSensor filterPresenceSensor, LatchActuatorModule latchActuator)

Method Summary

Modifier and Type	Method and Description
String	close() Close the latch : turn on the actuator, read the sensors and wait until the latch is closed.
NumericSensor	getFilterPresenceSensor()
LatchActuatorModule	getLatchActuator()
NumericSensor	getLockSensor()
FcsEnumerations.LockStatus	getLockStatus()
FcsEnumerations.FilterPresenceInLatchStatus	getPresenceStatus()
StatusDataPublishedByLatch	getStatusData()
long	getTimeoutForClosing()
long	getTimeoutForOpening()
NumericSensor	getUnlockSensor()
void	initModule()
boolean	isActionCompleted(FcsEnumerations.MobileItemAction action)
boolean	isHardwareReady()
boolean	isLocked()
String	open() Open the latch if the carousel is holding the filter.
void	postAction(FcsEnumerations.MobileItemAction action)
void	publishData() Publish Data on status bus for trending data base and GUIs.
void	publishLatchData() Deprecated.
void	publishTrendingData(StatusDataPublishedByLatch status) Deprecated.
void	setLockStatus(FcsEnumerations.LockStatus lockStatus)
void	setTimeoutForClosing(long timeoutForClosing)
void	setTimeoutForOpening(long timeoutForOpening)
void	startAction(FcsEnumerations.MobileItemAction action)
void	stopAction(FcsEnumerations.MobileItemAction action, long delay)
String	toString()
void	updateState(String hexaValue)
void	updateStateWithSensors()
void	updateStateWithSensorsToCheckIfActionIsCompleted()

Methods inherited from class org.lsst.ccs.subsystems.fcs.common.MobileItemModule

abort, abort, checkHardware, checkStarted, checkStopped, executeAction, isMoving, readSensorsUntilActionIsCompleted, shutdownNow, signal, stop

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

alias, change, dropConfigurationContext, getCheckedValueFromConfiguration, getChildren, getComponentByName, getComponentDictionariesTree, getComponentTree, getContext, getDictionary, getEnvironment, getMainDictionary, getModule, getName, getNObserverThreads, getObservables, getParent, getSubsystem, getTickMillis, init, injectResources, listens, newConfigurationContext, notifyChange, notifyChangeWithoutPreliminaryChecks, percolateSignal, processUpdate, publish, publish, publish, publish, publish, publish, publishData, publishData, publishData, publishData, publishData, publishData, publishData, register, sendSignal, sendSignal, sendToReply, sendToStatus, setBeanName, setContext, setEnvironment, setName, setNObserverThreads, setObservables, setStateModularSubsystem, setStateModularSubsystem, setTickMillis, shutdownCommand, start, 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

Field Detail

filterPresenceSensor

protected NumericSensor filterPresenceSensor

lockSensor

protected NumericSensor lockSensor

unlockSensor

protected NumericSensor unlockSensor

updatingState

protected volatile boolean updatingState

This is used when we update the latch state with the values returned by the sensors.

Constructor Detail

FilterLatchModule

public FilterLatchModule(String moduleName,
                         int aTickMillis,
                         long timeoutForClosing,
                         long timeoutForOpening,
                         String filterSensorsDIOName,
                         NumericSensor lockSensor,
                         NumericSensor unlockSensor,
                         NumericSensor filterPresenceSensor,
                         LatchActuatorModule latchActuator)

Method Detail

setTimeoutForClosing

@ConfigChanger
public void setTimeoutForClosing(long timeoutForClosing)

setTimeoutForOpening

@ConfigChanger
public void setTimeoutForOpening(long timeoutForOpening)

getTimeoutForClosing

public long getTimeoutForClosing()

getTimeoutForOpening

public long getTimeoutForOpening()

getFilterPresenceSensor

public NumericSensor getFilterPresenceSensor()

getLatchActuator

public LatchActuatorModule getLatchActuator()

getLockSensor

public NumericSensor getLockSensor()

getUnlockSensor

public NumericSensor getUnlockSensor()

initModule

public void initModule()

Overrides:

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

isHardwareReady

@Command(type=QUERY,
         level=1,
         description="Returns true if hardware is connected and ready.")
public boolean isHardwareReady()

Specified by:

isHardwareReady in class MobileItemModule

isActionCompleted

public boolean isActionCompleted(FcsEnumerations.MobileItemAction action)

Specified by:

isActionCompleted in class MobileItemModule

updateStateWithSensorsToCheckIfActionIsCompleted

public void updateStateWithSensorsToCheckIfActionIsCompleted()
                                                      throws Exception

Specified by:

updateStateWithSensorsToCheckIfActionIsCompleted in class MobileItemModule

Throws:

Exception

updateStateWithSensors

@Command(level=1,
         description="Read latch sensors and update latch state",
         type=QUERY)
public void updateStateWithSensors()
                                                                                                                                     throws Exception

Throws:

Exception

startAction

public void startAction(FcsEnumerations.MobileItemAction action)
                 throws org.lsst.ccs.bus.BadCommandException,
                        org.lsst.ccs.bus.ErrorInCommandExecutionException,
                        FcsHardwareException

Specified by:

startAction in class MobileItemModule

Throws:

org.lsst.ccs.bus.BadCommandException

org.lsst.ccs.bus.ErrorInCommandExecutionException

FcsHardwareException

stopAction

public void stopAction(FcsEnumerations.MobileItemAction action,
                       long delay)
                throws org.lsst.ccs.bus.BadCommandException,
                       org.lsst.ccs.bus.ErrorInCommandExecutionException,
                       FcsHardwareException

Specified by:

stopAction in class MobileItemModule

Throws:

org.lsst.ccs.bus.BadCommandException

org.lsst.ccs.bus.ErrorInCommandExecutionException

FcsHardwareException

postAction

public void postAction(FcsEnumerations.MobileItemAction action)
                throws org.lsst.ccs.bus.BadCommandException,
                       org.lsst.ccs.bus.ErrorInCommandExecutionException,
                       FcsHardwareException

Specified by:

postAction in class MobileItemModule

Throws:

org.lsst.ccs.bus.BadCommandException

org.lsst.ccs.bus.ErrorInCommandExecutionException

FcsHardwareException

getLockStatus

public FcsEnumerations.LockStatus getLockStatus()

setLockStatus

public void setLockStatus(FcsEnumerations.LockStatus lockStatus)

getPresenceStatus

public FcsEnumerations.FilterPresenceInLatchStatus getPresenceStatus()

getStatusData

public StatusDataPublishedByLatch getStatusData()

open

@Command(level=3,
         description="Open latch",
         type=ACTION)
public String open()
                                                                                       throws org.lsst.ccs.bus.BadCommandException,
                                                                                              org.lsst.ccs.bus.ErrorInCommandExecutionException,
                                                                                              FcsHardwareException,
                                                                                              Exception

Open the latch if the carousel is holding the filter.

Returns:

Throws:

org.lsst.ccs.bus.BadCommandException

org.lsst.ccs.bus.ErrorInCommandExecutionException

FcsHardwareException

Exception

close

@Command(level=3,
         description="Close latch",
         type=ACTION)
public String close()
                                                                                         throws org.lsst.ccs.bus.BadCommandException,
                                                                                                org.lsst.ccs.bus.ErrorInCommandExecutionException,
                                                                                                FcsHardwareException,
                                                                                                Exception

Close the latch : turn on the actuator, read the sensors and wait until the latch is closed. If the latch is not closed during the delai : timeoutForClosing throws an Exception.

Returns:

Throws:

org.lsst.ccs.bus.BadCommandException

org.lsst.ccs.bus.ErrorInCommandExecutionException

FcsHardwareException

Exception

isLocked

@Command(level=1,
         description="Return true if the latch is closed",
         type=QUERY)
public boolean isLocked()

Returns:

true if the latch is closed.

updateState

public void updateState(String hexaValue)

publishTrendingData

@Deprecated
public void publishTrendingData(StatusDataPublishedByLatch status)

Deprecated.

Broadcast the trending data on the status bus.

Parameters:

status -

publishLatchData

@Deprecated
public void publishLatchData()

Deprecated.

Publish Data on status bus for trending data base and GUIs. If a key is changed here, it has to be changed also in the GUIs (FilterExchangeMainPanel)

publishData

public void publishData()

Publish Data on status bus for trending data base and GUIs.

toString

public String toString()

Overrides:

toString in class Object