FB_EcGetSlaveCrcError

FB_EcGetSlaveCrcError 1:

The function block FB_EcGetSlaveCrcError allows the CRC error counters of the individual ports (A, B and C) of a slave to be read. If the call is successful, the output variable crcError, whose type is ST_EcCrcError, contains the requested CRC error counter.

The function block FB_EcGetSlaveCrcError can only be used with slaves with up to 3 ports (e.g. EK1100). The function block FB_EcGetSlaveCrcErrorEx can also be used with slaves with up to 4 ports (e.g. EK1122).

FB_EcGetSlaveCrcError 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 whose CRC error counter is to be read.

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_EcGetSlaveCrcError 3: Outputs

VAR_OUTPUT
    bBusy    : BOOL;
    bError   : BOOL;
    nErrId   : UDINT;
    crcError : ST_EcCrcError; 
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.

crcError

ST_EcCrcError

CRC error counters for the individual ports

Example of an implementation in ST:

PROGRAM TEST_GetSlaveCrcError
VAR
    fbGetSlaveCrcError : FB_EcGetSlaveCrcError;
    sNetId : T_AmsNetId := '172.16.2.131.2.1';
    bExecute : BOOL;
    crcError : ST_EcCrcError;
    nSlaveAddr : UINT := 1001;
    bError : BOOL;
    nErrId : UDINT;
END_VAR

fbGetSlaveCrcError(sNetId:= sNetId, nSlaveAddr:= nSlaveAddr, bExecute:=bExecute);
crcError := fbGetSlaveCrcError.crcError;
bError := fbGetSlaveCrcError.bError;
nErrId := fbGetSlaveCrcError.nErrId;

Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT v3.1.0

PC or CX (x86, x64, ARM)

Tc2_EtherCAT