Visualize Touch Debug Data using Data Visualizer

 Objective

This article provides information on using the Data Visualizer tool to view and debug QTouch® data.

 Materials

 Procedure

1

Enable Debug

Ensure that the Enable Data Streamer option is selected while generating the QTouch project from START.

EnableDebug.png

Detailed information on how to generate a QTouch project in Atmel START can be found here.

2

Import Project

After downloading the package from Atmel START, generate the project using Atmel Studio 7 or IAR.

  • Procedure to generate project using Atmel Studio 7
  • Procedure to generate project using IAR

Program the generated .hex file to the device.

3

Open Data Visualizer.

4

Serial Port Control Panel

The Xplained Pro Kits support DGI (Data Gateway Interface) and virtual COM Port Interface in order to transmit data from kits to Data Visualizer. In QTouch projects, debug data is sent through the serial interface (COM Port).

Expand the Serial Port Control Panel by doing a double-click on the Serial Port Control Panel title bar.

5

Select COM Port

In the Serial Port Control Panel:

  • Select the EDBG Virtual COM Port (COMxx) (If multiple Xplained Pro kits are connected, disconnect other Xplained Pro kits to identify correct COM Port)
  • Uncheck the Open Terminal check-box and select Autodetect Protocol
  • Click Connect

The Data Visualizer tool automatically checks for data on 9600, 19200, 38400, 57600, 115200, 230400, 500000, 1000000 and 2000000 baud rates.

SerialPort.png

6

Configuration Files

Verify whether .ds, .db, .sc files are present in the ../qtouch/datastreamer/ folder. The Data Visualizer configuration files will be present in the ../qtouch/datastreamer/ folder ONLY if Atmel START extension version is 1.0.105.0 or above is used in Atmel Studio. If these files are not present, update the Atmel START extension as follows.
- Open Atmel Studio 7
- Select Tools > Extension Manager
- In Extension Manager window, click Installed > All
- Select Atmel START extension from the list and click Update.

After Updating the extension create the project again using the .atzip package, program and continue.

Data Visualizer will prompt you to select the folder containing the configuration information. Configuration files are stored as part of project source files. Browse to the ../qtouch/datastreamer/ project folder and select "Select Folder".

The selected folder will be saved by Data Visualizer. It may be necessary to change this folder location when you want to view data of another/updated project. If you would like to change the path, you can click on Autodetect Protocol.

7

Dashboard

The dashboard will display basic and advanced information in tabular/graphical form:
Basic Information

basicinformation.png

Advanced Information

advancedinformation.png

8

Graphical View

The graphical view provides graphical representation of signal, reference and touch delta.

GraphicalView.png

9

Legends

Lastly, you can select the desired signals to plot by clicking the legends.

DesiredSignals.png
© 2017 Microchip Technology, Inc.
Information contained on this site regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer's risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights.