FB_MDP_ReadIndex

The function block enables an element of the IPC diagnosis data to be queried. This can be part of the configuration area as well as the device area.

VAR_INPUT

VAR_INPUT
    bExecute        : BOOL;             (* Function block execution is triggered by a rising edge at this input.*)
    nIndex          : WORD;
    nSubIndex       : BYTE;
    pDstBuf         : POINTER TO BYTE;          (* Contains the address of the buffer for the received data. *)
    cbDstBufLen     : UDINT;            (* Contains the max. number of bytes to be received. *)
    tTimeout        : TIME := DEFAULT_ADS_TIMEOUT;  (* States the time before the function is cancelled. *)
    sAmsNetId       : T_AmsNetId;           (* keep empty '' for the local device *)
END_VAR

bExecute

The function block is called by a rising edge on the input bExecute, if the block is not already active.

nIndex

The first part of the addressing belonging to the selected element is specified at this input.

nSubIndex

The second part of the addressing belonging to the selected element is specified at this input.

pDstBuf

The memory address of the data buffer is specified at this input. The received data are stored there if the query is successful.

cbDstBufLen

The length of the data buffer in bytes is specified at this input.

tTimeout

Specifies a maximum length of time for the execution of the function block.

sAmsNetId

For local access don't specify this input or allocate an empty string. For remote access to another computer specify its AMS Net Id.

VAR_OUTPUT

VAR_OUTPUT
    bBusy       : BOOL;
    bError      : BOOL;
    nErrId      : UDINT;
    nCount      : UDINT;
END_VAR

bBusy

This output is TRUE as long as the function block is active.

bError

Becomes TRUE as soon as an error situation occurs.

nErrID

Returns an error code if the bError output is set.

nCount

This output indicates the number of bytes read.

Requirements

Development environment

Target system type

PLC libraries to include

TwinCAT v2.11.0 Build >= 1541

PC or CX (x86, ARM)

TcMDP.Lib [version 1.4.0 or higher]