Skip to main content

Acc Manager

Enrichers#

orientation#

Adds device orientation (in degrees) which attempts to report back the exact orientation of the device to the ground.

note

This enricher is still a work-in-progress and is not considered stable. The calculations

here are based on this article: http://www.starlino.com/imu_guide.html

roll_pitch#

Calculates roll and pitch for a XYZ reading and appends it to the result. This enricher supports both single value results as well as multiple values results.

Filters#

alternating_readout#

Filter that only returns alternating/changed results.

Handlers#

connection#

Manages current connection.

OPTIONAL ARGUMENTS

  • close (bool): Close connection? Default value is False.

dump#

Dumps raw XYZ readings to screen or file.

OPTIONAL ARGUMENTS

  • duration (int): How many seconds to record data? Default value is 1.
  • file (str): Write data to a file with the given name.
  • range (int): Maximum number of g-forces being measured. Default value is 8.
  • rate (float): How many Hz (samples per second)? Default value is 12.5.
  • decimals (int): How many decimals to calculate? Default value is 4.
  • timestamp (bool): Add timestamp to each sample? Default value is True.
  • sound (bool): Play sound when starting and stopping recording? Default value is True.
  • interrupt_driven (bool): Await hardware data ready signal before reading a sample? Default value is True.

query#

Queries a given accelerometer command.

ARGUMENTS

  • cmd (str): The command to query.

Triggers#

motion_event#

Triggers vehicle/motion/jolting, vehicle/motion/shaking and vehicle/motion/steady events based on accelerometer XYZ readings.

OPTIONAL ARGUMENTS

  • jolt_g_threshold (float): G force threshold for jolting detection. Disabled when set to zero. Default value is 0.3.
  • jolt_duration (float): How long in seconds should the G force threshold be observed over? Default value is 1.
  • shake_g_threshold (float): G force threshold for shaking detection. Disabled when set to zero. Default value is 0.01.
  • shake_duration (float): How long in seconds should the G force threshold be observed over? Default value is 3.
  • shake_percentage (float): Percentage of positive motion detections required within duration period to conclude shaking. Default value is 90.
  • debounce_delay (float): Minimum delay in seconds between triggering events. Default value is 1.