ItpReadZeroShiftEx

from library version 6.1.21 and TwinCAT version 2.10 Build 1304

ItpReadZeroShiftEx 1:

The ItpReadZeroShiftEx function block reads the offset shift components X, Y and Z for the given zero offset shift.

Interface

VAR_INPUT
    bExecute       : BOOL;
    nZsNo          : UDINT;
    tTimeOut       : TIME;
END_VAR

VAR_IN_OUT
    sNciToPlc      : NciChannelToPlc;
    sZeroShiftDesc : ZeroShiftDesc;
END_VAR

VAR_OUTPUT
    bBusy          : BOOL;
    bErr           : BOOL;
    nErrId         : UDINT;
END_VAR

TYPE ZeroShiftDesc:
STRUCT
    fShiftX        : LREAL;
    fShiftY        : LREAL;
    fShiftZ        : LREAL;
END_STRUCT
END_TYPE

Input	Data type	Description
bExecute	BOOL	The command is triggered by a rising edge at this input.
nZsNo	UDINT	Number of the zero offset shift on the NC side G54 to G59 are zero offset shifts. The valid range of values for 'nZsNo' is therefore from 54 to 59.
tTimeOut	TIME	ADS Timeout-Delay
Input & output	Data type	Description
sNciToPlc	NciChannelToPlc	The structure of the cyclic channel interface from the NCI to the PLC. This structure is only accessed for reading.
sZeroShiftDesc	ZeroShiftDesc	The structure containing the components of the zero offset shift.

Output	Data type	Description
bBusy	BOOL	This output remains TRUE until the function block has executed a command, but at the longest for the duration supplied to the 'Timeout' input. While Busy = TRUE, no new command will be accepted at the inputs. Please note that it is not the execution of the service but its acceptance whose time is monitored.
bErr	BOOL	This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in ‘nErrId’. Is reset to FALSE by the execution of a command at the inputs.
nErrId	UDINT	Contains the command-specific error code of the most recently executed command. Is reset to 0 by the execution of a command at the inputs. The error numbers in ErrId can be looked up in the ADS error documentation or in the NC error documentation (error codes above 0x4000).

	For reasons of compatibility, there are two entries (coarse and fine) for each axis in each zero offset shift (e.g. G54). These two entries must be added together. This function block evaluates both the entries and adds them together automatically.

Development Environment	Target System Type	PLC Libraries to include
TwinCAT v2.10.0	PC (i386)	TcNci.lib