ItpReadRParams

ItpReadRParams 1:
ItpReadRParams 2:

Outdated version

The sole purpose of the function block is to ensure compatibility with existing projects. For new projects please use the function block ItpReadRParamsEx.

The ItpReadRParams function block reads the NC’s arithmetic parameters, also known as R-parameters. A more detailed description of the arithmetic parameters can be found here. A total of 1000 R-parameters are available, of which the first 900 (0..899) are local, so that they are only visible in the current NC channel. The other 100 (900..999) R-parameters are global, and are thus visible from anywhere in the NC.

ItpReadRParams 3: Inputs

VAR_INPUT
    bExecute       : BOOL;
    nChnId         : UDINT;
    pAddr          : PVOID;
    nIndex         : DINT;
    nCount         : DINT;
    tTimeOut       : TIME;
END_VAR

Name

Type

Description

bExecute

BOOL

A rising edge starts the read operation.

nChnId

UDINT

ID of the NC channel whose R-parameters are to be read.

pAddr

PVOID

Address of the target variables of the data to be read. The data are written by the NC directly from the specified address. i.e. nIndex is not to be interpreted as offset from pAddr. The data are usually in an array of type LREAL, which has to be defined by the user.

nIndex

DINT

Describes the index of the R-parameter to be read from an NC perspective.

nCount

DINT

Number of R-parameters to be read

tTimeOut

TIME

ADS Timeout-Delay

ItpReadRParams 4: 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).

See also:

ItpWriteRParams

Requirements

Development environment

Target platform

PLC libraries to be linked

TwinCAT v3.1.0

PC or CX (x86 or x64)

Tc2_NCI