FB_SimAxCommon

This class is used as a common platform for carrying out various types of axis simulations. It is not intended to instantiate objects.

Syntax:

FUNCTION_BLOCK FB_SimAxCommon

Properties

Name	Type	Access	Description
ActualPosition	LREAL	Get, Set	Simulated axis position. Notice The simulated position of the actuator can deviate from the reported axis position.
FB_SimAxCommon
ActualVelocity	LREAL	Get, Set	Simulated axis velocity. Notice The simulated velocity of the actuator may deviate from the reported axis position.
AbsolutSwitch	BOOL	Get	This runtime value provides information about the simulated feedback signal as defined by `AbsSwitchHighSelect`.
AbsSwitchHighEnd	LREAL	Get, Set	This parameter defines the threshold value for the case `AbsSwitchHighSelect=TRUE`: `AbsolutSwitch` is `TRUE` if the simulated actuator position is >= `AbsSwitchHighEnd`. Notice The simulated position of the actuator can deviate from the reported axis position.
AbsSwitchHighSelect	BOOL	Get, Set	This parameter defines the active `AbsolutSwitch`. A `TRUE` selects `AbsSwitchHighEnd`, while a `FALSE` makes `AbsSwitchLowEnd` the active `AbsolutSwitch`.
AbsSwitchLowEnd	LREAL	Get, Set	This parameter defines the threshold value for the case `AbsSwitchHighSelect=FALSE`: `AbsolutSwitch` is `TRUE` if the simulated actuator position is <= `AbsSwitchLowEnd`. Notice The simulated position of the actuator can deviate from the reported axis position.
CycleTime	LREAL	Get, Set	This parameter must be initialized with the update calling cycle of the `Cyclic()` method and will be forwarded to any sub-component if required. It is used to define any time behavior.
DenyEnable	BOOL	Get, Set	A `TRUE` blocks the feedback of the controller enable. This can be used to simulate a lack of response from the field device.
EncoderInterpolation	LREAL	Get, Set	This parameter must be initialized with the same value as the corresponding parameter in the motion technology: NC: encoder, parameter, scaling factor denominator Hydraulics library: encoder, inc. Interpolation
EncoderNoiseLevel	LREAL	Get, Set	The simulated axis offers the possibility to disturb the reported position with a pseudo-random white noise. This is realized by a `FB_Noise()` function block. The parameter EncoderNoiseLevel is forwarded as SetWhiteNoiseLevel.
EncoderWeighting	LREAL	Get, Set	This parameter must be initialized with the same value as the corresponding parameter in the motion technology: NC: encoder, parameter, scaling factor numerator Hydraulics library: encoder, weighting factor
EncoderZeroShift	LREAL	Get, Set	This parameter must be initialized with the same value as the corresponding parameter in the motion technology: NC: rotary encoder, parameter, position bias Hydraulics library: encoder, zero offset
HighSideBlock	LREAL	Get, Set	The simulated position of the actuator is limited to a value less than or equal to this parameter.
HighSideEndswitch	LREAL	Get, Set	This parameter defines the `UpperEndSwitch` threshold that becomes `TRUE` when the simulated position of the actuator is >= this parameter.
HighSideSpringLengt	LREAL	Get, Set	This parameter defines the length of a simulated spring-like effect at the upper side of the actuator stroke.
LowerEndSwitch	BOOL	Get	This runtime value provides information about the state of a simulated sensor. Becomes `TRUE` if the position of the simulated actuator is >= `HighSideEndswitch`.
LowSideBlock	LREAL	Get, Set	The simulated position of the actuator is limited to a value above or equal to this parameter.
LowSideEndswitch	LREAL	Get, Set	This parameter defines the `LowerEndSwitch` threshold that becomes `TRUE` when the simulated position of the actuator is <= this parameter.
LowSideSpringLength	LREAL	Get, Set	This parameter defines the length of a simulated spring-like effect at the lower side of the actuator stroke.
MovingMass	LREAL	Get, Set	This parameter can be used to define a moving mass. It is used to calculate dynamic acceleration and deceleration forces, torques or pressures.
NoBlock	BOOL	Get, Set	If this parameter is set to `TRUE`, the use of the springs and blocks on the upper and lower sides will be disabled.
Reversed	BOOL	Get, Set	The simulated axis works inverted.
UpperEndSwitch	BOOL	Get	This runtime value provides information about the state of a simulated sensor. Becomes `TRUE` if the position of the simulated actuator is <= `LowSideEndswitch`.

Methods

Name	Description
GoFaultState()	This method can be used to simulate an error situation on the simulated axis.

Interfaces

Type	Description
I_SimAxCommon	Standard interface for `FB_SimAxCommon`.

Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT v3.1.4024.35	PC or CX (x64, x86)	Tc3_PlasticFunctions v3.12.4.26 or higher

Further Information

GoFaultState()