报告模式

传感器能够以不同的方式(称为报告模式)生成事件;每种传感器类型有且仅有一个与之关联的报告模式。共有 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_nsmax_report_latency_ns 参数会被忽略。来自单次事件的事件不可存储在硬件 FIFO 中;这些事件在生成后必须立即报告。

特别模式

如需详细了解何时生成事件,请参阅各传感器类型说明