Diagnostics procedure

Updated

This document describes the diagnostics procedure invoked from the UPDD Console (release 566 and above). It can also be invoked via the command line interface as described here. For Linux users invocation of the diagnostics routine is clarified here. The Diagnostic option will be enabled if there is a connection to the driver.

Since release 675 there is also an option to periodically invoke diagnostics as a background task that can be used to help identify touch issues that occur intermittently especially on user facing systems rather than in a test environment.

Three setting are used buy the diagnostics daemon process:

 log.periodic_diagnostic_folder_retention_days Specifies a retention period for content generated by the periodic_diagnostic function see log.periodic_diagnostic_minutes below.
 log.periodic_diagnostic_folder Specifies an alternate folder to deliver content generated by the periodic_diagnostic function see log.periodic_diagnostic_minutes below.

There is an implied default of %DESKTOP%

 log.periodic_diagnostic_folder_minutes If set to a non zero value then UPDD will perform a non-interactive diagnostic dump periodically at an interval of the number of minutes given in this setting.

The dumps will be written to the logged in user's Desktop folder in a sub folder updd_diagnostics

Note: this can create a lot of data specially if a small interval is used

A change of this setting requires a restart of UPDD Daemon to become effective as discussed in this section or by rebooting the system.

The diagnostic procedure tries to gather as much information as possible on a failing system that will help us diagnose the problem.

You will need a keyboard or mouse to proceed through the various steps. You can cancel out of the application procedure at anytime using standard 'cancel' keystrokes relative to the OS, such as Esc on Windows system.

Initially it will gather some system and driver configuration and debug information:

You are now requested to draw a 'single touch' pattern on all connected touch screens and select Done when completed
(the image is only displayed on the main monitor and you trace the pattern on each touch monitor and select Done).

You are now requested to draw with two fingers on all connected touch screens and select Done when completed.  Ignore if you have a single-touch touch monitor and select Done.
(the image is only displayed on the main monitor and you trace the pattern on each multi-touch touch monitor and select Done).

Finally, you are requested to send the resultant file to us at support@touch-base.com for analysis.

Search