Atmel QTouch Library User Guide
Atmel QTouch Library User Guide Atmel QTouch Library User Guide
Channel NumberingChannel numbering when using QTouch acquisition methodQTouch acquisition method libraries require 2 GPIO pins per channel. QTouch libraries can beconfigured to use 1 to 16 channels requiring 2 to 32 pins respectively. There are two optionsprovided for connecting the SNS and SNSK pins.1. The SNS and SNSK pins are connected to separate ports. ( i.e. Interport)2. The SNS and SNSK pins are connected to the same port. ( i.e. Intraport)The following list provides a look at various combinations supported by various 8bit AVRlibraries released for each device.When pin configurability is not used:• 4-channel library – supports up to 4 channels using 4 consecutive pins on different SNSand SNSK ports (or) supports up to 4 channels using 8 consecutive pins on the sameport used for both SNS and SNSK lines. This library requires 1 or 2 ports.• 8-channel library – supports up to 8 channels using 8 consecutive pins on different SNSand SNSK ports (or) supports up to 8 channels using 16 pins spread over two ports (SNSand SNSK are on alternate pins) with SNS1 and SNSK1 pins on the first port and SNS2and SNSK2 pins on the second port. This library requires 2 ports.• 12-channel library (available only for 8bit AVR devices) – supports up to 12 channels outof which, 8 channels with 8 consecutive pins for SNS1 and SNSK1 are available ondifferent ports and the other 4 channels with 8 consecutive pins available on the sameport for both SNS and SNSK lines. This library requires a total of 3 ports.• 16-channel library – supports up to 16 channels out of which, 8 channels with 8consecutive pins for SNS1 and SNSK1 are available on different ports and the other 8channels with 8 consecutive pins are available on a different pair of SNS2 and SNSK2ports. This library requires a total of 4 ports.When pin configurability is used:• 4-channel library – supports up to 4 channels using any 4 pins on different SNS andSNSK ports (or) supports up to 4 channels using pins on the same port used for bothSNS and SNSK lines. This library requires 1 or 2 ports.• 8-channel library – supports up to 8 channels using 8 pins on different SNS and SNSKports (or) supports up to 8 channels using pins spread over two ports (SNS and SNSKare on alternate pins) with SNS1 and SNSK1 pins on the first port and SNS2 and SNSK2pins on the second port. This library requires 2 ports.• 12-channel library (available only for 8bit AVR devices) – supports up to 12 channels outof which, 8 channels with 8 pins for SNS1 and SNSK1 are available on different ports andthe other 4 channels with 8 pins available on the same port for both SNS and SNSKlines. This library requires a total of 3 ports.• 16-channel library – supports up to 16 channels out of which, 8 channels with 8 pins forSNS1 and SNSK1 are available on different ports and the other 8 channels with 8 pinsare available on a different pair of SNS2 and SNSK2 ports. This library requires a total of4 ports.Note:‣ When a library supports 4 channels using 8 consecutive pins on the same port, the SNS andSNSK pins are allocated alternately. This is valid for all the libraries mentioned above.348207K-AT42-09/11
‣ Usage of intraport configuration requires more code memory than the interport configuration.The values mentioned in the Library_selection_Guide.xls are for interport configurations. Thememory consumption for intra-port will be higher to the values mentioned in theLibrary_selection_Guide.xls‣ The configurations on pin configurability should be used in conjunction with the rules forassigning the pins that are described in section 5.8.2For UC3 and ATSAM libraries, an n- channel library supports up to n channels using nconsecutive pins on different SNS and SNSK ports (or) supports up to n/2 channels using (n)consecutive pins on the same port used for both SNS and SNSK lines. This library requires 1 or 2UC3 or ATSAM ports. In addition to this, for the ATSAM libraries the pins can be configured on 3ports based on the configuration selected.NOTE:Some of the devices in UC3 family has ports having more than 32 pins or less than 32pins.In those devices, the mapping is given as below:GPIO Port0 -> AGPIO Port1 -> BGPIO Port2 -> CGPIO Port3 -> XExample SNS=A and SNSK=X, So channel 0 will be (SNS0 = GPIO0_Pin0 and SNSK0 =GPIO3_Pin0 ).Similarly,Example SNS=X and SNSK=X, So channel 0 will be (SNS0 = GPIO3_Pin0 and SNSK0= GPIO3_Pin1 ).35
- Page 1: Atmel QTouch LibraryUser GuideSuppo
- Page 4: 5.6.11.6.1 Debug Support in the sam
- Page 7 and 8: 6.3.16.21 touch_info_t ............
- Page 12 and 13: • ARM: refers to a device in the
- Page 14 and 15: Libraries for AVR microcontrollers
- Page 16 and 17: QMatrix charge transfer is labeled
- Page 18 and 19: Maximum ON DurationIf an object uni
- Page 20 and 21: Setting Variable name Data Type Uni
- Page 22 and 23: Guard ChannelGuard channel in Qtouc
- Page 24 and 25: 7 AKS groups are supported by the l
- Page 26 and 27: Data structuresThis section lists t
- Page 28 and 29: The signal gain for each sensor is
- Page 30 and 31: • This function can be called any
- Page 32 and 33: unit16_t qt_measure_sensors( uint16
- 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 80 and 81: Support for different compiler tool
- Page 82 and 83: Maximum number of rotor / sliders s
Channel NumberingChannel numbering when using <strong>QTouch</strong> acquisition method<strong>QTouch</strong> acquisition method libraries require 2 GPIO pins per channel. <strong>QTouch</strong> libraries can beconfigured to use 1 to 16 channels requiring 2 to 32 pins respectively. There are two optionsprovided for connecting the SNS and SNSK pins.1. The SNS and SNSK pins are connected to separate ports. ( i.e. Interport)2. The SNS and SNSK pins are connected to the same port. ( i.e. Intraport)The following list provides a look at various combinations supported by various 8bit AVRlibraries released for each device.When pin configurability is not used:• 4-channel library – supports up to 4 channels using 4 consecutive pins on different SNSand SNSK ports (or) supports up to 4 channels using 8 consecutive pins on the sameport used for both SNS and SNSK lines. This library requires 1 or 2 ports.• 8-channel library – supports up to 8 channels using 8 consecutive pins on different SNSand SNSK ports (or) supports up to 8 channels using 16 pins spread over two ports (SNSand SNSK are on alternate pins) with SNS1 and SNSK1 pins on the first port and SNS2and SNSK2 pins on the second port. This library requires 2 ports.• 12-channel library (available only for 8bit AVR devices) – supports up to 12 channels outof which, 8 channels with 8 consecutive pins for SNS1 and SNSK1 are available ondifferent ports and the other 4 channels with 8 consecutive pins available on the sameport for both SNS and SNSK lines. This library requires a total of 3 ports.• 16-channel library – supports up to 16 channels out of which, 8 channels with 8consecutive pins for SNS1 and SNSK1 are available on different ports and the other 8channels with 8 consecutive pins are available on a different pair of SNS2 and SNSK2ports. This library requires a total of 4 ports.When pin configurability is used:• 4-channel library – supports up to 4 channels using any 4 pins on different SNS andSNSK ports (or) supports up to 4 channels using pins on the same port used for bothSNS and SNSK lines. This library requires 1 or 2 ports.• 8-channel library – supports up to 8 channels using 8 pins on different SNS and SNSKports (or) supports up to 8 channels using pins spread over two ports (SNS and SNSKare on alternate pins) with SNS1 and SNSK1 pins on the first port and SNS2 and SNSK2pins on the second port. This library requires 2 ports.• 12-channel library (available only for 8bit AVR devices) – supports up to 12 channels outof which, 8 channels with 8 pins for SNS1 and SNSK1 are available on different ports andthe other 4 channels with 8 pins available on the same port for both SNS and SNSKlines. This library requires a total of 3 ports.• 16-channel library – supports up to 16 channels out of which, 8 channels with 8 pins forSNS1 and SNSK1 are available on different ports and the other 8 channels with 8 pinsare available on a different pair of SNS2 and SNSK2 ports. This library requires a total of4 ports.Note:‣ When a library supports 4 channels using 8 consecutive pins on the same port, the SNS andSNSK pins are allocated alternately. This is valid for all the libraries mentioned above.348207K-AT42-09/11