Logging and Analyzing a Test

Preconditions

Testing a serial device or a protocol implementation

Logging the test

Click on the Start Logging button on the main toolbar.

A dialog window will open for choosing log file settings.

For each representation (ASCII, HEX, ...), a separate log file may be created. Choose at least one representation. Log files will have a ".txt" or ".htm" file extension. Docklight additionally adds the representation type to the file name to distinguish the different log files. E.g. if the user specifies "Test1" as the base log file name, the plain text ASCII file will be named "Test1_asc.txt", whereas an HTML HEX log file will be named "Test1_hex.htm".

Confirm your log file settings and start logging by clicking the OK button.

To stop logging and close the log file(s), click the Stop Logging button on the main toolbar. Unless the log file(s) have been closed, it is not possible to view their entire contents.

TIP: If you have additional requirements for your log file format, e.g starting a new file every hour, you can use a Docklight script and the StartLogging method for this purpose. See also the LogFileNamesTimestamp.zip sample script (folder Extra\LogFileNamesTimestamp in your Script Samples directory).