Atmel QTouch Library User Guide
Atmel QTouch Library User Guide Atmel QTouch Library User Guide
UseData structure which holds the Register configuration information for QMatrixThis structure contains the data fields that correspond to specific fields in different registers. For amore detailed explanation of the register fields, refer to the device datasheet.For example, CHLEN field of MCCFG0 is 8 bits wide (bit 8-15 of MGCFG0 register). The userneeds to set values from 0 to 255 (0xFF) in the chlen field of this structure. The library will takecare of writing this to the appropriate bit position of MCCFG0 register.Fields Type Corresponds to Register Register Fielddiv uint16 t MGCFG0 DIVchlen uint8 t MGCFG0 CHLENselen uint8 t MGCFG0 SELENdishift uint8 t MGCFG1 DISHIFTsync uint8 t MGCFG1 SYNCspread uint8 t MGCFG1 SPREADdilen uint8 t MGCFG1 DILENmax uint16 t MGCFG1 MAXacctrl uint8 t MGCFG2 ACCTRLconsen uint8 t MGCFG2 CONSENcxdilen uint8 t MGCFG2 CXDILENsynctim uint16 t MGCFG2 SYNCTIMfsources uint8 t DICS FSOURCESglen uint8 t DICS GLENintvrefsel uint8 t DICS INTVREFSELIntrefsel uint8 t DICS INTREFSELtrim uint8 t DICS TRIMsources uint8 t DICS SOURCESshival0 uint16 t ACSHI0 SHIVALshival1 uint16 t ACSHI1 SHIVALshival2 uint16 t ACSHI2 SHIVALshival3 uint16 t ACSHI3 SHIVALshival4 uint16 t ACSHI4 SHIVALshival5 uint16 t ACSHI5 SHIVALshival6 uint16 t ACSHI6 SHIVALshival7 uint16 t ACSHI7 SHIVALtouch_at_reg_tstructureInput / OutputUsetouch_at_reg_tInput to the libraryData structure which holds the Register configuration information forAutonomous QTouchThis structure contains the data fields that correspond to specific fields in different registers. For amore detailed explanation of the register fields, refer to the device datasheet.For example, DISHIFT field of ATCFG1 is 2 bits wide (bit 28-29 of ATCFG1 register). The userneeds to set values from 0 to 3 in the dishift field of this structure. The library will take care ofwriting this to the appropriate bit position of ATCFG1 register.Fields Type Corresponds to Register Register Field1508207K-AT42-09/11
div uint16 t ATCFG0 DIVchlen uint8 t ATCFG0 CHLENselen uint8 t ATCFG0 SELENdishift uint8 t ATCFG1 DISHIFTsync uint8 t ATCFG1 SYNCspread uint8 t ATCFG1 SPREADdilen uint8 t ATCFG1 DILENmax uint16 t ATCFG1 MAXat_param touch_at_param_t Autonomous Touch Sensorparameters corresponding toATCFG2 and ATCFG3.FILTER, OUTSENS,SENSE, PTHR,PDRIFT, NDRIFTtouch_qt_reg_tstructureInput / OutputUsetouch_qt_reg_tInput to the libraryData structure which holds the Register configuration information for QTouchGroup A/B.Fields Type Corresponds to Register Register Fielddiv uint16 t TGxCFG0 DIVchlen uint8 t TGxCFG0 CHLENselen uint8 t TGxCFG0 SELENdishift uint8 t TGxCFG1 DISHIFTsync uint8 t TGxCFG1 SYNCspread uint8 t TGxCFG1 SPREADdilen uint8 t TGxCFG1 DILENmax uint16 t TGxCFG1 MAXtouch_qm_config_tstructureInput / OutputUsetouch_qm_config_tInput to the libraryData structure which holds all configuration information pertaining to QMatrixFields Type Commentnum_channels uint8_t Indicates the number of QMatrix channelsrequired by the usernum_sensors uint8_t Indicates the number of QMatrix sensorsrequired by the user.num_rotors_and_slidersuint8_t Indicates the number of QMatrix rotors /sliders required by the user.num_x_lines uint8_t Number of QMatrix X lines required by theuser.num_y_lines uint8_t Number of QMatrix Y lines required by theuser.num_x_sp uint8_t Number of X sense pairs used. This is aprivate variable to the Touch library. The usermust providePRIV_QM_NUM_X_SENSE_PAIRS for thisinput field.bl_write_count uint8_t Burst length write count. This is a private151
- 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 148 and 149: touch_at_statusstructureInput / Out
- 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
UseData structure which holds the Register configuration information for QMatrixThis structure contains the data fields that correspond to specific fields in different registers. For amore detailed explanation of the register fields, refer to the device datasheet.For example, CHLEN field of MCCFG0 is 8 bits wide (bit 8-15 of MGCFG0 register). The userneeds to set values from 0 to 255 (0xFF) in the chlen field of this structure. The library will takecare of writing this to the appropriate bit position of MCCFG0 register.Fields Type Corresponds to Register Register Fielddiv uint16 t MGCFG0 DIVchlen uint8 t MGCFG0 CHLENselen uint8 t MGCFG0 SELENdishift uint8 t MGCFG1 DISHIFTsync uint8 t MGCFG1 SYNCspread uint8 t MGCFG1 SPREADdilen uint8 t MGCFG1 DILENmax uint16 t MGCFG1 MAXacctrl uint8 t MGCFG2 ACCTRLconsen uint8 t MGCFG2 CONSENcxdilen uint8 t MGCFG2 CXDILENsynctim uint16 t MGCFG2 SYNCTIMfsources uint8 t DICS FSOURCESglen uint8 t DICS GLENintvrefsel uint8 t DICS INTVREFSELIntrefsel uint8 t DICS INTREFSELtrim uint8 t DICS TRIMsources uint8 t DICS SOURCESshival0 uint16 t ACSHI0 SHIVALshival1 uint16 t ACSHI1 SHIVALshival2 uint16 t ACSHI2 SHIVALshival3 uint16 t ACSHI3 SHIVALshival4 uint16 t ACSHI4 SHIVALshival5 uint16 t ACSHI5 SHIVALshival6 uint16 t ACSHI6 SHIVALshival7 uint16 t ACSHI7 SHIVALtouch_at_reg_tstructureInput / OutputUsetouch_at_reg_tInput to the libraryData structure which holds the Register configuration information forAutonomous <strong>QTouch</strong>This structure contains the data fields that correspond to specific fields in different registers. For amore detailed explanation of the register fields, refer to the device datasheet.For example, DISHIFT field of ATCFG1 is 2 bits wide (bit 28-29 of ATCFG1 register). The userneeds to set values from 0 to 3 in the dishift field of this structure. The library will take care ofwriting this to the appropriate bit position of ATCFG1 register.Fields Type Corresponds to Register Register Field1508207K-AT42-09/11