org.lsst.ccs.subsystems.fcs

Class AutochangerOnlineClampModule

java.lang.Object

java.util.Observable

org.lsst.ccs.framework.Module

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

org.lsst.ccs.subsystems.fcs.AutochangerOnlineClampModule

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, MovedByEPOSController, org.lsst.ccs.UsesSubsystem

public class AutochangerOnlineClampModule
extends MobileItemModule
implements MovedByEPOSController

This is a model for online clamp which holds a filter when it is at ONLINE position. The online clamps are part of the autochanger subsystem. There is 3 online clamps.

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 Condition	currentRampEnded
protected boolean	hasToWaitForEndOfCurrentRamp
protected boolean	updatingState

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

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

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

name, nObserverThreads, tickMillis

Constructor Summary

Constructors

Constructor and Description
AutochangerOnlineClampModule(EPOSController controller, NumericSensor closeSensor, NumericSensor closeSensorC, NumericSensor openSensor, NumericSensor openSensorC, int currentToClose) Build an AutochangerOnlineClampModule with a controller, 4 sensors and 2 maps of parameters for the controller.

Method Summary

Modifier and Type	Method and Description
void	abortAction(FcsEnumerations.MobileItemAction action, long delay) What to do to abort an action.
void	checkConditionsForClosing() Check if it's safe to close the clamp.
void	checkConditionsForOpening() Check if it's safe to open the clamp.
void	checkControllerBeforeAction() Read parameters for mode CURRENT on controller CPU.
org.lsst.ccs.framework.TreeWalkerDiag	checkHardware() This method is called during INITIALIZATION phase.
void	close() Close the ONLINE clamp.
void	configureController() Configure ONLINE clamp controller.
void	configureDigitalInputOfOnlineClamps() This method is used to configure the controllers of the autochanger online clamps.
void	configureDigitalOutputOfOnlineClamps() This methods is used to configure the autochanger onlineClamps EPOS controllers.
StatusDataPublishedByAutochangerOnlineClamp	createStatusDataPublishedByOnlineClamp() Creates and returns the object to be published on the STATUS bus.
void	executeCurrentRamp(int initialValue, int finalValue, int nbStep, long period) Writes newCurrentValue to controller with a newCurrentValue ramp : from initialValue to finalValue in nbStep.
EPOSController	getController() Return ONLINE clamp controller
String	getControllerName() return controller name
int	getCurrentToClamp() For simulator
int	getCurrentToClose() For simulator
int	getCurrentToOpen() For simulator
long	getTravelTime() For simulator
void	initModule() Initialize fields autochanger, lockStatus and listens to its controller.
boolean	isActionCompleted(FcsEnumerations.MobileItemAction action)
boolean	isCANDevicesReady() Return true when ONLINE clamp hardware is ready.
boolean	isClosed() Returns true if LockStatus=CLOSED.
boolean	isCloseSensorsInError() Returns true if closeSensor and closeSensorC return the same value.
boolean	isControllerInFault() Returns true if controller is in fault.
boolean	isInError() Returns true if LockStatus=ERROR, this means closeSensor or openSensor is in ERROR or openSensor and closeSensor return non consistant values.
boolean	isInitialized() Returns true if clamp is initialized : hardware is ready (at least booted) and clamp controller is initialized (parameters in the controller CPU have been checked and controller has been configured.
boolean	isInTravel() Returns true if LockStatus=INTRAVEL.
boolean	isOpened() Returns true if LockStatus=OPENED.
boolean	isOpenSensorsInError() Returns true if openSensor and openSensorC retun the same value.
void	open() Open the ONLINE clamp.
void	postAction(FcsEnumerations.MobileItemAction action) What to be done after the action is completed.
void	processUpdate(Observable source, org.lsst.ccs.framework.Module.ValueUpdate v) What to do when the Modules we observe send there new values.
void	publishData()
void	quickStopAction(FcsEnumerations.MobileItemAction action, long delay)
void	sendCurrentToController(int cur) enables controller and sends current to controller first applies a force on the clamp, and then releaseBrake don't do it in the reverse order !!!!
void	setControllerInFault(boolean controllerInFault) set controllerInFault
void	startAction(FcsEnumerations.MobileItemAction action) Start action of locking or unlocking.
void	updateStateWithSensors(String[] hexaValues) This methods updates lockStatus from the values return by the sensors.
void	updateStateWithSensorsToCheckIfActionIsCompleted()

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

abort, abort, 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, 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.MovedByEPOSController

processEmergencyMessage, processFaultReset

Methods inherited from interface org.lsst.ccs.UsesSubsystem

getComponentConfigurationEnvironment, getComponentLookup, getName, getSubsystem

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

currentRampEnded

protected final Condition currentRampEnded

hasToWaitForEndOfCurrentRamp

protected boolean hasToWaitForEndOfCurrentRamp

Constructor Detail

AutochangerOnlineClampModule

public AutochangerOnlineClampModule(EPOSController controller,
                                    NumericSensor closeSensor,
                                    NumericSensor closeSensorC,
                                    NumericSensor openSensor,
                                    NumericSensor openSensorC,
                                    int currentToClose)

Build an AutochangerOnlineClampModule with a controller, 4 sensors and 2 maps of parameters for the controller.

Parameters:

controller -

closeSensor -

closeSensorC -

openSensor -

openSensorC -

currentToClose -

Method Detail

getController

public EPOSController getController()

Return ONLINE clamp controller

Returns:

getCurrentToClose

public int getCurrentToClose()

For simulator

Returns:

getCurrentToOpen

public int getCurrentToOpen()

For simulator

Returns:

getCurrentToClamp

public int getCurrentToClamp()

For simulator

Returns:

getTravelTime

public long getTravelTime()

For simulator

Returns:

isCloseSensorsInError

@Command(type=QUERY,
         level=1,
         description="Returns true if lockSensor and lockSensorC retun the same value. Doesn\'t read again sensors.")
public boolean isCloseSensorsInError()

Returns true if closeSensor and closeSensorC return the same value. Doesn't read again sensors.

Returns:

isOpenSensorsInError

@Command(type=QUERY,
         level=1,
         description="Returns true if unlockSensor and unlockSensorC retun the same value. Doesn\'t read again sensors.")
public boolean isOpenSensorsInError()

Returns true if openSensor and openSensorC retun the same value. Doesn't read again sensors.

Returns:

isInError

@Command(type=QUERY,
         level=1,
         description="Returns true if LockStatus=ERROR, this means that closeSensor or openSensor is in ERROR or thatopenSensor and closeSensor return non consistant values. Doesn\'t read again sensors.")
public boolean isInError()

Returns true if LockStatus=ERROR, this means closeSensor or openSensor is in ERROR or openSensor and closeSensor return non consistant values. Doesn't read again sensors.

Returns:

isClosed

@Command(type=QUERY,
         level=1,
         description="Returns true if LockStatus=CLOSED. Doesn\'t read again sensors.")
public boolean isClosed()

Returns true if LockStatus=CLOSED. Doesn't read again sensors.

Returns:

isOpened

@Command(type=QUERY,
         level=1,
         description="Returns true if LockStatus=OPENED. Doesn\'t read again sensors.")
public boolean isOpened()

Returns true if LockStatus=OPENED. Doesn't read again sensors.

Returns:

isInTravel

@Command(type=QUERY,
         level=1,
         description="Returns true if LockStatus=INTRAVEL. Doesn\'t read again sensors.")
public boolean isInTravel()

Returns true if LockStatus=INTRAVEL. Doesn't read again sensors.

Returns:

isControllerInFault

@Command(type=QUERY,
         level=1,
         description="Returns true if controller is in fault. Doesn\'t read controller CPU.")
public boolean isControllerInFault()

Returns true if controller is in fault. Doesn't read controller CPU.

Specified by:

isControllerInFault in interface MovedByEPOSController

Returns:

setControllerInFault

public void setControllerInFault(boolean controllerInFault)

set controllerInFault

Specified by:

setControllerInFault in interface MovedByEPOSController

Parameters:

controllerInFault -

getControllerName

@Command(type=QUERY,
         level=1,
         description="Returns controller name.")
public String getControllerName()

return controller name

Specified by:

getControllerName in interface MovedByEPOSController

Returns:

isInitialized

@Command(type=QUERY,
         level=1,
         description="Returns true if clamp is initialized : controller is booted, parameters in the controller CPU have been checked and controller is configured.")
public boolean isInitialized()

Returns true if clamp is initialized : hardware is ready (at least booted) and clamp controller is initialized (parameters in the controller CPU have been checked and controller has been configured.

Returns:

initModule

public void initModule()

Initialize fields autochanger, lockStatus and listens to its controller.

Overrides:

initModule in class MobileItemModule

isCANDevicesReady

@Command(type=QUERY,
         level=1,
         description="Returns true if controller is initialized and configured.")
public boolean isCANDevicesReady()

Return true when ONLINE clamp hardware is ready. That is when controller is initialized and configured.

Specified by:

isCANDevicesReady in class MobileItemModule

Returns:

checkConditionsForOpening

@Command(type=QUERY,
         level=1,
         description="Check if the onlineClamp can be locked.")
public void checkConditionsForOpening()

Check if it's safe to open the clamp.

Throws:

FcsHardwareException

checkConditionsForClosing

@Command(type=QUERY,
         level=1,
         description="Check if the onlineClamp can be locked.")
public void checkConditionsForClosing()

Check if it's safe to close the clamp.

Throws:

FcsHardwareException

checkHardware

@Command(type=QUERY,
         level=1,
         description="Initialize controller and check parameters.")
public org.lsst.ccs.framework.TreeWalkerDiag checkHardware()
                                                                                                                                                               throws org.lsst.ccs.HardwareException

This method is called during INITIALIZATION phase. It configures the controller for the digital inputs and outputs. It changes it to CURRENT mode if it's not in this mode and it writes in the CPU of the controller the values of configuration for CURRENT mode parameters.

Specified by:

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

Overrides:

checkHardware in class MobileItemModule

Returns:

Throws:

org.lsst.ccs.HardwareException

checkControllerBeforeAction

@Command(type=QUERY,
         level=1,
         description="Read in the CPU of the controller parameters for mode CURRENT.If a parameter has a different value than in configuration, throws an exception.")
public void checkControllerBeforeAction()

Read parameters for mode CURRENT on controller CPU. If a parameter has a different value than in configuration, throws an exception.

Throws:

FcsHardwareException

configureController

@Command(type=ACTION,
         level=1,
         description="Configure controller.")
public void configureController()
                                                                                                               throws org.lsst.ccs.HardwareException

Configure ONLINE clamp controller.

Throws:

org.lsst.ccs.HardwareException

FcsHardwareException

updateStateWithSensors

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

This methods updates lockStatus from the values return by the sensors. This values are given in an array of hexa values as arguments of the method.

Parameters:

hexaValues -

isActionCompleted

public boolean isActionCompleted(FcsEnumerations.MobileItemAction action)

Specified by:

isActionCompleted in class MobileItemModule

updateStateWithSensorsToCheckIfActionIsCompleted

public void updateStateWithSensorsToCheckIfActionIsCompleted()

Specified by:

updateStateWithSensorsToCheckIfActionIsCompleted in class MobileItemModule

close

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

Close the ONLINE clamp.

open

@Command(type=ACTION,
         level=1,
         description="Unlock the ONLINE clamp.")
public void open()

Open the ONLINE clamp.

startAction

public void startAction(FcsEnumerations.MobileItemAction action)

Start action of locking or unlocking.

Specified by:

startAction in class MobileItemModule

Parameters:

action -

Throws:

FcsHardwareException

sendCurrentToController

public void sendCurrentToController(int cur)

enables controller and sends current to controller first applies a force on the clamp, and then releaseBrake don't do it in the reverse order !!!!

Parameters:

cur - to be sent to the controller

abortAction

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

What to do to abort an action.

Specified by:

abortAction in class MobileItemModule

Parameters:

action -

delay -

Throws:

FcsHardwareException

postAction

public void postAction(FcsEnumerations.MobileItemAction action)

What to be done after the action is completed.

Specified by:

postAction in class MobileItemModule

Parameters:

action -

Throws:

FcsHardwareException

configureDigitalInputOfOnlineClamps

@Command(type=ACTION,
         level=1,
         description="To configure the online clamps controllers.")
public void configureDigitalInputOfOnlineClamps()

This method is used to configure the controllers of the autochanger online clamps. * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Digital Inputs activated for OnlineClamps controllers are: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ QuickStop Input=01 Mask=Enabled Polarity=HighActive HE_Sensor General_A Input=02 Mask=Enabled Polarity=HighActive HE_Sensor\ General_B Input=03 Mask=Enabled Polarity=HighActive Check Brake Status ******************************************** 1 - Configure the Digital Input Functionnality index 0x2070 sindex input_ID Functionnality tab Value = 15 General Purpose A Value = 14 General Purpose B Value = 13 General Purpose C Value = 12 General Purpose D Value = 11 General Purpose E Value = 10 General Purpose F Value = 9 General Purpose G Value = 8 General Purpose H Value = 7 General Purpose I Value = 6 General Purpose J Value = 5 QuickStop Value = 4 Drive enable Value = 3 Position marker Value = 2 Home switch Value = 1 Positive Limit switch Value = 0 Negative Limit switch msg = 'Set DigIn_1 Quick Stop,wsdo,%s,2070,01,02,0005\n' % (str(cobID)) self.com_hal.executeOperation(client,msg) msg = 'Set DigIn_2 General_A,wsdo,%s,2070,02,02,8000\n' % (str(cobID)) self.com_hal.executeOperation(client,msg) msg = 'Set DigIn_3 Genral_B,wsdo,%s,2070,02,02,4000\n' % (str(cobID)) self.com_hal.executeOperation(client,msg) *************************************************************** 2 - Configure the Digital Input Polarity index 0x2071 subindex 0x03 Value = 0 High Active Value = 1 Low Active **************************************************************** 3 - Configure the Digital Input Mask index 0x2071 subindex 0x02 Value = 0 Functionnality state will not be displayed Value = 1 Functionnality state will be displayed * Digital Input Functionnality tab value Bit_15 General Purpose A 1 Bit_14 General Purpose B 1 Bit_13 General Purpose C 0 Bit_12 General Purpose D 0 Bit_11 General Purpose E 0 Bit_10 General Purpose F 0 Bit_9 General Purpose G 0 Bit_8 General Purpose H 0 Bit_7 General Purpose I 0 Bit_6 General Purpose J 0 Bit_5 QuickStop 1 Bit_4 Drive enable 0 Bit_3 Position marker 0 Bit_2 Home switch 0 Bit_1 Positive Limit switch 0 Bit_0 Negative Limit switch 0 ********************************************************************* 4 - Configure the Digital Input Execution Mask index 0x2071 subindex 0x04 Digital Input Excecution Mask Value Bit_15 to Bit_6 reserved 0 Bit_5 QuickStop 1 Bit_4 Drive enable 1 Bit_3 Position marker 0 Bit_2 Home switch 0 Bit_1 Positive Limit switch 0 Bit_0 Negative Limit switch 0 **********************************************************************

configureDigitalOutputOfOnlineClamps

@Command(type=ACTION,
         level=1,
         description="To configure the online clamps controllers.")
public void configureDigitalOutputOfOnlineClamps()

This methods is used to configure the autochanger onlineClamps EPOS controllers. * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Digital Outputs activated for OnlineClamps controller are: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Ready/Fault Output=01 Mask=Enabled Polarity=HighActive General_A Output=04 Mask=Enabled Polarity=HighActive ******************************************** 1 - Configure the Digital Output Functionnality index 0x2079 subindex input_ID Functionnality tab Value = 15 General Purpose Out_A Value = 14 General Purpose Out_B Value = 13 General Purpose Out_C Value = 12 General Purpose Out_D Value = 11 General Purpose Out_E Value = 10..8 not used Value = 7..3 reserved Value = 2 Holding Brake Value = 1 Position compare Value = 0 Ready/Fault ******************************************************************************** 2 - Configure the Digital Output Functionnality Mask index 0x2078 subindex 0x02 Value = 0 functionnality not activatd Value = 1 functionnality activated ******************************************************************************** Digital Output Functionnality Mask Value Bit_15 General Purpose Out_A 1 Bit_14 General Purpose Out_B 0 Bit_13 General Purpose Out_C 0 Bit_12 General Purpose Out_D 0 Bit_11 General Purpose Out_E 0 Bit_10 General Purpose Out_F 0 Bit_9 General Purpose Out_G 0 Bit_8 General Purpose Out_H 0 Bit_7 reserved 0 Bit_6 reserved 0 Bit_5 reserved 0 Bit_4 reserved 0 Bit_3 reserved 0 Bit_2 Holding Brake 0 ******************************************************************************** 3 - Configure the Digital Output Functionnality Polarity index 0x2078 subindex 0x03 Value = 0 associated output not change => HighActive Value = 1 associated output inverted => LowActive ********************************************************************************

Throws:

FcsHardwareException

processUpdate

public void processUpdate(Observable source,
                          org.lsst.ccs.framework.Module.ValueUpdate v)

What to do when the Modules we observe send there new values. This class observes its controller to publish data when its controller is in fault or after a faultReset. Needed to update the GUI.

Specified by:

processUpdate in interface MovedByEPOSController

Overrides:

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

Parameters:

source -

v -

createStatusDataPublishedByOnlineClamp

public StatusDataPublishedByAutochangerOnlineClamp createStatusDataPublishedByOnlineClamp()

Creates and returns the object to be published on the STATUS bus.

Returns:

publishData

public void publishData()

Specified by:

publishData in interface MovedByEPOSController

Specified by:

publishData in class MobileItemModule

quickStopAction

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

Specified by:

quickStopAction in class MobileItemModule

executeCurrentRamp

public void executeCurrentRamp(int initialValue,
                               int finalValue,
                               int nbStep,
                               long period)

Writes newCurrentValue to controller with a newCurrentValue ramp : from initialValue to finalValue in nbStep.

Parameters:

initialValue -

finalValue -

nbStep -

period - of time to wait between 2 writes to the controller.