org.lsst.ccs.subsystem.refrig

Class ChillerSubsystem

java.lang.Object

org.lsst.ccs.Agent

org.lsst.ccs.Subsystem

org.lsst.ccs.subsystem.refrig.ChillerSubsystem

All Implemented Interfaces:

org.lsst.ccs.framework.HasLifecycle, org.lsst.ccs.messaging.AgentPresenceListener, org.lsst.ccs.messaging.CommandExecutor, org.lsst.ccs.messaging.MessageListener, org.lsst.ccs.messaging.StatusMessageListener, org.lsst.ccs.ServiceLifecycle

public class ChillerSubsystem
extends org.lsst.ccs.Subsystem
implements org.lsst.ccs.framework.HasLifecycle, org.lsst.ccs.messaging.StatusMessageListener, org.lsst.ccs.messaging.AgentPresenceListener

Implements the chiller subsystem.

Nested Class Summary

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

org.lsst.ccs.Agent.RunningCommand, org.lsst.ccs.Agent.ShutdownResult

Field Summary

Fields

Modifier and Type	Field and Description
protected String	coldplateChannelPath
protected String	listenTo
protected double	maxPressure
protected org.lsst.ccs.monitor.Monitor	mon
protected boolean	requireListening
protected double	temperatureTimeoutFactor

Fields inherited from class org.lsst.ccs.Agent

AGENT_DESCRIPTION, AGENT_RUNTIMEINFO_TASK, commandExecutorLock, currentAction, currentQueries, currentSignals, jvmShutdown, logBusHandler, treeComponentInitialized

Constructor Summary

Constructors

Constructor and Description
ChillerSubsystem() Constructor.

Method Summary

Modifier and Type	Method and Description
void	build() Build phase
void	clearAllPlcLatches() Clears all latched PLC conditions.
void	clearPlcLatch(String cond) Clears a (named) latched PLC condition.
void	connected(org.lsst.ccs.bus.data.AgentInfo... agents)
void	disconnected(org.lsst.ccs.bus.data.AgentInfo... agents)
void	enableChiller(boolean on) Enables/disables the chiller operation
ChillerControlState	getControlState() Gets the state of the chiller system.
List<String>	getPlcLatchNames() Gets the list of latched PLC condition names.
void	init() init() method
void	onStatusMessage(org.lsst.ccs.bus.messages.StatusMessage msg) If message is StatusSubsystemData from monitoring, search for Channel containing coldplate temperature data, and save data.
void	postStart() postStart (must follow Device.start())
void	quitControllingTemperature() Quit controlling temperature
String	setFlow(double flow) Set flow rate Command is accepted even if pumps are off, still setting flow setpoint.
void	setListenTo(String value) Select refrig subsystem to listen to for average coldplate temperature
void	setTankPressure(double value) Command to set chiller tank pressure
void	setTemperature(double temperature) Set chiller temperature and go there using default ramp
void	setTemperatureWithRamp(double temperature, double ramp) Set chiller temperature and go there using provided ramp rate
void	shutdown()
String	vetoTransitionToNormalMode() Veto transition to normal mode if Chiller state is not at setpoint, or if listening to thermal subsystem is required but not active.

Methods inherited from class org.lsst.ccs.Subsystem

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

Methods inherited from class org.lsst.ccs.Agent

createHelper, executeCommandRequest, getAgentInfo, getAgentPersistenceService, getAgentService, getAgentServices, getCommandCount, getComponentConfigurationEnvironment, getComponentConfigurationEnvironmentByName, getComponentLookup, getCurrentAction, getDescription, getEnvironmentLockService, getEnvironmentMessagingAccess, getLogger, getMessagingAccess, getName, getScheduler, helper, initAgent, initLogBusHandler, isInEngineeringMode, populateComponentLookup, preInit, preStart, printComponentNodeTree, publishSubsystemDataOnStatusBus, sendAck, sendNack, sendStatusMessage, setAgentName, shutdownAgent, shutdownAgent, startAgent

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, postInit, postShutdown, start

Methods inherited from interface org.lsst.ccs.messaging.AgentPresenceListener

connecting, disconnecting

Methods inherited from interface org.lsst.ccs.ServiceLifecycle

afterBuild, afterInit, afterStart, preBuild, preShutdown

Field Detail

mon

@LookupField(strategy=TREE)
protected org.lsst.ccs.monitor.Monitor mon

requireListening

@ConfigurationParameter(isFinal=true,
                        description="Require listening to thermal subsystem or equivalent for Normal mode",
                        units="unitless")
protected volatile boolean requireListening

listenTo

@ConfigurationParameter(isFinal=true,
                        description="Which refrig subsystem to listen to (RefrigAgentProperties)",
                        units="unitless")
protected volatile String listenTo

coldplateChannelPath

@ConfigurationParameter(isFinal=true,
                        description="path of coldplate temperature Channel to listen for",
                        units="unitless")
protected volatile String coldplateChannelPath

temperatureTimeoutFactor

@ConfigurationParameter(description="Factor on temperature-setting timeout",
                        range="1.0..1.4",
                        units="unitless")
protected volatile double temperatureTimeoutFactor

maxPressure

@ConfigurationParameter(isFinal=true,
                        description="Burst-disc presssure to stop flow",
                        units="psig")
protected volatile double maxPressure

Constructor Detail

ChillerSubsystem

public ChillerSubsystem()

Constructor.

Method Detail

build

public void build()

Build phase

Specified by:

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

init

public void init()

init() method

Specified by:

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

postStart

public void postStart()

postStart (must follow Device.start())

Specified by:

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

shutdown

public void shutdown()

Specified by:

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

setListenTo

@ConfigurationParameterChanger(propertyName="listenTo")
public void setListenTo(String value)

Select refrig subsystem to listen to for average coldplate temperature

Parameters:

String - value (case-insensitive)

vetoTransitionToNormalMode

public String vetoTransitionToNormalMode()

Veto transition to normal mode if Chiller state is not at setpoint, or if listening to thermal subsystem is required but not active.

Overrides:

vetoTransitionToNormalMode in class org.lsst.ccs.Agent

Returns:

String: null if not vetoed, explanation if vetoed

setTemperature

@Command(type=ACTION,
         level=1,
         name="setTemperature",
         autoAck=false,
         description="go to temperature setting using default ramp")
public void setTemperature(@Argument(description="tempeature in degrees")
                                                                                                                                                                                                double temperature)
                                                                                                                                                                                         throws org.lsst.ccs.drivers.commons.DriverException

Set chiller temperature and go there using default ramp

Parameters:

double - temperature in degrees

Throws:

org.lsst.ccs.drivers.commons.DriverException

setTemperatureWithRamp

@Command(type=ACTION,
         level=1,
         name="setTemperatureWithRamp",
         autoAck=false,
         description="go to temperature setting using provided ramp")
public void setTemperatureWithRamp(@Argument(description="tempeature in degrees")
                                                                                                                                                                                                                 double temperature,
                                                                                                                                                                                                                 @Argument(description="ramp in degrees/min")
                                                                                                                                                                                                                 double ramp)
                                                                                                                                                                                                          throws org.lsst.ccs.drivers.commons.DriverException

Set chiller temperature and go there using provided ramp rate

Parameters:

double - temperature in degrees

double - ramp in degrees/minute

Throws:

org.lsst.ccs.drivers.commons.DriverException

quitControllingTemperature

@Command(type=ACTION,
         level=1,
         name="quitControllingTemperature",
         description="stop controlling temperature")
public void quitControllingTemperature()
                                                                                                                                                                         throws org.lsst.ccs.drivers.commons.DriverException

Quit controlling temperature

Throws:

org.lsst.ccs.drivers.commons.DriverException

setFlow

@Command(type=ACTION,
         level=1,
         name="setFlow",
         description="set flow rate of chilled fluid")
public String setFlow(@Argument(description="flow rate in gpm")
                                                                                                                                              double flow)
                                                                                                                                       throws org.lsst.ccs.drivers.commons.DriverException

Set flow rate Command is accepted even if pumps are off, still setting flow setpoint.

Parameters:

double - flow Requested flow rate in gallons per minute

Returns:

String action taken

Throws:

org.lsst.ccs.drivers.commons.DriverException

setTankPressure

@Command(type=ACTION,
         level=1,
         name="setTankPressure",
         description="Set tank pressure in psig")
public void setTankPressure(@Argument(description="Tank pressure set value in psig")
                                                                                                                                                       double value)
                                                                                                                                                throws org.lsst.ccs.drivers.commons.DriverException

Command to set chiller tank pressure

Parameters:

value - Tank pressure setting (psig)

Throws:

org.lsst.ccs.drivers.commons.DriverException

onStatusMessage

public void onStatusMessage(org.lsst.ccs.bus.messages.StatusMessage msg)

If message is StatusSubsystemData from monitoring, search for Channel containing coldplate temperature data, and save data.

Specified by:

onStatusMessage in interface org.lsst.ccs.messaging.StatusMessageListener

connected

public void connected(org.lsst.ccs.bus.data.AgentInfo... agents)

Specified by:

connected in interface org.lsst.ccs.messaging.AgentPresenceListener

disconnected

public void disconnected(org.lsst.ccs.bus.data.AgentInfo... agents)

Specified by:

disconnected in interface org.lsst.ccs.messaging.AgentPresenceListener

getControlState

@Command(type=QUERY,
         description="Get the chiller state",
         level=0)
public ChillerControlState getControlState()

Gets the state of the chiller system. This is intended to be called by GUIs during initialization

Returns:

The thermal control state

enableChiller

@Command(type=ACTION,
         description="Enable or disable chiller operation")
public void enableChiller(boolean on)

Enables/disables the chiller operation

Parameters:

on - Whether enabling

getPlcLatchNames

@Command(type=QUERY,
         description="Get latched PLC condition names",
         level=0)
public List<String> getPlcLatchNames()

Gets the list of latched PLC condition names.

Returns:

The condition names.

clearPlcLatch

@Command(type=ACTION,
         description="Clear a latched PLC condition")
public void clearPlcLatch(@Argument(description="The condition name")
                                                                                                      String cond)
                                                                                               throws RefrigException

Clears a (named) latched PLC condition.

Parameters:

cond - The condition name.

Throws:

RefrigException

clearAllPlcLatches

@Command(type=QUERY,
         description="Clear all latched PLC conditions",
         level=0)
public void clearAllPlcLatches()

Clears all latched PLC conditions.