org.lsst.ccs.subsystems.fcs.drivers

Class CanOpenDevice

java.lang.Object

java.util.Observable

org.lsst.ccs.framework.Module

org.lsst.ccs.subsystems.fcs.drivers.CanOpenDevice

All Implemented Interfaces:

Observer, org.lsst.ccs.framework.Configurable, org.lsst.ccs.framework.SignalHandler, PieceOfHardware

Direct Known Subclasses:

CanOpenADC, CanOpenDAC, CanOpenDigitaxVariator, CanOpenEPOS

public class CanOpenDevice
extends org.lsst.ccs.framework.Module
implements PieceOfHardware

Author:

virieux

Nested Class Summary

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 static org.lsst.ccs.utilities.logging.Logger	fcslog

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

environment, log, name, nObserverThreads, registry, tickMillis

Constructor Summary

Constructors

Constructor and Description
CanOpenDevice(String aName, int aTickMillis, String nodeID, String serialNB)

Method Summary

Modifier and Type	Method and Description
String	displayErrorHistory()
String	displayErrorRegister()
String	getNodeID()
String	getSerialNB()
String	initializeHardware() This methods has to be overridden if there is some initialization to do for the device.
void	initModule()
boolean	isInitalized()
boolean	isNodeIdBootedAndOK()
String[]	readErrorHistory() The error history holds errors that have occurred on the device and have been signalled via the emergency object.
String	readErrorRegister() At index 1001 there deviceErrorFile an error register for the device.
int	readNumberOfErrors() Extract from the Maxon Motor firmware specification : Contains the number of actual errors that are recorded in the array starting at subindex 1.
String	readSDO(String index, String subindex)
String	toString()
String	writeSDO(String index, String subindex, String length, String newValue)

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

alias, change, dropConfigurationContext, getCheckedValueFromConfiguration, getChildren, getComponentByName, getComponentDictionariesTree, getComponentTree, getContext, getDictionary, getEnvironment, getMainDictionary, getModule, getName, getNObserverThreads, getObservables, getParent, getSubsystem, getTickMillis, init, injectResources, listens, newConfigurationContext, notifyChange, notifyChangeWithoutPreliminaryChecks, percolateSignal, processUpdate, publish, publish, publish, publish, publish, publish, publishData, publishData, publishData, publishData, publishData, publishData, publishData, register, sendSignal, sendSignal, sendToReply, sendToStatus, setBeanName, setContext, setEnvironment, setName, setNObserverThreads, setObservables, setStateModularSubsystem, setStateModularSubsystem, setTickMillis, shutdownCommand, shutdownNow, signal, start, 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.PieceOfHardware

getName

Field Detail

fcslog

protected static final org.lsst.ccs.utilities.logging.Logger fcslog

Constructor Detail

CanOpenDevice

public CanOpenDevice(String aName,
                     int aTickMillis,
                     String nodeID,
                     String serialNB)

Method Detail

getSerialNB

public String getSerialNB()

Specified by:

getSerialNB in interface PieceOfHardware

getNodeID

public String getNodeID()

Specified by:

getNodeID in interface PieceOfHardware

isNodeIdBootedAndOK

public boolean isNodeIdBootedAndOK()

Specified by:

isNodeIdBootedAndOK in interface PieceOfHardware

Returns:

true If this piece of hardware is booted and the nodeID on the hardware is the same than the one in the Configuration DB.

isInitalized

public boolean isInitalized()

Specified by:

isInitalized in interface PieceOfHardware

Returns:

true if the hardware has been initialized with success, false otherwise.

initModule

public void initModule()

Overrides:

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

initializeHardware

public String initializeHardware()
                          throws Exception

This methods has to be overridden if there is some initialization to do for the device.

Specified by:

initializeHardware in interface PieceOfHardware

Returns:

a message

Throws:

Exception

writeSDO

@Command(type=ACTION,
         level=3,
         description="Write on the Can Open Device with a command wsdo.")
public String writeSDO(String index,
                                                                                                                                         String subindex,
                                                                                                                                         String length,
                                                                                                                                         String newValue)
                                                                                                                                  throws SDORequestException

Throws:

SDORequestException

readSDO

@Command(type=QUERY,
         level=3,
         description="Reads the Can Open Device with a command rsdo.")
public String readSDO(String index,
                                                                                                                                    String subindex)
                                                                                                                             throws SDORequestException,
                                                                                                                                    ShortResponseToSDORequestException

Throws:

SDORequestException

ShortResponseToSDORequestException

readErrorRegister

public String readErrorRegister()
                         throws SDORequestException,
                                ShortResponseToSDORequestException

At index 1001 there deviceErrorFile an error register for the device. The device maps internal errors in this byte.

Returns:

error code in Hexa

Throws:

SDORequestException

ShortResponseToSDORequestException

displayErrorRegister

public String displayErrorRegister()
                            throws SDORequestException,
                                   ShortResponseToSDORequestException

Throws:

SDORequestException

ShortResponseToSDORequestException

readErrorHistory

public String[] readErrorHistory()
                          throws SDORequestException,
                                 ShortResponseToSDORequestException

The error history holds errors that have occurred on the device and have been signalled via the emergency object. This methods reads the Maxon Motor Error History and returns an array of error code.

Returns:

errors : a list of device error code

Throws:

SDORequestException

ShortResponseToSDORequestException

displayErrorHistory

public String displayErrorHistory()
                           throws SDORequestException,
                                  ShortResponseToSDORequestException

Throws:

SDORequestException

ShortResponseToSDORequestException

readNumberOfErrors

public int readNumberOfErrors()
                       throws SDORequestException,
                              ShortResponseToSDORequestException

Extract from the Maxon Motor firmware specification : Contains the number of actual errors that are recorded in the array starting at subindex 1. Writing a “0” deletes the error history (empties the array). Values higher then “0” (zero) are not allowed to write." Read and returns the number of errors registred in the Error History

Throws:

SDORequestException

ShortResponseToSDORequestException

toString

public String toString()

Overrides:

toString in class Object