Merge "[sensor] Clarification of sensor HAL behavior at deactivation" am: 04302ea2fa am: 4b59f97c82 am: 52946f658e
am: 4b36c5e462
Change-Id: I62618abbff602765669ce16660e3f00e071a3c4c
diff --git a/include/hardware/sensors.h b/include/hardware/sensors.h
index aa458a1..99c1147 100644
--- a/include/hardware/sensors.h
+++ b/include/hardware/sensors.h
@@ -1309,11 +1309,16 @@
struct {
struct hw_device_t common;
- /* Activate/de-activate one sensor. Return 0 on success, negative
+ /* Activate/de-activate one sensor.
*
* sensor_handle is the handle of the sensor to change.
* enabled set to 1 to enable, or 0 to disable the sensor.
*
+ * After sensor de-activation, existing sensor events that have not
+ * been picked up by poll() should be abandoned immediately so that
+ * subsequent activation will not get stale sensor events (events
+ * that is generated prior to the latter activation).
+ *
* Return 0 on success, negative errno code otherwise.
*/
int (*activate)(struct sensors_poll_device_t *dev,