2 Touch Configurator Release Notes

Touch Library v3.19.0 Release

New Features Supported
  • Added Touch Library support for new devices in the PIC32CX SG family of microcontrollers
  • Extended Touch Library support to the PIC32CXBZ36 and the PIC32WM_BZ36
  • Updated the acquisition library for the SAMC21, SAMD21, SAMDA1, SAMHA1, and the PIC32CMJH device families
Bug Fixes
  • Driven shield Plus timing synchronization has been updated for the SAMD20 and the PIC32CM-GV devices
  • Corrected minor wording changes in the Touch Configurator user interface
Development Tools
  • MPLAB X IDE v6.25 or higher
  • MPLAB XC32 C/C++ Compiler v4.60
  • MPLAB X IDE plug-ins:
    • MPLAB Code Configurator (MCC)
    • MCC Plugin v5.6.2

Touch Library v3.18.1 Release

Bug Fixes
  • Resolved issue related to Touch Configurator not loading for the PIC32WM_BZ6204

Touch Library v3.18.0 Release

New Features Supported

  • Added Touch Library support for the PIC32CM[3204|6408]JH000[32|48|64] devices
  • Added Touch Library support for the PIC32CM-GV family of microcontrollers

Bug Fixes

  • Resolved issue related to sync busy code missing for TC/TCC in timer-based Driven Shield projects
  • Resolved Touch Library path issues for TrustZone® devices

Development Tools

  • MPLAB X IDE v6.25 or higher
  • MPLAB XC32 C/C++ Compiler v4.60
  • MPLAB X IDE plug-ins:
    • MPLAB Code Configurator (MCC)
    • MCC Plugin v5.5.1

Touch Library v3.17.0 Release

New Features Supported

  • Added Touch Library support for the PIC32CM-GC/SG devices
  • Added Touch Library support for the PIC32WM_BZ6 devices
UI Enhancements
  • Improved Mutual Capacitance pin assignment UI

Bug Fixes

  • Resolved issue related to the lump feature support in Touch Configurator UI
  • Resolved compilation issues in Timer-based driven shield project generation for the SAM D10 and SAM D11

Known Issues

Projects created for the PIC32WM_BZ6 device are currently experiencing compilation issues with the existing compiler (v4.45). Await the next compiler release (v4.60), which will include a resolution for this problem.

Development Tools
  • MPLAB X IDE v6.20 or higher
  • MPLAB XC32 C/C++ Compiler v4.45
  • MPLAB X IDE plug-ins:
    • MPLAB Code Configurator (MCC)
    • MCC Plugin v5.5.1

Touch Library v3.16.0 Release

New Features Supported

  • Added Touch Library support for the PIC32CK SG/GC devices
  • Updated acquisition library files for the SAMC2x and the PIC32CMJH device families

UI Enhancements

  • Improved Matrix View for Mutual Capacitance pin assignment
Bug Fixes
  • Fixed the software low power sensors node mask re-generation issue
  • Resolved dependency issues in Timer-based driven shield project generation for the SAM C2x and SAM L22

Known Issues

  • For Arm Cortex-M TrustZone devices, RTC configured by Touch did not work. Workaround: Call touch_init after RTC_Initialize in the SYS_Initialize function.
  • For Arm Cortex-M TrustZone devices, few Touch lines are inoperative due to the default configuration bits set during initialization. Workaround: Manually modify the configuration bits.
  • For Arm Cortex-M TrustZone devices, there is a code compilation error when the boost mode feature is selected. Workaround: Library files have to be manually pasted in the specified path.
Development Tools
  • MPLAB X IDE v6.20
  • MPLAB XC32 C/C++ Compiler v4.40
  • MPLAB X IDE plug-ins:
    • MPLAB Code Configurator (MCC)
    • MCC Plugin v5.5.1
    • MCC Harmony Core v1.5.2

Touch Library v3.15.0 Release

New Features Supported

  • Touch Library support has been added for the PIC32MZ2051W104132
UI Enhancements
  • Improved the Matrix View for Mutual Capacitance pin assignment
  • Added an option to update all parameters of the same category in the sensor parameters table
  • Improved visibility of the Horizontal Scrollbar
Bug Fixes
  • Fixed the bugs related to the Driven Shield configuration for the SAMD21
  • Fixed the issue with the selection of a 1T surface without gesture option
  • Fixed the code generation issue with the Boost mode and surface combination
  • Fixed the PIC32MZDA code compilation issue
  • Fixed the PIC32CZCA software low power compilation issue
  • Fixed the Configuration Summary screen for the PIC32CMLE
  • Fixed the issue with surface pin configuration getting swapped on re-opening Touch Configurator
Known Issues
  • Timer based driven shield project may not work for the SAM C2x and SAM L22
  • Compilation error in the SAML11 Boost Mode project
Development Tools
  • MPLAB X IDE v6.20
  • MPLAB XC32 C/C++ Compiler v4.35
  • MPLAB X IDE plug-ins:
  • MPLAB Code Configurator (MCC)
  • MCC Plugin v5.5.0
  • MCC Harmony Core v1.5.1

Touch Library v3.14.0 Release

New Features Supported

  • MISRA-C 2012 Mandatory and Required rules Compliance achieved for Harmony generated Touch files
  • Touch cConfigurator is upgraded to the latest framework
  • Touch Tuning (bidirectional) support is extended for Surface and Gesture features from Touch plugin version 2.2.0
Bug Fixes
  • The SAM D51 and SAM E5x acquisition libraries are updated to version 1.5 to fix a bug regarding acquisition module getting struck
  • Fixed the bug to configure more than 3 steps in frequency hop UI
  • Fixed the bug related to the SAMD20 Driven Shield Plus
Development Tools
  • MPLAB X IDE v6.10
  • MPLAB XC32 C/C++ Compiler v4.30
  • MPLAB XIDE plug-ins:
    • MPLAB Code Configurator (MCC)
      • MCC Plugin v5.3.7
      • MCC Harmony Core v1.3.2
      • Harmony 3 – Harmony Services – v1.3.1(mandatory)

Touch Library v3.13.1 Release

Bug Fixes

  • Fixed bug related to SERCOM getting disconnected from Touch Library component when MCC is closed
  • Software based low power code compilation error is fixed
  • Sleep code moved to touch_example template
  • Fixed bug related to PTC mask being disabled for the PIC32CMJH device
  • Updated the SAML1x and the PIC32CM LE00/LS00/LS60 device acquisition libraries for bug fix related to overwriting PORT_MUX registers for pins adjacent to touch pins
  • Touch Configurator summary page update for displaying versions of few acquisition libraries

Touch Library v3.12.1 Release

New Features Supported

Touch Tune tab provides information to user on bidirectional or unidirectional interface

Bug Fixes
  • Fixed bug related to CSD option shown for devices which does not have CSD feature.
  • Driven shield on the SAMD2x was not working correctly. This is fixed.
  • Bug related to gesture timing periodicity is fixed.
  • Scroller configuration related bug is fixed in GUI.
  • Unintended braces in touch timer function is removed.
  • The SAMD2x Low power related issues are fixed.
Known Issues
  • For the PIC32CM JH and the SAMC2x device families, event system based low power has issues when it enters low power mode. Workaround - Use software based low power feature.
  • For the SAML1x and the PIC32CM LE00/LS00/LS60 device families, PORT_MUX registers for pins adjacent to touch pins may be overwritten by Touch Library.
Development ToolsBug Fixes
  • Bug related to enabling Driven shield is resolved
Development Tools

Touch Library v3.12.0 Release

New Features Supported
  • The PIC32CM JH device families support is done
  • RTC CountSync is disabled by default for all touch projects
Bug Fixes
  • Go to menu for Touch Configurator is set to proper path
Known Issues
  • Event system based low power has issues when it enters low power mode
Development Tools

Touch Library v3.11.2 Release

Bug Fixes
  • Bug related to Touch Configurator not opening in MPLAB Code Configurator (MCC) is resolved. Prerequisite MCC Plugin v5.1.2 and MCC Harmony Core v1.1.0.
  • Touch files not properly added to project for Trustzone applications. This is resolved.
  • The protocol version used in TouchTune.c file is updated to match with MPLAB Touch Plugin v2.0.0.
Known Issues
  • Touch tune data with MPLAB Touch Plugin does not work with Boost mode
Development Tools

Touch Library v3.11.1 Release

Bug Fixes
  • Bug related to the SAME5x Prescaler is resolved
  • Bug related to Touch timer periodicity is resolved
  • Data Streamer tune data is sent only once after each touch measurement
  • Compilation error on the SAMD10 device is resolved
  • Boost mode libraries and API files are NOT added when Boost mode is enabled. This is resolved
Known Issues
  • Touch tune data with MPLAB Touch Plugin does not work with Boost mode
Development Tools

Touch Library v3.11.0 Release

New Features Supported
  • Two-way debug protocol is supported
    • User can select between MPLAB Data Visualizer Touch Plugin and old Data Visualizer in the Parameters->Tune tab of Touch Configurator.
    • Refer to the Introduction to Touch Plugin for more details on MPLAB Data Visualizer Touch Plugin.
Bug Fixes
  • Bug related to mutual cap surface sensor node generation is fixed
  • Error related to surface two-way debug files are fixed
  • Label related issue in Mutual cap table view pin selection is fixed
Development Tools
Required MPLAB Harmony v3.x.x Modules
  • csp v3.10.0
  • mhc v3.8.2
Known Issues
  • Touch Configurator does not work properly when configuring Slider/Wheel using MCC Harmony Library. Workaround is to use Harmony Configurator.

Touch Library v3.10.1 Release

Bug Fixes
  • Low-power related bug fixes for the SAMD1x and software low-power
  • Touch Libraries 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

New Features Supported
  • Driven shield support extended for the SAM D1x and SAM D20
  • Acquisition engine and library are separate in MHC project graph
  • The PIC32MZDA device support
Bug Fixes
  • The SAMHA1 ondemand Osc8m ondemand not set
  • The 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 XY muxed 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
Known Issues
  • None

Touch Library v3.9.2 Release

Bug Fixes
  • Touch configuration panel cannot open when MHC upgrades to 3.7.0
  • Gesture disables timer start
  • The SAMD5x-E5x driven shield prescaler offset value
  • Keys module for boost mode calibration issue
Development Tools
Required MPLAB Harmony v3.x.x Modules
  • csp v3.9.0
  • bsp v3.9.0
  • dev_packs v3.9.0
  • mhc v3.7.0
Known Issues
  • None

Touch Library v3.9.1 Release

Bug Fixes
  • Event system low-power support added for the SAML2x.
  • Project generation for the 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.
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.5
Known Issues
  • None.

Touch Library v3.9.0 Release

New Features Supported
  • Low Power Support extended for the SAMC2x, SAM D1x, SAM E5x, SAM D5x, and SAM L2x
Bug Fixes
  • Driven shield waveform for C2x was not in sync - Corrected.
  • Calibration trigger does not automatically trigger corresponding buttons 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 later release.

Touch Library v3.8.0 Release

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

New Devices Supported
  • SAM L11
New Features Supported
  • Boost mode support (parallel acquisition) added for the 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, lists the changes which happen in the background when the user selects Yes.
  • The minimum and maximum PTC clock frequency 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

New Devices Supported
  • SAM HA1
  • PIC32MZ1025W104132 (HCVD)
New Features Supported
  • Driven Shield support for the SAM D21
  • Driven Shield support for the SAM DA1
  • Driven Shield support for the SAM HA1
  • Driven Shield support for the SAM L2x
  • Driven Shield support for the SAM C2x
  • Driven Shield support for the SAM E5x
  • Driven Shield support for the SAM D51
  • Updated the prescaler values in api.h files to include the internal prescaler division factor.
    • In the SAML10, for example, the prescaler values from 1, 2, 4, 8 are updated to 4, 8, 16, 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

New Devices Supported
New Features Supported
  • Driven shield support for the SAML10 is addded
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 (updated with Driven Shield)
  • ATSAMD10 Xplained Mini Self Capacitance Example Project with onboard Button
  • ATSAMD11 Xplained Pro Self Capacitance Example Project with onboard Button
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
  • The SAMD10 (C variant) Project generation fails, error is related to clock support.
Development Tools

Touch Library v3.4.0 Release

New Devices Supported
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
Required MPLAB Harmony v3.x.x Modules
  • csp v3.4.0
  • bsp v3.4.0
  • dev_packs v3.3.0
  • mhc v3.3.0.1
Bug Fixes
  • Clock configuration set by Touch Configurator is removed when Touch Configurator is closed. This bug is fixed.
Development Tools

Touch Library v3.3.0 Release

New Features Supported
  • Touch Surface (One Finger and Two Fingers) and Gesture firmware, GUI along with DataVisualizer and 2D Touch Surface Utility (Kronocomm) support for the 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

New Devices Supported
New Features Supported
  • 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 Fixes
  • 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 Supported
  • Button only touch support for the SAM C2x device families 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