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 MH3 platform.
QTouch® Modular Library User Guide
Microchip MPLAB® Harmony 3 Touch Library Release Notes
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
- MPLAB X IDE v5.45
- MPLAB XC32 C/C++ Compiler v2.50
- MPLAB X IDE plug-ins:
-
- MPLAB Harmony Configurator (MHC) v3.6.4
-
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 later release.
Touch Library v3.8.0 Release - September 2020
NEW FEATURES SUPPORTED
- Low Power Support
- Lump Support
- Binding Layer is disabled
DEVELOPMENT TOOLS
- MPLAB X IDE v5.40
- MPLAB XC32 C/C++ Compiler v2.41
- MPLAB X IDE plug-ins:
-
- MPLAB Harmony Configurator (MHC) v3.6.0
-
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
- MPLAB X IDE v5.40
- MPLAB XC32 C/C++ Compiler v2.41
- MPLAB X IDE plugins:
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
- MPLAB X IDE v5.35
- MPLAB XC32 C/C++ Compiler v2.40
- MPLAB X IDE plugins:
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
- MPLAB X IDE v5.25
- MPLAB XC32 C/C++ Compiler v2.30
- MPLAB X IDE plugins:
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:
- MPLAB X IDE v5.20
- MPLAB XC32 C/C++ Compiler v2.20
- MPLAB X IDE plugins:
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:
- MPLAB X IDE v5.20
- MPLAB XC32 C/C++ Compiler v2.20
- MPLAB X IDE plugins:
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:
- MPLAB X IDE v5.20
- MPLAB XC32 C/C++ Compiler v2.15
- MPLAB X IDE plugins:
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:
- MPLAB X IDE v5.15
- MPLAB XC32 C/C++ Compiler v2.15
- MPLAB X IDE plugins:
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:
- MPLAB X IDE v5.15
- MPLAB XC32 C/C++ Compiler v2.15
- MPLAB X IDE plugins: