Enhanced Diagnostics Messages - atmel-maxtouch/mxt-app GitHub Wiki

Enhanced Diagnostics Messages

Some maXTouch devices have the capability of sending Enhanced Diagnostic Messages which allow for quick detection and reporting of the following faults without affecting the overall system performance. These tests run in the background during normal operation of the touch controller device.

The faults detected include the following:

• Power supply, AVdd and Xdd
• Sensor FPC (Flexible Printed Circuit) disconnection
• Sense (X and Y) and driven shield (DS0) lines shorted to Ground
• Sense (X and Y) lines shorted to adjacent lines
• Open (disconnected) lines

mxt-app provides a command to view incoming enhanced diagnostic messages when enabled through the configuration of the device.

EXAMPLE: Display diagnostic message buffer

./mxt-app –diagnostic_msgs *FILENAME*

Using an editor on the file FILENAME, the following format of the messages will be displayed. Refer to the device protocol guide for bit definitions.

RAW DIAGNOSTIC MESSAGE
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00

MSG CRC value: 0x00 (CRC Passed)
ERROR STATUS: 0x00
NO FAILURES
COUNTER: 0x00
FIELD,BIT[7],BIT[6],BIT[5],BIT[4],BIT[3],BIT[2],BIT[1],BIT[0]
XBITMAP[0],0,0,0,0,0,0,0,0,
XBITMAP[1],0,0,0,0,0,0,0,0,
XBITMAP[2],0,0,0,0,0,0,0,0,
XBITMAP[3],0,0,0,0,0,0,0,0,
XBITMAP[4],0,0,0,0,0,0,0,0,
XBITMAP[5],0,0,0,0,0,0,0,0,
YBITMAP[0],0,0,0,0,0,0,0,0,
YBITMAP[1],0,0,0,0,0,0,0,0,
YBITMAP[2],0,0,0,0,0,0,0,0,
YBITMAP[3],0,0,0,0,0,0,0,0,
YBITMAP[18],No DS0 Failure

Parsing of the diagnostic messages can be done at the Host to determine if there is an issue with the device or sensor connection. Appropriate action based on failure is the responsibility of the Host.