Events Config

We've adding a new Raven settings section called "events_config", which will hold per-event configuration and allow us to introduce new event configuration parameters more reliably in the future.

The "events_config" section is available under the top-level RavenSettings message, and sits besides the existing "events" section. The "events" section will still be populated normally, but it will eventually be phased out and deprecated in favor of "events_config". New configuration parameters will only be added to "events_config".

The following new event configuration was introduced with this change:

REFUELING:
          "refueling": {
            "auto_video_upload_enabled": false,
            "enabled": true
          }

The following new event configuration parameters were also introduced for existing event types with this change:

"max_events_per_day": This parameter controls per-event daily throttling limits. With Raven FW 2.13.2, only accelerometer-based events will have this config set to max of 50 events per day by default.

"auto_video_upload_enabled" This parameter toggles auto-uploading of short video recordings when an event occurs. If enabled, Raven will automatically upload short video recordings associated with this event to the cloud for later review. By default, only hard braking and possible impact events have video auto-uploads enabled. WARNING: Enabling this setting may result in increased data usage and potential overage charges on your Raven data plan, especially if the event occurs frequently or if multiple events are triggered in a short period of time.

RC-API docs were updated to reflect these changes. Please find them here: https://docs.klashwerks.com/developers/846b420d-2d51-4966-873a-00a58769e6b0/rc-api/#

Example response from GET /ravens/{ravenId}/settings (sections ommitted for brevity):

{
  "display": {...},
  "system": {...},
  "camera": {...},
  "audio": {...},
  "events": {
    "aggressive_accel_event_enabled": true,
    "aggressive_accel_threshold": 320,
    ...
  },
  "events_config": {
    "aggressive_accel": { # You can also use the event type name as defined in EventType enum, ex: AGGRESSIVE_ACCELERATION
      "enabled": true, # Same as "events.aggressive_accel_event_enabled"
      "auto_video_upload_enabled": false,
      "max_events_per_day": 50,
      "accel_threshold": 320 # Same as "events.aggressive_accel_threshold"
    },
    "bad_install": {
      "enabled": true,
      "auto_video_upload_enabled": false,
      "audio_alert_enabled": false,
      "visual_alert_frequency_mins": -1
    },
    ...
  },
  "obd": {...},
  "eld": {...},
  "wifi_hotspot": {...},
  "driver_id": {...}
}