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 MPLAB® Code Configurator (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 section 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 Resource Management [MCC] and Project Graph tabs.

3. Add the Touch Host Driver to the project

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

      

   2. Click 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.

   I²C 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 the tuning option.

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

   

7. Configuring the SERCOM module.

   1. Configuring UART

      Configure UART settings as follows:

      

   2. Configuring I²C.

      Configure I²C settings as follows:

      

8. Configure INTERRUPT.

   1. Change the INTERRUPT Pin Name as needed and copy the name.

      

9. Pin configuration.

   1. Open Pin Configuration.

      

   2. Configure the UART pin.

      Configure the UART pins in the Pin Configuration window.

      

   3. Configure the I²C pin.

      Configure the I²C pins in the Pin Configuration window.

      

   4. Configure the Interrupt pin.

      Configure the Interrupt pin in the Pin Configuration window.

      

10. Disable SysTick.

    1. Click System in Project Graph.
    2. Go to the Cortex-M0+ Configuration.
    3. Go to the SysTick.
    4. Uncheck the Enable SysTick option.

       

11. Generate the files.

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

    

12. Add the code and compile.

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

    

13. How to Connect to the Data Visualizer.

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