FB_MDP_ScanModules

FB_MDP_ScanModules 1:

The function block enables a device to be scanned for a certain MDP module.
Selection can be made if several instances of the module type are present. The dynamic Module ID for the selected module type is determined by the function block.
This is an important component of the MDP addressing, which is represented in the structure ST_MDP_Addr.

VAR_INPUT

VAR_INPUT
    bExecute        : BOOL;
    nModuleType     : WORD;             (* chosen module type out of the module type list *)
    iModIdx         : USINT;                (* chosen index(0..n) of the demanded module type. E.g. second NIC(idx 1) of three found NICs. *)
    tTimeout        : TIME  := DEFAULT_ADS_TIMEOUT; (* States the time before the function is cancelled. *)
    sAmsNetId       : T_AmsNetId;          (* keep empty '' for the local device *)
END_VAR

bExecute

The function block is called by a rising edge on the input bExecute, if the block is not already active.

nModuleType

The MDP module type is specified at this input. The possible types are listed in the enumeration E_MDP_ModuleType. (General information on the module type list

iModIdx

If several instances of an MDP module exist, a selection can be made by means of the input iModIdx (0,...,n).
In the case of uncertainty concerning the selection: information about which module is explicitly concerned can be queried via the function block FB_MDP_ReadModuleHeader after scanning.

tTimeout

Specifies a maximum length of time for the execution of the function block.

sAmsNetId

For local access don't specify this input or allocate an empty string. For remote access to another computer specify its AMS Net Id.

VAR_OUTPUT

VAR_OUTPUT
    bBusy             : BOOL;
    bError            : BOOL;     (* indicates if Scan was successfull or not *)
    nErrID            : UDINT;
    nDynModuleId      : BYTE;     (* Dynamic Module Id *)
    iModuleTypeCount  : USINT;        (* returns the number of found modules equal the demanded module type. *)
    iModuleCount      : USINT;        (* returns the number of all detected MDP modules. *)
END_VAR

bBusy

This output is TRUE as long as the function block is active.

bError

Becomes TRUE as soon as an error situation occurs.

nErrID

Returns an error code if the bError output is set.

nDynModuleId

This output indicates the dynamic Module ID determined for the selected module.

iModuleTypeCount

The output iModuleTypeCount indicates the number of modules that correspond to the specified type.

iModuleCount

The output iModuleCount indicates the entire number of modules on the device.

Requirements

Development environment

Target platform

PLC libraries to be linked

TwinCAT v2.11.0 Build >= 1541

PC or CX (x86, ARM)

TcMDP.Lib