MotionParams

This core function is used to display a range of parameter values for a motion unit.

	Support of the parameters depends on the technology Some parameters are only available for specific drive technologies. Please note the comments in the "Choice" column!

	Function is asynchronous An implementation of runtime switching via this function block must always take the state of the function block into account. A written parameter does not become active immediately. The BusyState can be checked by setting it to FALSE

	Axes must be disabled Some parameters cannot be written while an axis is enabled.

Syntax:

FUNCTION_BLOCK FB_MotionParams EXTENDS FB_Corefunction

Properties

Name	Type	Access	Selection	Description
ActuatorBase	I_ActuatorParamsH	Get	Actuators only	Access to parameters for the base position of an actuator.
ActuatorWork	I_ActuatorParamsH	Get	Actuators only	Access to parameters for the working position of an actuator.
AsymTargeting	BOOL	Get, Set	Hydraulics only	TRUE if the parameters for the target approach are direction-dependent. Otherwise, the parameters for the negative direction are ignored and the parameters for the positive direction are used regardless of the direction.
AutoBrakeCalculation	BOOL	Get, Set	Hydraulics only	TRUE if the braking distance is determined automatically.
AxisIsNc	BOOL	Get	/	TRUE, if the axis is operated with TwinCAT NC.
BrakeDistanceM	LREAL	Get, Set	Hydraulics only	The braking distance time in negative direction. See also AsymTargeting.
BrakeDistanceP	LREAL	Get, Set	Hydraulics only	The braking distance time in positive direction.
CreepDistanceM	LREAL	Get, Set	Hydraulics only	The creep distance in negative direction. See also AsymTargeting.
CreepDistanceP	LREAL	Get, Set	Hydraulics only	The creep distance in positive direction.
CreepSpeedM	LREAL	Get, Set	Hydraulics only	The creep speed in negative direction.
CreepSpeedP	LREAL	Get, Set	Hydraulics only	The creep speed in positive direction.
CycleTime	LREAL	Get	/	The cycle time of the task in which the real-time functions of the axis are executed.
DriveIsCoE	BOOL	Get	/	TRUE, if the axis has a CoE interface.
DriveIsServo	BOOL	Get	/	TRUE if the axis is a servo drive.
DriveIsSimulated	BOOL	Get	/	TRUE if the drive of the axis is simulated.
DriveIsSoE	BOOL	Get	/	TRUE, if the axis has a SoE interface.
DriveReversed	BOOL	Get, Set	Not inverter	TRUE if the drive of the axis is inverted. Notice The outputs are swapped for actuators.
DriveType	UDINT	Get	/	A numeric identifier for the type of the connected drive. Notice The meaning of the constants is defined in the Tc2 NC or the Tc2_Hydraulics library.
EncoderInterpolation	LREAL	Get, Set	NC and hydraulics only	The divider for the encoder evaluation. It specifies the number of increments corresponding to the distance specified by EncoderWeighting.
EncoderIsAnalog	BOOL	Get	/	TRUE if the encoder of the axis uses an analog input.
EncoderIsSimulated	BOOL	Get	/	TRUE if the encoder of the axis is simulated.
EncoderMask	UDINT	Get	/	Encoder mask for encoder value overflow
EncoderMode	UDINT	Get	/	Operation mode of the encoder
EncoderReversed	BOOL	Get, Set	Not inverter	TRUE if the encoder of the axis is inverted. Notice The feedback inputs are swapped for actuators.
EncoderType	UDINT	Get	/	A numeric identifier for the type of the connected encoder. Notice The meaning of the constants is defined in the Tc2 NC or the Tc2_Hydraulics library.
EncoderWeighting	LREAL	Get, Set	NC and hydraulics only	The factor for encoder evaluation. It specifies the distance corresponding to a number of increments specified by EncoderInterpolation.
EncoderZeroShift	LREAL	Get, Set	NC and hydraulics only	The zero offset shift of the encoder.
HasAutoLimiting	BOOL	Get	/	TRUE if the axis uses an internal automatic limiting function.
LagControlled	BOOL	Get	/	TRUE if the axis has a position controller.
LagCtrlKp	LREAL	Get, Set	NC and hydraulics only	The kP factor of the position controller.
LagFilter	LREAL	Get, Set	NC and hydraulics only	The filter time of the lag error monitoring.
LagLimit	LREAL	Get, Set	NC and hydraulics only	The threshold value of the lag error monitoring.
LagMonitored	BOOL	Get, Set	NC and hydraulics only	TRUE, if the lag error monitoring of the axis is active.
MaxAccApplication	LREAL	Get, Set	Not actuators	An additional restriction on acceleration.
MaxAcceleration	LREAL	Get, Set	Not actuators	The maximum permissible acceleration. Notice A write operation on this parameter is always also applied to MaxAccApplication.
MaxDecApplication	LREAL	Get, Set	Not actuators	An additional limitation of the deceleration.
MaxDeceleration	LREAL	Get, Set	Not actuators	The maximum permissible deceleration. Notice A write operation on this parameter is always also applied to MaxDecApplication.
MaxJerk	LREAL	Get, Set	NC and hydraulics only	The maximum permissible jerk.
MaxVeloApplication	LREAL	Get, Set	Not actuators	An additional velocity restriction.
MaxVeloSystem	LREAL	Get, Set	Not actuators	The maximum velocity of the axis. Notice This parameter acts as a reference value for the maximum velocity output of the drive interface.
MinVeloApplication	LREAL	Get, Set	Not NC and actuators	The minimum velocity of the axis.
Persist	BOOL	Get, Set	NC and hydraulics only	Enables the persistent saving of parameter write operations of this function block on the target system.
ScalingOilPressure	LREAL	Get, Set	Hydraulics only	The scaling factor for the actual pressure acquisition.
SoftEndMax	LREAL	Get, Set	NC and hydraulics only	The maximum software limit switch.
SoftEndMaxEna	BOOL	Get, Set	NC and hydraulics only	Enable for the maximum software limit switch.
SoftEndMaxSystem	LREAL	Get, Set	NC and hydraulics only	For the load side of transforming axes: The converted maximum software limit switch of the drive side. For the drive side of transforming axes: The converted maximum software limit switch of the load side. For non-transforming axes: A copy of the maximum software limit switch.
SoftEndMin	LREAL	Get, Set	NC and hydraulics only	The minimum software limit switch.
SoftEndMinEna	BOOL	Get, Set	NC and hydraulics only	Enable for the minimum software limit switch.
SoftEndMinSystem	LREAL	Get, Set	NC and hydraulics only	For the load side of transforming axes: The converted minimum software limit switch of the drive side. For the drive side of transforming axes: The converted minimum software limit switch of the load side. For non-transforming axes: A copy of the minimum software limit switch.
Valid	BOOL	Get	/	TRUE if all parameters are valid.
HasTorqueLimiting¹	BOOL	Get	Obsolete	Returns the value of HasAutoLimiting.
MinVeloJog¹	LREAL	Get, Set	Obsolete	Returns the value of MinVeloApplication.

¹Obsolete

Interfaces

Type	Description
I_MotionParams	Standard interface on FB_MotionParams.

State interface

This core function implements a signal pattern that is different from the standards.

Name	Type	Access	Description
BusyState	BOOL	Get	TRUE, if the function block writes changed parameters.
ReadyState	BOOL	Get	TRUE if the function block has loaded all parameters at least once.

Requirements

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

Further Information

ActuatorParamsH