org.lsst.ccs.subsystems.fcs.simulation

Class SimuCanOpenProxy

java.lang.Object

java.util.Observable

org.lsst.ccs.framework.Module

org.lsst.ccs.subsystems.fcs.drivers.CanOpenProxy

org.lsst.ccs.subsystems.fcs.simulation.SimuCanOpenProxy

All Implemented Interfaces:

Observer, org.lsst.ccs.config.ConfigurationBulkChangeHandler, org.lsst.ccs.framework.ClearAlertHandler, org.lsst.ccs.framework.Configurable, org.lsst.ccs.framework.HardwareController, org.lsst.ccs.framework.HasLifecycle, org.lsst.ccs.framework.SignalHandler, AlertRaiser, TcpProxyInterface, org.lsst.ccs.UsesSubsystem

public class SimuCanOpenProxy
extends CanOpenProxy

Author:

virieux

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	FcsTcpProxy.ClientContext A class to handle the tcpip connexion.

Nested classes/interfaces inherited from class org.lsst.ccs.framework.Module

org.lsst.ccs.framework.Module.ValueUpdate

Nested classes/interfaces inherited from interface org.lsst.ccs.framework.ClearAlertHandler

org.lsst.ccs.framework.ClearAlertHandler.ClearAlertCode

Nested classes/interfaces inherited from interface org.lsst.ccs.framework.Configurable

org.lsst.ccs.framework.Configurable.Environment

Field Summary

Fields

Modifier and Type	Field and Description
protected FcsTcpProxy.ClientContext	clientContext
protected int	fieldBusTimeout
protected Condition	hardwareBooted
protected Lock	lock
protected int	portNumber
protected boolean	stopped
protected boolean	stopping
protected boolean	tcpServerStarted

Fields inherited from class org.lsst.ccs.subsystems.fcs.drivers.CanOpenProxy

bootingCompleted, hardwareList

Fields inherited from class org.lsst.ccs.framework.Module

name, nObserverThreads, tickMillis

Constructor Summary

Constructors

Constructor and Description
SimuCanOpenProxy(int portNumber, int fieldBusTimeout, String clientName, long hardwareBootTimeout)

Method Summary

Modifier and Type	Method and Description
Object	call(String clientName, String command) This methods send a command to the tcp client.
org.lsst.ccs.framework.TreeWalkerDiag	checkHardware() This method has to be tested on test benches.
String	getClientName() For simulation ONLY.
int	getPortNumber()
void	initModule()
boolean	isReady(String clientName)
boolean	isTcpServerStarted() returns true if this server is started.
PDOStorage	readPDOs() This method sends a sync command to the can open stack and returns the reply.
void	start()
void	startServer() Starts the server tcp on the port portNumber.
void	startThreadReader() Starts a thread which read on the tcp socket, waiting for messages coming from tcp proxy.
void	stopServer() Stops the tcp server.

Methods inherited from class org.lsst.ccs.subsystems.fcs.drivers.CanOpenProxy

canClearAlert, checkBootedCanOpenNodes, checkCanOpenCommand, checkHardwareID, checkNewHardware, checkNodeID, checkNumberOfBootedNodes, checkStarted, checkStopped, connectHardware, disconnectHardware, getBootedNodeBySerialNumber, getMyClientName, getNodeName, getPdoStorage, identifyHardware, initialize, isBooted, isCANDevicesReady, isHardwareIdentified, listBootedNodes, listHardwareNames, printBootedNodeBySerialNumber, printHardwareList, printHardwareState, printPDOStorage, processEmcyMessage, processResponseToReadSDO, processSDORequestError, publishData, publishHardwareData, publishHardwareData, readDevicesInfo, readSDO, readSDOCommand, sendCanOpenCommand, setCanOpenNodeNumbersOK, setHardwareBootProcessEnded, setHardwareIdentified, setHardwareList, shutdownNow, toString, updateDeviceInfo, writeSDO, writeSDO

Methods inherited from class org.lsst.ccs.framework.Module

getNObserverThreads, getObservables, getTickMillis, init, listens, processUpdate, sendSignal, sendSignalWithTimeLimit, setNObserverThreads, setObservables, setTickMillis, signal, startTicking, tick, update

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

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

raiseAlarm, raiseAlarm, raiseAlarm, raiseWarning, raiseWarning, raiseWarning

Methods inherited from interface org.lsst.ccs.UsesSubsystem

getComponentConfigurationEnvironment, getComponentLookup, getName, getSubsystem

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

change, dropSubmittedChanges, getChildren, getComponentByName, getEnvironment, getParent, getParentObject, getSubmittedChanges, isParameterConfigurable, postStart, printConfigurableParameters, setBulkParameter, submitChange, submitChanges, validateBulkChange

Methods inherited from interface org.lsst.ccs.config.ConfigurationBulkChangeHandler

setParameterBulk

Field Detail

portNumber

@ConfigurationParameter(isFinal=true,
                        range="1024..99000",
                        description="tcpip port number on which this tcpip server starts on.")
protected int portNumber

fieldBusTimeout

@ConfigurationParameter(description="Timeout in Millisecond. If a command sent to the CANbus doesn\'t respond during this amount of time, we considere that they could be an issue on the hardware.")
protected int fieldBusTimeout

stopped

protected volatile boolean stopped

stopping

protected volatile boolean stopping

tcpServerStarted

protected volatile boolean tcpServerStarted

clientContext

protected FcsTcpProxy.ClientContext clientContext

lock

protected final Lock lock

hardwareBooted

protected final Condition hardwareBooted

Constructor Detail

SimuCanOpenProxy

public SimuCanOpenProxy(int portNumber,
                        int fieldBusTimeout,
                        String clientName,
                        long hardwareBootTimeout)

Method Detail

initModule

public void initModule()

Overrides:

initModule in class CanOpenProxy

startServer

public void startServer()

Starts the server tcp on the port portNumber. And waits for a client connection.

startThreadReader

public void startThreadReader()

Starts a thread which read on the tcp socket, waiting for messages coming from tcp proxy. If the message has a known token (already registred in commandDispenser) it is a response to a can open command that we had sent to the proxy. If the token of the message is null, that means that is's an unsynchronous message coming from the can open stack and transmitted directly from the tcp proxy. That can be : - a boot message : "boot,nodeID" - an emergency message : "emcy,80+NodeID"

stopServer

public void stopServer()

Stops the tcp server.

checkHardware

public org.lsst.ccs.framework.TreeWalkerDiag checkHardware()
                                                    throws org.lsst.ccs.HardwareException

Description copied from class: CanOpenProxy

This method has to be tested on test benches. It should replace checkHardware.

Specified by:

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

Overrides:

checkHardware in class CanOpenProxy

Throws:

org.lsst.ccs.HardwareException

readPDOs

public PDOStorage readPDOs()

Description copied from class: CanOpenProxy

This method sends a sync command to the can open stack and returns the reply. example of sync reply we can receive : sync,23_1=25a7,23_2=113,23_3=10,23_4=109,23_5=108,23_6=104,23_7=101,23_8=112

Overrides:

readPDOs in class CanOpenProxy

Returns:

isTcpServerStarted

public boolean isTcpServerStarted()

returns true if this server is started.

Returns:

getPortNumber

public int getPortNumber()

getClientName

public String getClientName()

For simulation ONLY.

Returns:

start

public void start()

Specified by:

start in interface org.lsst.ccs.framework.Configurable

Specified by:

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

isReady

public boolean isReady(String clientName)

call

public Object call(String clientName,
                   String command)

This methods send a command to the tcp client. The command is a String and can be understood by the client. Example for a Can Open command : rsdo,1,1018,0 The command is stored in the command dispenser with a token and command corelation. When the response comes back from the proxy we can retrieve it from the dispenser with the call token.

Parameters:

clientName -

command -

Returns:

result of the call or null if the call failed