The leader in industrial automation and control solutions

Overview & Concepts

EasyDiagnoser is a diagnostic utility included with EasyBuilder Pro that helps monitor communication and system activity within an HMI project. It provides real-time visibility into how the HMI is interacting with connected devices, making it useful for troubleshooting communication issues and verifying that drivers and data exchanges are functioning correctly.

EasyDiagnoser displays runtime diagnostic information generated by the HMI, allowing engineers to observe communication behavior and system messages while the project is running.

Key areas of information provided include:

  • Communication polling activity – Shows data exchanges between the HMI and configured devices.
  • Device communication status – Indicates whether connected PLCs or devices are responding properly.
  • System and macro output messages – Displays runtime messages that can help identify errors or abnormal conditions.

EasyDiagnoser is commonly used during project development, system commissioning, and maintenance. By allowing users to observe communication activity and system responses in real time, it helps identify configuration problems, communication faults, or other operational issues within the HMI project.

Please note that EasyDiagnoser is for Legacy HMI products (HMI5000 Series) only, and not cMT / cMT X Series units. For cMT / cMT X Series diagnostics, please see the cMT Diagnoser feature page.

Implementation

Configuration

Open Utility Manager and click EasyDiagnoser.

Set the HMI IP address. Enter IP address or click [Search All], and then enter [Project Port].

EasyDiagnoser Select HMI dialog: IP tab.  Enter the IP address of the HMI here
EasyDiagnoser Select HMI dialog: Name tab.  Click the search or Search All buttons to view the HMis that are in the same network neighborhood as the PC.

Or, during On-line simulation, right click and select [Run EasyDiagnoser] to open EasyDiagnoser. EasyDiagnoser will monitor the communication between PC and PLC.

When in online-simulation mode, right-click the simulation window and select the "Run EasyDiagnoser" option.

When finished, click [OK], EasyDiagnoser dialog box is shown in the following figure

EasyDiagnoser main dialog window.

EasyDiagnoser Settings

ItemDescription
FileSave As
The communication data can be saved as .xls file which can be opened by Excel.
Exit
Exits current file.
ViewDevice Bar
Displays Device window.
Package Bar
Displays Package window
Logger Bar
Displays Logger window.
Output Bar
Displays Output window.
OptionsToolbars
Displays toolbar icons of Device Bar, Package Bar, Logger Bar, and Output Bar.
Status Bar
Displays information of CAP, NUM, and SCRL at the bottom of EasyDiagnoser window.
Update Package List
Displays the Polling Package information of current page.
Show Object ID (HMI)
Shows the ID of the objects on HMI viewing window.
Clear Activity List
Clears all the information recorded during communication.
HelpDisplays EasyDiagnoser version information.

Activity Area

In the activity area, users can observe the communication between HMI and PLC.

Screenshot of EasyDiagnoser Activity area, where communication between the HMI and PLC can be observed.
ItemDescription
CommandRead + Write
Displays Read and Write information in activity area.
Read
Displays only Read information in activity area.
Write
Displays only Write information in activity area.
DeviceAll
Displays the information of Local HMI and PLC.
• If command is set to Read + Write, the Read and Write information of Local HMI and PLC will be displayed in the activity area.
• If command is set to Read, the Read information of Local HMI and PLC will be displayed in the activity area.
• If command is set to Write, the Write information of Local HMI and PLC will be displayed in the activity area.

Local HMI
Displays the information of Local HMI.
• If command is set to Read + Write, the Read and Write information of Local HMI will be displayed in the activity area.
• If command is set to Read, the Read information of Local HMI will be displayed in the activity area.
• If command is set to Write, the Write information of Local HMI will be displayed in the activity area.

PLC
Displays the information of PLC.
• If command is set to Read + Write, the Read and Write information of PLC will be displayed in the activity area.
• If command is set to Read, the Read information of PLC will be displayed in the activity area.
• If command is set to Write, the Write information of PLC will be displayed in the activity area.
StationSelects the PLC station number to be displayed.
(This function is disabled when selecting [All] in [Device].)
Address TypeSelects all or a preferred address type to be displayed.
(This function is disabled when selecting [All] in [Device].)
RangeSets the range of address types.
(This function is disabled when selecting [All] in [Device].)
CaptureClick to start/stop capturing the communication message.

Polling Packages

Polling Packages section of the main EasyDiagnoser window
ItemDescription
Package IDUses the Package ID to check the error of the object.
DeviceDisplays HMI and PLC type.
StationDisplays PLC station number.
IndexDisplays the index register numbers of the objects.
Address / LengthDisplays the device type and the size of the package (in words).
When expanding a package ID containing multiple objects, then you can select one of the objects individually .
ItemDescription
ObjectCheck the object in the package.
ScreenThe window in the project where the object is placed.
IDThe ID number of the object.
AddressThe address of the object.

Notes:

  • Click [Package ID], the device station number will be displayed in the 3rd column
Click [Package ID], the device station number will be displayed in the 3rd column
  • Double click [Package ID] then select [object] to display the position of the object. For example, select [Numeric Input] and the screen no. displays 10. This shows that this object is in window no. 10 in the project and will be marked with pink frame on HMI as shown in the following figures:
If an object is selected in EasyDiagnoser, the corresponding object in the Simulation Window will be marked with a pink frame

Devices

This window displays the information of both the HMI and the PLC or other configured device.

EasyDiagnoser Devices window.  This window displays the information of both the HMI and PLC, or other configured devices.

Output (Macro Debug)

With Macro Trace function, the executing status of Macro can be seen. In the illustration below, for [ID 1, Ln 7] and [ID 1, Ln 12]

ID 1 represents Macro name.

Ln 7 and Ln 12 represent that data are in the 7th and 12th line of Macro.

EasyDiagnoser Output (macro Debug) window.  With Macro Trace function, the executing status of Macro can be seen

Error Code Identification and Handling

In the activity area, the reason of error can be found through the error codes listed below:

Error CodeCause of Communication Error
0Normal
1The device is busy and not yet ready to process a command.
2Communication error due to unexpected reason.
3The device does not exist.
4The device using the specified station number does not exist.
5Incorrect address format.
6Read/Write unsupported address.
7The driver of the device does not exist.
8The COM port does not exist.
9Incorrect IP address or unable to connect the device.
10Checksum error.
11Unidentified command.
12Ignore
20The USB device is improperly connected.
21The CAN Bus device is improperly connected.
22No reply from the device.
23Insufficient data read from the device before timeout.
24The Conversion Tag used by the object does not exist or the content is incorrect.
25HMI is not accepting any commands from a remote HMI.
251Read/Write exceeding number of words from/to the register of the MODBUS device.
252MODBUS device replies incorrect data format.
253MODBUS device checksum error.

When error occurs, the error message will be shaded red as shown in the following figure:

EasyDiagnoser Error Messages example.  Error messages are shown in RED.

Window Adjustment

Users can drag or use the smart docking icons in the editing window to place the windows into a different position if desired:

Users can drag or use the smart docking icons in the editing window to place the windows into a different position if desired

Note:

  • EasyDiagnoser does not support Siemens S7/1200 (Ethernet) or Allen-Bradley Ethernet/IP (CompactLogix/ControlLogix) – Free Tag Names drivers due to the tag structure of those drivers.