QTouch Library configuration parameters for ATtiny20

The Table below describes the various configuration parameters corresponding to the ATtiny20.

Parameter

Description

DEF_QT_QDEBUG_ENABLE

Enable/Disable QDebug debug data communication to QTouch Studio.

DEF_QT_NUM_SENSORS

QTouch number of Sensors.

Range: 1u to 5u.

DEF_QT_SENSOR_0_THRESHOLD,

DEF_QT_SENSOR_1_THRESHOLD,

DEF_QT_SENSOR_2_THRESHOLD,

DEF_QT_SENSOR_3_THRESHOLD,

DEF_QT_SENSOR_4_THRESHOLD

Sensor detection threshold value. Range: 1u to 255u

DEF_QT_SENSOR_0_HYSTERESIS,

DEF_QT_SENSOR_1_HYSTERESIS,

DEF_QT_SENSOR_2_HYSTERESIS,

DEF_QT_SENSOR_3_HYSTERESIS,

DEF_QT_SENSOR_4_HYSTERESIS

Sensor detection hysteresis value.  Refer hysteresis_t in touch_api_tiny20.h

HYST_50   =  (50% of Sensor detection threshold value)

HYST_25   =  (25% of Sensor detection threshold value)

HYST_12_5 =  (12.5% of Sensor detection threshold value)

HYST_6_25 =  (6.25%, but value is hardlimited to 2)

DEF_QT_SENSOR_0_RECAL_THRESHOLD,

DEF_QT_SENSOR_1_RECAL_THRESHOLD,

DEF_QT_SENSOR_2_RECAL_THRESHOLD,

DEF_QT_SENSOR_3_RECAL_THRESHOLD,

DEF_QT_SENSOR_4_RECAL_THRESHOLD

Sensor recalibration threshold value.  Refer recal_threshold_t in touch_api_tiny20.h

RECAL_100  =  (100% of Sensor detection threshold value)

RECAL_50   =  (50% of Sensor detection threshold value)

RECAL_25   =  (25% of Sensor detection threshold value)

RECAL_12_5 =  (12.5% of Sensor detection threshold value)

RECAL_6_25 =  (6.25%, but value is hardlimited to 4)

DEF_QT_DELAY_CYCLES

Delay cycles that determine the capacitance charge transfer time. Range: 1, 2, 4, 8 or 10 internal System Clock cycles.

DEF_QT_ADC_CHANNEL_START_INDEX

ADC Channel starting index. Range: 1u to 7u

DEF_QT_AKS_ENABLE

Enable/Disable Adjacent Key suppression (AKS) on all channels.

DEF_QT_DI

Sensor detect integration (DI) limit.Range: 0u to 255u.  

Refer Section 5.3 and Section 5.4 for more info.

DEF_QT_NEG_DRIFT_RATE*(See Note 1)

Sensor negative drift rate. Units: 100ms, Range: 1u to 127u.

Refer Section 5.3 and Section 5.4 for more info.

DEF_QT_POS_DRIFT_RATE*(See Note 1)

Sensor positive drift rate. Units: 100ms, Range: 1u to 127u.

Refer Section 5.3 and Section 5.4 for more info.

DEF_QT_MAX_ON_DURATION

Sensor maximum on duration. Units: 100ms, Range: 0u to 255u.

Refer Section 5.3 and Section 5.4 for more info.

DEF_QT_DRIFT_HOLD_TIME

Sensor drift hold time. Units: 100ms, Range: 1u to 255u.

Refer Section 5.3 and Section 5.4 for more info.

DEF_QT_POS_RECAL_DELAY

Positive Recalibration delay. Range: 1u to 255u.

Refer Section 5.3 and Section 5.4 for more info.

DEF_QT_NUM_SENSORS_SYM

QTouch number of Sensors Symbol for QTouch Library.

MUST be the same as DEF_QT_NUM_SENSORS.

DEF_QT_BURST_LENGTH

Specifies the no:of burst sequence required for a sensor. Multiple burst for adjusting sensitivity by increasing the resolution of the Signal measured.Use higher value for increasing sensitivity.

Values: 1u, 4u and 16u

DEF_CHARGE_SHARE_DELAY

Defines the Charging Share Delay time as an additional Number of CPU Cycles delay to be introduced during the Charge transfer.  Values:0 to 255 .

Note1:

For the case of ATtiny20 devices, a ‘touch’ causes the Signal value measured on the Sensor to increase above the Sensor Reference value (In the case of Generic Library devices, a ‘touch’ causes the Signal value to decrease below the Reference value).  

However, the Negative drift rate and Positive drift rate functionality for the case of Tiny20 devices shall be consistent with the Generic Library case.

So, it is recommended to have a ‘Slower’ Negative Drift rate (4 seconds is the default setting) and a ‘Faster’ Positive Drift rate (1 second is the default setting) for the Tiny20 device.