Modos de informes

Los sensores pueden generar eventos de diferentes maneras denominadas modos de generación de informes: cada tipo de sensor tiene un solo modo de generación de informes asociado. Existen cuatro modos de informes.

Continuo

Los eventos se generan a una tasa constante definida por el sampling_period_ns pasado a la función batch. Ejemplos de sensores que usan el modo de informes continuos acelerómetros y giroscopios.

Al cambiar

Los eventos solo se generan si los valores medidos cambiaron. Activar el sensor a nivel de HAL (llamar a activate(..., enable=1) en él) también activa un evento, lo que significa que HAL debe mostrar un evento de inmediato cuando se activa un sensor de cambio. Los sensores de ejemplo que usan el modo de generación de informes sobre cambio son contador de pasos, sensor de proximidad y de frecuencia cardíaca.

El parámetro sampling_period_ns que se pasa a la función batch se usa para establecer el tiempo mínimo entre eventos consecutivos, lo que significa que no se debe generar un evento hasta que transcurran sampling_period_ns nanosegundos desde el último evento, incluso si el valor cambió desde entonces. Si el valor cambia, se debe generar un evento en cuanto sampling_period_ns transcurrido desde el último evento.

Por ejemplo, supongamos:

  • Activamos el contador de pasos con sampling_period_ns = 10 * 10^9 (10 segundos).
  • Caminamos durante 55 segundos y, luego, permanecemos inmóviles durante un minuto.
  • Los eventos se generan aproximadamente cada 10 segundos durante el primer minuto (incluidos los tiempos t=0 debido a la activación del sensor y t=60 segundos), para un total de siete eventos. No se genera ningún evento en el segundo minuto porque el valor del recuento de pasos no cambió después de t=60 segundos.

Una sola acción

Al detectar un evento, el sensor se desactiva a sí mismo y, luego, envía un solo evento a través de la HAL. El orden es importante para evitar condiciones de carrera. (el sensor debe desactivarse antes de que se informe el evento a través del HAL). No se enviarán otros eventos hasta que se reactive el sensor. El movimiento significativo es un ejemplo de este tipo de sensor.

A veces, los sensores de un solo uso se denominan sensores de activación.

Se ignoran los parámetros sampling_period_ns y max_report_latency_ns que se pasan a la función batch. Los eventos de un solo uso no se pueden almacenar en FIFO de hardware. Los eventos se deben informar en cuanto se generan.

Especial

Ver el tipo de sensor individual descripciones para obtener detalles sobre cuándo se generan los eventos.