传感器能够以不同的方式(称为报告模式)生成事件;每种传感器类型有且仅有一个与之关联的报告模式。共有 4 种报告模式。
连续
以传递给 batch
函数的 sampling_period_ns
参数所定义的恒定速率生成事件。使用连续报告模式的示例传感器有加速度计和陀螺仪。
变化模式
仅在测量值发生变化时生成事件。在 HAL 层激活传感器(在其上调用 activate(..., enable=1)
)也会触发事件,也就是说在激活变化模式传感器时,HAL 必须立即返回事件。使用变化报告模式的示例传感器类型有计步器、近程传感器和心率传感器。
传递给 batch
函数的 sampling_period_ns
参数用于设置连续事件之间的最小时间间隔,也就是说不得在自上一事件后的 sampling_period_ns
纳秒内生成事件,即使值在这段时间内发生了变化也是如此。如果值在间隔期间发生变化,则必须在自上一事件的 sampling_period_ns
后立即生成事件。
例如,假设:
- 我们使用
sampling_period_ns = 10 * 10^9
(10 秒)激活计步器。 - 步行 55 秒,再站立 1 分钟。
- 在第一分钟,约每 10 秒生成一个事件(包括传感器激活时的
t=0
秒以及t=60
秒),共有 7 个事件。在第二分钟,不生成任何事件,因为步数的值在t=60
秒后没有发生变化。
单次模式
传感器一检测到事件便会自行禁用,然后通过 HAL 发送单个事件。顺序非常重要,可避免出现竞态条件。(在通过 HAL 报告事件之前,传感器必须处于禁用状态)。重新激活传感器之前,不会发送其他任何事件。大幅度动作传感器就是这样一种传感器。
单次模式传感器有时称为触发传感器。
传递给 batch
函数的 sampling_period_ns
和 max_report_latency_ns
参数会被忽略。来自单次事件的事件不可存储在硬件 FIFO 中;这些事件在生成后必须立即报告。
特殊模式
如需详细了解何时生成事件,请参阅各传感器类型说明。