I sensori possono generare eventi in modi diversi, chiamati modalità di generazione di report. Ogni tipo di sensore ha una sola modalità di generazione di report associata. Esistono quattro modalità di generazione di report.
Continuo
Gli eventi vengono generati con una frequenza costante definita
sampling_period_ns
passato alla funzione batch
. Sensori di esempio
utilizzando la modalità di segnalazione continua vengono
accelerometri
e giroscopi.
Al cambio
Gli eventi vengono generati solo se i valori misurati sono stati modificati.
L'attivazione del sensore a livello di HAL (chiamata
activate(..., enable=1)
) attiva anche un evento,
il che significa che l'HAL deve restituire un evento immediatamente quando viene attivato un sensore su variazione. I sensori di esempio che utilizzano la modalità di segnalazione delle modifiche sono i
tipi di sensori di passi, prossimità e sensore del battito cardiaco.
Il
sampling_period_ns
parametro passato alla funzione batch
viene utilizzato per impostare il
tempo minimo tra eventi consecutivi, il che significa che un evento non deve essere
generato fino a quando non sono trascorsi sampling_period_ns
nanosecondi dall'ultimo
evento, anche se il valore è cambiato da allora. Se il valore cambia,
deve essere generato un evento non appena sampling_period_ns
ha
trascorsi dall'ultimo evento.
Ad esempio, supponiamo che:
- Attiva il contapassi con
sampling_period_ns = 10 * 10^9
(10 secondi). - Camminiamo per 55 secondi, poi rimaniamo fermi per un minuto.
- Gli eventi vengono generati ogni 10 secondi circa durante il primo
minuto (incluso all'ora
t=0
a causa dell'attivazione del sensore et=60
secondi), per un totale di sette eventi. Nessun evento viene generato nel secondo minuto perché il valore del conteggio dei passi non è cambiato dopot=60
secondi.
One-shot
Quando viene rilevato un evento, il sensore si disattiva e poi invia a un singolo evento tramite l'HAL. L'ordine è importante per evitare le gare. (Il sensore deve essere disattivato prima che l'evento venga segnalato tramite HAL). Nessun altro evento viene inviato finché il sensore non viene riattivato. Significativo movimento è un esempio di questo tipo di sensore.
I sensori one-shot a volte sono chiamati sensori di attivazione.
I parametri sampling_period_ns
e max_report_latency_ns
passati alla funzione batch
vengono ignorati. Gli eventi
da eventi una tantum non possono essere memorizzati in FIFO hardware; gli eventi devono essere
registrati non appena vengono generati.
Speciale
Vedere il singolo tipo di sensore descrizioni per i dettagli su quando vengono generati gli eventi.