ST_GearInPosCAOptions

The options can be set to specialize the synchronization profile of the slave.

TYPE ST_GearInPosCAOptions :
STRUCT
    AfterSyncVelocity                : MC_LREAL := MC_DEFAULT;
    AfterSyncAcceleration            : MC_LREAL := MC_DEFAULT;
    AfterSyncDeceleration            : MC_LREAL := MC_DEFAULT;
    AfterSyncJerk                    : MC_LREAL := MC_DEFAULT;
    MasterVelocityUndershootAllowed  : BOOL := TRUE;
    MasterVelocityOvershootAllowed   : BOOL := TRUE;
    MinimalSlavePosition             : MC_LREAL := MC_IGNORE;
    DirectionReversalAllowed         : BOOL := TRUE;
    OverrideSlaveDynamicRestrictions : BOOL := FALSE;
    GapControlMode                   : MC_GAP_CONTROL_MODE := mcGapControlModeGroupDefault;
    SlaveSyncPositionReferenceSystem : OTCID := 0;
    DynamicsReferenceSystem          : OTCID := 0;
    MasterSignalCorrection           : MC_MASTER_SIGNAL_CORRECTION := mcMasterSignalCorrectionAuto;
END_STRUCT
END_TYPE

Name

Type

Description

AfterSyncVelocity

(From TF5400 V3.1.10.1)

MC_LREAL

Maximum velocity of the slave axis after it has synchronized for the first time. The velocity value must be greater than 0. It is automatically limited by the axis parameter 'Maximum Velocity' of the slave axis.

The input is preset with MC_DEFAULT. The velocity is set according to the CA-Group parameter 'GearInPosAfterSyncDynamics'.

AfterSyncAcceleration

(From TF5400 V3.1.10.1)

MC_LREAL

Maximum acceleration of the slave axis after it has synchronized for the first time. The acceleration value must be greater than or equal to 1 and is limited by the axis parameter 'Maximum Acceleration' of the slave axis.

The input is preset with MC_DEFAULT. The acceleration is set according to the CA-Group parameter 'GearInPosAfterSyncDynamics'.

AfterSyncDeceleration

(From TF5400 V3.1.10.1)

MC_LREAL

Maximum deceleration of the slave axis after it has synchronized for the first time. The deceleration value must be greater than or equal to 1 and is limited by the axis parameter 'Maximum deceleration' of the slave axis.

The input is preset with MC_DEFAULT. The deceleration is set according to the CA-Group parameter 'GearInPosAfterSyncDynamics'.

AfterSyncJerk

(From TF5400 V3.1.10.1)

MC_LREAL

Maximum jerk of the slave axis after it has synchronized for the first time. The jerk must be ≥100. The input is preset with MC_DEFAULT. The deceleration is set according to the CA-Group parameter 'GearInPosAfterSyncDynamics'.

MasterVelocityUndershootAllowed

BOOL

This option only affects the synchronization profile and has no effect once the slave is InSync.

TRUE: No restrictions for the profile

FALSE: The slave velocity during the synchronization phase is always greater than or equal to the master velocity. If the slave velocity is lower than the master velocity at the time the command is issued, the slave accelerates with its synchronization dynamics to reach the master velocity as quickly as possible.

MasterVelocityUndershootAllowed and MasterVelocityOvershootAllowed cannot both be set to FALSE.

MasterVelocityOvershootAllowed

BOOL

This option only affects the synchronization profile and has no effect once the slave is InSync.

TRUE: No restrictions for the profile.

FALSE: The slave velocity during the synchronization phase is always less than or equal to the master velocity. If the slave velocity is greater than the master velocity at the time the command is issued, the slave decelerates with its synchronization dynamics in order to reach the master velocity.

MasterVelocityUndershootAllowed and MasterVelocityOvershootAllowed cannot both be set to FALSE.

MinimalSlavePosition

MC_LREAL

Absolute minimum position of the slave during the synchronization phase. This option only affects the synchronization profile and has no effect once the slave is InSync.

DirectionReversalAllowed

BOOL

This option only affects the synchronization profile and has no effect once the slave is InSync.

TRUE: No restrictions for the profile.

FALSE: The direction is determined by the sign of the slave velocity in the SlaveSyncPosition (gear ratio * master velocity). The slave is not allowed to move in the opposite direction.

OverrideSlaveDynamicRestrictions

BOOL

This option only affects the synchronization profile and has no effect once the slave is InSync. It only has an effect if the strategies mcSyncStrategyLate or mcSyncStrategySlow are used.

FALSE: The synchronization profile is recalculated each time the master velocity changes. An error may occur if no valid synchronization profile can be generated within the dynamic limits specified in the function block MC_GearInPosCA. In particular, a noisy master signal can lead to such an error (e.g. encoder axis). Furthermore, a high load may result if the master velocity changes frequently, e.g. if the master accelerates or decelerates, or if the master signal is noisy.

TRUE: The synchronization profile is not necessarily recalculated when the velocity of the master changes. Instead, the originally calculated profile is stretched or compressed. This avoids the errors described above (see FALSE). However, this could lead to violation of the dynamic limits specified in the function block MC_GearInPosCA (the Maximum Axis Dynamic Limits are not violated). This option can be used for synchronization to a noisy master axis (e.g. encoder axis) and can also reduce the computing time.

GapControlMode

MC_GAP_CONTROL_MODE

See the description of the data type MC_GAP_CONTROL_MODE for further information.

SlaveSyncPositionReferenceSystem

(From TF5400 V3.1.6.03)

OTCID

  • This input is of type OTCID and can therefore refer to a mover template.
  • For the position reference of a synchronized slave axis to the XTS motor path, the input SlaveSyncPositionReferenceSystem can be left open or set to the value zero so that compatibility with earlier versions of this function block is maintained.
  • For the position reference of a synchronized slave axis to the path defined by a Mover Template Object, set SlaveSyncPositionReferenceSystem to its object ID. Then the position input for the synchronized slave axis is interpreted according to the offset path.

DynamicsReferenceSystem

(From TF5400 V3.1.6.03)

OTCID

  • This input is of type OTCID and can therefore refer to a mover template.
  • For the dynamic reference to the XTS motor path, the input DynamicsReferenceSystem can be left open or set to the value zero so that compatibility with earlier versions of this function block is maintained.
  • For dynamic reference to the path defined by a Mover Template Object, set DynamicsReferenceSystem to its object ID. Then the dynamics of the motion profile will be constrained to the given path.

MasterSignalCorrection

(From TF5400 V3.2.60)

MC_MASTER_SIGNAL_CORRECTION

ST_GearInPosCAOptions 1:

Restricting the synchronization profile could make synchronization impossible for the slave.

If synchronization is impossible, MC_GearInPosCA issues an error.

Requirements

Development environment

Target platform

PLC libraries
to include

TwinCAT V3.1.4018.26

TF5400 Advanced Motion Pack V3.1.1.17

PC or CX (x64)

Tc3_McCollisionAvoidance, Tc3_McCoordinatedMotion, Tc2_MC2