FC_SetposSingle

FC_SetposSingle - General Information

Overview

Type:	Function
Available as of:	SystemInterface_1.32.6.0
Versions:	Current version

Task

Manipulate the position of an object.

Description

The positions of the object identified by i_stDevId are manipulated. The new position is derived from i_lrPosition. This function can be used on logical encoders and axes.

oIf i_stDevId is a logical encoder, note the maximum value range of parameter i_lrPosition of the logical encoder.

oIf i_stDevId is a sum encoder, then the first logical encoder in the sum encoder is set to the absolute value and the others to zero during the absolute setting. During the relative setting, the first logical encoder is set relatively and the others remain unchanged.

NOTE: Real axes connected to the synchronized encoder inputs at this point in time or machine parts attached to them can be damaged. When calling the function FC_SetposSingle, the EncoderPosition of the synchronized encoder output is changed; this changed position is automatically passed on to all associated synchronized encoder inputs.

WARNING

SHORT-TIME VELOCITY PEAKS

Make sure that when calling the function (using i_stDevId = synchronized encoder output), no axes are connected to the synchronized encoder inputs.

Failure to follow these instructions can result in death, serious injury, or equipment damage.

Parameter DevId	Meaning
LXM62DxS	Axis
L_ENC	Logical encoder
SENC	Sum encoder
SYNC_DOUT	Synchronized Encoder output (from V00.22.00) Only the modes "NONE" and "ABSOLUT" are supported.

Parameter Mode	Meaning
ET_SetposMode.None	No position change
ET_SetposMode.Absolute	Absolute setting No influence on the virtual portion of logical encoders
ET_SetposMode.Relative	Relative setting No influence on the virtual portion of logical encoders
ET_SetposMode.AbsolutePlus	Absolute setting Plus setting virtual portion of logical encoders to zero
ET_SetposMode.RelativePlus	Relative setting Plus setting virtual portion of logical encoders to zero
ET_SetposMode.AbsPhaseOffset	-> of PhasePosition (for i_stDevId = L_ENC) -> YOffsetPos (for i_stDevId = LXM62DxS)
ET_SetposMode.RelPhaseOffset	-> of PhasePosition (for i_stDevId = L_ENC) -> YOffsetPos (for i_stDevId = LXM62DxS)
ET_SetposMode.AbsCoupling	-> of EngagePosition (for i_stDevId = L_ENC)
ET_SetposMode.RelCoupling	-> of EngagePosition (for i_stDevId = L_ENC)

Interface

Input	Data type	Description
i_stDevId	ST_LogicalAddress	ID of the device
i_etMode	ET_SetposMode	ET_SetposMode
i_lrPosition	LREAL	Encoder position that has to be set for the device

Return Value

Data type	Description
DINT	0: OK -1: Logical address of the device invalid -2: Indeterminable mode

Examples

FC_SetposSingle(Vorschub, ET_SetposMode.Absolute, 0.0 );
FC_PosStartJerk(....);
FC_SetposSingle(SyncDataOut.stLogAddr, ET_SetposMode.Absolute, 0.0 );