Topic: DMD0283

Do-more Logger - Network Message Viewer

The Network Message Viewer (Do-more Logger) utility runs on a PC and is used to capture and display debug and status messages from the Do-more controller.

Debug Packets are sent from the Do-more controller by first setting the system status bit $EnableMsgDump (ST36) = ON to instruct the controller to start echoing debug messages out the onboard Ethernet port. These packets will be captured and displayed in the Logger dialog. In this mode, any instruction in the program that makes use of this feature. For example, the Send Email (EMAIL) will begin sending debug messages to Do-more Logger as long as $EnableMsgDump (ST36) is ON. Note: $EnableMsgDump (ST36) can also be enabled by the clicking the Message Dump button in the Debug View.
 

Status Message Packets are sent using the Stream Out Data to Device (STREAMOUT) instruction to send user created status messages directly to Do-more Logger by selecting the pre-defined device DMLogger in the Device field of the instruction. This feature provides a very effective way to debug a ladder logic program by having the program send status messages to the logger as it executes.

Specifying the IP Address and Port Number

UDP Port: - The UDP Port Number to listen on for network packets. The default value of 0x7272 is the default port number used by the onboard Ethernet port of the Do-more Controller.

Accepting Packets From: - specifies which IP address to accept packets from. The default value of ANY means that all packets destined for the Logger from any IP address will be accepted and displayed.

The values for UDP Port and Accepting Packets can be altered by clicking the 'Change' button.
 

• The UDP Port can be specified as a decimal number or a hexadecimal number by pre-pending a 0x.
   

• A single IP Address can be specified as the only IP Address to accept packets from, or by clicking the 'ALL' button, Do-more Logger can be setup to accept packets from any IP Address.

Setting the Display Options

Max # of Records: - specifies the maximum number of entries to records to display in Do-more Logger before the oldest entries are written over.

Display Sending Address: - if enabled, the IP Address that sent the packet will be displayed

Display Time: - if enabled, the time the packet was received will be displayed

Insert at Top: - if enabled, new records will be inserted at the top of the display, if disabled, new records will be added to the bottom of the display

Display format - specifies what format to display new messages

• ASCII - new messages will be displayed in ASCII format
   

• Hex - new messages will be displayed in Hex format

Click the Pause button to temporarily stop the Logger from adding new records to the display. This only pauses what is added to and deleted from the display, however, packets are still being received in the background and all of them (up to the max # of records) will appear in the display once the Un-Pause is clicked.

If a Save operation is executed while the display is paused, only the data that is currently is the display list will be written to disk, any data that has been received in the background will NOT be saved.

A Clear operation that is executed while the display is paused will clear both the display and any data received in the background.

Click the Save button to invoke a dialog that allows the programmer to save the contents of the Logger's display in a CSV file. Saving to a file while paused will only save what is displayed in the list, not what is being collected in the background.

Click the Clear button to clear all data.. The clear operation will delete the contents of display and any packets collected in the background.

Click the About button to display the current version of the Do-more Logger.