Atmel QTouch Library User Guide
Atmel QTouch Library User Guide Atmel QTouch Library User Guide
Maximum number of rotor / sliders supportedNOTE:• For 8-bit devices, ports which have less than 8 pins cannot be used by the QTouchacquisition method libraries. Check the data sheet to determine the number of pinssupported for each portPort combinations supported for SNS and SNSK pin configurationsFor the list of all ports supported for each device please refer to the library selection guide. Thereare no limitations for AVR devices (8bit and 32 bit) on the combination of SNS and SNSK port tobe used from QTouch libraries 4.0 release onwards.For ATSAM devices the one port pair combinations supported are given below in the table.One port pair supported combinations forATSAMAA, BB, CC, AB, BA, AC, CA, BC, CBTips on pin assignments for the sensor design using one pair of SNS/SNSKportsThis section lists tips on selecting the pin assignments when using a single port pair for the SNSand SNSK Pins.Design choice for the sensorSNSK & SNS pins are on differentports, number of channels = 4SNSK & SNS pins are on differentports, number of channels = 8Example Port configuration with pin assignments• If the SNS1(C) and SNSK1(B) pins are on two different ports, theuser should mount the sensors onto the corresponding pins suchas (PC0,PB0), (PC1,PB1), (PC2,PB2) and (PC3,PB3), when pinconfigurability is not used.• In case of pin configurability, sensors should be mounted on thepins as selected based on rules illustrated in section 5.8.1• If the SNS1(C) and SNSK1(B) pins are on two different ports, theuser should mount the sensors onto the corresponding pins suchas (PC0,PB0), (PC1,PB1), (PC2,PB2) and so on, When pinconfigurability is not used.• When using pin configurability, sensors should be mounted on thepins as selected based on rules illustrated in section 5.8.1• When pin configurability is not used, channel 0 will be on (PC0,PB0) pins, channel 1 will be on (PC1, PB1) pins and so on up tochannel 7 will be on (PC7, PB7) pins.• When using pin configurability, channel should be assigned asgiven in section 5.6.6.1.1.2•SNSK & SNS pins are on differentports, number of channels = 32when using UC3 device• If the SNS1(B) and SNSK1(A) pins are on two different ports, theuser should mount the sensors onto the corresponding pins suchas (PB0,PA0), (PB1,PA1), (PB2,PA2)..• In this case channel 0 will be on (PB0, PA0) pins, channel 1 will beon (PB1, PA1) pins and so on up to channel 31 will be on (PB31,PA31) pins.828207K-AT42-09/11
SNSK & SNS pins are on thesame port, number of channels =2• If the use of SNS1(A) and SNSK1(A) pins are on the same port,the user should always have the configuration (PA0, PA1) & (PA2,PA3). In this case channel 0 will be on (PA0, PA1) pins; channel 1will be on (PA2, PA3) pins. The even pins of the port are used asSNS1 pins and odd pins of the port are used as SNSK1 pins• When pin configurability is used, sensors should be mounted onthe pins as selected as per the rules illustrated in section 5.8.1 andchannels should be assigned as given in section 5.6.6.1.1.4SNSK & SNS pins are on thesame port, number of channels =4• If the use of SNS1(A) and SNSK1(A) pins are on the same port,the user should always have the configuration (PA0, PA1), (PA2,PA3), (PA4, PA5) & (PA6, PA7). In this case channel 0 will be on(PA0, PA1) pins, channel 1 will be on (PA2, PA3) pins and so onup to channel 4 will be on (PA6, PA7) pins. The even pins of theport are used as SNS1 pins and odd pins of the port are used asSNSK1 pins, when pin configurability is not being used.• When using pin configurability, sensors should be mounted on thepins as selected as per the rules illustrated in section 5.8.1 andchannels should be assigned as given in section 5.6.6.1.1.4SNSK & SNS pins are on thesame port, number of channels =16( Available only for UC3 devices ifmore than 4 channels are to beused on a single port. FortinyAVR, megaAVR, XMEGAdevices up to 8 channels withSNS and SNSK on same portsrefer to section 5.7.1.5.2 )SNSK & SNS pins are on thesame port, number of channels =16( Available only for SAM devices)• This configuration is available only for UC3 library variants.• In the use of SNS(A) and SNSK(A) pins are on the same port, theuser should always have the configuration (PA0, PA1), (PA2,PA3), (PA4, PA5) & so on. In this case channel 0 will be on (PA0,PA1) pins, channel 1 will be on (PA2, PA3) pins and so on up tochannel 15 will be on (PA30, PA31) pins. The even pins of the portare used as SNS pins and odd pins of the port are used as SNSKpins• If the use of SNS(A) and SNSK(A) pins are on the same port, theuser should always have the configuration (PA0, PA1), (PA2,PA3), (PA4, PA5), (PA6, PA7) and so on.• In this case channel 0 will be on (PA0, PA1) pins, channel 1 will beon (PA2, PA3) pins and so on up to channel 15 will be on (PA30,PA31) pins.• The even pins of the port are used as SNS pins and odd pins ofthe port are used as SNSK pinsPort combinations supported for two port pair SNS and SNSK pinconfigurationsFor the list of all ports supported for each device please refer to the library selection guide. Thereare no limitations on the combination of SNS and SNSK port to be used from QTouch libraries 4.0release onwards.For ATSAM devices the total two port pairs supported combinations are given below in the table.Two port pairs supported combinations forATSAMAA_BB, BB_AA, AA_CC, CC_AA, BB_CC,CC_BB, AA_BC, AA_CB, BB_AC, BB_CA,CC_BA, CC_AB83
- 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 80 and 81: Support for different compiler tool
- 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
- Page 130 and 131: Host Application codeUsing the init
Maximum number of rotor / sliders supportedNOTE:• For 8-bit devices, ports which have less than 8 pins cannot be used by the <strong>QTouch</strong>acquisition method libraries. Check the data sheet to determine the number of pinssupported for each portPort combinations supported for SNS and SNSK pin configurationsFor the list of all ports supported for each device please refer to the library selection guide. Thereare no limitations for AVR devices (8bit and 32 bit) on the combination of SNS and SNSK port tobe used from <strong>QTouch</strong> libraries 4.0 release onwards.For ATSAM devices the one port pair combinations supported are given below in the table.One port pair supported combinations forATSAMAA, BB, CC, AB, BA, AC, CA, BC, CBTips on pin assignments for the sensor design using one pair of SNS/SNSKportsThis section lists tips on selecting the pin assignments when using a single port pair for the SNSand SNSK Pins.Design choice for the sensorSNSK & SNS pins are on differentports, number of channels = 4SNSK & SNS pins are on differentports, number of channels = 8Example Port configuration with pin assignments• If the SNS1(C) and SNSK1(B) pins are on two different ports, theuser should mount the sensors onto the corresponding pins suchas (PC0,PB0), (PC1,PB1), (PC2,PB2) and (PC3,PB3), when pinconfigurability is not used.• In case of pin configurability, sensors should be mounted on thepins as selected based on rules illustrated in section 5.8.1• If the SNS1(C) and SNSK1(B) pins are on two different ports, theuser should mount the sensors onto the corresponding pins suchas (PC0,PB0), (PC1,PB1), (PC2,PB2) and so on, When pinconfigurability is not used.• When using pin configurability, sensors should be mounted on thepins as selected based on rules illustrated in section 5.8.1• When pin configurability is not used, channel 0 will be on (PC0,PB0) pins, channel 1 will be on (PC1, PB1) pins and so on up tochannel 7 will be on (PC7, PB7) pins.• When using pin configurability, channel should be assigned asgiven in section 5.6.6.1.1.2•SNSK & SNS pins are on differentports, number of channels = 32when using UC3 device• If the SNS1(B) and SNSK1(A) pins are on two different ports, theuser should mount the sensors onto the corresponding pins suchas (PB0,PA0), (PB1,PA1), (PB2,PA2)..• In this case channel 0 will be on (PB0, PA0) pins, channel 1 will beon (PB1, PA1) pins and so on up to channel 31 will be on (PB31,PA31) pins.828207K-AT42-09/11