org.lsst.ccs.subsystems.fcs

Class LoaderModule

java.lang.Object

java.util.Observable

org.lsst.ccs.framework.Module

org.lsst.ccs.subsystems.fcs.LoaderModule

All Implemented Interfaces:

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

public class LoaderModule
extends org.lsst.ccs.framework.Module
implements org.lsst.ccs.framework.HardwareController

This is the model for the loader in the Filter Exchange System. The loader is used to load a filter into the camera or to unload a filter from the camera.

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.framework.Module

environment, log, name, nObserverThreads, tickMillis

Constructor Summary

Constructors

Constructor and Description
LoaderModule(String moduleName, int aTickMillis, LoaderCarrierModule carrier, LoaderClampModule clamp, String plutoGatewayName, NumericSensor filterPresenceSensor0, NumericSensor filterPresenceSensor1, NumericSensor loaderOnCameraSensor0, NumericSensor loaderOnCameraSensor1)

Method Summary

Modifier and Type	Method and Description
org.lsst.ccs.framework.TreeWalkerDiag	checkHardware()
boolean	checkPreConditionsForCarrierMotion()
boolean	checkPreConditionsForClosingHooks()
boolean	checkPreConditionsForOpeningHooks()
void	checkStarted() CheckStarted is executed by completeInitialization when a first start has failed.
void	checkStopped() This method is executed during a shutdown of the subystem to prevent a shutdown when some hardware is moving.
String	clampHooks() This method closes the clamps strongly.
String	closeHooks() This method closes the clamps.
StatusDataPublishedByLoader	createStatusDataPublishedByLoader() Creates an Object to be published on the STATUS bus.
NumericSensor	getAutochangerHoldingFilterSensor()
LoaderCarrierModule	getCarrier()
EPOSController	getCarrierController()
LoaderClampModule	getClamp()
NumericSensor	getFilterPresenceSensor0()
NumericSensor	getFilterPresenceSensor1()
EPOSController	getHooksController()
NumericSensor	getLoaderOnCameraSensor0()
NumericSensor	getLoaderOnCameraSensor1()
StatusDataPublishedByLoader	getStatusData()
String	goToHandoff() Moves the loader carrier to the handoff position.
String	goToStorage() Moves the loader carrier to the storage position.
void	initializeHardware()
void	initModule()
boolean	isAutochangerHoldingFilter()
boolean	isAutochangerHoldingFilterToPublish() To publish data we don't want to read again the sensors.
boolean	isCarrierAtStoragePosition()
boolean	isConnectedOnCamera() Returns the boolean field atHandoff.
boolean	isEmpty() Returns the boolean field empty.
boolean	isEmptyToPublish() To publish data we don't want to read again the sensors.
boolean	isFilterPresenceSensorsInError()
boolean	isHardwareReady()
boolean	isHoldingAFilter()
boolean	isInitialized()
boolean	isLoaderOnCameraSensorsInError()
boolean	isMoving()
boolean	isOnCameraToPublish() To publish data we don't want to read again the sensors.
String	listHooks()
String	listSensorsValues()
String	loadFilterInCamera() This command can be launched when a filter is in the loader and we want to put in inside the camera.
String	openHooks() This method opens the clamp.
void	publishData() Publish Data on status bus for trending data base and GUIs.
void	tick()
String	unloadFilterFromCamera() This command can be launched when the loader is empty and we want to take a filter from the camera.
void	updateStateWithSensors() This methods updates the carrier and clamp state in reading all the sensors.

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

getComponentTree, getEnvironment, getModule, getName, getNObserverThreads, getObservables, getSubsystem, getTickMillis, init, listens, postStart, processUpdate, sendSignal, sendSignalWithTimeLimit, setEnvironment, setName, setNObserverThreads, setObservables, setTickMillis, shutdownNow, signal, startTicking, 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.framework.Configurable

change, getCheckedValueFromConfiguration, getChildren, getComponentByName, getFullPath, getParent, getParentObject, injectResources, listChildren, notifyChange, notifyChangeWithoutPreliminaryChecks, setBulkParameter, start, submitChange, submitChanges, validateBulkChange

Constructor Detail

LoaderModule

public LoaderModule(String moduleName,
                    int aTickMillis,
                    LoaderCarrierModule carrier,
                    LoaderClampModule clamp,
                    String plutoGatewayName,
                    NumericSensor filterPresenceSensor0,
                    NumericSensor filterPresenceSensor1,
                    NumericSensor loaderOnCameraSensor0,
                    NumericSensor loaderOnCameraSensor1)

Method Detail

getFilterPresenceSensor0

public NumericSensor getFilterPresenceSensor0()

getFilterPresenceSensor1

public NumericSensor getFilterPresenceSensor1()

getLoaderOnCameraSensor0

public NumericSensor getLoaderOnCameraSensor0()

getLoaderOnCameraSensor1

public NumericSensor getLoaderOnCameraSensor1()

getAutochangerHoldingFilterSensor

public NumericSensor getAutochangerHoldingFilterSensor()

isFilterPresenceSensorsInError

public boolean isFilterPresenceSensorsInError()

isLoaderOnCameraSensorsInError

public boolean isLoaderOnCameraSensorsInError()

isEmptyToPublish

public boolean isEmptyToPublish()

To publish data we don't want to read again the sensors.

Returns:

isOnCameraToPublish

public boolean isOnCameraToPublish()

To publish data we don't want to read again the sensors.

Returns:

isAutochangerHoldingFilterToPublish

public boolean isAutochangerHoldingFilterToPublish()

To publish data we don't want to read again the sensors.

Returns:

getHooksController

public EPOSController getHooksController()

getCarrierController

public EPOSController getCarrierController()

initModule

public void initModule()

Overrides:

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

isHardwareReady

public boolean isHardwareReady()

isInitialized

public boolean isInitialized()

isEmpty

@Command(type=QUERY,
         level=0,
         description="Return true if there is no filter in the loader. This command doesn\'t read again the sensors.")
public boolean isEmpty()

Returns the boolean field empty. If the empty boolean is being updated and waits for a response from a sensor, this methods waits until empty is updated. If the field empty is not being updated, it returns immediatly the field empty.

Returns:

empty

isConnectedOnCamera

@Command(type=QUERY,
         level=0,
         description="Return true if the loader is connected on the camera. This command doesn\'t read again the sensors.")
public boolean isConnectedOnCamera()

Returns the boolean field atHandoff. If the atHandoff boolean is being updated and waits for a response from a sensor, this methods waits until atHandoff is updated. If the field atHandoff is not being updated, it returns immediatly the field atHandoff.

Returns:

atHandoff

isAutochangerHoldingFilter

@Command(type=QUERY,
         level=0,
         description="Return true if the autochanger is holding the filter. This command doesn\'t read again the sensors.")
public boolean isAutochangerHoldingFilter()

isHoldingAFilter

@Command(type=QUERY,
         level=0,
         description="Return true if a filter is present and it is held by the loader clamp.")
public boolean isHoldingAFilter()
                                                                                                                                                               throws SDORequestException,
                                                                                                                                                                      org.lsst.ccs.messaging.BadCommandException,
                                                                                                                                                                      FcsHardwareException

Throws:

SDORequestException

org.lsst.ccs.messaging.BadCommandException

FcsHardwareException

isMoving

@Command(type=QUERY,
         level=0,
         description="Return true if the clamp or the carrier are in action.")
public boolean isMoving()

getClamp

public LoaderClampModule getClamp()

getCarrier

public LoaderCarrierModule getCarrier()

isCarrierAtStoragePosition

public boolean isCarrierAtStoragePosition()

initializeHardware

@Command(type=ACTION,
         level=1,
         description="Initialize loader hardware.")
public void initializeHardware()
                                                                                                                    throws org.lsst.ccs.HardwareException

Throws:

org.lsst.ccs.HardwareException

checkHardware

public org.lsst.ccs.framework.TreeWalkerDiag checkHardware()
                                                    throws org.lsst.ccs.HardwareException

Specified by:

checkHardware in interface org.lsst.ccs.framework.HardwareController

Throws:

org.lsst.ccs.HardwareException

checkStarted

public void checkStarted()
                  throws org.lsst.ccs.HardwareException

CheckStarted is executed by completeInitialization when a first start has failed. Because end user could have changed many things, we have to check again that all is correct.

Specified by:

checkStarted in interface org.lsst.ccs.framework.HardwareController

Throws:

org.lsst.ccs.HardwareException

checkStopped

public void checkStopped()
                  throws org.lsst.ccs.HardwareException

This method is executed during a shutdown of the subystem to prevent a shutdown when some hardware is moving. Nothing to do here because all the moving hardware of the loader is represented by the class MobilItemModule where the method checkStopped is implemented.

Specified by:

checkStopped in interface org.lsst.ccs.framework.HardwareController

Throws:

org.lsst.ccs.HardwareException

tick

public void tick()

Overrides:

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

checkPreConditionsForCarrierMotion

@Command(type=QUERY,
         level=1,
         description="Check if the carrier can move.")
public boolean checkPreConditionsForCarrierMotion()
                                                                                                                                         throws SDORequestException,
                                                                                                                                                org.lsst.ccs.messaging.BadCommandException,
                                                                                                                                                FcsHardwareException,
                                                                                                                                                org.lsst.ccs.messaging.ErrorInCommandExecutionException

Throws:

SDORequestException

org.lsst.ccs.messaging.BadCommandException

FcsHardwareException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

checkPreConditionsForOpeningHooks

@Command(type=QUERY,
         level=1,
         description="Check if the clamp can be open.")
public boolean checkPreConditionsForOpeningHooks()
                                                                                                                                         throws SDORequestException,
                                                                                                                                                org.lsst.ccs.messaging.BadCommandException,
                                                                                                                                                FcsHardwareException,
                                                                                                                                                org.lsst.ccs.messaging.ErrorInCommandExecutionException

Throws:

SDORequestException

org.lsst.ccs.messaging.BadCommandException

FcsHardwareException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

checkPreConditionsForClosingHooks

@Command(type=QUERY,
         level=1,
         description="Check if the clamp can be closed.")
public boolean checkPreConditionsForClosingHooks()
                                                                                                                                           throws SDORequestException,
                                                                                                                                                  org.lsst.ccs.messaging.BadCommandException,
                                                                                                                                                  FcsHardwareException,
                                                                                                                                                  org.lsst.ccs.messaging.ErrorInCommandExecutionException

Throws:

SDORequestException

org.lsst.ccs.messaging.BadCommandException

FcsHardwareException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

closeHooks

@Command(type=ACTION,
         level=1,
         description="Close hooks.")
public String closeHooks()
                                                                                               throws org.lsst.ccs.messaging.BadCommandException,
                                                                                                      org.lsst.ccs.messaging.ErrorInCommandExecutionException,
                                                                                                      FcsHardwareException

This method closes the clamps. When this action is completed the filter is clamped softly on the loader and can't fall.

Returns:

a message for the end user.

Throws:

org.lsst.ccs.messaging.BadCommandException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

FcsHardwareException

clampHooks

@Command(type=ACTION,
         level=1,
         description="Clamp hooks.")
public String clampHooks()
                                                                                               throws org.lsst.ccs.messaging.BadCommandException,
                                                                                                      org.lsst.ccs.messaging.ErrorInCommandExecutionException,
                                                                                                      FcsHardwareException

This method closes the clamps strongly. When this action is completed, the filter is clamped softly on the loader and is tight fermely on the carrier.

Returns:

a message for the end user.

Throws:

org.lsst.ccs.messaging.BadCommandException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

FcsHardwareException

openHooks

@Command(level=1,
         type=ACTION,
         description="Open the hooks")
public String openHooks()
                                                                                                throws org.lsst.ccs.messaging.BadCommandException,
                                                                                                       org.lsst.ccs.messaging.ErrorInCommandExecutionException,
                                                                                                       FcsHardwareException

This method opens the clamp.

Returns:

a message for the end user.

Throws:

org.lsst.ccs.messaging.BadCommandException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

FcsHardwareException

goToHandoff

@Command(type=ACTION,
         level=1,
         description="Move the loader carrier to HANDOFF position")
public String goToHandoff()
                                                                                                                               throws org.lsst.ccs.messaging.BadCommandException,
                                                                                                                                      FcsHardwareException,
                                                                                                                                      SDORequestException,
                                                                                                                                      org.lsst.ccs.messaging.ErrorInCommandExecutionException

Moves the loader carrier to the handoff position.

Returns:

Throws:

org.lsst.ccs.messaging.BadCommandException

FcsHardwareException

SDORequestException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

goToStorage

@Command(type=ACTION,
         level=1,
         description="Move the loader carrier to STORAGE position")
public String goToStorage()
                                                                                                                               throws org.lsst.ccs.messaging.BadCommandException,
                                                                                                                                      FcsHardwareException,
                                                                                                                                      SDORequestException,
                                                                                                                                      org.lsst.ccs.messaging.ErrorInCommandExecutionException

Moves the loader carrier to the storage position.

Returns:

Throws:

org.lsst.ccs.messaging.BadCommandException

FcsHardwareException

SDORequestException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

updateStateWithSensors

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

This methods updates the carrier and clamp state in reading all the sensors.

Throws:

FcsHardwareException

loadFilterInCamera

@Command(type=ACTION,
         level=1,
         description="Load a filter from the loader into the camera.")
public String loadFilterInCamera()
                                                                                                                                         throws org.lsst.ccs.messaging.BadCommandException,
                                                                                                                                                FcsHardwareException,
                                                                                                                                                org.lsst.ccs.messaging.ErrorInCommandExecutionException,
                                                                                                                                                InterruptedException

This command can be launched when a filter is in the loader and we want to put in inside the camera.

Returns:

Throws:

org.lsst.ccs.messaging.BadCommandException

FcsHardwareException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

InterruptedException

unloadFilterFromCamera

@Command(type=ACTION,
         level=1,
         description="Unload a filter from the camera into the loader.")
public String unloadFilterFromCamera()
                                                                                                                                               throws org.lsst.ccs.messaging.BadCommandException,
                                                                                                                                                      FcsHardwareException,
                                                                                                                                                      InterruptedException,
                                                                                                                                                      SDORequestException,
                                                                                                                                                      org.lsst.ccs.messaging.ErrorInCommandExecutionException

This command can be launched when the loader is empty and we want to take a filter from the camera. A filter must be at handoff position and held by autochanger.

Returns:

Throws:

org.lsst.ccs.messaging.BadCommandException

FcsHardwareException

InterruptedException

SDORequestException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

listHooks

@Command(type=QUERY,
         level=0,
         description="List and display info on the hooks.")
public String listHooks()

listSensorsValues

@Command(type=QUERY,
         level=1,
         description="List and display hooks sensors values.")
public String listSensorsValues()

getStatusData

public StatusDataPublishedByLoader getStatusData()

createStatusDataPublishedByLoader

public StatusDataPublishedByLoader createStatusDataPublishedByLoader()

Creates an Object to be published on the STATUS bus.

Returns:

publishData

public void publishData()

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