org.lsst.ccs.subsystems.fcs.drivers

Class CanOpenADC

java.lang.Object

java.util.Observable

org.lsst.ccs.framework.Module

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

org.lsst.ccs.subsystems.fcs.drivers.CanOpenADC

All Implemented Interfaces:

Observer, org.lsst.ccs.config.ConfigurationBulkChangeHandler, org.lsst.ccs.framework.Configurable, org.lsst.ccs.framework.HasLifecycle, org.lsst.ccs.framework.SignalHandler, ADCInterface, AlertRaiser, PieceOfHardware, org.lsst.ccs.UsesSubsystem

Direct Known Subclasses:

SimuCanOpenADC

public class CanOpenADC
extends CanOpenDevice
implements ADCInterface

This is the driver class for the ADC we use in the FCS test bench at APC and in SINGLE FILTER TEST CAN-CBX-AI814.

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
static double	adcVoltsPerBit One bit read on the input of the ADC represents 0.3125 mV
protected String	transmissionType The transmission types for the analogue inputs are described in the following: acyclic, synchronous: The transmission is initiated if a SYNC-message has been received (PDO- transmission type 0) and data has changed.
static double	waterFreezeTemp

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

errorHistory, errorRegister, inError, initialized, nodeID, serialNB, tcpProxy

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

name, nObserverThreads, tickMillis

Constructor Summary

Constructors

Constructor and Description
CanOpenADC(String nodeID, String serialNB, String transmissionType) Build a CanOpenADC with a CANopen node ID, a serial number and a transmission type.

Method Summary

Modifier and Type	Method and Description
void	initializeAndCheckHardware() This methods has to be overridden if there is some initialization to do for the device.
String	readAnalogInput(int inputNB) Read the analog input whom number is given as a parameter
double	readVoltage(int inputNB) Read the voltage at the ADC input inputNB on the ADC and returns the value in Volt
protected String	writeTransmissionTypeToDevice() This methods writes the transmission type given by the configuration to the device.

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

configAsHeartbeatConsumer, configAsHeartbeatProducer, configAsHeartbeatProducer, createStatusDataPublishedByCanOpenDevice, displayErrorHistory, displayErrorRegister, getErrorHistory, getErrorRegister, getNodeID, getSerialNB, getTcpProxy, initModule, isBooted, isInError, isInitialized, processUpdate, publishData, readErrorHistory, readErrorHistoryNames, readErrorRegister, readNumberOfErrors, readSDO, resetError, saveParameters, toString, writeSDO

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

getNObserverThreads, getObservables, getTickMillis, init, listens, sendSignal, sendSignalWithTimeLimit, setNObserverThreads, setObservables, setTickMillis, shutdownNow, 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.PieceOfHardware

checkBooted, checkInitialized, createStatusDataPublishedByHardware, printState

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

raiseAlarm, raiseAlarm, raiseAlarm, raiseAlarm, raiseWarning, 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, start, submitChange, submitChanges, validateBulkChange

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

setParameterBulk

Field Detail

adcVoltsPerBit

public static final double adcVoltsPerBit

One bit read on the input of the ADC represents 0.3125 mV

See Also:

Constant Field Values

waterFreezeTemp

public static final double waterFreezeTemp

See Also:

Constant Field Values

transmissionType

@ConfigurationParameter
protected String transmissionType

The transmission types for the analogue inputs are described in the following: acyclic, synchronous: The transmission is initiated if a SYNC-message has been received (PDO- transmission type 0) and data has changed. cyclic, synchronous: The transmission is initiated if a defined number of SYNC-messages have been received (PDO-transmission type 1...240). synchronous, remote request: The state of the inputs is latched with each SYNC-message and is transmitted after the reception of a RTR-frame (PDO-transmission type 252). asynchronous, remote request: After the reception of a RTR-frame the last latched state of the inputs is transmitted (PDO-transmission type 253). event controlled, asynchronous: The transmission is initiated if the state of selected inputs has changed (PDO-transmission type 254, 255).

Constructor Detail

CanOpenADC

public CanOpenADC(String nodeID,
                  String serialNB,
                  String transmissionType)

Build a CanOpenADC with a CANopen node ID, a serial number and a transmission type.

Parameters:

nodeID -

serialNB -

transmissionType -

Method Detail

readAnalogInput

@Command
public String readAnalogInput(int inputNB)

Read the analog input whom number is given as a parameter

Specified by:

readAnalogInput in interface ADCInterface

Parameters:

inputNB -

Returns:

the value read in hexa (on 16bits)

Throws:

SDORequestException

HardwareNotDetectedException

ShortResponseToSDORequestException

readVoltage

public double readVoltage(int inputNB)

Read the voltage at the ADC input inputNB on the ADC and returns the value in Volt

Specified by:

readVoltage in interface ADCInterface

Parameters:

inputNB - : integer from 1 to 8

Returns:

the value read in hexa (on 16bits)

Throws:

SDORequestException

HardwareNotDetectedException

ShortResponseToSDORequestException

initializeAndCheckHardware

@Command
public void initializeAndCheckHardware()

Description copied from class: CanOpenDevice

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

Specified by:

initializeAndCheckHardware in interface PieceOfHardware

Overrides:

initializeAndCheckHardware in class CanOpenDevice

writeTransmissionTypeToDevice

@Command
protected String writeTransmissionTypeToDevice()

This methods writes the transmission type given by the configuration to the device.

Returns:

a message

Throws:

FcsHardwareException