Atmel QTouch Library User Guide
Atmel QTouch Library User Guide Atmel QTouch Library User Guide
sensor_type_tEnumerationUsesensor_type_tDefine the type of the sensorValuesSENSOR_TYPE_UNASSIGNEDSENSOR_TYPE_KEYSENSOR_TYPE_ROTORSENSOR_TYPE_SLIDERCommentChannel is not assigned to any sensorSensor is a keySensor is a rotorSensor is a slideraks_group_tEnumerationUseaks_group_tDefines the Adjacent Key Suppression (AKS) groups that each sensor may beassociated withAKS is selectable by the system designer7 AKS groups are supported by the libraryValuesCommentNO_AKS_GROUPNo AKS group is 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 7hysteresis_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)ValuesHYST_50HYST_25HYST_12_5HYST_6_25Comment50% Hysteresis25% Hysteresis12.5% Hysteresis6.25% Hysteresis1428207K-AT42-09/11
ecal_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_25resolution_tEnumerationUseComment100% recalibration threshold50% recalibration threshold25% recalibration threshold12.5% recalibration threshold6.25% recalibration thresholdresolution_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.ValuesCommentRES_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 – 255at_status_change_tEnumerationUseat_status_change_tIndicates the current status of autonomous QTouch sensorValuesComment143
- 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
- Page 132 and 133: Frozen Stop Stop Run Run Run Run On
- Page 134 and 135: Figure 45 Raw acquisition mode API
- Page 136 and 137: Figure 46 GNU Example project usage
- Page 138 and 139: the QTouch Library as QMatrix data
- Page 140 and 141: TOUCH_STATUS_CHANGE 0x0002u Status
- Page 144 and 145: OUT_OF_TOUCHIN_TOUCHCurrently the a
- Page 146 and 147: num_channel_signals uint8_t Length
- Page 148 and 149: touch_at_statusstructureInput / Out
- Page 150 and 151: UseData structure which holds the R
- Page 152 and 153: variable to the Touch library. The
- Page 154 and 155: structure.p_qta_config touch_qt_con
- Page 156 and 157: p_touch_sensor_param touch_qm_param
- Page 158 and 159: current_time_ms touch_time_t Curren
- Page 160 and 161: touch_ret_t touch_qt_sensor_config(
- Page 162 and 163: touch_qt_sensors_calibratetouch_ret
- Page 164 and 165: touch_qt_get_libinfotouch_ret_t tou
- Page 166 and 167: • This API updates the configurat
- Page 168 and 169: Rule Rule Description Advisory/Requ
- Page 170 and 171: VCCPA0No ConnectionPA1PA2ATtiny20PA
- Page 172 and 173: QTouch Library configuration parame
- Page 174 and 175: Recommended setting.Table 19 QTouch
- Page 176 and 177: Figure 51 Schematic overview of QTo
- Page 178 and 179: QTouch Library configuration parame
- Page 180 and 181: Devices supportedThe list of differ
- Page 182 and 183: • The channel number is derived f
- Page 184 and 185: MISRA Compliance ReportThis section
- Page 186 and 187: May 2010Ver 4.2July 2010Ver 4.3Jan
ecal_threshold_tEnumeration<strong>User</strong>ecal_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_25resolution_tEnumerationUseComment100% recalibration threshold50% recalibration threshold25% recalibration threshold12.5% recalibration threshold6.25% recalibration thresholdresolution_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.ValuesCommentRES_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 – 255at_status_change_tEnumerationUseat_status_change_tIndicates the current status of autonomous <strong>QTouch</strong> sensorValuesComment143