IoDrvEtherCAT.GetStatistics (METH)ΒΆ

METHOD GetStatistics

Reads the statistics data and copies it to the output values. The number of sent frames or TX error counts could be then used within the application. The statistic information could be reset by calling ClearStatistics In a well working runtime system the values of udiLostFrameCount, udiTxErrorCount and udiRxErrorCount should be always zero. The same information is also shown at the status page of each EtherCAT master.

InOut:

Scope

Name

Type

Comment

Output

udiSendFrameCount

UDINT

Number of total EtherCAT frames sent

udiFramesPerSecond

UDINT

Number of frames per second

udiLostFrameCount

UDINT

Number of total lost frames. A frame is lost due to EMC, connection or other hardware problems for example. In addition, if the CRC does not match then this counter is increased as the network driver skips the frame.

udiTxErrorCount

UDINT

Number of frames that could be not sent as the runtime function sendethframe returns not ERR_OK.

udiRxErrorCount

UDINT

Number of missing received frames. Each sent frame must be also received at least in the next IEC cycle. If the runtime system (TCP-IP stack) is busy or the priority is low then frames could be delayed for sending or receiving and this counter will increase.