ItpWriteZeroShift
from library version 4.0
 | Outdated version The sole purpose of the function block is to ensure compatibility with existing projects. For new projects please use the function block ItpWriteZeroShiftEx. |
Interface
VAR_INPUT
bExecute : BOOL;
nChnId : UDINT;
nZsNo : UDINT;
tTimeOut : TIME;
END_VAR
VAR_OUTPUT
bBusy : BOOL;
bErr : BOOL;
nErrId : UDINT;
END_VAR
VAR_IN_OUT
sZeroShiftDesc : ZeroShiftDesc;
END_VAR
TYPE ZeroShiftDesc:
STRUCT
fShiftX : LREAL;
fShiftY : LREAL;
fShiftZ : LREAL;
END_STRUCT
END_TYPE
The ItpWriteZeroShift function block reads the offset shift components X, Y and Z for the given zero offset shift.
Input | Data type | Description |
|---|---|---|
bExecute | BOOL | The command is triggered by a rising edge at this input |
nChnId | UDINT | Channel ID |
nZsNo | UDINT | Number of the zero offset shift |
tTimeOut | TIME | ADS Timeout-Delay |
Input & output | Data type | Description |
|---|---|---|
sZeroShiftDesc | ZeroShiftDesc | The structure containing the components of the zero offset shift. This structure is only accessed for reading. |
|
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 every zero offset shift that can be set has two parameters (coarse and fine) for each axis. When using this function block to write a new zero offset shift, the new value is written into the 'fine parameter'. A value of 0.0 is entered into the 'coarse parameter'. This makes it possible to use a function block such as ItpReadZeroShift to read and modify a zero offset shift and to send it back to the NC. |
see also:
Requirements
|
Development Environment |
Target System |
PLC libraries to include |
|---|---|---|
|
TwinCAT v2.7.0 |
PC (i386) |
TcNciItp.lib |
|
TwinCAT v2.8.0 |
PC (i386) |
TcNci.lib |