FB_SimHydAx_Standard

This FB is a simplified simulation of a universal hydraulic axis. A number of typical effects are supported.

	The implementation of this object is not a full-fledged and realistic simulation.

Syntax:

FUNCTION_BLOCK FB_SimHydAx_Standard EXTENDS 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_SimHydAx_Standard
Cylinder	I_SimCylinder	Get	An interface to the local `FB_SimCylinder` object.
Encoder	I_SimUniversalEncoder	Get	An interface to the local `FB_SimUniversalEncoder` object.
ExternalForce	LREAL	Get, Set	This runtime value can be updated with pressure values required for process simulation. It is used to calculate the total pressure on the simulated cylinder and is part of the reported actual pressure.
Overlapp_PA	LREAL	Get, Set	Overlap on the A-side of the valve.
Overlapp_PB	LREAL	Get, Set	Overlap on the B-side of the valve.
PressureTransducerA	I_PressureTransducer	Get	An interface to the local `FB_PressureTransducer` object on the A-side of the `FB_SimCylinder` object.
PressureTransducerB	I_PressureTransducer	Get	An interface to the local `FB_PressureTransducer` object on the B-side of the `FB_SimCylinder` object.
Qnominal_PA	LREAL	Get, Set	Oil flow between the supply connection and the A-side connection of the valve.
Qnominal_PB	LREAL	Get, Set	Oil flow between the supply connection and the B-side connection of the valve.
SpoolFeedback	INT	Get	Feedback value of the valve coil position.
SupplyPressure	LREAL	Get, Set	Supply pressure of the valve.
Valve	I_SimValve	Get	An interface to the local `FB_SimValve` object on the B-side of the `FB_SimCylinder` object.
ValveControlValueType	E_SimControlValueType	Get, Set	The valve type used for the axis.
ValveXyz	<Diverse>	Get, (Set)	Forwarded values of the internal `FB_SimValve` instance.
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.
FB_SimHydAx_Standard
Cyclic()	Cycle method

Interfaces

Type	Description
I_SimAxCommon	Standard interface for `FB_SimAxCommon`.
I_SimHydAx	Standard interface for FB_SimHydAx_Standard.

Prerequisites

Development environment	Target platform	PLC libraries to include
TwinCAT v3.1.4024.56	PC or CX (x64, x86)	Tc3_PlasticFunctions (>= v12.8.2.0) Tc3_PlasticHydraulic (>= v12.8.2.0)

Development environment

Target platform

PLC libraries to include

TwinCAT v3.1.4024.56

PC or CX (x64, x86)

Tc3_PlasticFunctions (>= v12.8.2.0)

Tc3_PlasticHydraulic (>= v12.8.2.0)