IOF_GetDeviceInfoByName

IOF_GetDeviceInfoByName 1:

The IOF_GetDeviceInfoByName function block determines the device ID of an IO device and its TwinCAT network address, knowing the device name. The device IDs cannot be configured by the user.

VAR_INPUT

VAR_INPUT
    NETID      : T_AmsNetId;
    DEVICENAME : T_MaxString;
    START      : BOOL;
    TMOUT      : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR

NETID: The AmsNetId of the TwinCAT computer on which the function is to be executed can be entered here (type: T_AmsNetID). If it is to be run on the local computer, an empty string can be entered.

DEVICENAME: The device name of an IO device (type: T_MaxString).

START: the block is activated by a positive edge at this input.

TMOUT: States the length of the timeout that may not be exceeded during execution of the command.

VAR_OUTPUT

VAR_OUTPUT
    BUSY        : BOOL;
    ERR         : BOOL;
    ERRID       : UDINT;
    DEVICEID    : UDINT;
    DEVICENETID : T_AmsNetId;
END_VAR

BUSY: When the function block is activated this output is set. It remains set until a feedback is received.

ERR: If an error should occur during the transfer of the command, then this output is set once the BUSY output was reset.

ERRID: Supplies the ADS error number when the ERR output is set.

DEVICEID: The device ID of an I/O device.

DEVICENETID: The network address of an IO device (type: T_AmsNetID).

Requirements

Development environment

Target platform

IO hardware

PLC libraries to be integrated (category group)

TwinCAT v3.1.0

PC or CX (x86, x64, ARM)

All IO devices

Tc2_IoFunctions (IO)