org.lsst.ccs.subsystems.fcs.common

Interface Carousel

All Known Implementing Classes:

CarouselModule, SftCarouselModule, SimuSftCarouselModule

public interface Carousel

This interface is a model for a carousel. The Filter carousel holds 5 filters. The filters are held in 5 sockets around the carousel.

• It can rotate and be stopped.
• It can give its position.
• It can be EngageBrakeed or ReleaseBrakeed.
• It can release its clamps at standby position.
• It can ReleaseBrake its clamps at standby position.
• It can return the socket which is at standby position.

Author:

virieux

Method Summary

Modifier and Type	Method and Description
String	engageBrake() Lock the carousel (or engage the break).
void	engageClampsContact() After a rotation, when the carousel is stopped the power contact can be engaged again.
double	getPosition() The carousel position measures the rotation angle of the carousel within the fixed part of the camera.
CarouselSocket	getSocketAtStandby() This methods returns the socket at standby position or null if there is no socket at standby position.
boolean	isAbleToMove() The carousel can be EngageBrakeed by a break or prevented to move by the autochanger fliprail.
String	releaseBrake() UnEngageBrake the carousel (or disengage the break)
String	releaseClamps() This is a command that can be sent to the carousel.
void	releaseClampsContact() Before rotating the carousel we have to release the power contact between the moving part and the fixed part.
String	rotate(double angle) This method is a command that can be sent to the carousel.
String	unlockClamps(Filter filter)

Method Detail

getPosition

double getPosition()

The carousel position measures the rotation angle of the carousel within the fixed part of the camera.

Returns:

The position of the carousel in degrees. Its values is greater or equal to 0 and less than 360.

isAbleToMove

boolean isAbleToMove()

The carousel can be EngageBrakeed by a break or prevented to move by the autochanger fliprail. The carousel is able to move if no piece of hardware (nor simulated hardware) prevents the carousel to move.

Returns:

true if the carousel is able to move, false if not.

rotate

String rotate(double angle)
       throws IllegalArgumentException,
              org.lsst.ccs.messaging.BadCommandException

This method is a command that can be sent to the carousel. It make the carousel rotating for a given angle.

Parameters:

angle - : given in degree available values for an angle : [-360,+360]

Returns:

Throws:

IllegalArgumentException - if the angle given as parameter is not in the ranges of available values.

org.lsst.ccs.messaging.BadCommandException - if the carousel is already rotating or is unable to move.

engageBrake

String engageBrake()

Lock the carousel (or engage the break).

Returns:

releaseBrake

String releaseBrake()

UnEngageBrake the carousel (or disengage the break)

Returns:

getSocketAtStandby

CarouselSocket getSocketAtStandby()

This methods returns the socket at standby position or null if there is no socket at standby position. If the carousel is rotating, it returns null.

Returns:

the socket which is at standby position or null if there is no socket at standby position.

releaseClamps

String releaseClamps()
              throws org.lsst.ccs.messaging.BadCommandException,
                     org.lsst.ccs.messaging.ErrorInCommandExecutionException,
                     FcsHardwareException

This is a command that can be sent to the carousel. It releases (ReleaseBrake it) the clamps at standby position. (when a clamp is released, it can be EngageBrakeed automaticaly when a filter comes in the socket)

Returns:

Throws:

org.lsst.ccs.messaging.BadCommandException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

FcsHardwareException

unlockClamps

String unlockClamps(Filter filter)
             throws org.lsst.ccs.messaging.BadCommandException,
                    org.lsst.ccs.messaging.ErrorInCommandExecutionException,
                    FcsHardwareException

Throws:

org.lsst.ccs.messaging.BadCommandException

org.lsst.ccs.messaging.ErrorInCommandExecutionException

FcsHardwareException

releaseClampsContact

void releaseClampsContact()

Before rotating the carousel we have to release the power contact between the moving part and the fixed part.

engageClampsContact

void engageClampsContact()

After a rotation, when the carousel is stopped the power contact can be engaged again.