CfgRead3DAxisIds

CfgRead3DAxisIds 1:

The function block CfgRead3DAxisIds reads the axis configuration of a 3D group.

CfgRead3DAxisIds 2: Inputs

VAR_INPUT
    bExecute       : BOOL;
    nGroupId       : UDINT;
    pAddr          : PVOID;
    tTimeOut       : TIME;
END_VAR

Name

Type

Description

bExecute

BOOL

The command is triggered by a rising edge at this input.

nGroupId

UDINT

ID of the 3D group

pAddr

PVOID

Address of the variable into which the function block writes the axis IDs of the group assignment (array with three elements of type UDINT).

tTimeOut

TIME

ADS Timeout-Delay

CfgRead3DAxisIds 3: 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).

Sample:

VAR
    (* instance *)
    ReadAxIds : CfgRead3DAxisIds;
    AxIds : ARRAY[1..3] OF UDINT;
END_VAR
ReadAxIds( bExecute := TRUE,
    nGroupId := 4,
    pAddr := ADR( AxIds ),
    tTimeOut := T#1s );

AxIds now contains the three axis IDs for the 3D group with the group ID 4.

Requirements

Development environment

Target platform

PLC libraries to be linked

TwinCAT v3.1.0

PC or CX (x86 or x64)

Tc2_NCI