O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Modos de relatório

Os sensores podem gerar eventos de diferentes maneiras, chamados de modos de relatório; cada tipo de sensor possui um e apenas um modo de relatório associado a ele. Existem quatro modos de relatório.

Contínuo

Os eventos são gerados a uma taxa constante definida pelo parâmetro sampling_period_ns passado para a função batch . Sensores de exemplo usando o modo de relatório contínuo são acelerômetros e giroscópios .

Em mudança

Os eventos são gerados apenas se os valores medidos foram alterados. Ativar o sensor no nível HAL (chamar activate(..., enable=1) nele) também dispara um evento, o que significa que o HAL deve retornar um evento imediatamente quando um sensor ao mudar é ativado. Sensores de exemplo que usam o modo de relatório ao alterar são os tipos de sensores de contador de passos, proximidade e frequência cardíaca.

O parâmetro sampling_period_ns passado para a função batch é usado para definir o tempo mínimo entre eventos consecutivos, significando que um evento não deve ser gerado até sampling_period_ns nanossegundos decorridos desde o último evento, mesmo se o valor mudou desde então. Se o valor mudou, um evento deve ser gerado assim que sampling_period_ns tiver decorrido desde o último evento.

Por exemplo, suponha:

  • Ativamos o contador de passos com sampling_period_ns = 10 * 10^9 (10 segundos).
  • Caminhamos por 55 segundos, depois ficamos parados por um minuto.
  • Os eventos são gerados aproximadamente a cada 10 segundos durante o primeiro minuto (incluindo no tempo t=0 por causa da ativação do sensor, t=60 segundos), para um total de sete eventos. Nenhum evento é gerado no segundo minuto porque o valor da contagem de passos não mudou após t=60 segundos.

Um disparo

Ao detectar um evento, o sensor se desativa e envia um único evento por meio do HAL. O pedido é importante para evitar condições de corrida. (O sensor deve ser desativado antes que o evento seja relatado por meio do HAL). Nenhum outro evento é enviado até que o sensor seja reativado. O movimento significativo é um exemplo desse tipo de sensor.

Sensores de disparo único às vezes são chamados de sensores de gatilho.

Os parâmetros sampling_period_ns e max_report_latency_ns passados ​​para a função batch são ignorados. Os eventos de eventos únicos não podem ser armazenados em FIFOs de hardware; os eventos devem ser relatados assim que forem gerados.

Especial

Consulte as descrições do tipo de sensor individual para obter detalhes sobre quando os eventos são gerados.