> For the complete documentation index, see [llms.txt](https://docs.bluefletch.com/bluefletch-enterprise/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/support-application/sa-6/features/device-drop-detection.md).

# Device Drop Detection

A Support Application 6 feature that detects and reports physical device drops.

## Overview

Use Device Drop Detection to monitor the accelerometer for a free-fall signature followed by an impact spike, and report detected drops as a devicedrop event. This gives fleet operators visibility into physical device damage risk and history without relying on self-reporting.

Device Drop Detection is enabled by default. Free-fall is detected when acceleration drops below 2.0 m/s², impact is detected when acceleration spikes above 25.0 m/s², and a 5000 ms cooldown applies between reported drop events.

## User Guide

To configure Device Drop Detection, complete the following steps:

1. Set `dropFreeFallThresholdMs2` to the acceleration value below which motion is treated as free-fall.
2. Set `dropImpactThresholdMs2` to the acceleration spike value that, following a qualifying free-fall, is treated as an impact.
3. Set `dropMinFreeFallDurationMs` to filter out brief sensor noise by requiring a minimum free-fall duration.
4. Set `dropCooldownMs` to the minimum time between two reported drop events.

## Configuration

### Configuring Free-Fall Sensitivity

Set `dropFreeFallThresholdMs2` to the acceleration value below which motion is treated as free-fall. The default is 2.0:

```json
"bfSupportAgent": {
 "dropFreeFallThresholdMs2": 2.0
}
```

### Configuring Impact Sensitivity

Set `dropImpactThresholdMs2` to the acceleration spike value that, following a qualifying free-fall, is treated as an impact. The default is 25.0:

```json
"bfSupportAgent": {
 "dropImpactThresholdMs2": 25.0
}
```

### Configuring Minimum Free-Fall Duration

Set `dropMinFreeFallDurationMs` to the minimum free-fall duration, in milliseconds, before an impact counts as a drop. This filters out brief sensor noise. The default is 80:

```json
"bfSupportAgent": {
 "dropMinFreeFallDurationMs": 80
}
```

### Configuring Drop Cooldown

Set `dropCooldownMs` to the minimum time, in milliseconds, between two reported drop events. The default is 5000:

```json
"bfSupportAgent": {
 "dropCooldownMs": 5000
}
```

This table provides the settings for the Device Drop Detection feature.

| Configuration               | Type    | Default | Description                                                                                    |
| --------------------------- | ------- | ------- | ---------------------------------------------------------------------------------------------- |
| `dropFreeFallThresholdMs2`  | Float   | 2.0     | Acceleration below this value is treated as free-fall                                          |
| `dropImpactThresholdMs2`    | Float   | 25.0    | Acceleration spike above this value, following a qualifying free-fall, is treated as an impact |
| `dropMinFreeFallDurationMs` | Integer | 80      | Minimum free-fall duration before an impact counts as a drop (filters out brief sensor noise)  |
| `dropCooldownMs`            | Integer | 5000    | Minimum time between two reported drop events                                                  |

## Putting It All Together

For the example described above, the full configuration for the Device Drop Detection feature is as follows:

```json
"bfSupportAgent": {
 "dropFreeFallThresholdMs2": 2.0,
 "dropImpactThresholdMs2": 25.0,
 "dropMinFreeFallDurationMs": 80,
 "dropCooldownMs": 5000
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.bluefletch.com/bluefletch-enterprise/product-guides/support-application/sa-6/features/device-drop-detection.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
