org.lsst.ccs.subsystems.fcs

Class AutochangerTwoLatches

java.lang.Object

java.util.Observable

org.lsst.ccs.framework.Module

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

org.lsst.ccs.subsystems.fcs.AutochangerTwoLatches

All Implemented Interfaces:

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

public class AutochangerTwoLatches
extends MobileItemModule

This class represents a model for the 2 Latches of the autochanger. The Latches hold a filter on the trucks. There is one latch on each side of the filter. Because the ACTION open (or close) for 2 latches is different from opening (or closing) one Latch, then the other one, it's more convenient to have a class to represent 2 Latches at a time.

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

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

currentAction, FCSLOG, haltRequired, hasToWaitForEndOfAction, lock, motionCompleted, moving, stopRequired

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

name, nObserverThreads, tickMillis

Constructor Summary

Constructors

Constructor and Description
AutochangerTwoLatches(AutochangerLatchModule latchXminus, AutochangerLatchModule latchXplus) Build an Object AutochangerTwoLatches from 2 AutochangerLatchModule.

Method Summary

Modifier and Type	Method and Description
void	abortAction(FcsEnumerations.MobileItemAction action, long delay)
String	close() Close latches
StatusDataPublishedByAutochangerTwoLatches	createStatusDataPublishedByTwoLatches()
AutochangerLatchModule	getLatchXminus()
AutochangerLatchModule	getLatchXplus()
StatusDataPublishedByAutochangerTwoLatches	getStatusData()
long	getTimeoutForClosing() Return the max time for closing in millisecond.
long	getTimeoutForOpening() Return the max time for opening.
void	initModule()
boolean	isActionCompleted(FcsEnumerations.MobileItemAction action)
boolean	isCANDevicesReady()
boolean	isEmpty() Returns true if there is no filter is latches.
boolean	isHoldingFilter() Return true if autochanger is holding a filter.
boolean	isInError() Returns true if one of the latches is in ERROR state.
boolean	isInitialized() Returns true if the 2 latches controllers are initialized.
boolean	isLocked() Return if both latches are LOCKED.
boolean	isUnlocked() Return if both latches are UNLOCKED.
String	open() Open the 2 latches.
void	postAction(FcsEnumerations.MobileItemAction action)
void	publishData()
void	quickStopAction(FcsEnumerations.MobileItemAction action, long delay)
void	startAction(FcsEnumerations.MobileItemAction action)
void	updateStateWithSensors() This methods updates the whole autochanger state in reading all the sensors.
void	updateStateWithSensorsToCheckIfActionIsCompleted()

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

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

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

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

raiseAlarm, raiseAlarm, raiseAlarm, 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, postStart, printConfigurableParameters, setBulkParameter, start, submitChange, submitChanges, validateBulkChange

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

setParameterBulk

Field Detail

updatingState

protected volatile boolean updatingState

Constructor Detail

AutochangerTwoLatches

public AutochangerTwoLatches(AutochangerLatchModule latchXminus,
                             AutochangerLatchModule latchXplus)

Build an Object AutochangerTwoLatches from 2 AutochangerLatchModule.

Parameters:

latchXminus -

latchXplus -

Method Detail

isInitialized

@Command(type=QUERY,
         level=1,
         description="Returns true if the 2 latches are initialized.")
public boolean isInitialized()

Returns true if the 2 latches controllers are initialized.

Returns:

getLatchXminus

public AutochangerLatchModule getLatchXminus()

getLatchXplus

public AutochangerLatchModule getLatchXplus()

getTimeoutForClosing

@Command(type=QUERY,
         level=1,
         description="Return the max time for closing in millisecond.")
public long getTimeoutForClosing()

Return the max time for closing in millisecond.

Returns:

getTimeoutForOpening

@Command(type=QUERY,
         level=1,
         description="Return the max time for opening in millisecond.")
public long getTimeoutForOpening()

Return the max time for opening.

Returns:

isLocked

@Command(type=QUERY,
         level=1,
         description="Returns true if both latches are LOCKED.")
public boolean isLocked()

Return if both latches are LOCKED.

Returns:

isUnlocked

@Command(type=QUERY,
         level=1,
         description="Returns true if both latches are UNLOCKED.")
public boolean isUnlocked()

Return if both latches are UNLOCKED.

Returns:

isInError

@Command(type=QUERY,
         level=1,
         description="Returns true if one of the latches is in ERROR state.")
public boolean isInError()

Returns true if one of the latches is in ERROR state. Doesn't read again sensors.

Returns:

isEmpty

@Command(type=QUERY,
         level=1,
         description="Returns true if there is no filter is latches.")
public boolean isEmpty()

Returns true if there is no filter is latches. Doesn't read again sensors.

Returns:

isHoldingFilter

@Command(type=QUERY,
         level=1,
         description="Return true if autochanger is holding a filter.")
public boolean isHoldingFilter()

Return true if autochanger is holding a filter. A filter is ENGAGED and latches are LOCKED. Does not read again sensors values.

Returns:

initModule

public void initModule()

Overrides:

initModule in class MobileItemModule

isCANDevicesReady

public boolean isCANDevicesReady()

Specified by:

isCANDevicesReady in class MobileItemModule

updateStateWithSensors

@Command(type=ACTION,
         level=1,
         description="Update autochanger state in reading sensors.")
public void updateStateWithSensors()

This methods updates the whole autochanger state in reading all the sensors.

Throws:

FcsHardwareException

updateStateWithSensorsToCheckIfActionIsCompleted

public void updateStateWithSensorsToCheckIfActionIsCompleted()

Specified by:

updateStateWithSensorsToCheckIfActionIsCompleted in class MobileItemModule

close

@Command(type=ACTION,
         level=1,
         description="Close latches.")
public String close()

Close latches

Returns:

Throws:

FcsHardwareException

open

@Command(type=ACTION,
         level=1,
         description="Open both latches.")
public String open()

Open the 2 latches.

Returns:

Throws:

FcsHardwareException

startAction

public void startAction(FcsEnumerations.MobileItemAction action)

Specified by:

startAction in class MobileItemModule

abortAction

public void abortAction(FcsEnumerations.MobileItemAction action,
                        long delay)

Specified by:

abortAction in class MobileItemModule

quickStopAction

public void quickStopAction(FcsEnumerations.MobileItemAction action,
                            long delay)

Specified by:

quickStopAction in class MobileItemModule

postAction

public void postAction(FcsEnumerations.MobileItemAction action)

Specified by:

postAction in class MobileItemModule

isActionCompleted

public boolean isActionCompleted(FcsEnumerations.MobileItemAction action)

Specified by:

isActionCompleted in class MobileItemModule

getStatusData

public StatusDataPublishedByAutochangerTwoLatches getStatusData()

createStatusDataPublishedByTwoLatches

public StatusDataPublishedByAutochangerTwoLatches createStatusDataPublishedByTwoLatches()

publishData

public void publishData()

Specified by:

publishData in class MobileItemModule