IOF_GetDeviceInfoByName
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) |