IOF_GetBoxNetId 1:

Some boxes (slave modules) can be assigned an AmsNetId during the configuration in TwinCAT. The AmsNetId can then be used to execute firmware functions on the box. The IOF_GetBoxNetId function block determines the TwinCAT network address, knowing the device ID of the master and the fieldbus address or logical address in the fieldbus. The device IDs are specified by the TwinCAT system during the configuration and cannot be configured by the user.


    NETID     : T_AmsNetId;
    START     : BOOL;

NETID: The network address 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.

DEVICEID: The master's device ID.

BOXADDR: The fieldbus address, or the logical address of the box (slave module)whose AmsNetId is to be read.

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.


    BUSY     : BOOL;
    ERR      : BOOL;
    ERRID    : UDINT;
    BoxNetId : T_AmsNetId;

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.

BoxNetId: The TwinCAT network address of the box as a string (type: T_AmsNetID).


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)