'History' tab (EtherCAT Master Online Functions)

The following information refers to a specific, typical device type. Your screen may differ.

This help topic describes the 'History' editor of the EtherCAT 'Online Functions'. In the 'Online Functions' editor, select the EtherCAT master in the tree on the left and click the 'History' tab on top of the editor on the right.

This editor tab is only available for the EtherCAT master but not for slaves.

The tab provides a tabular view on the logged diagnostic information loaded from the EtherCAT master. The editor provides the possibility to customize the grid view, for example, by hiding particular log message types or filtering the messages. Furthermore you can delete the history log or export it to a csv file.

The Diagnosis Message buffer works like a ring buffer and displays the information from register 0x10F3 of the device. This ring buffer...

can record a maximum of 200 diagnostic messages.
distinguishes different diagnosis message types (severities): Info, Warning and Error.
can be configured to work in Overwrite Mode or Acknowledge Mode.

This topic contains the following sections:

Toolbar of the 'History' editor tab

Toolbar button Description

Refreshes the list by reading diagnostic log from the EtherCAT master.

Exports the messages visible in the list (depending on the 'Settings' and marked 'Filter' options) to a csv file.

Saves the current 'Settings' made on the 'History' tab on the controller.

Deletes the history log on the slave.

Toolbar button	Description
	Refreshes the list by reading diagnostic log from the EtherCAT master.
	Exports the messages visible in the list (depending on the 'Settings' and marked 'Filter' options) to a csv file.
	Saves the current 'Settings' made on the 'History' tab on the controller.
	Deletes the history log on the slave.

'Settings'

The settings are written to the slave to configure which type of message is logged by the slave. If only error message is configured and the configuration is written to the slave, INFO and WRN message will not be logged anymore.

Element Description

Show Info Messages Informational message include status reports and inform about status transitions, services or completed operations.
If activated, the slave adds info messages to the log.

Show Warning Messages If activated, the slave adds warning messages to the log.

Show Error Messages If activated, the slave adds error messages to the log.

Mode The mode can be selected on the Master node while the Online Functions are not started (i.e., while the controller is not connected to PLCnext Engineer), or on a slave node while the Online Functions are active.
Two settings can be selected from a list box:

Enable Acknowledge Mode: All messages will be acknowledged. If the message buffer is full, new messages are discarded.

Overwrite Mode: New messages overwrite older messages once the buffer is full even when they were not acknowledged before.

Element	Description
Show Info Messages	Informational message include status reports and inform about status transitions, services or completed operations. If activated, the slave adds info messages to the log.
Show Warning Messages	If activated, the slave adds warning messages to the log.
Show Error Messages	If activated, the slave adds error messages to the log.
Mode	The mode can be selected on the Master node while the Online Functions are not started (i.e., while the controller is not connected to PLCnext Engineer), or on a slave node while the Online Functions are active. Two settings can be selected from a list box: Enable Acknowledge Mode: All messages will be acknowledged. If the message buffer is full, new messages are discarded. Overwrite Mode: New messages overwrite older messages once the buffer is full even when they were not acknowledged before.

'Messages'

'Filter': By selecting a checkbox, you can apply filters to the messages listed.

Note
When exporting the messages (by clicking the corresponding button on the editor toolbar), the filter settings also apply. This means, only visible messages are exported.

Columns in the message table

Element Description

Severity Classifies the displayed message into INF (information), WRN (warning) and ERR (error).

Time Time stamp when the message was generated.

ID Message ID which corresponds to the subindex of register 0x10F3, value range 6 to 255.

Acknowledge Indicates whether the message is acknowledged or not.

Code Hexadecimal diagnostic message code read from slave. The lower byte is the code type, the higher byte represents the message ID.
The message code is listed and described in the corresponding device manual. In the manual you can find information on possible error causes and possibilities for remedy.

Message Content of the message.

Element	Description
Severity	Classifies the displayed message into INF (information), WRN (warning) and ERR (error).
Time	Time stamp when the message was generated.
ID	Message ID which corresponds to the subindex of register 0x10F3, value range 6 to 255.
Acknowledge	Indicates whether the message is acknowledged or not.
Code	Hexadecimal diagnostic message code read from slave. The lower byte is the code type, the higher byte represents the message ID. The message code is listed and described in the corresponding device manual. In the manual you can find information on possible error causes and possibilities for remedy.
Message	Content of the message.