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, hasToWaitForEndOfAction, lock, scheduler

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) aborts action actually running.
void	close() Close latches
StatusDataPublishedByAutochangerTwoLatches	createStatusDataPublishedByTwoLatches() Creates an object to be published on the STATUS bus by AutochangerTwoLatches.
FcsEnumerations.FilterPresenceStatus	getFilterPresenceStatus() return filterPresenceStatus
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.
void	open() Open the 2 latches.
void	postAction(FcsEnumerations.MobileItemAction action)
void	publishData()
void	quickStopAction(FcsEnumerations.MobileItemAction action, long delay)
void	startAction(FcsEnumerations.MobileItemAction action) starts the action given as argument.
void	updateStateAndCheckSensors() Checks sensors.
void	updateStateWithSensors(String[] readHexaValues) Update latches lockStatus from an array of hexa values read from the sensors.
void	updateStateWithSensorsToCheckIfActionIsCompleted() reads sensors or any device and updates state from sensors it can be also reading a position or a current on a motor controller.

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

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

postInit, postShutdown, postStart, start

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

sendSignal, sendSignalWithTimeLimit

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:

getFilterPresenceStatus

@Command(type=QUERY,
         description="return filterPresenceStatus")
public FcsEnumerations.FilterPresenceStatus getFilterPresenceStatus()

return filterPresenceStatus

Returns:

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

updateStateAndCheckSensors

public void updateStateAndCheckSensors()

Checks sensors.

Throws:

FcsHardwareException - if some latch sensors are in error or if latches state is not equal on both side of the filter.

FcsHardwareException

updateStateWithSensors

public void updateStateWithSensors(String[] readHexaValues)

Update latches lockStatus from an array of hexa values read from the sensors.

Parameters:

readHexaValues -

updateStateWithSensorsToCheckIfActionIsCompleted

public void updateStateWithSensorsToCheckIfActionIsCompleted()

Description copied from class: MobileItemModule

reads sensors or any device and updates state from sensors it can be also reading a position or a current on a motor controller. It's abstract because it'up to the sub-classes to know what to do.

Specified by:

updateStateWithSensorsToCheckIfActionIsCompleted in class MobileItemModule

close

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

Close latches

Throws:

FcsHardwareException

open

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

Open the 2 latches.

Throws:

FcsHardwareException

startAction

public void startAction(FcsEnumerations.MobileItemAction action)

Description copied from class: MobileItemModule

starts the action given as argument. It has to be specified in sub-classes. Usually it consist in sending a command to a controller : give a value of current or give a target position.

Specified by:

startAction in class MobileItemModule

abortAction

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

Description copied from class: MobileItemModule

aborts action actually running. It has to be specified in sub-classes. It can be : write a zero value of current or send a stop command to a controller.

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

createStatusDataPublishedByTwoLatches

public StatusDataPublishedByAutochangerTwoLatches createStatusDataPublishedByTwoLatches()

Creates an object to be published on the STATUS bus by AutochangerTwoLatches.

Returns:

publishData

public void publishData()

Specified by:

publishData in class MobileItemModule