org.lsst.ccs.subsystems.fcs.simulation

Class SimuCarouselController

java.lang.Object

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

org.lsst.ccs.subsystems.fcs.drivers.CanOpenEPOS

org.lsst.ccs.subsystems.fcs.drivers.CanOpenEPOSCarousel

org.lsst.ccs.subsystems.fcs.simulation.SimuCarouselController

All Implemented Interfaces:

org.lsst.ccs.framework.HasLifecycle, AlertRaiser, EPOSController, EPOSControllerForCarousel, NamedComponent, PieceOfHardware, EmergencyMessageListener

public class SimuCarouselController
extends CanOpenEPOSCarousel
implements EPOSControllerForCarousel

To simulate the controller which rotates carousel.

Author:

virieux

Field Summary

Fields

Modifier and Type	Field and Description
protected int	actualCurrent
protected int	ssiPosition
protected int	targetCurrent
protected int	targetPosition

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

cobid1, cobid2, positionSensorType

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

current, eposState, followingError, mode, parametersOK, position, simuEnabled, statusWord, velocity

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

booted, dataProviderDictionaryService, errorHistory, errorRegister, inError, initialized, lastErrorCode, lastErrorName, name, nodeID, serialNB, subs, tcpProxy

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

alertSeparator

Constructor Summary

Constructors

Constructor and Description
SimuCarouselController() Build a new SimuCarouselController

Method Summary

Modifier and Type	Method and Description
void	build()
void	checkFault() Check if the Controller is in fault.
void	checkParameters(EPOSEnumerations.EposMode aMode) For every parameter to be defined for this mode this method compares the values in configuration with the value stored in controller CPU and throws a FcsHardwareException if these values are not equal.
void	defineAbsolutePosition(int position) Defines the actual position as the absolute position which value is given as an argument.
String	displayErrorHistory() Read error history on the device and return its String representation.
int	getErrorHistoryNB() Return the number of errors that occured on this controller.
void	goToSwitchOnDisabled()
void	init()
boolean	isParametersOK() We assum that simulated hardware'subs controller has always correct parameters.
boolean	isTargetReached() overriden for simulation
void	quickStop() Send a quickStop command to the controller.
int	readCurrent() In Current Mode this methods returns the current actualy received by the motor.
int	readErrorRegister() Read Error Register on the controller (index 1001).
EPOSEnumerations.EposMode	readMode() Reads the EPOS mode in the CPU of the EPOS device, updates the field mode and returns the mode as a String.
long	readParameter(EPOSEnumerations.Parameter parameter) Reads in the EPOS CPU the value of the Parameter.
String	readParameters(EPOSEnumerations.EposMode mode) Read all the value of parameters for a given EPOS mode and return a printed list of this values.
int	readPosition() Reads in the CPU the value of the parameter PositionActualValue and returns it in a decimal format.
int	readSSIPosition() Read the position returned by the absolute encoder (single serial data).
int	readStatusWord() Read the status word (index=6041, subindex=0,size=2)
void	setPosition(int actualPosition) set a position for simulation
void	setPositionSensorTypeEncoderSSI() Set PositionSensorType to Absolute encoder SSI (value=4)
void	setPositionSensorTypeSinusIncrementalEncoder() Set PositionSensorType to Sinus Incremental Encoder(value=8)
void	setSsiPosition(int ssiPosition) To initialize a simulated ssiPosition.
void	simulatePosition(int pos) set controller position in PDOData to simulate a carousel position.
void	simulateStatusWord(int sw) set carouselController statusWord in PDOData to simulate a statusWord.
void	simulateSWITCH_ON_DISABLED()
void	stopAction() Stop action and shutdownController(shutdown) controller.
void	updateErrorHistory() read error history on the device and update error history fields : errorHistory, lastErrorCode, lastErrorName.
void	updateFakePDOData(int cobid, long newPdo) Update PDOdata
void	writeControlWord(int w) Write a value in the control word (index=6040, subindex=0,size=2)
void	writeCurrent(int aValue) In unsCurrent mode this methods send a unsCurrent to the motor.
void	writeParameter(EPOSEnumerations.Parameter param, int value) This method writes a parameter in the CPU of the EPOS.
void	writeParameters(EPOSEnumerations.EposMode mode) This methods writes in the CPU of the EPOS devis the values of the parameters set for the mode.
void	writeParameters(Map<String,Integer> paramMap) Write to the CPU of the EPOS a map of parameters.
void	writeTargetPosition(int absolutePosition) This methods does nothing but save the relativePosition given as argument.

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

doInitializePDOs, extractCurrentAverage, extractFollowingError, extractPosition, extractStatusWord, extractVelocity, faultReset, getCobid1, getCobid2, getPdo1, getPdo2, getPositionSensorType, getStatusWord, printValuesUpdatedByPDOs, setPdo1, setPdo2, setPositionSensorType, updateFromPDO, updateStatusWord

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

changeEPOSParameter, changeMode, changeProfileVelocity, checkParameters, getCurrent, getEposState, getFollowingError, getMode, getPosition, getVelocity, initializeAndCheckHardware, isInError, printControlWord, publishData, readControlWord, readCurrentAverageValue, readFollowingError, readVelocity, restoreParameters, setCurrent, setEposState, setVelocity

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

configAsHeartbeatConsumer, configAsHeartbeatProducer, createStatusDataPublishedByCanOpenDevice, displayError, displayErrorRegister, getAlertService, getErrorHistory, getErrorRegister, getLastErrorCode, getLastErrorName, getName, getNodeID, getSerialNB, getSubsystem, getTcpProxy, isBooted, isInitialized, onEmergencyMessage, printSerialNumber, readDeviceType, readNumberOfErrors, readSDO, resetError, saveParameters, setBooted, toString, updateDeviceInfo, writeSDO, writeTransmissionTypeToDevice

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

checkPositionSensorType, doSetEncoderSSI, doSetSinusIncrementalEncoder, getPositionSensorType, setPositionSensorType

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

changeMode, changeProfileVelocity, checkEposMode, checkHomingDone, checkState, checkTargetReached, convertEPOSValue, createStatusDataPublishedByEPOSController, defineHomingCurrentThresholdNegativeSpeed, definePositionFromNegativeLimitSwitch, disableOperation, disableVoltage, enable, enableAndWriteAbsolutePosition, enableAndWriteCurrent, enableAndWriteRelativePosition, faultReset, getCurrent, getEposState, getErrorRegister, getLastErrorCode, getLastErrorName, getMode, getPosition, getStatusWord, getVelocity, goToOperationEnable, isEnabled, isFault, isInError, isInMode, isInState, isOperationEnabled, isQuickstop, isReadyToSwitchOn, isSwitchedOn, isSwitchOnDisabled, printStatusWordInBinary, readControllerStructure, readControlWord, readCurrentAverageValue, readFollowingError, readHomingMethod, readParameter, readParameters, readParameters, readPositionSensorType, readProfileVelocity, readVelocity, setCurrent, setEposState, setVelocity, shutdownController, stopPosition, stopVelocity, switchOnEnableOperation, updateEposState, updateEposState, updatePositionFromSDO, updateStatusWord, writeParameters

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

checkBooted, checkId, checkInitialized, createStatusDataPublishedByHardware, doInitializePDOs, getName, getNodeID, getSerialNB, initializeAndCheckHardware, initializePDOs, isBooted, isInitialized, printState, publishData, raiseAlarmIfMissing, raiseWarningIfMissing, readDeviceType, setBooted, updateDeviceInfo, updateFromPDO

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

onEmergencyMessage, onFault, onFaultReset

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

clearAlarm, getAlertSeparator, getAlertService, getSubsystem, raiseAlarm, raiseAlarm, raiseAlarm, raiseAlarm, raiseAlarmOnlyIfNew, raiseAlertOnlyEveryTenMinutes, raiseAlertOnlyEveryTenMinutes, raiseAlertOnlyIfNew, raiseWarning, raiseWarning, raiseWarning, raiseWarning, raiseWarningOnlyEveryTenMinutes, raiseWarningOnlyIfNew

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

postBuild, postInit, postShutdown, postStart, shutdown, start

Field Detail

targetPosition

protected int targetPosition

ssiPosition

protected int ssiPosition

targetCurrent

protected int targetCurrent

actualCurrent

protected int actualCurrent

Constructor Detail

SimuCarouselController

public SimuCarouselController()

Build a new SimuCarouselController

Method Detail

init

public void init()

Specified by:

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

Overrides:

init in class CanOpenEPOSCarousel

build

public void build()

Specified by:

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

Overrides:

build in class CanOpenEPOS

goToSwitchOnDisabled

public void goToSwitchOnDisabled()

Specified by:

goToSwitchOnDisabled in interface EPOSController

setSsiPosition

public void setSsiPosition(int ssiPosition)

To initialize a simulated ssiPosition.

Parameters:

ssiPosition -

setPositionSensorTypeSinusIncrementalEncoder

public void setPositionSensorTypeSinusIncrementalEncoder()

Description copied from interface: EPOSControllerForCarousel

Set PositionSensorType to Sinus Incremental Encoder(value=8)

Specified by:

setPositionSensorTypeSinusIncrementalEncoder in interface EPOSControllerForCarousel

setPositionSensorTypeEncoderSSI

public void setPositionSensorTypeEncoderSSI()

Description copied from interface: EPOSControllerForCarousel

Set PositionSensorType to Absolute encoder SSI (value=4)

Specified by:

setPositionSensorTypeEncoderSSI in interface EPOSControllerForCarousel

writeTargetPosition

@Command(type=ACTION,
         level=1,
         description="In PROFILE_POSITION mode this methods set the target position.")
public void writeTargetPosition(int absolutePosition)
                                                                                                                                                        throws FcsHardwareException

This methods does nothing but save the relativePosition given as argument.

Specified by:

writeTargetPosition in interface EPOSController

Overrides:

writeTargetPosition in class CanOpenEPOS

Parameters:

absolutePosition -

Throws:

FcsHardwareException

SDORequestException

updateFakePDOData

public void updateFakePDOData(int cobid,
                              long newPdo)

Update PDOdata

Parameters:

cobid -

newPdo -

simulatePosition

public void simulatePosition(int pos)

set controller position in PDOData to simulate a carousel position.

Parameters:

pos -

simulateStatusWord

public void simulateStatusWord(int sw)

set carouselController statusWord in PDOData to simulate a statusWord.

Parameters:

sw -

simulateSWITCH_ON_DISABLED

public void simulateSWITCH_ON_DISABLED()

setPosition

@Command(type=ACTION,
         level=1,
         description="For simulator only : Update position with a position given as argument.")
public void setPosition(int actualPosition)

set a position for simulation

Specified by:

setPosition in interface EPOSController

Overrides:

setPosition in class CanOpenEPOS

Parameters:

actualPosition -

isTargetReached

public boolean isTargetReached()

overriden for simulation

Specified by:

isTargetReached in interface EPOSController

Specified by:

isTargetReached in interface EPOSControllerForCarousel

Returns:

isParametersOK

public boolean isParametersOK()

We assum that simulated hardware'subs controller has always correct parameters.

Specified by:

isParametersOK in interface EPOSController

Overrides:

isParametersOK in class CanOpenEPOS

Returns:

defineAbsolutePosition

public void defineAbsolutePosition(int position)

Description copied from interface: EPOSController

Defines the actual position as the absolute position which value is given as an argument. Writes value 35 to set the Homing method as Actual (See EPOS documentation)

Specified by:

defineAbsolutePosition in interface EPOSController

Specified by:

defineAbsolutePosition in interface EPOSControllerForCarousel

writeParameters

public void writeParameters(EPOSEnumerations.EposMode mode)

Description copied from class: CanOpenEPOS

This methods writes in the CPU of the EPOS devis the values of the parameters set for the mode. Usually the values of the parameters are given by the configuration system.

Specified by:

writeParameters in interface EPOSController

Overrides:

writeParameters in class CanOpenEPOS

writeParameter

public void writeParameter(EPOSEnumerations.Parameter param,
                           int value)

Description copied from class: CanOpenEPOS

This method writes a parameter in the CPU of the EPOS. For end user at the console

Specified by:

writeParameter in interface EPOSController

Overrides:

writeParameter in class CanOpenEPOS

value - in decimal

readParameter

public long readParameter(EPOSEnumerations.Parameter parameter)

Description copied from class: CanOpenEPOS

Reads in the EPOS CPU the value of the Parameter.

Specified by:

readParameter in interface EPOSController

Overrides:

readParameter in class CanOpenEPOS

Returns:

value of the parameter in decimal format.

writeParameters

public void writeParameters(Map<String,Integer> paramMap)

Description copied from interface: EPOSController

Write to the CPU of the EPOS a map of parameters.

Specified by:

writeParameters in interface EPOSController

writeCurrent

public void writeCurrent(int aValue)

Description copied from class: CanOpenEPOS

In unsCurrent mode this methods send a unsCurrent to the motor. This make run the motor.

Specified by:

writeCurrent in interface EPOSController

Overrides:

writeCurrent in class CanOpenEPOS

Parameters:

aValue - UNIT=mA / FORMAT=decimal the value of the unsCurrent to be sent.

stopAction

public void stopAction()

Description copied from interface: EPOSController

Stop action and shutdownController(shutdown) controller.

Specified by:

stopAction in interface EPOSController

readPosition

public int readPosition()

Description copied from interface: EPOSController

Reads in the CPU the value of the parameter PositionActualValue and returns it in a decimal format.

Specified by:

readPosition in interface EPOSController

Returns:

value in decimal format

readSSIPosition

public int readSSIPosition()

Read the position returned by the absolute encoder (single serial data).

Specified by:

readSSIPosition in interface EPOSController

Returns:

readCurrent

public int readCurrent()

Description copied from class: CanOpenEPOS

In Current Mode this methods returns the current actualy received by the motor.

Specified by:

readCurrent in interface EPOSController

Overrides:

readCurrent in class CanOpenEPOS

Returns:

the unsCurrent UNIT=mA / FORMAT=decimal

readMode

public EPOSEnumerations.EposMode readMode()

Description copied from class: CanOpenEPOS

Reads the EPOS mode in the CPU of the EPOS device, updates the field mode and returns the mode as a String.

Specified by:

readMode in interface EPOSController

Overrides:

readMode in class CanOpenEPOS

Returns:

mode

readStatusWord

public int readStatusWord()

Description copied from class: CanOpenEPOS

Read the status word (index=6041, subindex=0,size=2)

Specified by:

readStatusWord in interface EPOSController

Overrides:

readStatusWord in class CanOpenEPOS

Returns:

value in hexa

quickStop

public void quickStop()

Description copied from interface: EPOSController

Send a quickStop command to the controller. see EPOS2_Application_Notes_Collection_En.pdf §8 page 8-104

Specified by:

quickStop in interface EPOSController

getErrorHistoryNB

public int getErrorHistoryNB()

Description copied from interface: EPOSController

Return the number of errors that occured on this controller.

Specified by:

getErrorHistoryNB in interface EPOSController

Overrides:

getErrorHistoryNB in class CanOpenDevice

Returns:

readErrorRegister

public int readErrorRegister()

Description copied from class: CanOpenDevice

Read Error Register on the controller (index 1001).

Overrides:

readErrorRegister in class CanOpenDevice

Returns:

error code

updateErrorHistory

public void updateErrorHistory()

Description copied from class: CanOpenDevice

read error history on the device and update error history fields : errorHistory, lastErrorCode, lastErrorName. Error history holds errors that have occurred on the device.

Overrides:

updateErrorHistory in class CanOpenDevice

displayErrorHistory

public String displayErrorHistory()

Description copied from class: CanOpenDevice

Read error history on the device and return its String representation.

Specified by:

displayErrorHistory in interface EPOSController

Overrides:

displayErrorHistory in class CanOpenDevice

Returns:

checkFault

@Command(type=QUERY,
         level=1,
         description="Check if the Controller is in fault.")
public void checkFault()

Description copied from class: CanOpenEPOS

Check if the Controller is in fault.

Specified by:

checkFault in interface EPOSController

Overrides:

checkFault in class CanOpenEPOS

readParameters

public String readParameters(EPOSEnumerations.EposMode mode)

Description copied from interface: EPOSController

Read all the value of parameters for a given EPOS mode and return a printed list of this values.

Specified by:

readParameters in interface EPOSController

Returns:

checkParameters

public void checkParameters(EPOSEnumerations.EposMode aMode)

Description copied from class: CanOpenEPOS

For every parameter to be defined for this mode this method compares the values in configuration with the value stored in controller CPU and throws a FcsHardwareException if these values are not equal. values stored in the controller CPU.

Specified by:

checkParameters in interface EPOSController

Overrides:

checkParameters in class CanOpenEPOS

writeControlWord

public void writeControlWord(int w)

Description copied from class: CanOpenEPOS

Write a value in the control word (index=6040, subindex=0,size=2)

Specified by:

writeControlWord in interface EPOSController

Overrides:

writeControlWord in class CanOpenEPOS