Atmel QTouch Library User Guide
Atmel QTouch Library User Guide Atmel QTouch Library User Guide
5.6.4.2 qt_touch_lib_config_data_t .................................................................................. 265.6.4.3 qt_touch_lib_measure_data_t .............................................................................. 275.6.4.4 qt_burst_lengths ................................................................................................... 275.6.4.5 tag_sensor_t ......................................................................................................... 285.6.4.6 qt_lib_siginfo_t ..................................................................................................... 285.6.5 Public Functions ..................................................................................................................... 295.6.5.1 qt_set_parameters ............................................................................................... 295.6.5.2 qt_enable_key ...................................................................................................... 305.6.5.3 qt_enable_rotor .................................................................................................... 305.6.5.4 qt_enable_slider ................................................................................................... 315.6.5.5 qt_init_sensing ..................................................................................................... 315.6.5.6 qt_measure_sensors ............................................................................................ 315.6.5.7 qt_calibrate_sensing ............................................................................................ 325.6.5.8 qt_reset_sensing .................................................................................................. 335.6.5.9 qt_get_sensor_delta ............................................................................................. 335.6.5.10 qt_get_library_sig ............................................................................................. 335.6.6 Sequence of Operations and Using the API ........................................................................... 335.6.6.1 Channel Numbering ............................................................................................. 345.6.6.1.1 Channel numbering when using QTouch acquisition method ......................... 345.6.6.1.2 Channel numbering when using QMatrix acquisition method ......................... 405.6.6.2 Sensor Numbering ............................................................................................... 425.6.6.3 Filtering Signal Measurements ............................................................................. 435.6.6.4 Allocating unused Port Pins for User Application ................................................. 455.6.6.5 Disabling and Enabling of Pull-up for AVR devices ............................................. 465.6.7 Constraints ............................................................................................................................. 465.6.7.1 QTouch acquisition method constraints ............................................................... 465.6.7.2 QMatrix acquisition method constraints ............................................................... 465.6.7.3 Design Guidelines for QMatrix acquisition method systems ................................ 475.6.8 Frequency of operation (Vs) Charge cycle/dwell cycle times: ................................................ 485.6.9 Interrupts ................................................................................................................................ 495.6.10 Integrating QTouch libraries in your application ..................................................................... 495.6.10.1 Directory structure of the library files ................................................................ 495.6.10.2 Integrating QTouch acquisition method libraries in your application ................ 515.6.10.2.1 Example for 8bit AVR .................................................................................... 535.6.10.2.2 Example for ATSAM ...................................................................................... 545.6.10.2.3 Checklist of items for integrating QTouch acquisition method libraries ......... 555.6.10.3 Integrating QMatrix acquisition method libraries in your application ................ 565.6.10.3.1 Example for 8bit AVR .................................................................................... 565.6.10.3.2 Example for 32bit AVR .................................................................................. 635.6.10.3.3 Checklist of items for integrating QMatrix Capacitive sensing libraries ......... 675.6.10.4 Common checklist items ................................................................................... 675.6.10.4.1 Configuring the stack size for the application ................................................ 675.6.11 Example project files .............................................................................................................. 685.6.11.1 Using the Sample projects ................................................................................ 695.6.11.2 Example applications for QTouch acquisition method libraries ........................ 695.6.11.2.1 Selecting the right configuration .................................................................... 695.6.11.2.2 Changing the settings to match your device .................................................. 705.6.11.2.3 Changing the library configuration parameters .............................................. 715.6.11.2.4 Using the example projects ........................................................................... 735.6.11.3 Example applications for QMatrix acquisition method libraries ........................ 735.6.11.3.1 Selecting the right configuration .................................................................... 745.6.11.3.2 Changing the library configuration parameters .............................................. 755.6.11.3.3 Using the example projects ........................................................................... 765.6.11.4 Adjusting the Stack size when using IAR IDE .................................................. 765.6.11.5 Optimization levels ............................................................................................ 775.6.11.6 Debug Support in Example applications........................................................... 783
- Page 1: Atmel QTouch LibraryUser GuideSuppo
- Page 6 and 7: Table 13 QTouch Library for UC3L Co
- Page 8: 6.4.6 QTouch Library ATtiny20 Examp
- Page 13 and 14: Generic QTouch LibrariesIntroductio
- Page 15 and 16: SamplingcapacitorSNSKPB1RsElectrode
- Page 17 and 18: Recalibration ThresholdRecalibratio
- Page 19 and 20: If any key is found to have a signi
- Page 21 and 22: eport detection. So at any given ti
- Page 23 and 24: QTouch API and UsageThe Atmel QTouc
- Page 25 and 26: ValuesHYST_50HYST_25HYST_12_5HYST_6
- Page 27 and 28: section 5.3.2 Detect Integration fo
- Page 29 and 30: B9 : B3B10B15 : B11lib_sig_hword ui
- Page 31 and 32: qt_enable_sliderThis function is us
- Page 33 and 34: qt_reset_sensingThis function disab
- Page 35 and 36: ‣ Usage of intraport configuratio
- Page 37 and 38: Channel numbering when routing SNS
- Page 39 and 40: Example:SNS and SNSK pins are confi
- Page 41 and 42: Line label 4channelconfiguration(4
- Page 43 and 44: qt_enable_slider (CHANNEL_0, CHANNE
- Page 45 and 46: }filter[i][1] = filter[i][2];filter
- Page 47 and 48: o Event System Channel0 (EVSYS_CH0)
- Page 49 and 50: If the microcontroller is only used
- Page 51 and 52: Integrating QTouch acquisition meth
5.6.4.2 qt_touch_lib_config_data_t .................................................................................. 265.6.4.3 qt_touch_lib_measure_data_t .............................................................................. 275.6.4.4 qt_burst_lengths ................................................................................................... 275.6.4.5 tag_sensor_t ......................................................................................................... 285.6.4.6 qt_lib_siginfo_t ..................................................................................................... 285.6.5 Public Functions ..................................................................................................................... 295.6.5.1 qt_set_parameters ............................................................................................... 295.6.5.2 qt_enable_key ...................................................................................................... 305.6.5.3 qt_enable_rotor .................................................................................................... 305.6.5.4 qt_enable_slider ................................................................................................... 315.6.5.5 qt_init_sensing ..................................................................................................... 315.6.5.6 qt_measure_sensors ............................................................................................ 315.6.5.7 qt_calibrate_sensing ............................................................................................ 325.6.5.8 qt_reset_sensing .................................................................................................. 335.6.5.9 qt_get_sensor_delta ............................................................................................. 335.6.5.10 qt_get_library_sig ............................................................................................. 335.6.6 Sequence of Operations and Using the API ........................................................................... 335.6.6.1 Channel Numbering ............................................................................................. 345.6.6.1.1 Channel numbering when using <strong>QTouch</strong> acquisition method ......................... 345.6.6.1.2 Channel numbering when using QMatrix acquisition method ......................... 405.6.6.2 Sensor Numbering ............................................................................................... 425.6.6.3 Filtering Signal Measurements ............................................................................. 435.6.6.4 Allocating unused Port Pins for <strong>User</strong> Application ................................................. 455.6.6.5 Disabling and Enabling of Pull-up for AVR devices ............................................. 465.6.7 Constraints ............................................................................................................................. 465.6.7.1 <strong>QTouch</strong> acquisition method constraints ............................................................... 465.6.7.2 QMatrix acquisition method constraints ............................................................... 465.6.7.3 Design <strong>Guide</strong>lines for QMatrix acquisition method systems ................................ 475.6.8 Frequency of operation (Vs) Charge cycle/dwell cycle times: ................................................ 485.6.9 Interrupts ................................................................................................................................ 495.6.10 Integrating <strong>QTouch</strong> libraries in your application ..................................................................... 495.6.10.1 Directory structure of the library files ................................................................ 495.6.10.2 Integrating <strong>QTouch</strong> acquisition method libraries in your application ................ 515.6.10.2.1 Example for 8bit AVR .................................................................................... 535.6.10.2.2 Example for ATSAM ...................................................................................... 545.6.10.2.3 Checklist of items for integrating <strong>QTouch</strong> acquisition method libraries ......... 555.6.10.3 Integrating QMatrix acquisition method libraries in your application ................ 565.6.10.3.1 Example for 8bit AVR .................................................................................... 565.6.10.3.2 Example for 32bit AVR .................................................................................. 635.6.10.3.3 Checklist of items for integrating QMatrix Capacitive sensing libraries ......... 675.6.10.4 Common checklist items ................................................................................... 675.6.10.4.1 Configuring the stack size for the application ................................................ 675.6.11 Example project files .............................................................................................................. 685.6.11.1 Using the Sample projects ................................................................................ 695.6.11.2 Example applications for <strong>QTouch</strong> acquisition method libraries ........................ 695.6.11.2.1 Selecting the right configuration .................................................................... 695.6.11.2.2 Changing the settings to match your device .................................................. 705.6.11.2.3 Changing the library configuration parameters .............................................. 715.6.11.2.4 Using the example projects ........................................................................... 735.6.11.3 Example applications for QMatrix acquisition method libraries ........................ 735.6.11.3.1 Selecting the right configuration .................................................................... 745.6.11.3.2 Changing the library configuration parameters .............................................. 755.6.11.3.3 Using the example projects ........................................................................... 765.6.11.4 Adjusting the Stack size when using IAR IDE .................................................. 765.6.11.5 Optimization levels ............................................................................................ 775.6.11.6 Debug Support in Example applications........................................................... 783