ItpReadZeroShift
The ItpReadZeroShift function block reads the offset shift components X, Y and Z for the given zero offset shift.
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. |
Outdated version The sole purpose of the function block is to ensure compatibility with existing projects. For new projects please use the function block ItpReadZeroShiftEx. |
Inputs
VAR_INPUT
bExecute : BOOL;
nChnId : UDINT;
nZsNo : UDINT;
tTimeOut : TIME;
END_VAR
Name | Type | Description |
---|---|---|
bExecute | BOOL | A rising edge starts the read operation. |
nChnId | UDINT | Channel ID |
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 |
/ Inputs/Outputs
VAR_IN_OUT
sZeroShiftDesc : ZeroShiftDesc;
END_VAR
Name | Type | Description |
---|---|---|
sZeroShiftDesc | ZeroShiftDesc | The structure containing the components of the zero offset shift. |
Outputs
VAR_OUTPUT
bBusy : BOOL;
bErr : BOOL;
nErrId : UDINT;
END_VAR
Name | 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). |
TYPE ZeroShiftDesc:
STRUCT
fShiftX : LREAL;
fShiftY : LREAL;
fShiftZ : LREAL;
END_STRUCT
END_TYPE
See also:
ItpWriteZeroShift; ItpSetZeroShiftNull
Requirements
Development environment |
Target platform |
PLC libraries to be linked |
---|---|---|
TwinCAT v3.1.0 |
PC or CX (x86 or x64) |
Tc2_NCI |