Release Notes for

STM32 Touch-Sensing Driver

Copyright © 2011 STMicroelectronics

 

Contents

  1. Update History
  2. License

Update History


V0.1.3 / 23-September-2011

Main changes

  • Add directive for GNU C compiler in stm32l15x_tsl_acquisition.c file
  • Update STM32L15x channel table of MCU resources section of the user manual (.chm)

Toolchains and Compilers used during validation

  • KEIL µVision version 4.03, compiler version  4.0.0.728
  • IAR EWARM version 6.21.1, compiler version 6.21.1.52794

V0.1.2 / 02-September-2011

Main changes

  • Bug correction in stm32l15x_tsl_services.c file (ECSTimeStepCounter variable was decremented below its minimum value (0)).
  • Bug correction in stm32l15x_tsl_singlechannelkey.c file (Channel_P3.EnabledChannels was badly affected).
  • Bug correction in stm32l15x_tsl_checkconfig.h file (shield masks for PB4 was wrong).

Toolchains and Compilers used during validation

  • KEIL µVision version 4.03, compiler version  4.0.0.728
  • IAR EWARM version 6.21.1, compiler version 6.21.1.52794

V0.1.1 / 20-April-2011

Main changes

  • Bug correction in stm32l15x_tsl_ct_acquisition.c file (RI->HYSCR1 badly configured).

   

V0.1.0 / 08-April-2011

Main changes

  • First Beta release.
  • Bugs correction and enhancements:
  • correct the GPIO clock setting in TSL_IO_Init().
  • add missing enable/disable interrupt in TSL_IO_Acquisition_P1/2/3().
  • add support of the shield with one pin.
  • remove TSL_RefKey_Process() and TSL_SCKey_SetAcquisitionMasks() functions (not used).
  • replace uint8_t and uint32_t by unsigned in bit fields structures.
  • remove the RTOS feature (not used).
  • remove DriveMask and RejectedNb elements of TOUCH_PORT_Info_T structure (not used).
  • remove unused constants related to RC acquisition.
  • add wait delay during acquisition (CLWHTA and CLWLTA constants).
  • support of the PROTECT_IO_ACCESS feature.
  • remove IT_SYNC feature (not used) in the configuration file.
  • change the device name supported in the configuration file.
  • remove MCKEYx_LAYOUT_TYPE in the configuration file.
  • rename PIN_SHIELD by ACTIVE_SHIELD_CHANNEL in the configuration file.
  • code clean-up.
        

Toolchains and Compilers used during validation

  • KEIL µVision version 4.03, compiler version  4.0.0.728
  • IAR EWARM version 6.10.5, compiler version 6.10.2.52244
     

Known limitations

  • If the DxS feature is enabled, the Debounce Filter must be >= 1 (i.e. if at least 2 channels have their DxSGroup parameter different from 0).
  • The Recalibration timeout is 1s accurate (i.e. for 2s specified, the RecalTimeout will be between 1s and 2s).
  • Inlining functions are not yet supported by IAR compiler when referencing global variables. USE_INLINED_FUNCTIONS has also no effect when IAR compiler is used.
  • The 3 electrodes of a MCKey must have the same channel number.
  • Only the interlaced electrodes layout is supported for MCKeys.
  • The GROUP6 (PB4 and PB5) is not usable due to a poor sensitivity.

         

     

 

License

By using this Licensed Software, You are agreeing to be bound by the terms and conditions of this License Agreement. Do not use the Licensed Software until You have read and agreed to the following terms and conditions. The use of the Licensed Software implies automatically the acceptance of the following terms and conditions.

 

DEFINITIONS

Licensed Software: means the enclosed STM32 TOUCH-SENSING LIBRARY (drivers, example firmwares and project templates) and all the related documentations and design tools licensed in the form of object and/or source code as the case maybe.

Product: means a product or a system that includes or incorporates solely and exclusively an executable version of the Licensed Software and provided further that such Licensed Software executes solely and exclusively on STM32 microcontroller devices manufactured by or for ST.

 

LICENSE

STMicroelectronics (“ST”) grants You a non-exclusive, worldwide, non-transferable (whether by assignment or otherwise) non sub-licensable (except as expressly provided hereunder), revocable, royalty-free limited license to:

(i) make copies, prepare derivatives works, of the source code version of the Licensed Software for the sole and exclusive purpose of developing executable versions of such Licensed Software only for use with the Product;

(ii) make copies, prepare derivatives works of the object code versions of the Licensed Software for the sole purpose of designing, developing and manufacturing the Products;

(iii) make, use, sell, offer to sell, import or otherwise distribute Products.

You have the right to grant sub-licenses of the rights set forth in this section in order to execute all of the rights set forth herein, provided that you will impose to the sub-licensee the same terms and conditions set forth in this Agreement and that you will remain fully liable to indemnify ST against all and any loss, liability, costs, damages, expenses (including the fees of lawyers and other professionals), suffered, incurred or sustained as a result of or in relation to the breach of the terms of this Agreement.

 

OWNERSHIP AND COPYRIGHT

Title to the Licensed Software, related documentation and all copies thereof remain with ST and/or its licensors. You may not remove the copyrights notices from the Licensed Software and to any copies of the Licensed Software. You agree to prevent any unauthorized copying of the Licensed Software and related documentation.

 

RESTRICTIONS

Unless otherwise explicitly stated in this Agreement, You may not sell, assign, sublicense, lease, rent or otherwise distribute the Licensed for commercial purposes, in whole or in part.

You acknowledge and agree that any use, adaptation translation or transcription of the Licensed Software or any portion or derivative thereof, for use with processors manufactured by or for an entity other than ST is a material breach of this Agreement and requires a separate license from ST.

No source code and/or object code relating to and/or based upon Licensed Software is to be made available by You unless expressly permitted under the section “License”.

You acknowledge and agree that the protection of the source code of the Licensed Software warrants the imposition of reasonable security precautions

In the event ST demonstrates to You a reasonable belief that the source code of the Licensed Software has been used or distributed in violation of this Agreement, ST may by written notification request certification as to whether such unauthorized use or distribution has occurred. You shall cooperate and assist ST in its determination of whether there has been unauthorized use or distribution of the source code of the Licensed Software and will take appropriate steps to remedy any unauthorized use or distribution.

 

NO WARRANTY

The Licensed Software is provided “as is” and “with all faults” without warranty of any kind expressed or implied. ST and its licensors expressly disclaim all warranties, expressed, implied or otherwise, including without limitation, warranty of merchantability, fitness for a particular purpose and non-infringement of intellectual property rights. ST does not warrant that the use in whole or in part of the Licensed Software will be interrupted or error free, will meet your requirements, or will operate with the combination of hardware and software selected by You.

You are responsible for determining whether the Licensed Software will be suitable for your intended use or application or will achieve your intended results.

ST has not authorized anyone to make any representation or warranty for the Licensed Software, and any technical, applications or design information or advice, quality characterization, reliability data or other services provided by ST shall not constitute any representation or warranty by ST or alter this disclaimer or warranty, and in no additional obligations or liabilities shall arise from ST’s providing such information or services. ST does not assume or authorize any other person to assume for it any other liability in connection with its Licensed Software.

Nothing contained in this Agreement will be construed as

(i) a warranty or representation by ST to maintain production of any ST device or other hardware or software with which the Licensed Software may be used or to otherwise maintain or support the Licensed Software in any manner; and

(ii) a commitment from ST and/or its licensors to bring or prosecute actions or suits against third parties for infringement of any of the rights licensed hereby, or conferring any rights to bring or prosecute actions or suits against third parties for infringement. However, ST has the right to terminate this Agreement immediately upon receiving notice of any claim, suit or proceeding that alleges that the Licensed Software or your use or distribution of the Licensed Software infringes any third party intellectual property rights.

All other warranties, conditions or other terms implied by law are excluded to the fullest extent permitted by law.

 

LIMITATION OF LIABILITIES

In no event ST or its licensors shall be liable to You or any third party for any indirect, special, consequential, incidental, punitive damages or other damages (including but not limited to, the cost of labor, re-qualification, delay, loss of profits, loss of revenues, loss of data, costs of procurement of substitute goods or services or the like) whether based on contract, tort, or any other legal theory, relating to or in connection with the Licensed Software, the documentation or this Agreement, even if ST has been advised of the possibility of such damages.

In no event shall ST’s liability to You or any third party under this Agreement, including any claim with respect of any third party intellectual property rights, for any cause of action exceed 100 US$. This section does not apply to the extent prohibited by law. For the purposes of this section, any liability of ST shall be treated in the aggregate.

 

TERMINATION

ST may terminate this license at any time if You are in breach of any of its terms and conditions. Upon termination, You will immediately destroy or return all copies of the software and documentation to ST.

 

APPLICABLE LAW AND JURISDICTION

In case of dispute and in the absence of an amicable settlement, the only competent jurisdiction shall be the Courts of Geneva, Switzerland. The applicable law shall be the law of Switzerland.

 

SEVERABILITY

If any provision of this agreement is or becomes, at any time or for any reason, unenforceable or invalid, no other provision of this agreement shall be affected thereby, and the remaining provisions of this agreement shall continue with the same force and effect as if such unenforceable or invalid provisions had not been inserted in this Agreement.

 

WAIVER

The waiver by either party of any breach of any provisions of this Agreement shall not operate or be construed as a waiver of any other or a subsequent breach of the same or a different provision.

 

RELATIONSHIP OF THE PARTIES

Nothing in this Agreement shall create, or be deemed to create, a partnership or the relationship of principal and agent or employer and employee between the Parties. Neither Party has the authority or power to bind, to contract in the name of or to create a liability for the other in any way or for any purpose


For complete documentation on STMTouch Microcontrollers visit www.st.com/STMTouch

For complete documentation on STM32L (CORTEX M3) 32-Bit Microcontrollers visit www.st.com/STM32L