Meldemodi

Sensoren können Ereignisse auf unterschiedliche Weise generieren, die als Berichtsmodi bezeichnet werden. Jedem Sensortyp ist genau ein Berichtsmodus zugeordnet. Es gibt vier Berichtsmodi.

Kontinuierlich

Ereignisse werden mit einer konstanten Rate generiert, die durch den Parameter sampling_period_ns definiert wird, der an die Funktion batch übergeben wird. Beispiele für Sensoren, die den Modus für kontinuierliche Berichte verwenden, sind Beschleunigungsmesser und Gyroskope.

Bei Änderung

Ereignisse werden nur generiert, wenn sich die gemessenen Werte geändert haben. Wenn der Sensor auf HAL-Ebene aktiviert wird (activate(..., enable=1) wird darauf aufgerufen), wird auch ein Ereignis ausgelöst. Das bedeutet, dass die HAL sofort ein Ereignis zurückgeben muss, wenn ein Sensor mit der Funktion „Bei Änderung“ aktiviert wird. Beispiele für Sensoren, die den Berichtsmodus „Bei Änderung“ verwenden, sind Schrittzähler, Näherungs- und Herzfrequenzsensoren.

Mit dem Parameter sampling_period_ns, der an die batch-Funktion übergeben wird, wird die Mindestzeit zwischen aufeinanderfolgenden Ereignissen festgelegt. Das bedeutet, dass ein Ereignis erst generiert werden sollte, wenn seit dem letzten Ereignis sampling_period_ns Nanosekunden vergangen sind, auch wenn sich der Wert seitdem geändert hat. Wenn sich der Wert geändert hat, muss ein Ereignis generiert werden, sobald seit dem letzten Ereignis sampling_period_ns vergangen ist.

Angenommen, folgende Bedingungen sind erfüllt:

• Wir aktivieren den Schrittzähler mit sampling_period_ns = 10 * 10^9 (10 Sekunden).
• Wir gehen 55 Sekunden und stehen dann eine Minute still.
• Die Ereignisse werden in der ersten Minute etwa alle 10 Sekunden generiert (einschließlich der Zeit t=0 aufgrund der Aktivierung des Sensors und t=60 Sekunden), insgesamt also sieben Ereignisse. In der zweiten Minute wird kein Ereignis generiert, da sich der Wert der Schrittzahl nach t=60 Sekunden nicht geändert hat.

One-Shot

Nach der Erkennung eines Ereignisses deaktiviert sich der Sensor und sendet dann ein einzelnes Ereignis über die HAL. Die Reihenfolge ist wichtig, um Race-Bedingungen zu vermeiden. Der Sensor muss deaktiviert sein, bevor das Ereignis über die HAL gemeldet wird. Bis zur Reaktivierung des Sensors werden keine weiteren Ereignisse gesendet. Erhebliche Bewegungen sind ein Beispiel für diese Art von Sensor.

Einmalsensoren werden manchmal auch als Triggersensoren bezeichnet.

Die Parameter sampling_period_ns und max_report_latency_ns, die an die Funktion batch übergeben werden, werden ignoriert. Ereignisse aus einmaligen Ereignissen können nicht in Hardware-FIFOs gespeichert werden. Sie müssen gemeldet werden, sobald sie generiert werden.

Specials

Einzelheiten dazu, wann die Ereignisse generiert werden, finden Sie in den Beschreibungen der einzelnen Sensortypen.