H3 Touch Release Notes

For additional support related to issues and limitations, please contact Design Support.

Important Information

Touch® Library Information

The following Touch Library Information Spreadsheet contains information related to the published Touch library modules via the MH3 platform.

QTouch® Modular Library User Guide

Microchip MPLAB® Harmony 3 Touch Library Release Notes

Touch Library v3.10.1 Release

BUG FIXES

Low-power related bug fixes for SAMD1x and software low-power
Touch Library's capability name is reverted back to "TouchData"
Bug fix related to resistor value not populated on node parameter for Mutual cap sensor

DEVELOPMENT TOOLS

Touch Library v3.10.0 Release - July 2021

NEW FEATURES SUPPORTED

  • Driven shield support extended for - SAM D1x, SAM D20
  • Acquisition engine and library are separate in MHC project graph
  • PIC32MZDA device support

BUG FIXES

  • SAMHA1 ondemand Osc8m ondemand not set
  • ATSAMD10D14AS Touch Project Clock Error
  • Enable only non-event system low-power with driven shield
  • Touch GUI dock update issue
  • RTC count sync issue
  • Mutual cap surface XY configuration for XYmuxed devices
  • Lump with boost mode
  • Touch_example.c file is generated along with touch.c file
  • Sleep instruction is moved from touch_process() to touch_example.c file

DEVELOPMENT TOOLS

Required MPLAB Harmony v3.x.x Modules

  • csp v3.9.1
  • bsp v3.9.0
  • dev_packs v3.9.0
  • mhc v3.8.0

Touch Library v3.9.2 Release - April 2021

BUG FIXES

  • Touch configuration panel cannot open when MHC upgrades to 3.7.0
  • Gesture disables timer start
  • SAMD5x-E5x driven shield Prescaler offset value
  • Keys module for boost mode calibration issue

Touch Library v3.9.1 Release - January 2021

BUG FIXES

  • Event system low-power support added for SAML2x.
  • Project generation for PIC32MZW fixed.
  • Updating RTC period value halts the CPU due to count sync. Count sync is disabled.
  • Optimized low-power touch code for one button project.

Touch Library v3.9.0 Release - December 2020

NEW FEATURES SUPPORTED

  • Low Power Support extended for - SAMC2x, SAM D1x, SAM E5x, SAM D5x, SAM L2x.

BUG FIXES

  • Driven shield waveform for C2x was not in sync - Corrected.
  • Calibration trigger does not automatically trigger corresponding button's calibration in boost mode - Corrected.

DEVELOPMENT TOOLS

Required MPLAB Harmony v3.x.x Modules

  • csp v3.8.3
  • bsp v3.8.2
  • dev_packs v3.8.0
  • mhc v3.6.4

KNOWN ISSUES

  • SAM L2x - Event system-based low-power support in a later release.

Touch Library v3.8.0 Release - September 2020

NEW FEATURES SUPPORTED

  • Low Power Support
  • Lump Support
  • Binding Layer is disabled

DEVELOPMENT TOOLS

Required MPLAB Harmony v3.x.x Modules

  • csp v3.8.0
  • bsp v3.8.0
  • dev_packs v3.8.0
  • mhc v3.5.1

KNOWN ISSUES

  • Lump mode mouse drag operation in Touch configurator GUI only operates from top left to bottom right.

Touch Library v3.7.0 Release - June 2020

NEW DEVICES SUPPORTED:

  • SAML11

NEW FEATURE SUPPORTED:

  • Boost mode support (parallel acquisition) added for SAML10 and SAML11 devices.
  • Graphical representation of the input clock, available prescaler values, and PTC clock frequencies are displayed in the parameter tab.
  • The clock-change warning message, which appears when a new sensor is added, now lists the changes that happen in the background when the user selects Yes.
  • The minimum and maximum PTC clock-free quency details are added.

DEVELOPMENT TOOLS

Required MPLAB Harmony v3.x.x Modules:

  • csp v3.7.1
  • bsp v3.7.0
  • dev_packs v3.4.1
  • mhc v3.4.0

KNOWN ISSUES:

  • None

Touch Library v3.6.0 Release - March, 2020

NEW DEVICES SUPPORTED:

  • SAMHA1
  • PIC32MZ1025W104132 (HCVD)

NEW FEATURE SUPPORTED:

  • Driven Shield support for SAM D21
  • Driven Shield support for SAM DA1
  • Driven Shield support for SAM HA1
  • Driven Shield support for SAM L2x
  • Driven Shield support for SAM C2x
  • Driven Shield support for SAM E5x
  • Driven Shield support for SAM D51
  • Updated the prescaler values in api.h files to include the internal prescaler division factor. For example, in SAML10, the prescaler values from 1, 2, 4, and 8 are updated to 4, 8, 16, and 32 (to include a fixed internal division factor of 4). Similarly, all prescaler values are updated for all other devices.

DEVELOPMENT TOOLS

Required MPLAB Harmony v3.x.x Modules:

  • csp v3.6.1
  • bsp v3.6.1
  • dev_packs v3.6.1
  • mhc v3.3.5

KNOWN ISSUES:

  • None

Touch Library v3.5.0 Release - November, 2019

NEW DEVICES SUPPORTED:

  • SAMDA1
  • SAMD10
  • SAMD11

NEW FEATURE SUPPORTED:

  • Driven Shield for SAML10 device

NEW DEMO PROJECTS:

  • ATSAMDA1 Xplained Pro Mutual Capacitance Example Project with QT1
  • ATSAMDA1 Xplained Pro Self Capacitance Example Project with QT1
  • ATSAML10 Xplained Pro Driven Shield Example Project with QT7
  • ATSAMD10 Xplained Mini Self Capacitance Example Project with onboard Button
  • ATSAMD11 Xplained Pro Self Capacitance Example Project with onboard Button

DEVELOPMENT TOOLS

Required MPLAB Harmony v3.x.x Modules:

  • csp v3.5.0
  • bsp v3.5.0
  • dev_packs v3.5.0
  • mhc v3.3.3

KNOWN ISSUES:

  • SAMD10 (C variant) Project generation fails, error is related to clock support.
  • SAML10 project may not compile if generated without driven shield.

Touch Library v3.4.0 Release - September, 2019

NEW DEVICES SUPPORTED:

  • SAML22
  • SAML21
  • SAML10

NEW DEMO PROJECTS:

  • ATSAML21 Xplained Pro Mutual Capacitance Example Project with QT1
  • ATSAML21 Xplained Pro Self Capacitance Example Project with onboard Button
  • ATSAML22 Xplained Pro Mutual Capacitance Example Project with QT1
  • ATSAML22 Xplained Pro Self Capacitance Example Project with onboard Button
  • ATSAML10 Xplained Pro Self Capacitance Example Project with QT7

BUG FIXES:

  • Clock configuration set by touch configurator is removed when the touch configurator is closed. This bug is fixed.

DEVELOPMENT TOOLS:

Required MPLAB Harmony v3.x.x Modules:

  • csp v3.3.0
  • bsp v3.3.0
  • dev_packs v3.3.0
  • mhc v3.3.0.1

Touch Library v3.3.0 Release - July 2019

NEW FEATURES:

  • Touch Surface (One Finger and Two Fingers) and Gesture firmware, GUI along with DataVisualizer, and 2D Touch Surface Utility (Kronocomm) support for SAMC2x, SAMD2x, SAMD51, SAME51, SAME53, and SAME54 devices.
  • Clock selection support for proper operation of Touch, automated through the Touch configurator.

Required MPLAB Harmony v3.x.x Modules:

  • csp v3.4.0
  • bsp v3.4.0
  • dev_packs v3.4.0
  • mhc v3.3.1

KNOWN ISSUES:

  • Scroller + Surface combination is not supported.

DEVELOPMENT TOOLS:

Touch Library v3.2.0 Release - May, 2019

NEW DEVICES SUPPORTED:

  • SAMD20
  • SAMD21
  • SAME51
  • SAME53
  • SAME54
  • SAMD51

NEW FEATURES:

  • Slider and Wheel Firmware Support along with GUI Support
  • Support for Tabbed View of Data-Visualizer Software

NEW DEMO PROJECTS:

  • ATSAMD20 Xplained Pro Mutual Capacitance Example Project with QT1
  • ATSAMD20 Xplained Pro Self Capacitance Example Project with QT1
  • ATSAMD21 Xplained Pro Mutual Capacitance Example Project with QT1
  • ATSAMD21 Xplained Pro Self Capacitance Example Project with QT1
  • ATSAME54 Xplained Pro Mutual Capacitance Example Project with QT1
  • ATSAME54 Xplained Pro Self Capacitance On Board Example Project
  • ATSAMC21 Xplained Pro Mutual Capacitance Example Project with QT1
  • ATSAMC21 Xplained Pro Self Capacitance Example Project with QT1

Required MPLAB Harmony v3.x.x Modules:

  • csp v3.3.0
  • bsp v3.3.0
  • dev_packs v3.3.0
  • mhc v3.3.0.1

KNOWN ISSUES:

  • Touch libraries are built with v2.15 compiler version. Touch Applications may not work properly with other compiler versions.

DEVELOPMENT TOOLS:

Touch Library v3.1.1 Release

BUG FIX:

  • Compilation error related to Data Visualizer code when Frequency Hop is NOT enabled.

Required MPLAB Harmony v3.x.x Modules:

  • csp v3.2.0
  • dev_packs v3.2.0
  • mhc v3.2.0

DEVELOPMENT TOOLS:

Touch Library v3.1.0 Release

NEW FEATURES:

  • Button only touch support for SAM C2x device family along with Data Visualizer option
  • Touch Configurator GUI

NEW DEMO PROJECTS:

  • ATSAMC21 Xplained Pro Mutual Capacitance Example Project with QT1
  • ATSAMC21 Xplained Pro Self Capacitance Example Project with QT1

Required MPLAB Harmony v3.x.x Modules:

  • csp v3.2.0
  • dev_packs v3.2.0
  • mhc v3.2.0

KNOWN ISSUES:

  • None

DEVELOPMENT TOOLS:

  Return to Top

© 2021 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.