How to Increase the Processing Speed and Avoid "Input Buffer Overflow" Messages

<< Click to Display Table of Contents >>

Navigation:  Working with Docklight (Advanced) >

How to Increase the Processing Speed and Avoid "Input Buffer Overflow" Messages

When monitoring serial communications between two devices, Docklight cannot control the amount of incoming data. Since Docklight applies a number of formatting and conversion rules on the serial data, only a limited number of bytes per seconds can be processed. There are numerous factors that determine the processing speed, e.g. the PC and COM devices used, the Display Settings, and the Receive Sequence Actions defined. It is therefore not possible to specify any typical data rates.


The most time-consuming task for Docklight is the colors&font formatting applied by default (see the Docklight Display Options). If Docklight cannot keep up with formatting  the incoming data, it will automatically switch to the simpler Plain Text Mode.


If this is still not fast enough to handle the incoming data, Docklight will add the following message in the Communication Window output and log files.


DOCKLIGHT reports: Input buffer overflow on COM1


TIP: Search for this message using the BINOCULR Find Sequence in Communication Window... (Ctrl + F) function.


If you are experiencing the above behavior, Docklight offers you several ways to increase the data throughput.


1.Simplify the display output:

- Deactivate all unneeded Display Modes in the WRENCH Options... dialog

- Use Plain Text Mode right from the start (see the automatic switch behavior described above).

- If you are using ASCII mode, disable the Control Characters Description option


2.Log the communication data to a plain text file instead of using the communication window(s):

- Use the "plain text" Log File Format

- Create only a log file for the Representation (ASCII / HEX / Decimal / Binary) you actually need

- Disable the communication windows while logging, using the High Speed Logging option


3.Use the Communication Filter from the PROPERTIES Project Settings... dialog, and disable the original serial data for one or both communication directions. This is especially useful if you actually know what you are looking for and can define one or several Receive Sequences for this pieces of data. These Receive Sequences can print a comment each time the sequence appears in the data stream so you still know what has happened,  even if the original serial data is not displayed by Docklight.