org.lsst.ccs.subsystems.fcs.drivers

Class CanOpenProxy

java.lang.Object

java.util.Observable

org.lsst.ccs.framework.Module

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

All Implemented Interfaces:

Serializable, Observer, org.lsst.ccs.framework.Configurable

public class CanOpenProxy
extends org.lsst.ccs.framework.Module

This Module starts a tcpip server, waits for the connection of a client whose name is the value of the field myClientName. This client is supposed to be a CanOpen C-wrapper. When the client starts it scans the can open network and send to the server some information on the can open nodes living on the network.

Author:

virieux

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CanOpenProxy.PDOStorage To store the values returned by the PDO.
protected static class	FcsTcpProxy.ClientContext

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

org.lsst.ccs.framework.Configurable.Environment

Field Summary

Fields

Modifier and Type	Field and Description
protected FcsTcpProxy.ClientContext	clientContext
PieceOfHardware[]	hardwareList
protected boolean	stopping

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

environment, log, name, nObserverThreads, registry, tickMillis

Constructor Summary

Constructors

Constructor and Description
CanOpenProxy(String aName, int aTickMillis, int portNumber, String aClientName, int expectedNodesNB, long hardwareBootTimeout)

Method Summary

Methods

Modifier and Type	Method and Description
Object	call(String clientName, String command) This methods send a command to the tcp client.
boolean	checkCanOpenNodeConfiguration(PieceOfHardware pieceOfHardware) When the hardware is booted and we have retrieve the information, we want to check for each piece of hardware that the node ID stored in the Configuration data base is the same than the node ID which is stored on the hardware with a switch : so we compare the serial number found on the can open bus for the piece of hardware node id with the serial number of the harwdare configuration.
boolean	checkCanOpenNodes()
String	configAsHeartbeatConsumer(int nodeID, int producerNodeID, int heartbeat_time) Configure a node as a hearbeat consumer.
String	configAsHeartbeatProducer(int nodeID, int heartbeat_time) Command to be used by the end users.
String	configAsHeartbeatProducer(String nodeID, String heartbeat_time) Configure a node as a hearbeat producer.
void	disconnectHardware() This methods stops the CWrapper client, and the TCP server.
int	getBootedNodesNB()
CanOpenNode	getDetectedNodeForSerialNumber(String aSerialNB) This method returns the can open detected on the can open network for a piece of hardware identified by its serial number.
int	getExpectedNodesNB()
long	getHardwareBootTimeout()
String	getMyClientName()
CanOpenProxy.PDOStorage	getPdoStorage()
int	getPortNumber()
void	identifieHardware() Identification of the hardware : we want to retrieve the information stored in the hardware of the booted nodes and update the array of nodes with this information.
String	initializeHardware()
void	initModule()
boolean	isBooted(PieceOfHardware piece)
boolean	isBooted(String aNodeID)
boolean	isHardwareIdentified()
boolean	isHardwareInitialized()
boolean	isHardwareReady() This method returns true if : all the hardware items are booted and identified and the hardware have the node ID expected within the configuration and the hardware is initialized.
boolean	isNodeIdBootedAndOK(PieceOfHardware piece) Check if a piece of hardware is booted and if its can open node ID is correct.
boolean	isReady(String clientName)
String	listHardware()
String	listNodes() List the can open nodes which are in the nodes table.
CanOpenProxy.PDOStorage	readPDOs() This method sends a sync command to the can open stack and returns the reply.
String	readSDO(int nodeID, String index, String subindex) Command to be used by the end user at the console in engineering mode.
String	readSDO(String nodeID, String index, String subindex) Read a SDO with the given index and subindex RETURNS the value read in hexa (String) if no error occured or returns the error code if a error was detected.
String	sendCanOpen(String command) For engineering mode, this method can be used to send Can Open commands to the Wrapper.
void	setExpectedNodesNB(int nodeNB)
void	setHardwareBootTimeout(int hardwareBootTimeout)
void	setHardwareBootTimeout(long hardwareBootTimeout)
void	setPortNumber(int portNumber)
void	shutdownNow()
void	startThreadReader() Starts a thread which read on the tcp socket, waiting for messages coming from tcp proxy.
void	stop()
void	tick()
String	writeSDO(int nodeID, String index, String subindex, int size, int value) Command to be used by the end user at the console.
String	writeSDO(String nodeID, String index, String subindex, String size, String value) Write a SDO request and send it to the can open stack, then analyses the response or throws an exception if the request failed.

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

alias, change, checkHardware, dropConfigurationContext, getCheckedValueFromConfiguration, getChildren, getContext, getModule, getName, getNObserverThreads, getObservables, getSubsystem, getTickMillis, init, listens, newConfigurationContext, notifyChange, notifyChangeWithoutPreliminaryChecks, processUpdate, publishData, publishData, publishData, publishData, publishData, publishData, publishData, register, removeLogPanicState, sendToReply, sendToStatus, setBeanName, setContext, setEnvironment, setHandlerLevel, setLogLevel, setName, setNObserverThreads, setObservables, setStateModularSubsystem, setStateModularSubsystem, setTickMillis, shutdownCommand, start, startTicking, 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, toString, wait, wait, wait

Field Detail

hardwareList

public PieceOfHardware[] hardwareList

stopping

protected volatile boolean stopping

clientContext

protected FcsTcpProxy.ClientContext clientContext

Constructor Detail

CanOpenProxy

public CanOpenProxy(String aName,
            int aTickMillis,
            int portNumber,
            String aClientName,
            int expectedNodesNB,
            long hardwareBootTimeout)

Method Detail

disconnectHardware

public void disconnectHardware()
                        throws InterruptedException

This methods stops the CWrapper client, and the TCP server. Then it starts a new TCP server for the next connection of the hardware.

Throws:

InterruptedException

getExpectedNodesNB

public int getExpectedNodesNB()

Returns:

the expectedNodesNB

setExpectedNodesNB

public void setExpectedNodesNB(int nodeNB)

Parameters:

expectedNodesNB - the expectedNodesNB to set

getHardwareBootTimeout

public long getHardwareBootTimeout()

setHardwareBootTimeout

@ConfigChanger
public void setHardwareBootTimeout(long hardwareBootTimeout)

setHardwareBootTimeout

@ConfigChanger
public void setHardwareBootTimeout(int hardwareBootTimeout)

getBootedNodesNB

public int getBootedNodesNB()

Returns:

the bootedNodesNB

getMyClientName

public String getMyClientName()

Returns:

the myClientName

getPdoStorage

public CanOpenProxy.PDOStorage getPdoStorage()

isHardwareIdentified

public boolean isHardwareIdentified()

isHardwareInitialized

public boolean isHardwareInitialized()

initModule

public void initModule()

tick

public void tick()

Overrides:

tick in class org.lsst.ccs.framework.Module

isBooted

public boolean isBooted(String aNodeID)

isBooted

public boolean isBooted(PieceOfHardware piece)

isNodeIdBootedAndOK

public boolean isNodeIdBootedAndOK(PieceOfHardware piece)

Check if a piece of hardware is booted and if its can open node ID is correct.

listNodes

public String listNodes()

List the can open nodes which are in the nodes table.

Returns:

the list of can open nodes and the information stored in this.nodes.

sendCanOpen

public String sendCanOpen(String command)
                   throws TimeoutException,
                          org.lsst.ccs.bus.BadCommandException

For engineering mode, this method can be used to send Can Open commands to the Wrapper. Test if the command is valid before sending it to the can open stack.

Parameters:

command - A Can Open command that the Wrapper should understand.

Returns:

the response from the Wrapper

Throws:

TimeoutException

org.lsst.ccs.bus.BadCommandException

writeSDO

public String writeSDO(String nodeID,
              String index,
              String subindex,
              String size,
              String value)
                throws SDORequestException

Write a SDO request and send it to the can open stack, then analyses the response or throws an exception if the request failed. The parameters are given in HEXA.

Parameters:

nodeID - FORMAT=HEXA

index - FORMAT=HEXA

subindex - FORMAT=HEXA

size - FORMAT=HEXA

value - FORMAT=HEXA

Returns:

"OK" if OK

Throws:

SDORequestException

writeSDO

public String writeSDO(int nodeID,
              String index,
              String subindex,
              int size,
              int value)
                throws SDORequestException,
                       org.lsst.ccs.bus.BadCommandException

Command to be used by the end user at the console. Write a SDO message and send it to the can open stack. The parameters are given in the following format:

Parameters:

nodeID - FORMAT=decimal

index - FORMAT=HEXA

subindex - FORMAT=HEXA

size - FORMAT=decimal

value - FORMAT=decimal

Returns:

Throws:

SDORequestException

org.lsst.ccs.bus.BadCommandException

readSDO

public String readSDO(String nodeID,
             String index,
             String subindex)
               throws SDORequestException

Read a SDO with the given index and subindex RETURNS the value read in hexa (String) if no error occured or returns the error code if a error was detected.

Throws:

SDORequestException

readSDO

public String readSDO(int nodeID,
             String index,
             String subindex)
               throws SDORequestException,
                      org.lsst.ccs.bus.BadCommandException

Command to be used by the end user at the console in engineering mode.

Parameters:

nodeID - FORMAT=decimal

index - FORMAT=hexa

subindex - FORMAT=hexa

Returns:

the value sent by the can open stack if the read SDO request succeded.

Throws:

SDORequestError

SDORequestException

org.lsst.ccs.bus.BadCommandException

readPDOs

public CanOpenProxy.PDOStorage readPDOs()
                                 throws HardwareException,
                                        org.lsst.ccs.bus.BadCommandException

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

Returns:

Throws:

HardwareException

org.lsst.ccs.bus.BadCommandException

identifieHardware

public void identifieHardware()
                       throws TimeoutException

Identification of the hardware : we want to retrieve the information stored in the hardware of the booted nodes and update the array of nodes with this information. The Can Open node ID is a main information to retrieve.

Throws:

TimeoutException

isHardwareReady

public boolean isHardwareReady()

This method returns true if : all the hardware items are booted and identified and the hardware have the node ID expected within the configuration and the hardware is initialized.

Returns:

a boolean

getDetectedNodeForSerialNumber

public CanOpenNode getDetectedNodeForSerialNumber(String aSerialNB)

This method returns the can open detected on the can open network for a piece of hardware identified by its serial number. It can return NULL if the Serial Number is not on the can open network.

Parameters:

aSerialNB -

Returns:

checkCanOpenNodes

public boolean checkCanOpenNodes()
                          throws org.lsst.ccs.bus.BadCommandException,
                                 ErrorInBootingHardwareProcessException,
                                 HardwareConfigurationException,
                                 HardwareNotDetectedException

Throws:

org.lsst.ccs.bus.BadCommandException

ErrorInBootingHardwareProcessException

HardwareConfigurationException

HardwareNotDetectedException

checkCanOpenNodeConfiguration

public boolean checkCanOpenNodeConfiguration(PieceOfHardware pieceOfHardware)
                                      throws org.lsst.ccs.bus.BadCommandException,
                                             HardwareConfigurationException,
                                             HardwareNotDetectedException

When the hardware is booted and we have retrieve the information, we want to check for each piece of hardware that the node ID stored in the Configuration data base is the same than the node ID which is stored on the hardware with a switch : so we compare the serial number found on the can open bus for the piece of hardware node id with the serial number of the harwdare configuration.

Returns:

Throws:

org.lsst.ccs.bus.BadCommandException

HardwareConfigurationException

HardwareNotDetectedException

listHardware

public String listHardware()

initializeHardware

public String initializeHardware()
                          throws org.lsst.ccs.bus.BadCommandException,
                                 Exception

Throws:

org.lsst.ccs.bus.BadCommandException

Exception

configAsHeartbeatProducer

public String configAsHeartbeatProducer(String nodeID,
                               String heartbeat_time)
                                 throws SDORequestException,
                                        TimeoutException,
                                        org.lsst.ccs.bus.BadCommandException

Configure a node as a hearbeat producer. Every heartbeat_time milliseconds this node will produce a message like: 0x700+nodeID: 05 - 1340268404.980000

Parameters:

nodeID - node ID in hexa

heartbeat_time - FORMAT=hexa UNIT=milliseconds

Throws:

SDORequestException

TimeoutException

org.lsst.ccs.bus.BadCommandException

configAsHeartbeatProducer

public String configAsHeartbeatProducer(int nodeID,
                               int heartbeat_time)
                                 throws SDORequestException,
                                        TimeoutException,
                                        org.lsst.ccs.bus.BadCommandException

Command to be used by the end users. Configure a node as a heartbeat producer. Parameters given in decimal format.

Parameters:

nodeID - FORMAT=decimal

heartbeat_time - FORMAT=decimal UNIT=milliseconds

Throws:

SDORequestException

TimeoutException

org.lsst.ccs.bus.BadCommandException

configAsHeartbeatConsumer

public String configAsHeartbeatConsumer(int nodeID,
                               int producerNodeID,
                               int heartbeat_time)
                                 throws SDORequestException,
                                        TimeoutException,
                                        org.lsst.ccs.bus.BadCommandException

Configure a node as a hearbeat consumer. Every heartbeat_time milliseconds this node will produce a message like: 0x700+nodeID: 05 - 1340268404.980000

Parameters:

nodeID - node ID in decimal

heartbeat_time - FORMAT=decimal UNIT=milliseconds

Throws:

SDORequestException

TimeoutException

org.lsst.ccs.bus.BadCommandException

getPortNumber

public int getPortNumber()

setPortNumber

public void setPortNumber(int portNumber)

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"

shutdownNow

public void shutdownNow()

Overrides:

shutdownNow in class org.lsst.ccs.framework.Module

stop

public void stop()

isReady

public boolean isReady(String clientName)

call

public Object call(String clientName,
          String command)
            throws TimeoutException,
                   CWrapperNotConnected

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

Throws:

TimeoutException

CWrapperNotConnected