MiniFesaMasp

version 0.2.2 class documentation

thaberm ( CSCO )

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

Introduction

Explain the purpose of this class

HTML part of introduction

---

---

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

BeamModes

   [Back to top]

Beam modes for all BeamModeDomains and Experiment info

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

Value-Items	Direction	Type	Scalarity	Description
beamModeUNILAC	INOUT	BEAM_MODE	custom-type-scalar
beamModeSIS18	INOUT	BEAM_MODE	custom-type-scalar
beamModeFRS	INOUT	BEAM_MODE	custom-type-scalar
beamModeESR	INOUT	BEAM_MODE	custom-type-scalar
beamModeCryRing	INOUT	BEAM_MODE	custom-type-scalar
beamModeExperiment	INOUT	BEAM_MODE	custom-type-scalar
experimentID	INOUT	char	array
experimentDescription	INOUT	char	array
experimentDetailedDescription	INOUT	char	array
experimentLocation	INOUT	char	array

ExpertSetting

   [Back to top]

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

Value-Items	Direction	Type	Scalarity	Description
faultySystemMask	INOUT	bool	array
signals	INOUT	char	array2D

Setting

   [Back to top]

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

Value-Items	Direction	Type	Scalarity	Description
signals	OUT	char	array2D
setupBeamFlagMaskable	OUT	bool	array
setupBeamFlagMask	INOUT	bool	array

LSASetting

   [Back to top]

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

Value-Items	Direction	Type	Scalarity	Description
particleTransfers	INOUT	char	array2D
nominallyMaskedSignalSources	INOUT	char	array2D

Power

   [Back to top]

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
multiplexed	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 acorresponding 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
multiplexed	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
multiplexed	true
partial-setting	false
type	acquisition
visibility	operational

Value-Items	Direction	Type	Scalarity	Description
signals	OUT	char	array2D	lists all signals for this BPC, other arrays in this property refer to the signal at same index in this array
globalBPCStatus	OUT	bool	scalar
signalStatus	OUT	bool	array
particleTransfers	OUT	char	array2D
beamModeDomain	OUT	char	array2D
nominalMask	OUT	bool	array
faultySystemMask	OUT	bool	array
setupBeamFlagMask	OUT	bool	array
setupBeamFlagMaskable	OUT	bool	array
beamModes	OUT	BEAM_MODE	custom-type-array
detailedBPCStatus	OUT	bool	array2D	status per beam mode x beam mode domain
beamPresenceFlag	OUT	bool	scalar
setupBeamFlag	OUT	bool	array
detailedBPCStatus_dimensions	OUT	int8_t	array
detailedBPCStatus_labels	OUT	char	array2D
detailedBPCStatus_dim1_labels	OUT	char	array2D
detailedBPCStatus_dim2_labels	OUT	char	array2D
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

AllSignalsStatus

   [Back to top]

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

Value-Items	Direction	Type	Scalarity	Description
signals	OUT	char	array2D
signalsStatusRaw	OUT	MASP_STATUS	custom-type-array
signalsStatus	OUT	bool	array
particleTransfers	OUT	char	array2D
faultySystemMask	OUT	bool	array
setupBeamFlagMaskable	OUT	bool	array
emitterType	OUT	EmitterType	custom-type-array
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

Single_dev_status

   [Back to top]

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

Value-Items	Direction	Type	Scalarity	Description
OP_READY	OUT	MASP_STATUS	custom-type-scalar
REMOTE	OUT	MASP_STATUS	custom-type-scalar
INTERLOCK	OUT	MASP_STATUS	custom-type-scalar
POWER_ON	OUT	MASP_STATUS	custom-type-scalar
MOD_RDY	OUT	MASP_STATUS	custom-type-scalar
ONLINE	OUT	MASP_STATUS	custom-type-scalar
HW_INTERLOCK	OUT	MASP_STATUS	custom-type-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

Filter-Items	Direction	Type	Scalarity	Description
Nomen	IN	char	array

Version

   [Back to top]

Returns the current software and hardware versions of a piece of equipment.

Attributes	Value
multiplexed	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
multiplexed	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
detailedStatus_labels	char
detailedStatus_severity	DETAILED_STATUS_SEVERITY
moduleStatus_labels	char

Acquisition

   [Back to top]

Name	Type	Description
Status_num_entries_field	int64_t
Status_id_array_field	char
Status_status_field	MASP_STATUS
eat_my_shorts_mp_field	char
Dummy_field	bool
control	DEVICE_CONTROL
powerState	DEVICE_POWER_STATE
status	DEVICE_STATUS
interlock	bool
opReady	bool
modulesReady	bool
detailedStatus	bool
moduleStatus	MODULE_STATUS
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_SIZE	custom-types
DETAILED_STATUS_SEVERITY	custom-types
MODULE_STATUS	custom-types
MAX_MODULE_STATUS_LABEL_LENGTH	custom-types
MODULE_STATUS_SIZE	custom-types
Max_Status_num_entries	custom-types
MASP_STATUS	custom-types
BEAM_MODE	custom-types
STATUS_EMTTER_TYPE	custom-types
EmitterType	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

MASP_STATUS

   [Back to top]

Symbol	Value	Access
OK	0	RW
NOT_OK	1	RW
UNKNOWN	2	RW
UNDEF	3	RW

BEAM_MODE

   [Back to top]

Symbol	Value	Access
UNKNOWN	-3	RW
POST_MORTEM	-2	RW
RECORERY	-1	RW
NO_BEAM	0	RW
PILOT_BEAM	1	RW
INTENISTY_RAMP_UP	2	RW
ADJUST	3	RW
STABLE_BEAMS	4	RW

STATUS_EMTTER_TYPE

   [Back to top]

Symbol	Value	Access
FESA_EMITTER	0	RW
CAP_GATEWAY	1	RW
HW_INTERLOCK	2	RW
CUSTOM_EMITTER	3	RW

EmitterType

   [Back to top]

Symbol	Value	Access
FESA_EMITTER	0	RW

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
DETAILED_STATUS_SIZE	uint32_t	2

Name	Type	Value
MAX_MODULE_STATUS_LABEL_LENGTH	uint32_t	30

Name	Type	Value
MODULE_STATUS_SIZE	uint32_t	2

Name	Type	Value
Max_Status_num_entries	uint32_t	8000