FB_EcReadBIC

FB_EcReadBIC 1:

The function block FB_EcReadBIC can be used to read the BIC from the EEPROM of an EtherCAT slave via ADS. For this the slave must contain the BIC in the EEPROM.

FB_EcReadBIC 2: Inputs

VAR_INPUT
    sNetId     : T_AmsNetId; 
    nSlaveAddr : UINT; 
    bExecute   : BOOL;
    tTimeout   : TIME := DEFAULT_ADS_TIMEOUT; 
END_VAR

Name

Type

Description

sNetId

T_AmsNetId

String containing the AMS network ID of the EtherCAT master device. (Type: T_AmsNetId)

nSlaveAddr

UINT

Fixed address of the EtherCAT slave to which the SDO upload command should be sent.

bExecute

BOOL

The function block is activated by a positive edge at this input.

tTimeout

TIME

Maximum time allowed for the execution of the function block.

FB_EcReadBIC 3: Outputs

VAR_OUTPUT
    bBusy     : BOOL;
    bError    : BOOL;
    nErrId    : UDINT;
    sBICValue : STRING(1023)
    stMSID    : ST_SplittedBIC
END_VAR

Name

Type

Description

bBusy

BOOL

This output is set when the function block is activated, and remains set until a feedback is received.

bError

BOOL

This output is set after the bBusy output has been reset when an error occurs in the transmission of the command.

nErrId

UDINT

Supplies the ADS error code associated with the most recently executed command if the bError output is set.

sBICValue

STRING(1023)

This output contains (after an error-free run) the BIC of the EtherCAT slave after the bBusy output has been reset, e.g. "„1P193995SBTN0002agdw1KEL7411                        Q1    2P112104020018".

stMSID

ST_SplittedBIC

This output contains (after an error-free run) the substrings of the BIC of the EtherCAT slave after the bBusy output has been reset.

The following substrings are assigned for the above BIC:
sItemNo = "193995"
sBTN = "0002agdw"
sDescription = "EL7411"
sQuantity = "1"
sBatchNo = "112104020018"

Sample of an implementation in ST

PROGRAM TEST_EcReadBIC 
VAR
    fbEcBIC    : FB_EcReadBIC;
    sNetId     : T_AmsNetId := '172.16.2.131.2.1';
    bExecute   : BOOL := TRUE;
    nSlaveAddr : UINT := 1006;
    sECBIC     : STRING(1023);
    stEcBIC    : ST_SplittedBIC;
    bError     : BOOL;
    nErrId     : UDINT;
END_VAR

fbEcBIC(sNetId:= sNetID, nSlaveAddr:= nPort, bExecute:= bExecute, tTimeout:= T#5s);;
IF NOT fbEcBIC.bBusy THEN
     bExecute := FALSE;
     IF NOT fbEcBIC.bError THEN
          stEcBIC   := fbEcBIC.stMSID;
          sECBIC    := fbEcBIC.sBICValue;
     END_IF
     fbEcBIC (bExecute:= bExecute);
END_IF

Prerequisites

Development environment

Target platform

PLC libraries to include

TwinCAT v3.1.0

PC or CX (x86, x64, Arm®)

Tc2_EtherCAT