ElectroStatQuad

version 2.0.5 class documentation

krause ( ACO )

Generated on 2015-12-17T15:28:17+01:00

Introduction

Explain the purpose of this class

---

---

Interface

   [Back to top]

Device Interface

   [Back to top]

Setting Properties

   [Back to top]

Init

   [Back to top]

Control property, used to initialize the device with default values from the device instantiation file.

Attributes	Value
multiplexed	false
partial-setting	true
type	setting
visibility	operational

Reset

   [Back to top]

Control property, used to reset the device while keeping the persistent data.

Attributes	Value
multiplexed	false
partial-setting	true
type	setting
visibility	operational

ParameterSetting

   [Back to top]

Parameters of associated power supplies

Attributes	Value
multiplexed	false
partial-setting	true
type	setting
visibility	development

Value-Items	Direction	Type	Scalarity	Description
currentLimitH	INOUT	double	scalar	Current limit defining trip condition, horizontal plates
currentLimitH_max	OUT	double	scalar
currentLimitH_min	OUT	double	scalar
currentLimitH_units	OUT	char	array
rampUpRateH	INOUT	double	scalar
rampUpRateH_max	OUT	double	scalar
rampUpRateH_min	OUT	double	scalar
rampUpRateH_units	OUT	char	array
rampDownRateH	INOUT	double	scalar
rampDownRateH_max	OUT	double	scalar
rampDownRateH_min	OUT	double	scalar
rampDownRateH_units	OUT	char	array
tripTimeH	INOUT	double	scalar
tripTimeH_max	OUT	double	scalar
tripTimeH_min	OUT	double	scalar
tripTimeH_units	OUT	char	array
currentLimitV	INOUT	double	scalar	Current limit defining trip condition, vertical plates
currentLimitV_max	OUT	double	scalar
currentLimitV_min	OUT	double	scalar
currentLimitV_units	OUT	char	array
rampUpRateV	INOUT	double	scalar
rampUpRateV_max	OUT	double	scalar
rampUpRateV_min	OUT	double	scalar
rampUpRateV_units	OUT	char	array
rampDownRateV	INOUT	double	scalar
rampDownRateV_max	OUT	double	scalar
rampDownRateV_min	OUT	double	scalar
rampDownRateV_units	OUT	char	array
tripTimeV	INOUT	double	scalar
tripTimeV_max	OUT	double	scalar
tripTimeV_min	OUT	double	scalar
tripTimeV_units	OUT	char	array

Min-Value-Items	Direction	Type	Scalarity	Description
currentLimitH_min	OUT	double	scalar
rampUpRateH_min	OUT	double	scalar
rampDownRateH_min	OUT	double	scalar
tripTimeH_min	OUT	double	scalar
currentLimitV_min	OUT	double	scalar
rampUpRateV_min	OUT	double	scalar
rampDownRateV_min	OUT	double	scalar
tripTimeV_min	OUT	double	scalar

Max-Value-Items	Direction	Type	Scalarity	Description
currentLimitH_max	OUT	double	scalar
rampUpRateH_max	OUT	double	scalar
rampDownRateH_max	OUT	double	scalar
tripTimeH_max	OUT	double	scalar
currentLimitV_max	OUT	double	scalar
rampUpRateV_max	OUT	double	scalar
rampDownRateV_max	OUT	double	scalar
tripTimeV_max	OUT	double	scalar

Units-Value-Items	Direction	Type	Scalarity	Description
currentLimitH_units	OUT	char	array
rampUpRateH_units	OUT	char	array
rampDownRateH_units	OUT	char	array
tripTimeH_units	OUT	char	array
currentLimitV_units	OUT	char	array
rampUpRateV_units	OUT	char	array
rampDownRateV_units	OUT	char	array
tripTimeV_units	OUT	char	array

Setting

   [Back to top]

Used for setting hardware parameters for controlling the device.

Attributes	Value
multiplexed	true
partial-setting	true
type	setting
visibility	operational

Value-Items	Direction	Type	Scalarity	Description
voltageH	INOUT	double	scalar	Voltage of horizontal plates
voltageH_min	OUT	double	scalar
voltageH_max	OUT	double	scalar
voltageH_units	OUT	char	array
voltageV	INOUT	double	scalar	Voltage of vertical plates
voltageV_min	OUT	double	scalar
voltageV_max	OUT	double	scalar
voltageV_units	OUT	char	array

Min-Value-Items	Direction	Type	Scalarity	Description
voltageH_min	OUT	double	scalar
voltageV_min	OUT	double	scalar

Max-Value-Items	Direction	Type	Scalarity	Description
voltageH_max	OUT	double	scalar
voltageV_max	OUT	double	scalar

Units-Value-Items	Direction	Type	Scalarity	Description
voltageH_units	OUT	char	array
voltageV_units	OUT	char	array

Power

   [Back to top]

Returns the current software and hardware versions of a piece of equipment.Used to turn the power of a device on or off.

Attributes	Value
multiplexed	false
partial-setting	true
type	setting
visibility	operational

Value-Items	Direction	Type	Scalarity	Description
power	INOUT	DEVICE_POWER	custom-type-scalar

Acquisition Properties

   [Back to top]

Status

   [Back to top]

Used to display the (cycle independent) overall status of the device. Detailed status information may be additionally added to this property.

Attributes	Value
cycle-bound	false
partial-setting	false
type	acquisition
visibility	operational

Value-Items	Direction	Type	Scalarity	Description
status	OUT	DEVICE_STATUS	custom-type-scalar
detailedStatus	OUT	bool	array	Detailed status should consist of an array of boolean values considered as detailed status information as well as a corresponding string array containing keys to illustrate the meaning of the detailed status information.
detailedStatus_labels	OUT	char	array2D	Labels of detailed status bits.
detailedStatus_severity	OUT	DETAILED_STATUS_SEVERITY	custom-type-array	Severities of the detailed status bits.
powerState	OUT	DEVICE_POWER_STATE	custom-type-scalar	Power state of the device (ON, OFF).
control	OUT	DEVICE_CONTROL	custom-type-scalar
interlock	OUT	bool	scalar	Interlock state of the device.
opReady	OUT	bool	scalar	Contains the devices state regarding operation.
modulesReady	OUT	bool	scalar	Contains the devices module state.
error_codes	OUT	int32_t	array
error_messages	OUT	char	array2D
error_timestamps	OUT	int64_t	array
error_cycle_names	OUT	char	array2D

ModuleStatus

   [Back to top]

Gives detailed information on the state of 3rd party hardware and software components which are required to operate the device.

Attributes	Value
cycle-bound	false
partial-setting	false
type	acquisition
visibility	development

Value-Items	Direction	Type	Scalarity	Description
moduleStatus	OUT	MODULE_STATUS	custom-type-array
moduleStatus_labels	OUT	char	array2D

Acquisition

   [Back to top]

Used for returning acquisition data which is retrieved from the hardware.

Attributes	Value
cycle-bound	true
partial-setting	false
type	acquisition
visibility	operational

Value-Items	Direction	Type	Scalarity	Description
voltageHSet	OUT	double	scalar
voltageHSet_units	OUT	char	array
voltageVSet	OUT	double	scalar
voltageVSet_units	OUT	char	array
voltageH	OUT	double	scalar
voltageH_units	OUT	char	array
voltageV	OUT	double	scalar
voltageV_units	OUT	char	array
currentH	OUT	double	scalar
currentH_units	OUT	char	array
currentV	OUT	double	scalar
currentV_units	OUT	char	array
polarityH	OUT	int32_t	scalar
polarityV	OUT	int32_t	scalar
processIndex	OUT	int32_t	scalar
sequenceIndex	OUT	int32_t	scalar
chainIndex	OUT	int32_t	scalar
eventNumber	OUT	int32_t	scalar
timingGroupID	OUT	int32_t	scalar
acquisitionStamp	OUT	int64_t	scalar
eventStamp	OUT	int64_t	scalar
processStartStamp	OUT	int64_t	scalar
sequenceStartStamp	OUT	int64_t	scalar
chainStartStamp	OUT	int64_t	scalar

Units-Value-Items	Direction	Type	Scalarity	Description
voltageHSet_units	OUT	char	array
voltageVSet_units	OUT	char	array
voltageH_units	OUT	char	array
voltageV_units	OUT	char	array
currentH_units	OUT	char	array
currentV_units	OUT	char	array

SubDevices

   [Back to top]

Nomenclatures of HW-devices used in this association

Attributes	Value
cycle-bound	false
partial-setting	false
type	acquisition
visibility	development

Value-Items	Direction	Type	Scalarity	Description
horizontalPlates	OUT	char	array	Nomenclature of power supply for horizontal plate
verticalPlates	OUT	char	array	Nomenclature of power supply for vertical plate
processIndex	OUT	int32_t	scalar
sequenceIndex	OUT	int32_t	scalar
chainIndex	OUT	int32_t	scalar
eventNumber	OUT	int32_t	scalar
timingGroupID	OUT	int32_t	scalar
acquisitionStamp	OUT	int64_t	scalar
eventStamp	OUT	int64_t	scalar
processStartStamp	OUT	int64_t	scalar
sequenceStartStamp	OUT	int64_t	scalar
chainStartStamp	OUT	int64_t	scalar

Version

   [Back to top]

Attributes	Value
cycle-bound	false
partial-setting	false
type	acquisition
visibility	operational

Value-Items	Direction	Type	Scalarity	Description
classVersion	OUT	char	array
deployUnitVersion	OUT	char	array
fesaVersion	OUT	char	array

Global Interface

   [Back to top]

Setting Properties

   [Back to top]

DiagnosticSetting

   [Back to top]

Generic property which allows to diagnose any FESA classes

Attributes	Value
multiplexed	false
partial-setting	false
type	setting
visibility	expert

Value-Items	Direction	Type	Scalarity	Description
requestState	IN	bool	scalar

Acquisition Properties

   [Back to top]

DeviceDescription

   [Back to top]

Attributes	Value
cycle-bound	false
partial-setting	false
type	acquisition
visibility	operational

Value-Items	Direction	Type	Scalarity	Description
deviceNameTimingReceiver	OUT	char	array
propertyNames	OUT	char	array2D
deviceNames	OUT	char	array2D
globalDeviceName	OUT	char	array
host	OUT	char	array

Data

   [Back to top]

Device Data

   [Back to top]

Configuration

   [Back to top]

Name	Type	Description
acceptFilledSelectors	bool
deviceNameH	char
deviceNameV	char
subdevicetype	SUB_DEVICE_TYPE
detailedStatus_sub_labels	char
detailedStatus_labels	char
detailedStatus_severity	DETAILED_STATUS_SEVERITY
moduleStatus_labels	char

Acquisition

   [Back to top]

Name	Type	Description
voltageHSet	double
voltageVSet	double
voltageHAct	double
voltageVAct	double
currentHAct	double
currentVAct	double
polarityH	int32_t
polarityV	int32_t
detailedStatusH	bool
detailedStatusV	bool
voltageUnitStatic	char
currentUnitStatic	char
controlV	DEVICE_CONTROL
controlH	DEVICE_CONTROL
opReadyV	bool
opReadyH	bool
interlockV	bool
interlockH	bool
powerStateV	DEVICE_POWER_STATE
powerStateH	DEVICE_POWER_STATE
statusV	DEVICE_STATUS
statusH	DEVICE_STATUS
modulesReadyV	bool
modulesReadyH	bool
detailedStatus	bool
moduleStatus	MODULE_STATUS
control	DEVICE_CONTROL
powerState	DEVICE_POWER_STATE
status	DEVICE_STATUS
interlock	bool
opReady	bool
modulesReady	bool
acquisitionContext	GSI_ACQ_CONTEXT
error_collection	GSI_ERROR

Setting

   [Back to top]

Name	Type	Description
power	DEVICE_POWER

Global Data

   [Back to top]

Configuration

   [Back to top]

Name	Type	Description
deviceNameTimingReceiver	char

Acquisition

   [Back to top]

None

Setting

   [Back to top]

None

Custom Types

   [Back to top]

Name	Type
DIAG_TOPIC	custom-types
DEVICE_STATUS	custom-types
DEVICE_POWER_STATE	custom-types
DEVICE_POWER	custom-types
DEVICE_CONTROL	custom-types
TOL_CHECK_MODE	custom-types
AQN_STATUS	custom-types
GSI_ERROR	custom-types
GSI_ACQ_CONTEXT	custom-types
MAX_ERROR_MESSAGE_LENGTH	custom-types
MAX_NUMBER_OF_ERROR_MESSAGES	custom-types
MAX_CYCLE_NAME_LENGTH	custom-types
MAX_VERSION_NAME_LENGTH	custom-types
MAX_DETAILED_STATUS_LABEL_LENGTH	custom-types
DETAILED_STATUS_SEVERITY	custom-types
SUBDEVICE_COUNT	custom-types
MODULE_STATUS	custom-types
MAX_MODULE_STATUS_LABEL_LENGTH	custom-types
MODULE_STATUS_SIZE	custom-types
SUB_DEVICE_TYPE	custom-types
MODULE_STATUS_ITEMS	custom-types

Struct and Enumeration Data

   [Back to top]

GSI_ERROR

   [Back to top]

Name	Scalarity	Type	Size	Description
error_string	array	char	MAX_ERROR_MESSAGE_LENGTH
error_code	scalar	int32_t
error_timestamp	scalar	int64_t
error_cycle_name	array	char	MAX_CYCLE_NAME_LENGTH

GSI_ACQ_CONTEXT

   [Back to top]

Name	Scalarity	Type	Size	Description
processIndex	scalar	int32_t		Used in order to index process-multiplexed data
sequenceIndex	scalar	int32_t		Used in order to index sequence-multiplexed data
chainIndex	scalar	int32_t		Refers to a specific beam production chain
eventNumber	scalar	int32_t		The number of the event describes it's type
timingGroupID	scalar	int32_t		ID of the timing group for which the event is relevant
acquisitionStamp	scalar	int64_t		The acquisition stamp is used to indicate when a measurement was done
eventStamp	scalar	int64_t		The event stamp is used to indicate when WhiteRabbit event was triggered on the Timing Receiver
processStartStamp	scalar	int64_t		The process start stamp indicates when the first event of the current process was triggered
sequenceStartStamp	scalar	int64_t		The sequence start stamp indicates when the first event of the current sequence was triggered
chainStartStamp	scalar	int64_t		The chain start stamp indicates when the first event of the current chain was triggered

DEVICE_STATUS

   [Back to top]

Symbol	Value	Access
UNKNOWN	0	RW
OK	1	RW
WARNING	2	RW
ERROR	3	RW

DEVICE_POWER_STATE

   [Back to top]

Symbol	Value	Access
UNKNOWN	0	RW
ON	1	RW
OFF	2	RW
STANDBY	3	RW
POWER_DOWN	4	RW
POWER_UP	5	RW

DEVICE_POWER

   [Back to top]

Symbol	Value	Access
ON	1	RW
OFF	2	RW

DEVICE_CONTROL

   [Back to top]

Symbol	Value	Access
REMOTE	0	RW
LOCAL	1	RW

TOL_CHECK_MODE

   [Back to top]

Symbol	Value	Access
ABS	0	RO
REL	1	RO

DETAILED_STATUS_SEVERITY

   [Back to top]

Symbol	Value	Access
INFO	0	RO
WARNING_ON_FALSE	1	RO
ERROR_ON_FALSE	2	RO

MODULE_STATUS

   [Back to top]

Symbol	Value	Access
UNKNOWN	0	RO
OK	1	RO
WARNING	2	RO
ERROR	3	RO
NOT_AVAILABLE	4	RO

SUB_DEVICE_TYPE

   [Back to top]

Symbol	Value	Access
CaenHvSYx527Channel	0	RO
PowerSupply	1	RO

MODULE_STATUS_ITEMS

   [Back to top]

Symbol	Value	Access
horizontalSupply	0	RO
verticalSupply	1	RO

AQN_STATUS

   [Back to top]

bit-enum-32bits

Bit	Name
b0	NOT_OK
b1	BAD_QUALITY
b2	DIFFERENT_FROM_SETTING
b3	OUT_OF_RANGE
b4	BUSY
b5	TIMEOUT
b6	bit6_is_reserved_for_later_usage
b7	bit7_is_reserved_for_later_usage
b8	bit8_is_reserved_for_later_usage
b9	bit9_is_reserved_for_later_usage
b10	bit10_is_reserved_for_later_usage
b11	bit11_is_reserved_for_later_usage
b12	bit12_is_reserved_for_later_usage
b13	bit13_is_reserved_for_later_usage
b14	bit14_is_reserved_for_later_usage
b15	bit15_is_reserved_for_later_usage
b16	bit_16_and_higher_can_be_used_by_the_class_developer

Constants

   [Back to top]

Name	Type	Value
MAX_ERROR_MESSAGE_LENGTH	uint32_t	256

Name	Type	Value
MAX_NUMBER_OF_ERROR_MESSAGES	uint32_t	16

Name	Type	Value
MAX_CYCLE_NAME_LENGTH	uint32_t	256

Name	Type	Value
MAX_VERSION_NAME_LENGTH	uint32_t	256

Name	Type	Value
MAX_DETAILED_STATUS_LABEL_LENGTH	uint32_t	30

Name	Type	Value
SUBDEVICE_COUNT	uint16_t	2

Name	Type	Value
MAX_MODULE_STATUS_LABEL_LENGTH	uint32_t	30

Name	Type	Value
MODULE_STATUS_SIZE	uint32_t	2