MC_SetCoordinateTransform

TF5410 TwinCAT 3 Motion Collision Avoidance	TF5420 TwinCAT 3 Motion Pick-and-Place
	MC Group with Pick-and-Place	MC Group Coordinated Motion
	(up to and including v3.2)

The function block MC_SetCoordinateTransform activates a coordinate transformation for successor movements. The successful activation is indicated by Active or Done.

Decouples the successor movements from a transport system (see MC_TrackConveyorBelt).

Successor movements (e.g. MC_MovePath) take place relative to the coordinate transformation.

	Use case for changing the reference system The `MC` group can be decoupled by using `MC_SetCoordinateTransform` and changing the reference system.

Inputs

VAR_INPUT
    Execute        : BOOL;
    CoordTransform : MC_COORD_REF;
END_VAR

Name	Type	Description
Execute	BOOL	The command is triggered by a rising edge at this input.
CoordTransform	MC_COORD_REF	Reference to a coordinate system (see MC_COORD_REF).

Inputs/outputs

VAR_IN_OUT
    AxesGroup      : AXES_GROUP_REF;
END_VAR

Name	Type	Description
AxesGroup	AXES_GROUP_REF	Reference to a group of axes (see Cyclic Group Interface).

Outputs

VAR_OUTPUT
    Done           : BOOL;
    Busy           : BOOL;
    Active         : BOOL;
    CommandAborted : BOOL;
    Error          : BOOL;
    ErrorId        : UDINT;
END_VAR

Name	Type	Description
Done	BOOL	This output becomes `TRUE` when the command was successfully executed.
Busy	BOOL	This output becomes `TRUE` when the command is started with `Execute` and remains so as long as the function block executes the command. If `Busy` becomes `FALSE` again, the function block is ready for a new command. At the same time, one of the outputs `Done`, `CommandAborted` or `Error` is set.
Active	BOOL	`Active` indicates that the command is being executed. `Active` indicates that the reference system has been successfully set (MC Coordinated Motion Group only). `Active` indicates a delay in conveyor tracking (MC Coordinated Motion Group only). `Active` becomes `FALSE` if one of the outputs `Done`, `CommandAborted` or `Error` is set to `TRUE`. Note: According to the PLCopen definition, `Active` is reset if `Done` is set to `TRUE`. In the event of an insignificant or non-existent delay, `Active` can only be set to `TRUE` for a short period of time. If the PLC program checks `Active`, it is therefore advisable to also check `Done`.
CommandAborted	BOOL	This output becomes `TRUE` if the command was interrupted by another command.
Error	BOOL	This output becomes `TRUE` if an error has occurred during command execution.
ErrorId	UDINT	Contains the command-specific error code of the last executed command. Details of the error code can be found in the ADS error documentation or in the NC error documentation (error codes 0x4nnn and 0x8nnn).

Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT V3.1.4022.25 TF5400 Advanced Motion Pack V3.1.6.03	PC or CX (x64)	Tc3_McCoordinatedMotion, Tc2_MC2