感應器可以透過不同的方式 (稱為回報模式) 產生事件;每種感應器類型只會關聯一個回報模式。共有四種報表模式。
連續
系統會以固定速率產生事件,該速率是由傳遞至 batch 函式的 sampling_period_ns 參數定義。感應器範例
使用持續回報模式的感應器為
加速計
和陀螺儀。
On-change
只有在測量值有變更時,系統才會產生事件。
在 HAL 層級啟用感應器 (呼叫 activate(..., enable=1)) 也會觸發事件,也就是說,啟用變更時感應器時,HAL 必須立即傳回事件。使用變更時回報模式的感應器範例包括步數計數器、接近感應器和心率感應器類型。
傳遞至 batch 函式的 sampling_period_ns 參數用於設定連續事件間的最短時間,也就是說,即使值已變更,也必須經過 sampling_period_ns 奈秒,才能產生事件。如果值有所變更,則必須在自上次事件起經過 sampling_period_ns 後,立即產生事件。
舉例來說,假設:
- 我們會以
sampling_period_ns = 10 * 10^9(10 秒) 啟動步數計數器。 - 我們步行 55 秒,然後靜止不動一分鐘。
- 在前一分鐘內,系統大約每 10 秒會產生一個事件 (包括感應器啟動時的
t=0秒和t=60秒),總共七個事件。由於步數值在t=60秒後沒有變化,因此第二分鐘不會產生任何事件。
單樣本
偵測到事件後,感應器會自行停用,然後透過 HAL 傳送單一事件。為避免競爭狀況,請務必依序呼叫。 (感應器必須先停用,才能透過 HAL 回報事件)。感應器重新啟動前,系統不會傳送其他事件。 重大動作就是這類感應器的例子。
單次觸發感應器有時也稱為觸發感應器。
傳遞至 batch 函式的 sampling_period_ns 和 max_report_latency_ns 參數會遭到忽略。單次事件產生的事件無法儲存在硬體 FIFO 中,必須在產生後立即回報。
特別節目
如要瞭解事件的生成時間,請參閱個別感應器類型說明。