ATAVRQTOUCHX Atmel, ATAVRQTOUCHX Datasheet - Page 149

• Manufacturer Part Number: ATAVRQTOUCHX
• Description: BOARD EVAL CAPACITIVE TOUCH
• Manufacturer: Atmel
• Series: QTouch™r

Specifications of ATAVRQTOUCHX

• Sensor Type: Touch, Capacitive
• Sensing Range: 1 Slider, 1 Wheel, 2 Buttons
• Interface: USB
• Voltage - Supply: 5V, USB
• Embedded: Yes, MCU, 8-Bit
• Utilized Ic / Part: AT90USB1287, ATxmega128A1
• Silicon Manufacturer: Atmel
• Silicon Family Name: ATxmega
• Kit Contents: Board
• Svhc: No SVHC (15-Dec-2010)
• Core Architecture: AVR
• Core Sub-architecture: AVR19
• Kit Features: One Slider, One Wheel And 2
• Rohs Compliant: Yes
• Lead Free Status / RoHS Status: Lead free / RoHS Compliant
• Sensitivity: -
• Lead Free Status / Rohs Status: Lead free / RoHS Compliant

6.3.17.1.10 touch_qm_get_libinfo
Arguments
Arguments
current_time_ms
p_touch_dma
qm_acq_mode
void
(*measure_complete_callback)(
void )
p_
touch_info
•
•
•
•
•
•
•
•
void (*measure_complete_callback)( touch_measure_data_t *p_measure_data ))
This API initiates a capacitive measurement on all enabled QMatrix sensors.
When normal acquisition mode is used, once the Touch measurement is completed on all
the QMatrix sensors, before processing the raw acquisition data (channel_signals), a
filter_callback function is optionally called by the Touch Library.
Once the filter_callback is completed, the signal values will be processed by the Touch
Library. The measure_complete_callback function is then called with touch data
(channel_signals, channel_references, sensor_states, sensors structure) as well as the
Touch Status (sensor_states) and Rotor/Slider position (rotor_slider_values).
The touch_event_dispatcher API needs to be called as frequently as possible for the
Touch Library to process the raw acquisition data.
When raw data acquisition mode is used, once the raw acquisition data is available from
the CAT module for all the sensors, the measure_complete_callback function is
immediately called with acquisition data (channel_signals).
sensor_states and rotor_slider_values data are not updated by the Touch Library in this
mode.
This API will return error if a Touch measurement is already in progress.
Two peripheral DMA channels must be provided using p_touch_dma for QMatrix
operation.
touch_ret_t touch_qm_get_libinfo( touch_info_t *p_touch_info)
The touch_info_t structure is filled by the library with information like number of QMatrix
channels, number of QMatrix sensors, number of QMatrix rotors/slider, CAT hardware
version, and library version.
Type
touch_info_t*
Comment
User passes the memory address at which the library information
is to be stored by the library.
Type
touch_time_t
touch_qm_dma_t*
touch_acq_mode_t
void
(*measure_complete_callback)(
touch_measure_data_t
*p_measure_data)
touch_acq_mode_t qm_acq_mode,
The channel_references,
Specify whether Normal
Comment
Current time in ms
DMA channels to be
used for transfer to burst
length & acquisition
count
acquisition mode or
Raw acquisition mode
should be done.
QMatrix Measure
complete callback
function pointer
149