10.4.2 Status and Output Data

Table 10-4. Group Data
Parameter Size Range/Options Usage
qtm_keys_status 1 byte Bit 7: Reburst required

Bit 6-1: Reserved

Bit 0: Touch Detection
Indicates the current state of the Touch Key Group
acq_group_timestamp 2 bytes 0-to-65535 Timestamp of last drift period processed
dht_count_in 1 byte 0-to-‘sensor_drift_hold_time Countdown to drift hold release after a touch event
tch_drift_count_in 1 byte 0-to-‘sensor_touch_drift_rate Countdown to next towards a touch drift period
antitch_drift_count_in 1 byte 0-to-‘sensor_anti_touch_drift_rate Countdown to the next away from a touch drift period

Individual Key Sensor Data

The individual key sensor data is required by other post processing modules like Scroller. So, this data structure definition is placed on the common_compoenents_api.h file.
Parameter Size Range/Options Usage
sensor_state 1 byte Bit field Touch key sensor state
sensor_state_counter 1 byte 0-to-255 The number of repeat measurements to confirm a touch detection and an out-of-touch detection
*node_data_struct_ptr 2/4 bytes Pointer Pointer to node data structure array
Channel_reference 2 bytes 0-to-65535 Reference measurement, baseline for touch detection
sensor_state Value
QTM_KEY_STATE_DISABLE 0x00
QTM_KEY_STATE_INIT 0x01
QTM_KEY_STATE_CAL 0x02
QTM_KEY_STATE_NO_DET 0x03
QTM_KEY_STATE_FILT_IN 0x04
QTM_KEY_STATE_DETECT 0x85
QTM_KEY_STATE_FILT_OUT 0x86
QTM_KEY_STATE_ANTI_TCH 0x07
QTM_KEY_STATE_SUSPEND 0x08
QTM_KEY_STATE_CAL_ERR 0x09
Note: Bit 7 (0x80u) is set in each state where the touch key sensor is ‘In Detect’.