2.1.1 Getting Started with the Touch Host Driver

MTCH2120 and SAMD21 XPRO are used as an example.

1. Create a New 32-bit MCC Harmony Project

   

   Upon clicking the Finish button of the New Project Wizard, the MCC Content Manager will open along with the newly created project.

   Note: Refer to the "Create a New MPLAB® Harmony v3 Project" page for more details on how to create your project.

2. Add the Touch Host Driver to the MCC content

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

      

   2. Select Touch Host Driver from the optional content and click Finish.

      

   3. This will close the Content Manager and open the MCC Resource Management and Project Graph windows.

3. Add the Touch Host Driver to the project

   1. In the Device Resources pane of the Resource Management tab, expand the Touch Turnkey library to find the Touch Host Interface component.

      

   2. Click on the Add button (green square with white cross) next to Touch Host Interface to add it to the Project Graph. The configuration options are shown in the right-hand pane.

      
4. Choose a Turnkey device

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

   
5. Add the SERCOM module

   I2C is the only interface for the host driver and the selected MTCH2120 turnkey device. Choose a satisfying Serial Communication (SERCOM) and select the corresponding pins from the PIN configurator.

   
   
6. Add Tuning Option

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

   
7. Configuring SERCOM module

   1. Configuring UART

      Configure UART settings as follows.

      

   2. Configuring I2C

      Configure I2C settings as follows.

      
8. Configure INTERRUPT

   1. Change INTERRUPT pin Name as you want and copy the name.

      
9. Pin Configuration
   1. Open Pin Configuration
      
   2. Configure UART pin

      Configure UART pins as follows in Pin Configuration window.

      
   3. Configure I2C pin

      Configure I2C pins as follows in Pin Configuration window.

      
   4. Configure Interrupt pin

      Configure the Interrupt pin in Pin Configuration window.

      

10. Disable "SysTick"

    1. Click System in Project Graph

    2. Goto Cortex-M0+ Configuration

    3. Goto SysTick

    4. Uncheck "Enable SysTick" option

       

11. Generate the files

    Click on the Generate button to start generating the MCC files for the project.

    

12. Add code and compile

    Add code (touch_init_example() and touch_mainloop_example()) to main.c. Refer to mtch2120_host_example.c file for reference and compile the project.

    
13. How to Connect to Data Visualizer

    Refer to the "How to Connect to Data Visualizer" section for more details on how to connect the kit to Data Visualizer.