Atmel QTouch Library User Guide
Atmel QTouch Library User Guide Atmel QTouch Library User Guide
Support for different compiler tool chainsThe QTouch acquisition method libraries are supported for the following compiler tool chains.Table 7 Compiler tool chains supported for QTouch acquisition method librariesToolVersionIAR Compiler for 8bit AVR 5.51IAR Embedded Workbench for AVR 5.5.7.1355GCC – AVRStudio 4.18 build 692IAR Compiler 32bit AVR 4.10WinAVR for 8bit AVR 20100110GCC – AVR32 Studio 2.5.0GCC – GCC GNU Tool Chain 32bit AVRavr32-gnu-toolchain-2.4.2IAR Embedded Workbench for ARM 5.40.4GCC for ARM Sourcery G++ Lite 2009q3-68QTouch Acquisition method library naming conventionsThe libraries are named according the convention listed belowNaming convention for libraries to be used with GCC tool chainlibg1_qt_k_rs.aField Possible Commentsname valuescoreP avr25avr 35VersionP of the core for AVR/ATSAM devices supported by this library variantfor tinyAVR and megaAVR devices.avr 4avr 51avr 5avrxmega2avrxmega3avrxmega4avrxmega5avrxmega6avrxmega7uc3auc3buc3csam3ssam3usam3nCH 4, 8, 12, 16, Total number of channels supported by each library.32RS 1, 2, 3, 4, 8 Total number of rotors / sliders supported for the respective channel countsmentioned in previous row.For example, the library variant “libavr25g1_8qt_k_2rs.a” supports the following configuration• Device : tinyAVR or megaAVR device belonging to core version avr25• Belongs to a set of devices of group 1 supported by this library808207K-AT42-09/11
• Support a maximum of 8 channels• Supports a maximum of up to 2 rotors / sliders.Naming convention for libraries to be used with IAR Embedded WorkbenchThe libraries are named according the naming convention listed belowlibg_qt_k_rs.r90Field Possible Commentsname valuescoreP v1v3VersionP of the for AVR/ATSAM devices supported by this library variantvariant for tinyAVR and megaAVR devices.v3xmsfv3xmv4xmv5xmv6xmuc3auc3buc3csam3ssam3usam3nQ 1 to 3 GroupQ of the core AVR device supported by this library variantCH 4, 8, 12, 16, Total number of channels supported by each library.32RS 1, 2, 3, 4, 8 Total number of rotors / sliders supported for the respective channel countsmentioned in previous row.For example, the library variant “libv3g2_4qt_k_1rs.r90” supports the following configuration• Device : tinyAVR or megaAVR device belonging to core version v3• Belongs to a set of devices of group 2 supported by this library• Supports a maximum of 4 channels• Supports 1 rotor/sliderQTouch acquisition method library variantslists the different QTouch acquisition method library variants supported for AVRs. Use this tableto select the correct library variant to be used in your application. Each row in the table belowindicates• the corresponding Ports available for SNS and SNSK pins• Compilers used for generating the libraries• The library names to be selected for the requirementsNote: The libraries that are supported as listed in the table are only supported provided thedevice memory requirements are also satisfied.Naming convention of the library Maximum channels supported by the library.DeviceRangetinyAVR, megaAVR, XMEGA 4,8,12,16UC3 8,16,32ATSAM 3281
- Page 30 and 31: • This function can be called any
- Page 32 and 33: unit16_t qt_measure_sensors( uint16
- Page 34 and 35: Channel NumberingChannel numbering
- Page 36 and 37: qt_reset_sensing()qt_enable_xxx()qt
- Page 38 and 39: Port AAll SNSK pinsterminatedon thi
- Page 40 and 41: Example:Pins A0 ,A3 and A5 of PORT
- Page 42 and 43: Channel 47 N/A N/A N/A N/A N/A X7Y5
- Page 44 and 45: channel 0channel 1channel 2channel
- Page 46 and 47: Disabling and Enabling of Pull-up f
- Page 48 and 49: ‣ Recommended threshold should be
- Page 50 and 51: QMatrix acquisitionmethod libraries
- Page 52 and 53: definition is not required.QT_NUM_C
- Page 54 and 55: SNS1 and SNSK1 pins usethe same por
- Page 56 and 57: • It is recommended to disable PU
- Page 58 and 59: Table 4 :List of configurable param
- Page 60 and 61: Number ofchannels requiredfor the a
- Page 62 and 63: 2. The above definitions should be
- Page 64 and 65: NUM_Y_LINES_ROTOR_SLIDER_QT_MAX_NUM
- Page 66 and 67: has Four Comparators (AC0A , AC1A ,
- Page 68 and 69: Note: When using the IAR IDE / comp
- Page 70 and 71: Figure 5-11: Selecting the right co
- Page 72 and 73: SNS1 - SNSK1 & SNS2 -SNSK2QT_NUM_CH
- Page 74 and 75: Selecting the right configurationTh
- Page 76 and 77: Figure 5-20 : Specifying QMatrix ac
- Page 78 and 79: Debug Support in Example applicatio
- Page 82 and 83: Maximum number of rotor / sliders s
- Page 84 and 85: Tips on pin assignments for the sen
- Page 86 and 87: ATtiny88)v1g1s2(ATtiny461,ATmega16a
- Page 88 and 89: X0,X1,X2,X3 are on PB0,PB1,PB2,PB3N
- Page 90 and 91: 1. The channel numbers are allocate
- Page 92 and 93: SNSK_array[1][1]=0x00; (SNSK odd ma
- Page 94 and 95: SNSK_array[1][0]=0x14; (SNSK even m
- Page 96 and 97: Figure 5-28: New Design Sensors in
- Page 98 and 99: Figure 5-31: Selecting the MCU for
- Page 100 and 101: Figure 5-34: Selecting the SNS and
- Page 102 and 103: 2. QTOUCH_STUDIO_MASKS needs to be
- Page 104 and 105: Figure 5-38: Selecting New Design3.
- Page 106 and 107: Figure 5-42: Start window of the co
- Page 108 and 109: Figure 5-45: Selecting the X,YA,YB,
- Page 110 and 111: The code can be copied using the
- Page 112 and 113: ApplicablereleaseQTouch libraries v
- Page 114 and 115: Device Specific LibrariesIntroducti
- Page 116 and 117: Table 8 Compiler tool chains suppor
- Page 118 and 119: maintains the States of QMatrix, QT
- Page 120 and 121: equired as shown in the case A of F
- Page 122 and 123: Figure 37 QMatrix method schematicQ
- Page 124 and 125: Figure 39 QMatrix API Flow diagram
- Page 126 and 127: CAT Module Pin NameCSA0CSB0CSA1CSB1
- Page 128 and 129: The QTouch method acquisition using
• Support a maximum of 8 channels• Supports a maximum of up to 2 rotors / sliders.Naming convention for libraries to be used with IAR Embedded WorkbenchThe libraries are named according the naming convention listed belowlibg_qt_k_rs.r90Field Possible Commentsname valuescoreP v1v3VersionP of the for AVR/ATSAM devices supported by this library variantvariant for tinyAVR and megaAVR devices.v3xmsfv3xmv4xmv5xmv6xmuc3auc3buc3csam3ssam3usam3nQ 1 to 3 GroupQ of the core AVR device supported by this library variantCH 4, 8, 12, 16, Total number of channels supported by each library.32RS 1, 2, 3, 4, 8 Total number of rotors / sliders supported for the respective channel countsmentioned in previous row.For example, the library variant “libv3g2_4qt_k_1rs.r90” supports the following configuration• Device : tinyAVR or megaAVR device belonging to core version v3• Belongs to a set of devices of group 2 supported by this library• Supports a maximum of 4 channels• Supports 1 rotor/slider<strong>QTouch</strong> acquisition method library variantslists the different <strong>QTouch</strong> acquisition method library variants supported for AVRs. Use this tableto select the correct library variant to be used in your application. Each row in the table belowindicates• the corresponding Ports available for SNS and SNSK pins• Compilers used for generating the libraries• The library names to be selected for the requirementsNote: The libraries that are supported as listed in the table are only supported provided thedevice memory requirements are also satisfied.Naming convention of the library Maximum channels supported by the library.DeviceRangetinyAVR, megaAVR, XMEGA 4,8,12,16UC3 8,16,32ATSAM 3281