Required Source Files

The mTouch Framework will automatically choose the correct header files for your chosen device.

These configuration files will have unique settings for each application:

• C:/YourApplicationSourceDirectory/mTouch_config.h
• C:/YourApplicationSourceDirectory/mTouch_config_slider.h
• C:/YourApplicationSourceDirectory/mTouch_config_modes.h
• C:/YourApplicationSourceDirectory/mTouch_config_cvdAdvanced.h

These source files are required in the project:

• C:/YourApplicationSourceDirectory/mTouch.c
• C:/YourApplicationSourceDirectory/mTouch_acquisition.c
• C:/YourApplicationSourceDirectory/mTouch_eeprom.c - Only if EEPROM is enabled in mTouch_config.h
• C:/YourApplicationSourceDirectory/mTouch_proximity.c - Only if proximity sensors are enabled in mTouch_config.h
• C:/YourApplicationSourceDirectory/mTouch_slider.c - Only if sliders are enabled in mTouch_config_slider.h

Hardware Profile

Each framework-supported PIC microcontroller has an associated HardwareProfile header file to define the relationship between the AN channel and its port/pin assignment, how to initialize the communications module, and which communications methods are available. This file will also perform some error checking on the current configuration to determine if your microcontroller will be able to correctly implement the requested framework features.

Only the hardware profile that is associated with your microcontroller's family is required.

Hardware Profile Options:

• Alternative Configurations/mTouch_hardwareProfile_12F61x.h :: PIC12F615, PIC12F617, PIC12HV615
• Alternative Configurations/mTouch_hardwareProfile_16F151x.h :: PIC16F1516, PIC16F1517, PIC16F1518, PIC16F1519
• Alternative Configurations/mTouch_hardwareProfile_16F152x.h :: PIC16F1526, PIC16F1527
• Alternative Configurations/mTouch_hardwareProfile_16F182x.h :: PIC12F1822, PIC16F1823, PIC16F1824, PIC16F1825, PIC16F1826, PIC16F1827, PIC16F1828, PIC16F1829
• Alternative Configurations/mTouch_hardwareProfile_16F193x.h :: PIC16F1933, PIC16F1934, PIC16F1936, PIC16F1937, PIC16F1938, PIC16F1939
• Alternative Configurations/mTouch_hardwareProfile_16F194x.h :: PIC16F1946, PIC16F1947
• and others... see C:/Your MLA Directory/Microchip/mTouchCap/PIC12F PIC16F CVD Library/Alternative Configurations for a full listing

Macro Library

The mTouch acquisition function is implemented using a combination of C and assembly. To support multiple cores with different assembly instruction sets, separate macro definitions are required. These macros perform the mTouch scanning routine and initial signal processing on the results. Due to noise concerns, we do not recommend editting these macros.

Only the macro library that is associated with your microcontroller's instruction set + mTouch_macroLibrary_common.h are required.

The correct macro library header file for your processor's core is automatically chosen from the list:

• mTouchCVD_macroLibrary_PIC16F.h :: PIC12/16 Non-Enhanced Core, Midrange Devices
• mTouchCVD_macroLibrary_PIC16F1.h :: PIC16F1 Enhanced Core, Midrange Devices
• mTouchCVD_macroLibrary_PIC18F.h :: PIC18 Devices