Los sensores pueden generar eventos de diferentes maneras llamadas modos de informe; Cada tipo de sensor tiene un solo modo de informe asociado. Existen cuatro modos de informes.
Continuo
Los eventos se generan a una velocidad constante definida por el parámetro sampling_period_ns
pasado a la función batch
. Ejemplos de sensores que utilizan el modo de informe continuo son acelerómetros y giroscopios .
En cambio
Los eventos se generan sólo si los valores medidos han cambiado. Activar el sensor en el nivel HAL (llamando activate(..., enable=1)
en él) también desencadena un evento, lo que significa que HAL debe devolver un evento inmediatamente cuando se activa un sensor en cambio. Los sensores de ejemplo que utilizan el modo de informe de cambios son los tipos de sensores de contador de pasos, proximidad y frecuencia cardíaca.
El parámetro sampling_period_ns
pasado a la función batch
se utiliza para establecer el tiempo mínimo entre eventos consecutivos, lo que significa que no se debe generar un evento hasta que sampling_period_ns
hayan transcurrido nanosegundos desde el último evento, incluso si el valor cambió desde entonces. Si el valor cambió, se debe generar un evento tan pronto como haya transcurrido sampling_period_ns
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 nos quedamos quietos durante un minuto.
- Los eventos se generan aproximadamente cada 10 segundos durante el primer minuto (incluido el momento
t=0
debido a la activación del sensor yt=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 det=60
segundos.
Un trago
Al detectar un evento, el sensor se desactiva y luego envía un único evento a través del 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 envía ningún otro evento hasta que se reactiva el sensor. El movimiento significativo es un ejemplo de este tipo de sensor.
Los sensores de un solo disparo a veces se denominan sensores de disparo.
Se ignoran los parámetros sampling_period_ns
y max_report_latency_ns
pasados a la función batch
. Los eventos de eventos únicos no se pueden almacenar en FIFO de hardware; Los eventos deben ser reportados tan pronto como se generen.
Especial
Consulte las descripciones de los tipos de sensores individuales para obtener detalles sobre cuándo se generan los eventos.