org.lsst.ccs.subsystems.fcs

Class Autochanger

java.lang.Object

org.lsst.ccs.subsystems.fcs.Autochanger

All Implemented Interfaces:

org.lsst.ccs.framework.HardwareController, org.lsst.ccs.framework.HasLifecycle, AlertRaiser, FilterHolder

public class Autochanger
extends Object
implements org.lsst.ccs.framework.HardwareController, FilterHolder, AlertRaiser, org.lsst.ccs.framework.HasLifecycle

This class is used with the final hardware and prototype in which we have online clamps to hold the filter at online position. It's not used for Single Filter Test. CAMERA PROTECTION SYSTEM Signal comming from carousel : CS : Carousel stopped on socket CF0: No filter in carousel socket CF1: Filer in carousel socket CFC: Filter clamped on carousel socket Signal coming from loader : LPS: Loader at Storage position (loader is connected) LRH: Loader at Handoff position, closed but not clamped Local Protection Module Signals emitted by AC: enableRailLin1 enable master linear rail (X+) enableRailLin2 enable slave linear rails (X-) enableClamps enableLatches

Author:

virieux

Field Summary

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

alertSeparator

Constructor Summary

Constructors

Constructor and Description
Autochanger(PlutoGatewayInterface plutoGateway)

Method Summary

Modifier and Type	Method and Description
void	checkConditionsForActioningOnlineClamps() log if actions on online clamps are allowed, throws an exception otherwise.
void	checkConditionsForClosingLatches() Check if Autochanger latches can be closed.
void	checkConditionsForOpeningLatches() Check if latches can be opened.
void	checkFilterSafetyBeforeMotion() This methods checks that filter can be moved by trucks.
void	checkStarted()
StatusDataPublishedByAutoChanger	createStatusDataPublishedByAutoChanger() Creates an Object to be published on the STATUS bus.
void	decreaseCurrentMonitoring() slow down online clamps current monitoring for the 3 clamps
void	decreaseLinearRailsCurrentMonitoring() slow down online clamps current monitoring for the 3 clamps
org.lsst.ccs.services.alert.AlertService	getAlertService() return alertService
AutochangerTwoTrucks	getAutochangerTrucks() returns trucks to be able to send commands to trucks in fcs subsystem.
int	getFilterOnTrucksID() If autochanger holds a filter, returns filterID, else returns 0.
String	getFilterOnTrucksName() If autochanger holds a filter, return filter name else return null.
String	getName()
AutochangerThreeOnlineClamps	getOnlineClamps() returns onlineClamps to be able to send commands to onlineClamps in fcs subsystem.
org.lsst.ccs.Subsystem	getSubsystem()
void	grabFilterAtStandby() Close latches on filter at STANDBY.
void	increaseCurrentMonitoring() speed up online clamps current monitoring for the 3 clamps
void	increaseLinearRailsCurrentMonitoring() increase current monitoring for the 2 trucks
boolean	isAtHandoff() Return true if autochanger trucks are at HANDOFF.
boolean	isAtOnline() return true if autochanger trucks are at ONLINE.
boolean	isAtStandby() Return true if autochanger trucks are at STANDBY.
boolean	isCANDevicesReady()
boolean	isCarouselHoldingFilterAtStandby() TODO when autochanger is in standalone mode this method has to answer the value of the fake carousel sensor.
boolean	isEmpty() Return true if there is no filter in the autochanger.
boolean	isFilterOnAC(int filterID)
boolean	isHardwareReady()
boolean	isHoldingFilter() Return true if a filter is in trucks and latches are LOCKED.
boolean	isInitialized() Return true if plutoGateway, trucks, latches and onlineClamps are initialized.
boolean	isLoaderConnected() Returns the boolean field loaderConnected.
boolean	isLoaderHoldingFilterAtHandoff() Return true if loader is connected and holding a filter.
boolean	isNotHoldingFilter() Return true if FilterHolder is NOT holding filter, false otherwise.
boolean	isSensorsInError() Return true if an error has been detected on sensors.
void	postStart()
void	publishData() Publish Data on status bus for trending data base and GUIs.
void	setFastAcqRateLinearRails(int rate) set a new value for the acquisition frequency of linear rail controllers current.
void	setFastAcqRateOnlineClamps(int rate) set a new value for the acquisition frequency of ONLINE clamps controllers current.
void	setFilterOnTrucksID(int filterOnTrucksID) Used for simulator only.
void	ungrabFilterAtStandby() Open the latches at standby position.
void	updateFCSStateToReady() Update FCS state and FCS readyness state and publish on the status bus.
void	updateFilterOnTrucksID() update filterOnTrucksID
void	updateStateWithSensors() This method reads all the sensors and updates the trucks, latches and online clamps state.

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

checkHardware, checkStopped

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

clearAlarm, getAlertSeparator, raiseAlarm, raiseAlarm, raiseAlarm, raiseAlarm, raiseWarning, raiseWarning

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

build, init, postBuild, postInit, postShutdown, shutdown, start

Constructor Detail

Autochanger

public Autochanger(PlutoGatewayInterface plutoGateway)

Method Detail

getName

public String getName()

Specified by:

getName in interface AlertRaiser

getSubsystem

public org.lsst.ccs.Subsystem getSubsystem()

Specified by:

getSubsystem in interface AlertRaiser

getAlertService

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

Description copied from interface: AlertRaiser

return alertService

Specified by:

getAlertService in interface AlertRaiser

Returns:

isSensorsInError

@Command(type=QUERY,
         level=1,
         description="Return true if an error has been detected on sensors.")
public boolean isSensorsInError()

Return true if an error has been detected on sensors.

Returns:

getAutochangerTrucks

public AutochangerTwoTrucks getAutochangerTrucks()

returns trucks to be able to send commands to trucks in fcs subsystem.

Returns:

trucks

getOnlineClamps

public AutochangerThreeOnlineClamps getOnlineClamps()

returns onlineClamps to be able to send commands to onlineClamps in fcs subsystem.

Returns:

onlineClamps

getFilterOnTrucksID

@Command(type=QUERY,
         level=0,
         description="If autochanger holds a filter, return filterID, else return 0.")
public int getFilterOnTrucksID()

If autochanger holds a filter, returns filterID, else returns 0.

Returns:

setFilterOnTrucksID

public void setFilterOnTrucksID(int filterOnTrucksID)

Used for simulator only.

Parameters:

filterOnTrucksID -

isFilterOnAC

public boolean isFilterOnAC(int filterID)

getFilterOnTrucksName

@Command(type=QUERY,
         level=0,
         description="If autochanger holds a filter, return filter name else return null.")
public String getFilterOnTrucksName()

If autochanger holds a filter, return filter name else return null.

Returns:

isLoaderConnected

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

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

Returns:

atHandoff

isCarouselHoldingFilterAtStandby

@Command(type=QUERY,
         level=0,
         description="Return true if the carousel is holding the filter at STANDBY position.")
public boolean isCarouselHoldingFilterAtStandby()

TODO when autochanger is in standalone mode this method has to answer the value of the fake carousel sensor.

Returns:

Throws:

FcsHardwareException

isLoaderHoldingFilterAtHandoff

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

Return true if loader is connected and holding a filter. This command doesn't read again the sensors.

Returns:

Throws:

FcsHardwareException

isCANDevicesReady

@Command(type=QUERY,
         level=0,
         description="Return true if all autochanger CANopen devices are booted, identified and initialized.")
public boolean isCANDevicesReady()

Returns:

true if all autochanger hardware is initialized and bridge is hardwareReady.

isHardwareReady

@Command(type=QUERY,
         level=0,
         description="Return true if all autochanger CANopen devices are booted, identified and initialized and homing of the controllers is done.")
public boolean isHardwareReady()

Returns:

if all autochanger CANopen devices are booted, identified and nitialized and homing of the controllers is done.

isInitialized

@Command(type=QUERY,
         level=0,
         description="Return true if all autochanger hardware is initialized.")
public boolean isInitialized()

Return true if plutoGateway, trucks, latches and onlineClamps are initialized.

Returns:

postStart

public void postStart()

Specified by:

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

checkStarted

public void checkStarted()

Specified by:

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

checkConditionsForOpeningLatches

@Command(type=QUERY,
         level=1,
         description="Check if the latches can be opened.")
public void checkConditionsForOpeningLatches()

Check if latches can be opened. If latches can't be openened because the conditions for opening are not filled, this command throws a RejectedCommandException. If latches are in error, it throws a FcsHardwareException.

Throws:

FcsHardwareException

checkConditionsForClosingLatches

@Command(type=QUERY,
         level=1,
         description="Check if Autochanger latches can be closed.")
public void checkConditionsForClosingLatches()

Check if Autochanger latches can be closed.

Throws:

FcsHardwareException

checkConditionsForActioningOnlineClamps

@Command(type=QUERY,
         description="log if actions on online clamps are allowed,throws an exception otherwise.")
public void checkConditionsForActioningOnlineClamps()

log if actions on online clamps are allowed, throws an exception otherwise.

checkFilterSafetyBeforeMotion

@Command(type=QUERY,
         level=1,
         description="Check if its safe for filters to move autochanger trucks.")
public void checkFilterSafetyBeforeMotion()

This methods checks that filter can be moved by trucks. Returns immediately if autochanger trucks are empty. Throws RejectedCommandException if a filter is in trucks AND held both by autochanger and (loader or carousel).

Throws:

FcsHardwareException

RejectedCommandException

updateStateWithSensors

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

This method reads all the sensors and updates the trucks, latches and online clamps state.

Specified by:

updateStateWithSensors in interface FilterHolder

Throws:

FcsHardwareException

updateFilterOnTrucksID

@Command(type=QUERY,
         level=1,
         description="update filterOnTrucksID.")
public void updateFilterOnTrucksID()

update filterOnTrucksID

updateFCSStateToReady

@Command(type=ACTION,
         level=1,
         description="Update FCS state and FCS readyness state and publishes on the status bus.")
public void updateFCSStateToReady()

Update FCS state and FCS readyness state and publish on the status bus. Check that Autochanger hardware is ready to be operated and moved. This means that : - all CAN open devices are booted, identified and initialized, - initialization has been done on the controllers.

isHoldingFilter

@Command(type=QUERY,
         level=1,
         description="Return true if a filter is in trucks and latches are CLOSED.")
public boolean isHoldingFilter()

Return true if a filter is in trucks and latches are LOCKED.

Specified by:

isHoldingFilter in interface FilterHolder

Returns:

isNotHoldingFilter

public boolean isNotHoldingFilter()

Description copied from interface: FilterHolder

Return true if FilterHolder is NOT holding filter, false otherwise. Example : latches OPENED (AF0=1) It can't be just !isHoldingFilter() because hardware can be in an intermediate state. For example, when opening or closing autochanger latches, latches go in state IN_TRAVEL. So we can have state where AF3=0 and AF2=0

Specified by:

isNotHoldingFilter in interface FilterHolder

Returns:

true if NOT holding filter

isAtHandoff

@Command(type=QUERY,
         level=0,
         description="Return true if autochanger trucks are at HANDOFF. This command doesn\'t read again the sensors.")
public boolean isAtHandoff()

Return true if autochanger trucks are at HANDOFF. This command doesn't read again the sensors.

Specified by:

isAtHandoff in interface FilterHolder

Returns:

isAtStandby

@Command(type=QUERY,
         level=0,
         description="Return true if autochanger trucks are at STANDBY. This command doesn\'t read again the sensors.")
public boolean isAtStandby()

Return true if autochanger trucks are at STANDBY. This command doesn't read again the sensors.

Specified by:

isAtStandby in interface FilterHolder

Returns:

isAtOnline

@Command(type=QUERY,
         description="Return true if autochanger trucks are at ONLINE. This command doesn\'t read again the sensors.")
public boolean isAtOnline()

return true if autochanger trucks are at ONLINE.

Returns:

isEmpty

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

Return true if there is no filter in the autochanger. This command doesn't read again the sensors.

Returns:

grabFilterAtStandby

@Command(type=ACTION,
         level=1,
         alias="grabFilter",
         description="Go to STANDBY to grab filter and stay at STANDBY.")
public void grabFilterAtStandby()

Close latches on filter at STANDBY. Identify filter at STANDBY in reading identifier ID. Update filter location.

Throws:

RejectedCommandException - if autochanger trucks are not at STANDBY.

ungrabFilterAtStandby

@Command(type=ACTION,
         level=1,
         description="Ungrab filter at STANDBY")
public void ungrabFilterAtStandby()

Open the latches at standby position. position.

Throws:

RejectedCommandException

FcsHardwareException

setFastAcqRateLinearRails

@Command(type=QUERY,
         description="set a new value for the acquisition frequency of linear rail controllers current, in milliseconds.")
public void setFastAcqRateLinearRails(int rate)

set a new value for the acquisition frequency of linear rail controllers current.

Parameters:

rate -

setFastAcqRateOnlineClamps

@Command(type=QUERY,
         description="set a new value for the acquisition frequency of ONLINE clamps controllers current, in milliseconds.")
public void setFastAcqRateOnlineClamps(int rate)

set a new value for the acquisition frequency of ONLINE clamps controllers current.

Parameters:

rate -

increaseCurrentMonitoring

@Command(type=QUERY)
public void increaseCurrentMonitoring()

speed up online clamps current monitoring for the 3 clamps

decreaseCurrentMonitoring

@Command(type=QUERY)
public void decreaseCurrentMonitoring()

slow down online clamps current monitoring for the 3 clamps

increaseLinearRailsCurrentMonitoring

@Command(type=QUERY)
public void increaseLinearRailsCurrentMonitoring()

increase current monitoring for the 2 trucks

decreaseLinearRailsCurrentMonitoring

@Command(type=QUERY)
public void decreaseLinearRailsCurrentMonitoring()

slow down online clamps current monitoring for the 3 clamps

createStatusDataPublishedByAutoChanger

public StatusDataPublishedByAutoChanger createStatusDataPublishedByAutoChanger()

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.