touch_qm_sensors_start

touch_ret_t touch_qm_sensors_start_acquisition(touch_time_t current_time_ms, touch_qm_dma_t *p_touch_dma, touch_acq_mode_t qm_acq_mode, void (*measure_complete_callback)( touch_measure_data_t *p_measure_data ))

Arguments	Type	Comment
current_time_ms	touch_time_t	Current time in ms
p_touch_dma	touch_qm_dma_t*	DMA channels to be used for transfer to burst length & acquisition count
qm_acq_mode	touch_acq_mode_t	Specify whether Normal acquisition mode or Raw acquisition mode should be done.
void (*measure_complete_callback)( void )	void (measure_complete_callback)( touch_measure_data_t p_measure_data)	QMatrix Measure complete callback function pointer

1.
This API initiates a capacitive measurement on all enabled QMatrix sensors.
2.
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.
3.
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).
4.
The touch_event_dispatcher API needs to be called as frequently as possible for the Touch Library to process the raw acquisition data.
5.
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). The channel_references, sensor_states and rotor_slider_values data are not updated by the Touch Library in this mode.
6.
This API will return error if a Touch measurement is already in progress.
7.
Two peripheral DMA channels must be provided using p_touch_dma for QMatrix operation.