IOF_GetBoxCount 1:

The IOF_GetBoxCount function block reads the number of configured and active boxes (box = slave, module, station) of an IO device.


    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: DeviceID specifies the device on which the function is to be executed. The device IDs are specified by the TwinCAT system during the hardware configuration.

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;

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.

BOXCOUNT: The number of boxes.


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)