org.lsst.ccs.subsystem.pathfinder

Class PathfinderSubsystem

java.lang.Object

org.lsst.ccs.Agent

org.lsst.ccs.Subsystem

org.lsst.ccs.subsystem.pathfinder.PathfinderSubsystem

All Implemented Interfaces:

EventListener, org.lsst.ccs.framework.HasLifecycle, org.lsst.ccs.messaging.CommandExecutor, org.lsst.ccs.ServiceLifecycle, org.lsst.ccs.services.alert.AlertListener

public class PathfinderSubsystem
extends org.lsst.ccs.Subsystem
implements org.lsst.ccs.framework.HasLifecycle, org.lsst.ccs.services.alert.AlertListener

The PathfinderSubsystem is designed specifically for running ComCam thermal and vacuum control,

Nested Class Summary

Nested classes/interfaces inherited from class org.lsst.ccs.Agent

org.lsst.ccs.Agent.RunningCommand

Field Summary

Fields inherited from class org.lsst.ccs.Agent

AGENT_HEARTBEAT_TASK, AGENT_RUNTIMEINFO_TASK, commandExecutorLock, currentAction, currentQueries, currentSignals, jvmShutdown, logBusHandler, stateService, treeComponentInitialized

Constructor Summary

Constructors

Constructor and Description
PathfinderSubsystem() Main constructor for the PathfinderSubsystem, normally invoked from the corresponding groovy file.

Method Summary

Modifier and Type	Method and Description
void	build()
void	clearLatch(int cond) Clears a latched condition.
void	enableAlertResponse(boolean enable)
List<String>	getFanNames() Gets the list of fan names.
VacSysState	getFullState() Gets the subsystem state.*
double	getHeaterLevel(int heaterId) Gets a heater level
double	getHeaterPowerFraction(int heaterId) Gets a heater power fraction of max allowed
List<String>	getSwitchNames() Gets the list of switch names.
VacSysState	getVacuumState() Gets the state of the Vacuum system.
double	getWaterValveControlCurrent() Get the water valve control current
void	init()
boolean	isAlertResponseEnabled()
boolean	isMonAlertEnabledVATShut()
void	onAlert(org.lsst.ccs.services.alert.AlertEvent event) Alert event handler.
void	postInit()
void	postStart()
void	setFanSpeed(String name, double speed) Sets a fan speed (using its name).
void	setFanState(String name, FanState state) Sets a fan state (using its name).
String	setHeater(int heaterId, double level) Sets a heater level
String	setHeaterPowerFraction(int heaterId, double powerFraction) Sets a heater level using the fraction of max allowed power
void	setMonAlertEnabledVATShut(boolean enable)
void	setNamedSwitchOn(String name, boolean on) Turns a named switch on or off.
void	setPower(int htr, double power) Sets a pathfinder heater power fraction value.
void	setSwitchOn(int sw, boolean on) Turns a switch on or off.
void	setTemperature(int htr, double temp) Sets a target pathfinder temperature value.
String	setTrimHeaterState(int htr, TrimHeaterOpState state) Sets a trim heater operation state.
void	setUpdatePeriod(int value) Sets the update period.
void	setWaterValveOpen(boolean openValve) Sets the state of the water valve
void	Sleep(double secs) Sleep - what a waste **************************************************************************

Methods inherited from class org.lsst.ccs.Subsystem

getLogHandler, getNumberCommandThreads, ping, printRunningCommands, setLogFormat, setLogHandlerLevel, setLogLevel, setStackTraceDepth

Methods inherited from class org.lsst.ccs.Agent

broadcastStatus, checkAllHardwareStopped, createHelper, executeCommandRequest, getAgentInfo, getAgentPersistenceService, getAgentService, getAgentServices, getCCSVersions, getCommandCount, getComponentConfigurationEnvironment, getComponentConfigurationEnvironmentByName, getComponentLookup, getCurrentAction, getDescription, getDistributionInfo, getEnvironmentLockService, getEnvironmentMessagingAccess, getLogger, getMessagingAccess, getName, getScheduler, getStatusBroadcastPeriod, helper, initAgent, internalCheckHardware, isConnectedToTheBuses, isInEngineeringMode, populateComponentLookup, preBuild, preInit, printComponentNodeTree, publishSubsystemDataOnStatusBus, sendAck, sendNack, sendStatusMessage, setAgentName, shutdownAgent, startAgent, vetoTransitionToNormalMode

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

postBuild, postShutdown, shutdown, start

Methods inherited from interface org.lsst.ccs.ServiceLifecycle

afterInit, afterStart, preShutdown, preStart

Constructor Detail

PathfinderSubsystem

public PathfinderSubsystem()

Main constructor for the PathfinderSubsystem, normally invoked from the corresponding groovy file.

Method Detail

init

public void init()

Specified by:

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

postInit

public void postInit()

Specified by:

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

build

public void build()

Specified by:

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

postStart

public void postStart()

Specified by:

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

Sleep

public void Sleep(double secs)

Sleep - what a waste **************************************************************************

getVacuumState

@Command(type=QUERY,
         description="Get the vacuum system state")
public VacSysState getVacuumState()

Gets the state of the Vacuum system.

Returns:

The vacuum state

getSwitchNames

@Command(type=QUERY,
         description="Get switch names")
public List<String> getSwitchNames()
                                                                                          throws VacuumException

Gets the list of switch names.

Returns:

The switch names.

Throws:

VacuumException

setSwitchOn

@Command(type=ACTION,
         description="Turn on/off a switch")
public void setSwitchOn(@Argument(description="The switch number")
                                                                                           int sw,
                                                                                           @Argument(description="Whether to turn on")
                                                                                           boolean on)
                                                                                    throws VacuumException

Turns a switch on or off.

Parameters:

sw - The switch number.

on - Whether to turn on or off

Throws:

VacuumException

setNamedSwitchOn

@Command(type=ACTION,
         description="Turn on/off a named switch")
public void setNamedSwitchOn(@Argument(description="The switch name")
                                                                                                      String name,
                                                                                                      @Argument(description="Whether to turn on")
                                                                                                      boolean on)
                                                                                               throws VacuumException

Turns a named switch on or off.

Parameters:

name - The switch name.

on - Whether to turn on or off

Throws:

VacuumException

clearLatch

@Command(type=ACTION,
         description="Clear a condition")
public void clearLatch(@Argument(description="The condition number")
                                                                                       int cond)
                                                                                throws VacuumException

Clears a latched condition.

Parameters:

cond - The condition number.

Throws:

VacuumException

setUpdatePeriod

@Command(type=ACTION,
         description="Set the update interval")
public void setUpdatePeriod(@Argument(description="The tick period (ms)")
                                                                                                  int value)

Sets the update period.

Parameters:

value - The update period (milliseconds) to set.

setHeater

@Command(type=ACTION,
         description="Sets the heater level")
public String setHeater(@Argument(description="heater ID")
                                                                                            int heaterId,
                                                                                            @Argument(description="heater level in mA (4-20)")
                                                                                            double level)
                                                                                     throws VacuumException

Sets a heater level

Parameters:

heaterId - The heater ID

level - The heater level in mA (4-20)

Returns:

message indicating actual heater level set

Throws:

VacuumException

setHeaterPowerFraction

@Command(type=ACTION,
         description="Sets the heater power level fraction")
public String setHeaterPowerFraction(@Argument(description="heater ID")
                                                                                                                        int heaterId,
                                                                                                                        @Argument(description="heater level fraction (0.0 to 1.0)")
                                                                                                                        double powerFraction)
                                                                                                                 throws VacuumException

Sets a heater level using the fraction of max allowed power

Parameters:

heaterId - The heater ID

level - The heater power fraction (0.0 to 1.0)

Returns:

message indicating actual heater level set

Throws:

VacuumException

setWaterValveOpen

@Command(type=ACTION,
         description="Sets the water valve open or close")
public void setWaterValveOpen(@Argument(description="true(open)/false(close)")
                                                                                                               boolean openValve)
                                                                                                        throws VacuumException

Sets the state of the water valve

Parameters:

heaterId - The heater ID

openValve - (true/false)

Throws:

VacuumException

getHeaterPowerFraction

@Command(type=ACTION,
         description="Gets the heater level")
public double getHeaterPowerFraction(@Argument(description="heater ID")
                                                                                                         int heaterId)
                                                                                                  throws VacuumException

Gets a heater power fraction of max allowed

Parameters:

heaterId - The heater ID

Returns:

level The heater power fraction of max allowed (0.0 to 1.0)

Throws:

VacuumException

getHeaterLevel

@Command(type=ACTION,
         description="Gets the heater level")
public double getHeaterLevel(@Argument(description="heater ID")
                                                                                                 int heaterId)
                                                                                          throws VacuumException

Gets a heater level

Parameters:

heaterId - The heater ID

Returns:

level The heater level (4-20)

Throws:

VacuumException

setTrimHeaterState

@Command(type=ACTION,
         description="Set a trim heater operation state")
public String setTrimHeaterState(int htr,
                                                                                                                 TrimHeaterOpState state)
                                                                                                          throws VacuumException

Sets a trim heater operation state.

Parameters:

htr - The heater number

state - The heater operation state to set: OFF, POWER or TEMP.

Returns:

message indicating success of state setting

Throws:

VacuumException

setTemperature

@Command(type=ACTION,
         description="Set a pathfinder temperature set point")
public void setTemperature(int htr,
                                                                                                                double temp)
                                                                                                         throws VacuumException

Sets a target pathfinder temperature value.

Parameters:

htr - The heater number

temp - The plate temperature set point.

Throws:

VacuumException

setPower

@Command(type=ACTION,
         description="Set a pathfinder heater power fraction")
public void setPower(int htr,
                                                                                                          double power)
                                                                                                   throws VacuumException

Sets a pathfinder heater power fraction value.

Parameters:

htr - The heater number

current - The heater power fraction

Throws:

VacuumException

getWaterValveControlCurrent

@Command(type=ACTION,
         description="Gets the VTC control current")
public double getWaterValveControlCurrent()
                                                                                                              throws VacuumException

Get the water valve control current

Returns:

VTC control current (4-20)

Throws:

VacuumException

enableAlertResponse

@Command(type=ACTION,
         description="Enable/disable alert response")
public void enableAlertResponse(boolean enable)

isAlertResponseEnabled

@Command(type=QUERY,
         description="Get true/false if the alert response is enabled")
public boolean isAlertResponseEnabled()

setMonAlertEnabledVATShut

@Command(type=ACTION,
         description="Enable/disable vacuum monitoring VAT shutting action")
public void setMonAlertEnabledVATShut(boolean enable)

isMonAlertEnabledVATShut

@Command(type=QUERY,
         description="Get true/false if the alert response is enabled")
public boolean isMonAlertEnabledVATShut()

onAlert

public void onAlert(org.lsst.ccs.services.alert.AlertEvent event)

Alert event handler. Resets PLC latch when corresponding alert is cleared.

Specified by:

onAlert in interface org.lsst.ccs.services.alert.AlertListener

Parameters:

event - The alert event

setFanState

@Command(type=ACTION,
         description="Set a fan control state")
public void setFanState(@Argument(description="The fan name")
                                                                                              String name,
                                                                                              @Argument(description="The control state")
                                                                                              FanState state)
                                                                                       throws VacuumException

Sets a fan state (using its name).

Parameters:

name - The fan name

state - The state to set

Throws:

VacuumException

setFanSpeed

@Command(type=ACTION,
         description="Set a fan speed")
public void setFanSpeed(@Argument(description="The fan name")
                                                                                      String name,
                                                                                      @Argument(description="The fan speed")
                                                                                      double speed)
                                                                               throws VacuumException

Sets a fan speed (using its name).

Parameters:

name - The fan name

speed - The fan speed

Throws:

VacuumException

getFullState

@Command(type=QUERY,
         description="Get the full state")
public VacSysState getFullState()

Gets the subsystem state.*

Returns:

The full PDU system state

getFanNames

@Command(type=QUERY,
         description="Get list of fan names")
public List<String> getFanNames()

Gets the list of fan names.

Returns:

The list of names