Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Mode pelaporan

Sensor dapat menghasilkan peristiwa dengan berbagai cara yang disebut mode pelaporan; setiap jenis sensor memiliki satu dan hanya satu mode pelaporan yang terkait dengannya. Ada empat mode pelaporan.

Kontinu

Peristiwa dibuat dengan kecepatan konstan yang ditentukan oleh parameter sampling_period_ns diteruskan ke fungsi batch . Contoh sensor yang menggunakan mode pelaporan kontinu adalah akselerometer dan giroskop .

Dalam perubahan

Peristiwa dibuat hanya jika nilai terukur telah berubah. Mengaktifkan sensor di tingkat HAL (memanggil activate(..., enable=1) di atasnya) juga memicu peristiwa, yang berarti HAL harus segera mengembalikan peristiwa saat sensor on-change diaktifkan. Contoh sensor yang menggunakan mode pelaporan saat diubah adalah jenis sensor penghitung langkah, kedekatan, dan detak jantung.

Parameter sampling_period_ns diteruskan ke fungsi batch digunakan untuk menyetel waktu minimum antara peristiwa berturut-turut, yang berarti peristiwa tidak boleh dibuat hingga sampling_period_ns nanodetik berlalu sejak peristiwa terakhir, meskipun nilainya berubah sejak saat itu. Jika nilainya berubah, peristiwa harus dibuat segera setelah sampling_period_ns berlalu sejak peristiwa terakhir.

Misalnya, misalkan:

  • Kami mengaktifkan penghitung langkah dengan sampling_period_ns = 10 * 10^9 (10 detik).
  • Kami berjalan selama 55 detik, lalu berdiri diam selama satu menit.
  • Peristiwa dihasilkan setiap 10 detik selama menit pertama (termasuk pada waktu t=0 karena aktivasi sensor, dan t=60 detik), dengan total tujuh peristiwa. Tidak ada peristiwa yang dihasilkan pada menit kedua karena nilai hitungan langkah tidak berubah setelah t=60 detik.

Satu tembakan

Setelah mendeteksi suatu peristiwa, sensor menonaktifkan dirinya sendiri dan kemudian mengirimkan satu peristiwa melalui HAL. Urutan penting untuk menghindari kondisi balapan. (Sensor harus dinonaktifkan sebelum kejadian tersebut dilaporkan melalui HAL). Tidak ada peristiwa lain yang dikirim sampai sensor diaktifkan kembali. Gerakan signifikan adalah salah satu contoh dari jenis sensor ini.

Sensor satu tembakan terkadang disebut sebagai sensor pemicu.

Parameter sampling_period_ns dan max_report_latency_ns diteruskan ke fungsi batch akan diabaikan. Acara dari acara satu tembakan tidak dapat disimpan dalam perangkat keras FIFO; acara harus dilaporkan segera setelah dibuat.

Khusus

Lihat deskripsi masing-masing jenis sensor untuk mengetahui detail tentang kapan peristiwa dibuat.