Atmel QTouch Library User Guide

More documents

Recommendations

Info

touch_at_statusstructureInput / OutputUsetouch_at_statusOutput structure received as part of the Autonomous QTouch Interrupt callbackfunction.Data structure which holds the status parameters for the autonomous QTouchsensor.StructurefieldTypeCommentstatus change at status change t Autonomous QTouch Status change.base_count uint16_t The base count currently stored by the autonomous touchsensor. This is useful for autonomous touch debuggingpurposes.current_count uint16_t The current count acquired by the autonomous touchsensor. This is useful for autonomous touch debuggingpurposes.touch_qm_dma_tstructureInput / OutputUsetouch_qm_dma_tInput to the touch_qm_sensors_start_acquisition() API.Data structure which holds the DMA channel information for touch acquisitiondata transferFields Type Commentdma_ch1 uint8_t Indicates the DMA channel 1. Can take values from 0 – 11, but should notbe same as dma_ch2dma_ch2 uint8_t Indicates the DMA channel 2. Can take values from 0 – 11, but should notbe same as dma_ch1touch_qm_pin_tstructureInput / OutputUsetouch_qm_pin_tInput to the libraryData structure which holds the Pin configuration information for QMatrixFields Type Commentx_lines uint32_t Bitmask that indicates the selected X pins for QMatrix. If bit n is set, Xn isenabled for QMatrix; n can be 0 to 17. Any other bits set are ignored. Note:For QMatrix operation, X8 is not available as it must be used for ACREFNfunction.Bit 18-3117 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2y_yk_linesuint8_tXLine- X17X16X15X14X13X12Bitmask that indicates the selected Y pins for QMatrix. If bit n is set, Yn &Ykn is enabled for QMatrix; n can be 0 to 7.X11X10X9X8X7X6X5X4X3X21488207K-AT42-09/11
Bit 7 6 5 4 3 2 1 0smp_dis_pingeneral_pin_options_tYLineY7 &YK7Y6 &YK6Specify one of the followingUSE_NO_PINUSE_PIN_PA12_AS_SMPUSE_PIN_PA13_AS_SMPUSE_PIN_PA14_AS_SMPUSE_PIN_PA17_AS_SMPUSE_PIN_PA21_AS_SMPUSE_PIN_PA22_AS_SMPUSE_PIN_PA17_AS_DISY5 &YK5Y4 &YK4Y3 &YK3Y2 &YK2Y1 &YK1Y0 &YK0vdiv_pingeneral_pin_options_tSpecify either USE_NO_PIN or USE_PIN_PB11_AS_VDIVtouch_at_pin_tstructureInput / OutputUsetouch_at_pin_tInput to the libraryData structure which holds the Pin configuration for Autonomous QTouchsensorFields Type Commentatsp uint8_t Sense pair to be used for autonomous QTouch detection. Choose any onesense pair from SP0 to SP16 using the qt_pin_options_t enum.For example, if atsp is set as SP7, Sense pair 7 (CSA7, CSB7) will be assignedfor autonomous QTouch detectiontouch_qt_pin_tstructureInput / OutputUsetouch_at_pin_tInput to the libraryData structure which holds the Pin configuration for QTouch sensor.FieldsspTypeuint32_tCommentBit n indicates Sense Pair SP[n] is selected. Choose sense pairs from SP0 toSP16.Bit 17-3116 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0SPn- X16X15X14X13X12X11X10X9X8X7X6X5X4X3X2X1X0touch_qm_reg_tstructure touch_qm_reg_tInput / Output Input to the library149
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 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 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
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 142 and 143: sensor_type_tEnumerationUsesensor_t
Page 144 and 145: OUT_OF_TOUCHIN_TOUCHCurrently the a
Page 146 and 147: num_channel_signals uint8_t Length
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
show all

Atmel QTouch Library User Guide

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?