报告模式

传感器能够以不同的方式（称为报告模式）生成事件；每种传感器类型有且仅有一个与之关联的报告模式。共有 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 中；这些事件在生成后必须立即报告。

特别模式

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