Atmel QTouch Library User Guide
Atmel QTouch Library User Guide Atmel QTouch Library User Guide
7 AKS groups are supported by the libraryValuesCommentNO_AKS_GROUP NO AKS group selected for the sensorAKS_GROUP_1 AKS Group number 1AKS_GROUP_2 AKS Group number 2AKS_GROUP_3 AKS Group number 3AKS_GROUP_4 AKS Group number 4AKS_GROUP_5 AKS Group number 5AKS_GROUP_6 AKS Group number 6AKS_GROUP_7 AKS Group number 7channel_tEnumerationUsechannel_tThe channel numbers used in the library.When using the QTouch acquisition method, the channel numbers have a oneto one mapping to the pin numbers of the port being used.When using the QMatrix acquisition method, the channel numbers are orderedin a matrix sequenceValuesCommentCHANNEL_0 Channel number : 0CHANNEL_1 Channel number : 1CHANNEL_2 Channel number : 2CHANNEL_3 Channel number : 3..... Channel number: ..Upto CHANNEL ( N-1 ) Channel number N-1 : for an N Channel libraryThe maximum number of channels supported is dependent on the library variant. Possible valuesof N are as listed belowAcquisition method Device type Possible values of N( Maximum number of channels )QTouch acquisition 8-bit 4,8,1632-bit 8, 16, 32QMatrix Acquisition 8-bit 8,16,32,64hysteresis_tEnumerationUseHysteresis_tDefines the sensor detection hysteresis value. This is expressed as apercentage of the sensor detection threshold.This is configurable per sensor.HYST_x = hysteresis value is x percent of detection threshold value (roundeddown).Note that a minimum value of 2 is used as a hard limit. Example: if detectionthreshold = 20, then:HYST_50 = 10 (50 percent of 20)HYST_25 = 5 (25 percent of 20)HYST_12_5 = 2 (12.5 percent of 20)HYST_6_25 = 2 (6.25 percent of 20 = 1, but set to the hard limit of 2)248207K-AT42-09/11
ValuesHYST_50HYST_25HYST_12_5HYST_6_25Comment50% Hysteresis25% Hysteresis12.5% Hysteresis6.25% Hysteresisresolution_tEnumerationUseresolution_tFor rotors and sliders, the resolution of the reported angle or position.RES_x_BIT = rotor/slider reports x-bit values.Example: if slider resolution is RES_7_BIT, then reported positions are in therange 0…127.Values CommentRES_1_BIT 1 bit resolution : reported positions range 0 – 1RES_2_BIT 2 bit resolution : reported positions range 0 – 3RES_3_BIT 3 bit resolution : reported positions range 0 – 7RES_4_BIT 4 bit resolution : reported positions range 0 – 15RES_5_BIT 5 bit resolution : reported positions range 0 – 31RES_6_BIT 6 bit resolution : reported positions range 0 – 63RES_7_BIT 7 bit resolution : reported positions range 0 – 127RES_8_BIT 8 bit resolution : reported positions range 0 – 255recal_threshold_tEnumerationUserecal_threshold_tA sensor recalibration threshold. This is expressed as a percentage of thesensor detection threshold.This is for automatic recovery from false conditions, such as a calibration whilesensors were touched, or a significant step change in power supply voltage.If the false condition persists the library will recalibrate according to the settingsof the recalibration threshold.This setting is applicable to all the configured sensors.Usage :RECAL_x = recalibration threshold is x percent of detection threshold value(rounded down).Note: a minimum value of 4 is used.Example: if detection threshold = 40, then:RECAL_100 = 40 ( 100 percent of 40)RECAL_50 = 20 ( 50 percent of 40)RECAL_25 = 10 ( 25 percent of 40)RECAL_12_5 = 5 ( 12.5 percent of 40)RECAL_6_25 = 4 ( 6.25 percent of 40 = 2, but value is limited to 4)ValuesRECAL_100RECAL_50RECAL_25RECAL_12_5RECAL_6_25Comment100% recalibration threshold50% recalibration threshold25% recalibration threshold12.5% recalibration threshold6.25% recalibration threshold25
- 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 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 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
7 AKS groups are supported by the libraryValuesCommentNO_AKS_GROUP NO AKS group selected for the sensorAKS_GROUP_1 AKS Group number 1AKS_GROUP_2 AKS Group number 2AKS_GROUP_3 AKS Group number 3AKS_GROUP_4 AKS Group number 4AKS_GROUP_5 AKS Group number 5AKS_GROUP_6 AKS Group number 6AKS_GROUP_7 AKS Group number 7channel_tEnumerationUsechannel_tThe channel numbers used in the library.When using the <strong>QTouch</strong> acquisition method, the channel numbers have a oneto one mapping to the pin numbers of the port being used.When using the QMatrix acquisition method, the channel numbers are orderedin a matrix sequenceValuesCommentCHANNEL_0 Channel number : 0CHANNEL_1 Channel number : 1CHANNEL_2 Channel number : 2CHANNEL_3 Channel number : 3..... Channel number: ..Upto CHANNEL ( N-1 ) Channel number N-1 : for an N Channel libraryThe maximum number of channels supported is dependent on the library variant. Possible valuesof N are as listed belowAcquisition method Device type Possible values of N( Maximum number of channels )<strong>QTouch</strong> acquisition 8-bit 4,8,1632-bit 8, 16, 32QMatrix Acquisition 8-bit 8,16,32,64hysteresis_tEnumerationUseHysteresis_tDefines the sensor detection hysteresis value. This is expressed as apercentage of the sensor detection threshold.This is configurable per sensor.HYST_x = hysteresis value is x percent of detection threshold value (roundeddown).Note that a minimum value of 2 is used as a hard limit. Example: if detectionthreshold = 20, then:HYST_50 = 10 (50 percent of 20)HYST_25 = 5 (25 percent of 20)HYST_12_5 = 2 (12.5 percent of 20)HYST_6_25 = 2 (6.25 percent of 20 = 1, but set to the hard limit of 2)248207K-AT42-09/11