FB_SimAxCommon

FB_SimAxCommon 1:

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

FB_SimAxCommon 2: Properties

Name

Type

Access

Description

ActualPosition

LREAL

Get, Set

This runtime value provides information about the simulated axis position.

Notice The simulated position of the actuator can 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 in case AbsSwitchHighSelect=TRUE: AbsolutSwitch will be 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 will select AbsSwitchHighEnd while a FALSE makes the AbsSwitchLowEnd the active AbsolutSwitch.

AbsSwitchLowEnd

LREAL

Get, Set

This parameter defines the threshold in case AbsSwitchHighSelect=FALSE: AbsolutSwitch will be 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.

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.

UpperEndSwitch

BOOL

Get

This runtime value provides information about the state of a simulated sensor. It becomes TRUE if the position of the simulated actuator is <= LowSideEndswitch.

FB_SimAxCommon 3: Methods

Name

Description

GoFaultState()

This method can be used to simulate an error situation on the simulated axis.

FB_SimAxCommon 4: 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