org.lsst.ccs.subsystems.fcs

Class AutochangerThreeOnlineClamps

java.lang.Object

org.lsst.ccs.subsystems.fcs.AutochangerThreeOnlineClamps

All Implemented Interfaces:

org.lsst.ccs.framework.HasLifecycle, org.lsst.ccs.framework.SignalHandler, AlertRaiser, ControlledBySensors

Direct Known Subclasses:

AutochangerThreeOnlineClampsProto

public class AutochangerThreeOnlineClamps
extends Object
implements ControlledBySensors, org.lsst.ccs.framework.SignalHandler, org.lsst.ccs.framework.HasLifecycle

Represents the set of the 3 onlineClamps of autochanger. This class gathers the method to send command to the 3 onlineClamps all together. It is no more a MobileItem since we use AutochangerOnlineClamp commands.

Author:

virieux

Field Summary

Fields

Modifier and Type	Field and Description
protected Autochanger	autochanger
protected AutochangerOnlineClamp[]	clampsList
protected ScheduledFuture<?>	currentRampHandle
protected org.lsst.ccs.services.DataProviderDictionaryService	dataProviderDictionaryService
protected int	maxTimeToCloseClampsX
protected int	maxTimeToLockAllClamps
protected int	maxTimeToOpenClampsX
protected int	maxTimeToUnlockAllClamps
protected int	minPeriod
protected String	name
protected AutochangerOnlineClamp	onlineClampXminus
protected AutochangerOnlineClamp	onlineClampXplus
protected AutochangerOnlineClamp	onlineClampYminus
protected String	path
protected int	timeoutForLockingClamps
protected int	timeoutForUnlockingClamps

Fields inherited from interface org.lsst.ccs.subsystems.fcs.common.AlertRaiser

alertSeparator

Constructor Summary

Constructors

Constructor and Description
AutochangerThreeOnlineClamps(AutochangerOnlineClamp onlineClampXminus, AutochangerOnlineClamp onlineClampXplus, AutochangerOnlineClamp onlineClampYminus) Create a AutochangerThreeOnlineClamps with 3 AutochangerOnlineClamp.

Method Summary

Modifier and Type	Method and Description
void	build()
void	closeClamps() close clamps in mode PROFILE_POSITION.
FcsEnumerations.LockStatus	computeStrainGaugeLockStatus() return a lock status computed from strain read on onlineStrainGauge.
StatusDataPublishedByAutochangerThreeClamps	createStatusDataPublishedByThreeClamps() Creates an object to be published on the status bus.
org.lsst.ccs.services.alert.AlertService	getAlertService() return alertService
FcsEnumerations.LockStatus	getLockStatus()
org.lsst.ccs.Subsystem	getSubsystem()
void	homing() do homing of the 3 clamps
void	init()
void	initializeHardware() initialize AC online clamps hardware after initialization.
boolean	isClosed() Returns true if LockStatus=CLOSED
boolean	isHomingDone()
boolean	isInError() Returns true if LockStatus=ERROR
boolean	isInitialized() Return true if the 3 onlineClamps hardware is lockStatusInitialized.
boolean	isLocked() Returns true if LockStatus=LOCKED
boolean	isLockStatusInitialized()
boolean	isOpened() Returns true if LockStatus=OPENED
void	lockClamps() Locks clamps : closed with a strong pressure (high current).
void	lockFilterAtOnline() to be used by setFilter
boolean	myDevicesReady() Return true if the 3 onlineClamps hardware is ready.
void	openClamps() Opens the 3 clamps.
void	postStart()
void	publishData()
void	setMinPeriod(int minPeriod) set a minimal value for current ramps period
void	testPeriodTask() test periodicTask.
void	unlockAndOpen() Use by command unclampAndMoveFilterToHandoff.
void	unlockClamps() Unlocks clamps : slows down current sent to controller in order to decrease pressure on the clamps.
void	updateState() This methods updates lockStatus from the values return by the sensors.
protected void	updateStateAndCheckSensors()

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

checkSensors

Methods inherited from interface org.lsst.ccs.subsystems.fcs.common.AlertRaiser

clearAlarm, getAlertSeparator, raiseAlarm, raiseAlarm, raiseAlarm, raiseAlarm, raiseAlarmOnlyIfNew, raiseAlertOnlyEveryTenMinutes, raiseAlertOnlyEveryTenMinutes, raiseAlertOnlyIfNew, raiseWarning, raiseWarning, raiseWarning, raiseWarning, raiseWarningOnlyEveryTenMinutes, raiseWarningOnlyIfNew

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

signal

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

postBuild, postInit, postShutdown, shutdown, start

Field Detail

name

@LookupName
protected String name

path

@LookupPath
protected String path

autochanger

@LookupField(strategy=TREE)
protected Autochanger autochanger

dataProviderDictionaryService

@LookupField(strategy=TREE)
protected org.lsst.ccs.services.DataProviderDictionaryService dataProviderDictionaryService

onlineClampXminus

protected final AutochangerOnlineClamp onlineClampXminus

onlineClampXplus

protected final AutochangerOnlineClamp onlineClampXplus

onlineClampYminus

protected final AutochangerOnlineClamp onlineClampYminus

clampsList

protected final AutochangerOnlineClamp[] clampsList

currentRampHandle

protected ScheduledFuture<?> currentRampHandle

timeoutForLockingClamps

@ConfigurationParameter(description="timeout in milliseconds : if closing the clamps last more than this amount of time, then the subsystem goes in ERROR.",
                        units="millisecond",
                        category="autochanger")
protected volatile int timeoutForLockingClamps

timeoutForUnlockingClamps

@ConfigurationParameter(description="timeout in milliseconds : if unlocking the clamps last more than this amount of time, then the subsystem goes in ERROR.",
                        units="millisecond",
                        category="autochanger")
protected volatile int timeoutForUnlockingClamps

maxTimeToLockAllClamps

@ConfigurationParameter(description="maximum time in milliseconds to lock the 3 clamps",
                        units="millisecond",
                        category="autochanger")
protected volatile int maxTimeToLockAllClamps

maxTimeToUnlockAllClamps

@ConfigurationParameter(description="maximum time in milliseconds to unlock the 3 clamps",
                        units="millisecond",
                        category="autochanger")
protected volatile int maxTimeToUnlockAllClamps

maxTimeToOpenClampsX

@ConfigurationParameter(description="maximum time in milliseconds to open the 3 clamps",
                        units="millisecond",
                        category="autochanger")
protected volatile int maxTimeToOpenClampsX

maxTimeToCloseClampsX

@ConfigurationParameter(description="maximum time in milliseconds to close the 3 clamps",
                        units="millisecond",
                        category="autochanger")
protected volatile int maxTimeToCloseClampsX

minPeriod

@ConfigurationParameter(description="minimal period for current ramps. should be > 50",
                        units="millisecond",
                        range="50..1000",
                        category="autochanger")
protected volatile int minPeriod

Constructor Detail

AutochangerThreeOnlineClamps

public AutochangerThreeOnlineClamps(AutochangerOnlineClamp onlineClampXminus,
                                    AutochangerOnlineClamp onlineClampXplus,
                                    AutochangerOnlineClamp onlineClampYminus)

Create a AutochangerThreeOnlineClamps with 3 AutochangerOnlineClamp.

Parameters:

onlineClampXminus -

onlineClampXplus -

onlineClampYminus -

Method Detail

getAlertService

public org.lsst.ccs.services.alert.AlertService getAlertService()

Description copied from interface: AlertRaiser

return alertService

Specified by:

getAlertService in interface AlertRaiser

Returns:

getSubsystem

public org.lsst.ccs.Subsystem getSubsystem()

Specified by:

getSubsystem in interface AlertRaiser

build

public void build()

Specified by:

build in interface org.lsst.ccs.framework.HasLifecycle

init

public void init()

Specified by:

init in interface org.lsst.ccs.framework.HasLifecycle

isLockStatusInitialized

@Command(type=QUERY,
         level=0,
         description="Returns true if lockStatus has been first initialized from strain.")
public boolean isLockStatusInitialized()

isHomingDone

@Command(type=QUERY,
         level=0,
         description="Returns true if homing has been done for the 3 ONLINE clamp controllers.")
public boolean isHomingDone()

Returns:

true if homing has been done for the 3 controllers of clamps.

setMinPeriod

@ConfigurationParameterChanger
public void setMinPeriod(int minPeriod)

set a minimal value for current ramps period

Parameters:

minPeriod -

getLockStatus

public FcsEnumerations.LockStatus getLockStatus()

Returns:

lockStatus

isLocked

@Command(type=QUERY,
         level=0,
         description="Returns true if the 3 clamps are LOCKED.")
public boolean isLocked()

Returns true if LockStatus=LOCKED

Returns:

isClosed

@Command(type=QUERY,
         level=0,
         description="Returns true if the 3 clamps are CLOSED.")
public boolean isClosed()

Returns true if LockStatus=CLOSED

Returns:

isOpened

@Command(type=QUERY,
         level=0,
         description="Returns true if the 3 clamps are OPENED.")
public boolean isOpened()

Returns true if LockStatus=OPENED

Returns:

isInError

@Command(type=QUERY,
         level=0,
         description="Returns true if one of the clamp is in error.")
public boolean isInError()

Returns true if LockStatus=ERROR

Specified by:

isInError in interface ControlledBySensors

Returns:

isInitialized

@Command(type=QUERY,
         level=0,
         description="Return true if the 3 onlineClamps hardware is ready : controllers ready, controllers parameters checked and controllers configured.")
public boolean isInitialized()

Return true if the 3 onlineClamps hardware is lockStatusInitialized.

Returns:

homing

@Command(type=ACTION,
         level=2,
         description="do homing of the 3 ONLINE clamps : open in CURRENT mode and homing of controller",
         timeout=6000)
public void homing()

do homing of the 3 clamps

testPeriodTask

public void testPeriodTask()

test periodicTask.

closeClamps

public void closeClamps()

close clamps in mode PROFILE_POSITION. for AC1 and AC2

openClamps

public void openClamps()

Opens the 3 clamps. initial state = CLOSED final state = OPENED. For final pruducts AC1 and AC2. For prototype see openClampsInCurrentMode.

lockClamps

public void lockClamps()

Locks clamps : closed with a strong pressure (high current). The clamps have to be CLOSED. At the end of this action, the clamps are CLOSED but a strong pressure to hold safely the clamps.

unlockClamps

public void unlockClamps()

Unlocks clamps : slows down current sent to controller in order to decrease pressure on the clamps. The clamps have to be LOCKED. At the end of this action, the clamps are CLOSED with a small pressure of the clamp hardware on the filter frame.

lockFilterAtOnline

public void lockFilterAtOnline()

to be used by setFilter

unlockAndOpen

public void unlockAndOpen()

Use by command unclampAndMoveFilterToHandoff. For tests only.

myDevicesReady

@Command(type=QUERY,
         level=0,
         description="Return true if the 3 onlineClamps hardware is ready.")
public boolean myDevicesReady()

Return true if the 3 onlineClamps hardware is ready.

Returns:

createStatusDataPublishedByThreeClamps

public StatusDataPublishedByAutochangerThreeClamps createStatusDataPublishedByThreeClamps()

Creates an object to be published on the status bus.

Returns:

publishData

public void publishData()

updateStateAndCheckSensors

protected void updateStateAndCheckSensors()

updateState

@Command(type=ACTION,
         level=1,
         description="Update state from sensors values.")
public void updateState()

This methods updates lockStatus from the values return by the sensors.

computeStrainGaugeLockStatus

@Command(type=QUERY,
         level=1,
         description="Return a lock status computed from the normalizedStrain value")
public FcsEnumerations.LockStatus computeStrainGaugeLockStatus()

return a lock status computed from strain read on onlineStrainGauge.

Returns:

initializeHardware

@Command(type=QUERY,
         level=1,
         description="Initialize AC online clamps hardware after initialization. To be executed if during boot process some hardware is missing.")
public void initializeHardware()

initialize AC online clamps hardware after initialization. to be executed if during boot process some hardware is missing.

postStart

public void postStart()

Specified by:

postStart in interface org.lsst.ccs.framework.HasLifecycle