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:

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

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 locked or unlocked. If the 2 status sensors are inconsistent, the latch is in error.

Author:

virieux

See Also:

Serialized Form

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

itemMoving, lock, motionCompleted

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

Methods

Modifier and Type	Method and Description
String	close()
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	isInError()
boolean	isLocked()
boolean	isUnlocked()
String	open()
void	postAction(FcsEnumerations.MobileItemAction action)
void	publishTrendingData(StatusDataPublishedByLatch status) Broadcast the trending data on the status bus.
void	setFilterSensorsDIOName(String filterSensorsDIOName)
void	setLockStatus(FcsEnumerations.LockStatus lockStatus)
void	setTimeoutForClosing(long timeoutForClosing)
void	setTimeoutForOpening(long timeoutForOpening)
void	startAction(FcsEnumerations.MobileItemAction action)
String	toString()
void	updateState(String hexaValue)
void	updateStateWithSensorsToCheckIfActionIsCompleted()

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

executeAction, readSensorsUntilActionIsCompleted, shutdownNow

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

alias, change, checkHardware, dropConfigurationContext, getCheckedValueFromConfiguration, getChildren, getContext, getModule, getName, getNObserverThreads, getObservables, getSubsystem, getTickMillis, init, listens, newConfigurationContext, notifyChange, notifyChangeWithoutPreliminaryChecks, processUpdate, publishData, publishData, publishData, publishData, publishData, publishData, publishData, register, removeLogPanicState, sendToReply, sendToStatus, setBeanName, setContext, setEnvironment, setHandlerLevel, setLogLevel, 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

setFilterSensorsDIOName

public void setFilterSensorsDIOName(String filterSensorsDIOName)

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

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

startAction

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

Specified by:

startAction in class MobileItemModule

Throws:

org.lsst.ccs.bus.BadCommandException

org.lsst.ccs.bus.ErrorInCommandExecutionException

HardwareException

postAction

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

Specified by:

postAction in class MobileItemModule

Throws:

org.lsst.ccs.bus.BadCommandException

org.lsst.ccs.bus.ErrorInCommandExecutionException

HardwareException

getLockStatus

public FcsEnumerations.LockStatus getLockStatus()

setLockStatus

public void setLockStatus(FcsEnumerations.LockStatus lockStatus)

getPresenceStatus

public FcsEnumerations.FilterPresenceInLatchStatus getPresenceStatus()

getStatusData

public StatusDataPublishedByLatch getStatusData()

open

public String open()
            throws org.lsst.ccs.bus.BadCommandException,
                   org.lsst.ccs.bus.ErrorInCommandExecutionException,
                   HardwareException,
                   Exception

Throws:

org.lsst.ccs.bus.BadCommandException

org.lsst.ccs.bus.ErrorInCommandExecutionException

HardwareException

Exception

close

public String close()
             throws org.lsst.ccs.bus.BadCommandException,
                    org.lsst.ccs.bus.ErrorInCommandExecutionException,
                    HardwareException,
                    Exception

Throws:

org.lsst.ccs.bus.BadCommandException

org.lsst.ccs.bus.ErrorInCommandExecutionException

HardwareException

Exception

isLocked

public boolean isLocked()

isUnlocked

public boolean isUnlocked()

isInError

public boolean isInError()

updateState

public void updateState(String hexaValue)

publishTrendingData

public void publishTrendingData(StatusDataPublishedByLatch status)

Broadcast the trending data on the status bus.

Parameters:

status -

toString

public String toString()

Overrides:

toString in class Object