Version Change Log

Version 2.1

• Enabling a non-TMR0 timer will now also automatically enable the PEIE bit for automatic interrupt use (mTouch.c)
• Default one-way communications now supports the updated Profilab GUI supplied with this framework package (mComm_config.h / mComm.c)
• Configuration values can now be stored in RAM (mTouch_configOptions) instead of EEPROM for use in the two-way communications. See MTOUCH_EEPROM_STORED_AS_RAM in mTouch_config.h
• Individual the oversampling array initialization has been changed to automatically adjust its size based on MTOUCH_NUMBER_SENSORS (mTouch_acquistion.c)
• When mTouch controls the ISR, it will now correctly exit from the function if the mTouch timer was not responsible for the interrupt (mTouch_acquistion.c)
• Fixed an issue with the DAC configuration in the hardware profiles of the 182x and 184x families
• Fixed a bug with the initial EEPROM byte check - previously the EEPROM would revert to factory settings on reset. (mTouch_eeprom.c)
• Fixed the mTouch_ClearToggle(i) API macro: Logical 'not' (!) changed to bit-wise 'not' (~).

Version 2.0

• Added support for a large number of processors. Refer to this documentations 'Resource Requirements' page for a full listing.
• The acquisition module has been reworked for added efficiency.
  • The assembly-coded jump table has been replaced with a compiler-generated look-up table.
  • The 'scan a' and 'scan b' portions of each sensor's mTouch waveform are dedicated functions that are dynamically generated at compile-time by the preprocessor macros. This eliminates the previous limitation on the number of sensors due to the rising length of the single mTouch acquisition function.
  • Individual oversampling values can be enabled from the mTouch_config_cvdAdvanced.h file.
• Structures have been implemented for a large number of mTouch variables to maximize the efficiency of RAM resources. Several previously supported processors are now able to implement more sensors due to this change.
• New features:
  • Scanning modes allow different sensor configurations to be scanned based on the application's state.
  • Built-in proximity sensor support with median filter. (mTouch_config.h)
  • Sliders and wheels can be implemented by editing the mTouch_config_slider.h options. Supports up to 10 sliders with 8 sensors per slider.
  • A most-pressed algorithm can be implemented by uncommenting MTOUCH_MOST_PRESSED_ONLY. (mTouch_config.h)
  • Toggle mode is now available by uncommenting MTOUCH_TOGGLE_ENABLED. (mTouch_config.h) It will toggle the output's value only when it detects a new press - not when it sees a release. Example API available in main.c.
  • Guard rings/shields can be implemented using any general IO pin or through the DACOUT pin. (mTouch_config_cvdAdvanced.h)
  • Support for matrix configurations can be implemented to automatically decode the rows and columns with debouncing and a dedicated most-pressed algorithm to ensure quality coordinate results. (mTouch_config.h)
  • Mutual coupling drives can be implemented to detect increased coupling between two interconnected sensors. (mTouch_config_cvdAdvanced.h)
  • mComm communications module added. See mComm_config.h
    • Implements I2C, SPI, and UART two-way communications to allow changing of configuration values at run-time.
    • Configuration options and thresholds are stored in EEPROM when this is implemented by defining MTOUCH_EEPROM_ENABLED in mTouch_config.h
    • Implements 1-way UART communications in hardware or by using a software-implementation.
• New configuration options:
  • MTOUCH_INTEGRATION_TYPE adjusts the way the framework integrates with the application (mTouch_config.h)
  • MTOUCH_ISR_TIMER changes which 8-bit timer is used for the mTouch interrupt (mTouch_config.h)
  • MTOUCH_SCAN_FUNCTIONALITY alternates between scanning one sensor per interrupt or scanning all sensors once per interrupt (mTouch_config.h)
  • MTOUCH_ADC_CONTROL determines whether the framework releases the ADC after performing its scan (mTouch_config.h)
  • APFCON_INITIALIZED can be used to disable "make sure you initialize" warnings on parts with APFCON registers (mTouch_config.h)
  • MTOUCH_DECIMATION_MAX_STEP adjusts the maximum step size for sensors while going through the decimation filter (mTouch_config.h)
  • MTOUCH_JITTER_BITS adjusts the number of bits used to implement the random seed value for jittering (mTouch_config.h)
  • CVD_FORCE_REF_DAC can be defined to force the CVD acquisition to use the DAC as the reference for the ADC's hold capacitor (mTouch_config_cvdAdvanced.h)
• Configuration option CVD_JITTER_ENABLE has been removed. To disable jittering, set the MTOUCH_JITTER_BITS value to 0.
• MTOUCH_SCALING has been adjusted to allow a larger number of scaling options. (mTouch_config.h)

Version 1.1

• Non-enhanced Core Device Support
• HI-TECH 9.81 Lite and Standard Compiler Support
• Acquisition variable array sensor_data is now initialized to 0x47F to reduce the required initialization time
• New configuration option CVD_SETTLING_DELAY adjusts the amount of time the CVD acquisition will wait for the voltages on the external sensor and internal ADC hold capacitor to settle. See this guide for more information.
• New configuration option CVD_CHOLD_CHARGE_DELAY adjusts the amount of time the CVD acquisition will wait for the voltage on the internal ADC hold capacitor to reach steady state (V_DD or V_SS) before connecting the two capacitors and allowing their voltages to settle. See this guide for more information.
• The scan order of the CVD acquisition has been reversed to ensure maximum sensitivity for larger external sensor capacitances. This means the waveform will change when viewed on a scope. See this guide for more information.
• GENERATE_STORAGE_FUNCTION() and GENERATE_JUMP_TABLE() macros have been redesigned with a more elegant implementation.
• The mTouch.h file has been split-in-two in order to accomodate the Microchip Application Libraries' directory structure. A local copy of mTouch.h should be included in your application's includes directory. mTouch_processConfiguration.h, the other half of the original mTouch.h file, only needs to be available in the library folders and does not require a local copy.
• Sensor 0's reference is now defined in the process configuration header file to help de-clutter the acquisition.c file.
• Many documentation updates including:
  • New 'Optimizing Performance' sections designed to make it easier to solve common problems:
    • Increasing Sensitivity
    • Adjusting the Response Time
    • Tuning the CVD Waveform
    • Establishing PC Communications
  • Redesigned main page to help new users find information
  • Guides to creating new projects in MPLAB 8 and MPLAB X

Version 1.0 - First Public Release

• 64-Pin Device Support
• HI-TECH 9.81 PRO Compiler Support
• Comm/HardwareProfile update to support devices with >1 UART modules
• New MTOUCH_COMM_ASCII_READING and MTOUCH_COMM_ASCII_BASELINE configuration options to quickly adjust comm output