org.lsst.ccs.subsystems.fcs.drivers

Class CanOpenADC

java.lang.Object

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

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

All Implemented Interfaces:

ADCInterface, AlertRaiser, PieceOfHardware, EmergencyMessageListener

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

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 int	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

booted, errorHistory, errorRegister, inError, initialized, name, nodeID, s, serialNB, tcpProxy

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

alertSeparater

Constructor Summary

Constructors

Constructor and Description
CanOpenADC(int nodeID, String serialNB, int 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.
int	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
void	updatePDO() send a "sync" command to CANbus, process response and update pdoVal.
protected void	updateWithPDO(int cob_id, long pdoVal)
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, createStatusDataPublishedByCanOpenDevice, displayErrorHistory, displayErrorRegister, getAlertService, getErrorHistory, getErrorRegister, getName, getNodeID, getSerialNB, getSubsystem, getTcpProxy, isBooted, isInError, isInitialized, onEmergencyMessage, publishData, readErrorHistory, readErrorRegister, readNumberOfErrors, readSDO, readStringSerialNumber, resetError, saveParameters, setBooted, toString, writeSDO

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, checkId, checkInitialized, createStatusDataPublishedByHardware, printState, raiseAlarmIfMissing

Methods inherited from interface org.lsst.ccs.subsystems.fcs.drivers.EmergencyMessageListener

onFault, onFaultReset

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

clearAlarm, raiseAlarm, raiseAlarm, raiseAlarm, raiseAlarm, raiseAlarm, raiseAlarm, raiseWarning, raiseWarning, raiseWarning, raiseWarning, raiseWarning

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 int 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(int nodeID,
                  String serialNB,
                  int 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 int 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

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

updateWithPDO

protected void updateWithPDO(int cob_id,
                             long pdoVal)

updatePDO

@Command(type=QUERY,
         description="send a sync command to CANbus, process response and update pdoVal.")
public void updatePDO()
                                                                                                                               throws org.lsst.ccs.drivers.commons.DriverException

send a "sync" command to CANbus, process response and update pdoVal. a reply to a sync command should be : PDO1=xxx, PDO2=xxxx, PDO3=xxxxx etc...

Throws:

org.lsst.ccs.drivers.commons.DriverException