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 velocidad constante definida por el parámetro sampling_period_ns que se pasa a la función batch. Los sensores de ejemplo que usan el modo de informes continuos son los acelerómetros y los giroscopios.

Al cambiar

Los eventos se generan solo si cambiaron los valores medidos. La activación del sensor a nivel de la HAL (llamando a activate(..., enable=1) en él) también activa un evento, lo que significa que la HAL debe devolver un evento de inmediato cuando se activa un sensor de cambio. Los sensores de ejemplo que usan el modo de generación de informes cuando se producen cambios son los tipos de sensores de contador de pasos, proximidad y 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 cambió, se debe generar un evento tan pronto como transcurra sampling_period_ns desde el último evento.

Por ejemplo, supongamos lo siguiente:

• 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 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.

Un ejemplo

Cuando se detecta un evento, el sensor se desactiva y, luego, envía un solo evento a través del HAL. El orden es importante para evitar condiciones de carrera. (El sensor debe desactivarse antes de que el evento se informe a través del HAL). No se envía ningún otro evento hasta que se reactiva el sensor. Movimiento significativo es un ejemplo de este tipo de sensor.

A veces, los sensores de un solo disparo 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 disparo no se pueden almacenar en FIFO de hardware; los eventos se deben informar en cuanto se generan.

Especial

Consulta las descripciones de cada tipo de sensor para obtener detalles sobre cuándo se generan los eventos.