Creating a Project with Touch Library

Step-by-Step User Guide

1

Create New Project

Create a new project by clicking the Folder button or from the File menu select New Project.

NewProject.png

Select Standalone Project and click Next in the New Project dialog box:

CreateProject.png

Select the required Device and click Next.

image3.png

Select the suitable compiler and click Next.

image4.png

Assign a project name and click Finish.

image5.png

2

Open and Initialize MPLAB® Code Configurator (MCC)

Open MCC by clicking on the MCC button.

MenuBar.png

After initialization, click on the Select MCC Melody button.

image7.png

Then, click Finish and wait for MCC to initialize and load the required contents.

image8.png

3

Load Touch Configurator

Open the Content Manager in the Device Resources tab.

ContentManager.png

Select the required version of the Touch Library from the dropdown.

image10.png

Under Device Resources, expand the touch configurator from the Libraries menu and click on the Add button to add the Touch library.

DeviceResources.png

The touch configurator will be loaded on the right side of IDE. A user tour will be initialized to guide the user about the available options inside the touch library.

image12.png

4

Add Components and Apply Modifications

Click on the button, slider, wheel, and/or surface to add it to the configuration.

image13.png
image14.png

After the addition of the button/slider/wheel/surface, click on the Configure menu to apply different modifications.

image15.png
image16.png

Click on the displayed pin to select and assign an alternate set of pins to the selected button/slider/wheel.

image17.png
image18.png

5

Modify Selections

Click on the Sensor Parameters to modify the selected button/slider/wheel’s Gain, Delay, Clock etc.

image19.png

Click on the Common Parameters to modify the selected button/slider/wheel’s Drift Rate, Hold Time etc.

image20.png

Click on the Driven Shield to enable the Driven Shield Feature and add a dedicated shield pin.

image22.png

Click on the Boost Mode to enable the Boost mode.

image23.png

Click on the Frequency Hop to enable Frequency Hop and Frequency Hop tuning.

image24.png

Click on the Tune Tab to enable the Tuning Data connection.

image25.png

6

Verify Device's Summary

Click on the Summary tab to check the device's summary.

image26.png

Follow all the hints displayed in the Important Notes dialog box in the Create Tab section of the Touch Configurator.

image27.png

7

Generate Code

Click on the Generate button in the Project Resources tab to generate the configured code.

image27.png
image28.png

8

Build Project

Click on the Build button hammer%20icon.png to build the project.
BuildSuccessful.png

Additional Information

Surface Configuration

Orientation Shift

In order to change the orientation of the surface to match the orientation of the board clicks, any one of the coordinates in the corner of the surface pin’s view.

SurfacePin.png

A popup with the option to switch orientation will be displayed. Select the required option to shift the coordinates and the pins to match the surface orientation of the connected board.

image30.png

Timer Selection for PIC devices:

In order to import the required timer, change the scan rate from Free Running to Scan Rate in (ms).

image32.png

After changing the value to Scan Rate in (ms), the dependency selector will be displayed.

image33.png

Results

Once you have finished configuring your project and are ready to export, you can export from MPLAB Xpress to MPLAB X IDE to start writing your application code or you can click on the Make and Program Device Main Project button image34.png to build and program the project to the kit.
© 2024 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.