MC_SetPosition

Functional Description

This function block sets a position value at the actual position of the motor. The zero point is defined by the position value. The function block can only be used when the motor is at a standstill.

Library and Namespace

Library name: GMC Independent PLCopen MC

Namespace: GIPLC

Graphical Representation

Inputs

Input	Data type	Description
Execute	BOOL	Value range: FALSE, TRUE. Default value: FALSE. A rising edge of the input Execute starts the function block. The function block continues execution and the output Busy is set to TRUE. A rising edge at the input Execute is ignored while the function block is being executed.
Position	DINT	Value range: -2147483648...2147483647 Default value: 0 Position in user-defined units. Value for position setting.
Relative	BOOL	Value range: FALSE, TRUE. Default value: FALSE. oFALSE: The actual position is set to the value of the input Position. oTRUE: The value of the Position is added to the actual position.

Input

Data type

Description

Execute

BOOL

Value range: FALSE, TRUE.

Default value: FALSE.

A rising edge of the input Execute starts the function block. The function block continues execution and the output Busy is set to TRUE.

A rising edge at the input Execute is ignored while the function block is being executed.

Position

DINT

Value range: -2147483648...2147483647

Default value: 0

Position in user-defined units.

Value for position setting.

Relative

BOOL

Value range: FALSE, TRUE.

Default value: FALSE.

oFALSE: The actual position is set to the value of the input Position.

oTRUE: The value of the Position is added to the actual position.

Outputs

Output	Data type	Description
Done	BOOL	Value range: FALSE, TRUE. Default value: FALSE. oFALSE: Execution has not been started, or an error has been detected. oTRUE: Execution terminated without an error detected.
Busy	BOOL	Value range: FALSE, TRUE. Default value: FALSE. oFALSE: Function block is not being executed. oTRUE: Function block is being executed.
Error	BOOL	Value range: FALSE, TRUE. Default value: FALSE. oFALSE: Execution of the function block is running, no error has been detected. oTRUE: An error has been detected in the execution of the function block.
ErrorID	WORD	Returns the value of a diagnostic code. Refer to Library Diagnostic Codes. If the value is 0 and if the output Error of this function block is set to TRUE, then the diagnostic code can be read with the output AxisErrorID of the function block MC_ReadAxisError.

Inputs/Outputs

Input/Output	Data type		Description
Axis	Axis_Ref		Reference to the axis (instance) for which the function block is to be executed (corresponds to the name of the axis). The name of the axis must be defined in the EcoStruxure Machine Expert Devices tree.

Additional Information

Operating Mode Homing