touch_qm_channel_udpate_burstlen

touch_ret_t touch_qm_channel_udpate _burstlen( channel_t channel, touch_bl_t qm_burst_length)

Arguments

Type

Comment

channel

uint8_t

Channel number for which the burst length is to be set.

qm_burst_length

touch_bl_t

QMatrix burst length.  The burst length value can be 1 to 255.  A value of 1 can be used to disable bursting on a given channel.

  1. 1.

    This API updates the burst length of the specified QMatrix channel

  2. 2.

    This API can also be used to disable Touch measurement on a Sensor.  

  3. 3.

    In order to disable a Sensor, the burst length value of all the channels corresponding to the Sensor must be set to 1.  A Sensor can then be re-enabled by setting the appropriate burst length for all channels using this API.   Note:  When disabling a sensor care must be taken such that all channels of the Sensor are set to 1.  If any of the channels are missed out, it will result in undesired behavior of the Sensor.  Similarly when re-enabling a Sensor, if one or more channels are left disabled with a burst length value of 1, it will result in undesired behavior of the Sensor

  4. 4.

    The touch_qm_sensors_calibrate API needs to be called whenever burst length is updated for one or more channels before starting a new Touch measurement using the  touch_qm_sensors_start_acquisition API.