Touch Host Driver Getting Started

How to Get Started

1

Download the latest MPLAB® X IDE and MPLAB Code Configurator (MCC) plugin. Create a new 32-bit MCC Harmony project.

HarmonyProject.png

2

Select the path where the Harmony v3 repository will be downloaded. The default location might be C:\Users\..\Harmony3 or C:\Users\..\.mcc\libraries\HarmonyContent.

FrameworkSelection.png

3

From the Content Manager, click the Select MPLAB Harmony button.

ContentManager.png

4

Select Touch Turnkey from the optional content and click Finish.

ContentManagerWizard.png

How to Create a Project

1

Create a Harmony v3 project and select Touch Host Interface from the available component list.

TouchTurnkey.png

2

Drag and drop or double-click on the component to add it to the Project Graph. The configuration options are shown in the right-hand pane.

TouchHostInterface.png

3

Select the turnkey device from the supported list of devices. AT42QT2120 is selected in this example.

TurnkeyDevice.png

4

I2C is the only interface for the host driver and the selected AT42QT2120 turnkey device. Serial Peripheral Interface (SPI) is supported for AT42QT1110. Choose a satisfying Serial Communication (SERCOM) and select the corresponding pins from the PIN configurator.

I2C.png
PinConfiguration.png

5

Check Enable Tuning option and select SERCOM for Universal Asynchronous Receiver Transmitter (UART) and choose the corresponding pins from the pin manager.

Tuning.png

6

Generate the files for the project.

GenerateProject.png

7

Add code (touchDeviceProcess() and touchTuneProcess()). Refer to host_example.c file for reference and compile the project.

AddCode.png

How to Connect to Data Visualizer

1

Flash the project and open Data Visualizer.

DataVisualizer.png

2

Select the COM port, set the Baud rate and click Connect.

COMSettings.png

3

When data starts streaming, under Touch Session, choose the same COM port and click Connect.

ConnectTouchSession.png

4

See the streaming data in the Touch window.

StreamingData.png

5

Error codes are shown in the General Status window. Go to common and individual parameters to tune them accordingly.

ErrorCodes.png

  Return to Top

© 2022 Microchip Technology, Inc.
Notice: ARM and Cortex are the registered trademarks of ARM Limited in the EU and other countries.
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.