org.lsst.ccs.subsystem.shutter.statemachine

Class TopContext

java.lang.Object

org.lsst.ccs.subsystem.shutter.statemachine.TopContext

public final class TopContext
extends Object

The top-level context for the state machine. Thread-safe.

Author:

tether

Constructor Summary

Constructors

Constructor and Description
TopContext(Actions actions) Saves the action implementations for this context.

Method Summary

Modifier and Type	Method and Description
default void	calibDone(Channel<EventReply> chan, CalibDone cal) Indicates that a Hall calibration operation has been successful.
default void	calibrate(Channel<EventReply> chan, Calibrate cal) Requests a Hall calibration.
default void	changeAxisEnable(Channel<EventReply> chan, org.lsst.ccs.subsystem.motorplatform.bus.ChangeAxisEnable req) Requests that the enable state of the given axis be changed.
default void	changeBrakeState(Channel<EventReply> chan, Axis ax, ChangeBrakeState.State newState) Requests that the brake state on a given axis be changed.
default void	clearAllFaults(Channel<EventReply> chan, org.lsst.ccs.subsystem.motorplatform.bus.ClearAllFaults req) Requests that fault conditions be cleared for both axes.
default void	clearAxisFaults(Channel<EventReply> chan, org.lsst.ccs.subsystem.motorplatform.bus.ClearAxisFaults req) Requests that fault conditions be cleared for the given axis.
default void	closeShutter(Channel<EventReply> chan) Requests that a closing of the shutter be started.
default void	contactLost(Channel<EventReply> chan) Indicates that the subsystem can't communicate properly with the shutter PLC.
default void	disable(Channel<EventReply> chan) Indicates that the shutter hardware protection is forbidding shutter operation.
default void	disableAllAxes(Channel<EventReply> chan, org.lsst.ccs.subsystem.motorplatform.bus.DisableAllAxes req) Requests that both axes be disabled.
default void	enable(Channel<EventReply> chan) Indicates that the shutter hardware protection is is allowing shutter operation.
default void	enableAllAxes(Channel<EventReply> chan, org.lsst.ccs.subsystem.motorplatform.bus.EnableAllAxes req) Requests that both axes be enabled.
default void	error(Channel<EventReply> chan, Error err) Indicates that the shutter tried and failed to carry out a requested operation.
void	finish() Cleans up a context that's not in active use.
Actions	getActions() Obtains the set of action implementations owned by this context.
String	getName() Gets the name of this context.
org.lsst.ccs.subsystem.shutter.statemachine.State<C>	getState() Gets the current state of this context.
default void	gotoCenter(Channel<EventReply> chan) Requests that the shutter prepare for power-down by placing both blade sets in the center position.
default void	gotoProd(Channel<EventReply> chan) Requests that the shutter, if it's ready to do so, accept subsequent requests to take exposures.
default void	homeAxis(Channel<EventReply> chan, org.lsst.ccs.subsystem.motorplatform.bus.HomeAxis req) Requests that the shutter perform a homing operation for the given axis.
default void	ignored(Channel<EventReply> chan, Ignored.Reason reason) Indicates that the shutter PLC state machine has ignored an event sent to it.
void	init()
void	makeTransition(org.lsst.ccs.subsystem.shutter.statemachine.State<C> newState, Runnable action) Performs a state transition, calling the appropriate exit and entry methods while running the transition action in between.
default void	motionDone(Channel<EventReply> chan, MotionDonePLC mot) Indicates that a blade set has successfully completed a motion.
default void	moveAxisAbsolute(Channel<EventReply> chan, org.lsst.ccs.subsystem.motorplatform.bus.MoveAxisAbsolute req) Requests that the given axis be moved to a given absolute position.
default void	moveAxisRelative(Channel<EventReply> chan, org.lsst.ccs.subsystem.motorplatform.bus.MoveAxisRelative req) Requests that an axis change its position by a certain offset.
default void	openShutter(Channel<EventReply> chan) Requests that an opening of the shutter be started.
default void	plcIsDisabled(Channel<EventReply> chan) Indicates that shutter controller has sent a status message in which the reported state is Enabled.
default void	plcIsEnabled(Channel<EventReply> chan) Indicates that the shutter controller has sent a status message in which reported state is Disabled.
default void	reset(Channel<EventReply> chan) Requests that the shutter controller stop any motion in progress and reset its state machine to one of its initial states.
default void	resync(Channel<EventReply> chan) Triggers another attempt to synchronize states with the PLC.
default void	syncTimeout(Channel<EventReply> chan) Indicates that after a reset the PLC has taken too long to reach one of the designated after-reset states.
default void	takeExposure(Channel<EventReply> chan, Duration exposureTime) Requests that an exposure of the given duration be started.
default void	timer(Channel<EventReply> chan) Indicates that an exposure in progress has run for its allotted time.
default void	toggleSafetyCheck(Channel<EventReply> chan) Reverses the current setting of the PLC safety check flag, true->false, false->true.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TopContext

public TopContext(Actions actions)

Saves the action implementations for this context.

Parameters:

actions - The action implementations.

Throws:

NullPointerException - if the actions ref is null.

Method Detail

init

public void init()

getState

public final org.lsst.ccs.subsystem.shutter.statemachine.State<C> getState()

Gets the current state of this context.

Returns:

The current state.

getName

public String getName()

Gets the name of this context.

Returns:

the name string.

makeTransition

public final void makeTransition(org.lsst.ccs.subsystem.shutter.statemachine.State<C> newState,
                                 Runnable action)

Performs a state transition, calling the appropriate exit and entry methods while running the transition action in between.

Parameters:

newState - the next value for the current state.

action - The action, possibly null, associated with the transition.

Throws:

NullPointerException - if newState is null.

getActions

public final Actions getActions()

Obtains the set of action implementations owned by this context.

Returns:

finish

public void finish()

Cleans up a context that's not in active use. For example, resets the state to null.

contactLost

public void contactLost(Channel<EventReply> chan)
                 throws InterruptedException

Description copied from interface: Events

Indicates that the subsystem can't communicate properly with the shutter PLC.

Specified by:

contactLost in interface Events

Parameters:

chan - The channel used to deliver the event reply.

Throws:

InterruptedException - if inter-task communication is interrupted.

ignored

public void ignored(Channel<EventReply> chan,
                    Ignored.Reason reason)
             throws InterruptedException

Description copied from interface: Events

Indicates that the shutter PLC state machine has ignored an event sent to it.

Specified by:

ignored in interface Events

Parameters:

chan - The channel used to deliver the event reply.

reason - The reason why the event was rejected.

Throws:

InterruptedException - if inter-task communication is interrupted.

homeAxis

public void homeAxis(Channel<EventReply> chan,
                     org.lsst.ccs.subsystem.motorplatform.bus.HomeAxis req)
              throws InterruptedException

Description copied from interface: Events

Requests that the shutter perform a homing operation for the given axis.

Specified by:

homeAxis in interface Events

Parameters:

chan - The channel used to deliver the event reply.

req - Contains the request parameters. If null then the event is rejected.

Throws:

InterruptedException - if inter-task communication is interrupted.

plcIsEnabled

public void plcIsEnabled(Channel<EventReply> chan)
                  throws InterruptedException

Description copied from interface: Events

Indicates that the shutter controller has sent a status message in which reported state is Disabled. This event is ignored save when synchronizing the subsystem state and the PLC state. At other times we rely on explicit enable() and disable() event messages sent from the controller.

Specified by:

plcIsEnabled in interface Events

Parameters:

chan - The channel used to deliver the event reply.

Throws:

InterruptedException - if inter-task communication is interrupted.

plcIsDisabled

public void plcIsDisabled(Channel<EventReply> chan)
                   throws InterruptedException

Description copied from interface: Events

Indicates that shutter controller has sent a status message in which the reported state is Enabled. At other times we rely on explicit enable() and disable() event messages sent from the controller.

Specified by:

plcIsDisabled in interface Events

Parameters:

chan - The channel used to deliver the event reply.

Throws:

InterruptedException - if inter-task communication is interrupted.

resync

public void resync(Channel<EventReply> chan)
            throws InterruptedException

Description copied from interface: Events

Triggers another attempt to synchronize states with the PLC.

Specified by:

resync in interface Events

Parameters:

chan - The channel used to deliver the event reply.

Throws:

InterruptedException - if inter-task communication is interrupted.

syncTimeout

public void syncTimeout(Channel<EventReply> chan)
                 throws InterruptedException

Description copied from interface: Events

Indicates that after a reset the PLC has taken too long to reach one of the designated after-reset states.

Specified by:

syncTimeout in interface Events

Parameters:

chan - The channel used to deliver the event reply.

Throws:

InterruptedException - if inter-task communication is interrupted.

enable

public void enable(Channel<EventReply> chan)
            throws InterruptedException

Description copied from interface: Events

Indicates that the shutter hardware protection is is allowing shutter operation.

Specified by:

enable in interface Events

Parameters:

chan - The channel used to deliver the event reply.

Throws:

InterruptedException - if inter-task communication is interrupted.

disable

public void disable(Channel<EventReply> chan)
             throws InterruptedException

Description copied from interface: Events

Indicates that the shutter hardware protection is forbidding shutter operation.

Specified by:

disable in interface Events

Parameters:

chan - The channel used to deliver the event reply.

Throws:

InterruptedException - if inter-task communication is interrupted.

motionDone

public void motionDone(Channel<EventReply> chan,
                       MotionDonePLC mot)
                throws InterruptedException

Description copied from interface: Events

Indicates that a blade set has successfully completed a motion.

Specified by:

motionDone in interface Events

Parameters:

chan - The channel used to deliver the event reply.

mot - The motion profile.

Throws:

InterruptedException - if inter-task communication is interrupted.

calibrate

public void calibrate(Channel<EventReply> chan,
                      Calibrate cal)
               throws InterruptedException

Description copied from interface: Events

Requests a Hall calibration.

Specified by:

calibrate in interface Events

Parameters:

chan - The channel used to deliver the event reply.

cal - The calibration parameters. If null the event is rejected.

Throws:

InterruptedException - if inter-task communication is interrupted.

toggleSafetyCheck

public void toggleSafetyCheck(Channel<EventReply> chan)
                       throws InterruptedException

Description copied from interface: Events

Reverses the current setting of the PLC safety check flag, true->false, false->true. Note that the flag will be reset to true after any motion completes or after a general reset. Any motion that takes place with the flag set to false is limited in speed to at most 1 mm/sec.

Specified by:

toggleSafetyCheck in interface Events

Parameters:

chan - The channel used to deliver the event reply.

Throws:

InterruptedException - if inter-task communication is interrupted.

calibDone

public void calibDone(Channel<EventReply> chan,
                      CalibDone cal)
               throws InterruptedException

Description copied from interface: Events

Indicates that a Hall calibration operation has been successful.

Specified by:

calibDone in interface Events

Parameters:

chan - The channel used to deliver the event reply.

cal - The results of the calibration.

Throws:

InterruptedException - if inter-task communication is interrupted.

error

public void error(Channel<EventReply> chan,
                  Error err)
           throws InterruptedException

Description copied from interface: Events

Indicates that the shutter tried and failed to carry out a requested operation.

Specified by:

error in interface Events

Parameters:

chan - The channel used to deliver the event reply.

err - The error message received from the shutter.

Throws:

InterruptedException - if inter-task communication is interrupted.

reset

public void reset(Channel<EventReply> chan)
           throws InterruptedException

Description copied from interface: Events

Requests that the shutter controller stop any motion in progress and reset its state machine to one of its initial states.

Specified by:

reset in interface Events

Parameters:

chan - The channel used to deliver the event reply.

Throws:

InterruptedException - if inter-task communication is interrupted.

takeExposure

public void takeExposure(Channel<EventReply> chan,
                         Duration exposureTime)
                  throws InterruptedException

Description copied from interface: Events

Requests that an exposure of the given duration be started.

Specified by:

takeExposure in interface Events

Parameters:

chan - The channel used to deliver the event reply.

exposureTime - The length of the exposure. If null or too short a duration the event is rejected.

Throws:

InterruptedException - if inter-task communication is interrupted.

openShutter

public void openShutter(Channel<EventReply> chan)
                 throws InterruptedException

Description copied from interface: Events

Requests that an opening of the shutter be started. Rejected if the shutter is not closed.

Specified by:

openShutter in interface Events

Parameters:

chan - The channel used to deliver the event reply.

Throws:

InterruptedException - if inter-task communication is interrupted.

timer

public void timer(Channel<EventReply> chan)
           throws InterruptedException

Description copied from interface: Events

Indicates that an exposure in progress has run for its allotted time.

Specified by:

timer in interface Events

Parameters:

chan - The channel used to deliver the event reply.

Throws:

InterruptedException - if inter-task communication is interrupted.

closeShutter

public void closeShutter(Channel<EventReply> chan)
                  throws InterruptedException

Description copied from interface: Events

Requests that a closing of the shutter be started. Rejected if the shutter is not open.

Specified by:

closeShutter in interface Events

Parameters:

chan - The channel used to deliver the event reply.

Throws:

InterruptedException - if inter-task communication is interrupted.

gotoProd

public void gotoProd(Channel<EventReply> chan)
              throws InterruptedException

Description copied from interface: Events

Requests that the shutter, if it's ready to do so, accept subsequent requests to take exposures.

Specified by:

gotoProd in interface Events

Parameters:

chan - The channel used to deliver the event reply.

Throws:

InterruptedException - if inter-task communication is interrupted.

gotoCenter

public void gotoCenter(Channel<EventReply> chan)
                throws InterruptedException

Description copied from interface: Events

Requests that the shutter prepare for power-down by placing both blade sets in the center position.

Specified by:

gotoCenter in interface Events

Parameters:

chan - The channel used to deliver the event reply.

Throws:

InterruptedException - if inter-task communication is interrupted.

moveAxisAbsolute

public void moveAxisAbsolute(Channel<EventReply> chan,
                             org.lsst.ccs.subsystem.motorplatform.bus.MoveAxisAbsolute req)
                      throws InterruptedException

Description copied from interface: Events

Requests that the given axis be moved to a given absolute position.

Specified by:

moveAxisAbsolute in interface Events

Parameters:

chan - The channel used to deliver the event reply.

req - Contains the request parameters. If null then the event is rejected.

Throws:

InterruptedException - if inter-task communication is interrupted.

moveAxisRelative

public void moveAxisRelative(Channel<EventReply> chan,
                             org.lsst.ccs.subsystem.motorplatform.bus.MoveAxisRelative req)
                      throws InterruptedException

Description copied from interface: Events

Requests that an axis change its position by a certain offset.

Specified by:

moveAxisRelative in interface Events

Parameters:

chan - The channel used to deliver the event reply.

req - Contains the request parameters. If null then event is rejected.

Throws:

InterruptedException - if inter-task communication is interrupted.

clearAllFaults

public void clearAllFaults(Channel<EventReply> chan,
                           org.lsst.ccs.subsystem.motorplatform.bus.ClearAllFaults req)
                    throws InterruptedException

Description copied from interface: Events

Requests that fault conditions be cleared for both axes.

Specified by:

clearAllFaults in interface Events

Parameters:

chan - The channel used to deliver the event reply.

req - Contains the request parameters. If null then the event is rejected.

Throws:

InterruptedException - if inter-task communication is interrupted.

changeAxisEnable

public void changeAxisEnable(Channel<EventReply> chan,
                             org.lsst.ccs.subsystem.motorplatform.bus.ChangeAxisEnable req)
                      throws InterruptedException

Description copied from interface: Events

Requests that the enable state of the given axis be changed.

Specified by:

changeAxisEnable in interface Events

Parameters:

chan - The channel used to deliver the event reply.

req - Contains the request parameters. If null then the event is rejected.

Throws:

InterruptedException - if inter-task communication is interrupted.

changeBrakeState

public void changeBrakeState(Channel<EventReply> chan,
                             Axis ax,
                             ChangeBrakeState.State newState)
                      throws InterruptedException

Description copied from interface: Events

Requests that the brake state on a given axis be changed.

Specified by:

changeBrakeState in interface Events

Parameters:

chan - The channel used to deliver the event reply.

ax - The PLC task axis to affect.

newState - The desired brake state.

Throws:

InterruptedException - if inter-task communication is interrupted.

clearAxisFaults

public void clearAxisFaults(Channel<EventReply> chan,
                            org.lsst.ccs.subsystem.motorplatform.bus.ClearAxisFaults req)
                     throws InterruptedException

Description copied from interface: Events

Requests that fault conditions be cleared for the given axis.

Specified by:

clearAxisFaults in interface Events

Parameters:

chan - The channel used to deliver the event reply.

req - Contains the request parameters. If null then the event is rejected.

Throws:

InterruptedException - if inter-task communication is interrupted.

enableAllAxes

public void enableAllAxes(Channel<EventReply> chan,
                          org.lsst.ccs.subsystem.motorplatform.bus.EnableAllAxes req)
                   throws InterruptedException

Description copied from interface: Events

Requests that both axes be enabled.

Specified by:

enableAllAxes in interface Events

Parameters:

chan - The channel used to deliver the event reply.

req - Contains the request parameters. If null then event is rejected.

Throws:

InterruptedException - if inter-task communication is interrupted.

disableAllAxes

public void disableAllAxes(Channel<EventReply> chan,
                           org.lsst.ccs.subsystem.motorplatform.bus.DisableAllAxes req)
                    throws InterruptedException

Description copied from interface: Events

Requests that both axes be disabled.

Specified by:

disableAllAxes in interface Events

Parameters:

chan - The channel used to deliver the event reply.

req - Contains the request parameters. If null then the event is rejected.

Throws:

InterruptedException - if inter-task communication is interrupted.