Atmel QTouch Library User Guide
Atmel QTouch Library User Guide Atmel QTouch Library User Guide
May 2010Ver 4.2July 2010Ver 4.3Jan 2011Ver 4.3.1Section 5.8,Section 5.7.2.4Chapter 7,Section5.6.11.2.1,Section5.7.11.2.1Section has been added.• Qtouch acquisition libraries support will be available forATSAM3U and ATSAM3S devices.• Qdebug protocol support will be extended for all exampleprojects.• Analog comparator usage and burst length settingrecommendation Note added for UC3L QMatrix method.• QMatrix device support added for AT90USB82 / 162 / 646 /647 / 1286• Device support added for Tiny44/84/461/861• Added the details on Pin configuration support for bothQTouch and QMatrix libraries.• Added section related to the usage of the pin configuratortool on QTouch Studio.(section 5.8)• Added sections for Tiny20 and Tiny40 Devices.• Device support added for QTouch 2K devicesATtiny2313A/261A/24A/25A.• Added Chapter 7 on 2K Device libraries.• QTouch Support added for UC3C family devices.• QTouch Support added for ATtiny87 device• Tiny20 code memory requirement section updated.Feb 2011Ver 4.4Chapter 2Section5.6.10.3Section 6.5Section 5.5.3• Added Feature Comparison Table• Section 5.6.10 changed and updated for Support forQMatrix AT32UC3C0512 Device• Section 6.5 changed and updated for ATtiny40 libraries• Section 5.5.3 added for Guard Channel1868207K-AT42-09/11
DisclaimerHeadquartersInternationalATMEL Corporation2325 OrchardParkwaySan Jose, CA 95131USATel: 1(408) 441-0311Fax: 1(408) 487-2600ATMEL AsiaUnit 1-5 & 16, 19/FBEA Tower, MillenniumCity 5418 Kwun Tong RoadKwun Tong, KowloonHong KongTel: (852) 2245-6100Fax: (852) 2722-1369ATMEL EuropeLe Krebs8, Rue Jean-PierreTimbaudBP 30978054 Saint-Quentin-en-Yvelines CedexFranceTel: (33) 1-30-60-70-00Fax: (33) 1-30-60-71-11ATMEL Japan9F, Tonetsu Shinkawa Bldg.1-24-8 ShinkawaChuo-ku, Tokyo 104-0033JapanTel: (81) 3-3523-3551Fax: (81) 3-3523-7581Product ContactWeb Sitehttp://www.atmel.com/Literature Requestwww.atmel.com/literatureTechnical SupportAVR Libraries:touch@atmel.comSAM Libraries:at91support@atmel.comSales Contactwww.atmel.com/contactsDisclaimer: The information in this document is provided in connection with ATMEL products. No license, express or implied, byestoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of ATMEL products.EXCEPT AS SET FORTH IN ATMEL’S TERMS AND CONDITIONS OF SALE LOCATED ON ATMEL’S WEB SITE, ATMELASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATINGTO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR APARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT, INDIRECT,CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSSOF PROFITS, BUSINESS INTERRUPTION, OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THISDOCUMENT, EVEN IF ATMEL HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. ATMEL makes norepresentations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right tomake changes to specifications and product descriptions at any time without notice. ATMEL does not make any commitment to updatethe information contained herein. Unless specifically provided otherwise, ATMEL products are not suitable for, and shall not be used in,automotive applications. ATMEL’s products are not intended, authorized, or warranted for use as components in applications intended tosupport or sustain life.© 2011 ATMEL Corporation. All rights reserved. ATMEL®, ATMEL logo and combinations thereof, AVR®, AVRStudio®, XMEGA®, megaAVR®, tinyAVR®, QTouch®, QMatrix®, and others are registered trademarks or trademarksof ATMEL Corporation or its subsidiaries. Other terms and product names may be trademarks of others.187
- Page 136 and 137: Figure 46 GNU Example project usage
- Page 138 and 139: the QTouch Library as QMatrix data
- Page 140 and 141: TOUCH_STATUS_CHANGE 0x0002u Status
- Page 142 and 143: sensor_type_tEnumerationUsesensor_t
- Page 144 and 145: OUT_OF_TOUCHIN_TOUCHCurrently the a
- Page 146 and 147: num_channel_signals uint8_t Length
- Page 148 and 149: touch_at_statusstructureInput / Out
- Page 150 and 151: UseData structure which holds the R
- Page 152 and 153: variable to the Touch library. The
- Page 154 and 155: structure.p_qta_config touch_qt_con
- Page 156 and 157: p_touch_sensor_param touch_qm_param
- Page 158 and 159: current_time_ms touch_time_t Curren
- Page 160 and 161: touch_ret_t touch_qt_sensor_config(
- Page 162 and 163: touch_qt_sensors_calibratetouch_ret
- Page 164 and 165: touch_qt_get_libinfotouch_ret_t tou
- Page 166 and 167: • This API updates the configurat
- Page 168 and 169: Rule Rule Description Advisory/Requ
- Page 170 and 171: VCCPA0No ConnectionPA1PA2ATtiny20PA
- Page 172 and 173: QTouch Library configuration parame
- Page 174 and 175: Recommended setting.Table 19 QTouch
- Page 176 and 177: Figure 51 Schematic overview of QTo
- Page 178 and 179: QTouch Library configuration parame
- Page 180 and 181: Devices supportedThe list of differ
- Page 182 and 183: • The channel number is derived f
- Page 184 and 185: MISRA Compliance ReportThis section
May 2010Ver 4.2July 2010Ver 4.3Jan 2011Ver 4.3.1Section 5.8,Section 5.7.2.4Chapter 7,Section5.6.11.2.1,Section5.7.11.2.1Section has been added.• Qtouch acquisition libraries support will be available forATSAM3U and ATSAM3S devices.• Qdebug protocol support will be extended for all exampleprojects.• Analog comparator usage and burst length settingrecommendation Note added for UC3L QMatrix method.• QMatrix device support added for AT90USB82 / 162 / 646 /647 / 1286• Device support added for Tiny44/84/461/861• Added the details on Pin configuration support for both<strong>QTouch</strong> and QMatrix libraries.• Added section related to the usage of the pin configuratortool on <strong>QTouch</strong> Studio.(section 5.8)• Added sections for Tiny20 and Tiny40 Devices.• Device support added for <strong>QTouch</strong> 2K devicesATtiny2313A/261A/24A/25A.• Added Chapter 7 on 2K Device libraries.• <strong>QTouch</strong> Support added for UC3C family devices.• <strong>QTouch</strong> Support added for ATtiny87 device• Tiny20 code memory requirement section updated.Feb 2011Ver 4.4Chapter 2Section5.6.10.3Section 6.5Section 5.5.3• Added Feature Comparison Table• Section 5.6.10 changed and updated for Support forQMatrix AT32UC3C0512 Device• Section 6.5 changed and updated for ATtiny40 libraries• Section 5.5.3 added for Guard Channel1868207K-AT42-09/11