User guide for version 7.10
Previous versions: 7.9 | 7.8 | 7.7
×
 

Configuring the fuel sensor

Fuel sensors in the system have multiple settings. This guide explains how to configure a sensor properly to receive accurate data and correctly track refueling and draining events.

General sensor settings

  • Function— the type of sensor in the system
  • Type — the sensor’s operating principle, e.g., “Discrete”
  • Name — internal sensor name displayed in the interface
  • Field — the hardware input on the tracker the sensor is connected to
  • Description — additional information about the sensor
  • Units — usually liters (“L”)
  • Conversion formula — if data adjustment is needed
  • Tags — labels for easier search and filtering of sensors

Refuel and drain detection

The system can automatically detect refueling and draining events based on the fuel level graph.
  • Active toggle — enables or disables refuel/drain detection for this sensor.
For fuel sensors: all active sensors for an object are summed to calculate total fuel in the vehicle, and events are detected based on this sum.
If disabled, the sensor works as a standard sensor without event detection.

Reverse flowdrain

The Reverse Flowdrain feature helps detect hidden fuel theft through the return line—the fuel line that carries unused fuel back to the tank.
When enabled, the system analyzes abnormal fuel consumption while the vehicle is moving, estimates the amount of fuel drained, and marks the event location on the map.

Event thresholds

  • Refueling threshold — minimum volume (liters) for an event to be considered a refuel. Smaller changes are ignored to filter out minor fluctuations.
  • Drain threshold — minimum volume for an event to be considered a drain.

Speed filter

This filter prevents normal fuel usage during movement from being detected as refuel or drain.
  • Max speed for event detection — speed (km/h) below which the vehicle is considered stationary
  • Speed mode — method for checking speed within the event
Speed mode options:
  • All points — all points in the event must be below the speed threshold (strictest mode)
  • Start — only the first point is checked
  • Any point — at least one point is below the threshold
  • Avg — average speed of the event must be below the threshold
  • Off — disables speed verification. In this mode, refuelings and drainings are recorded regardless of speed
  • Ratio — checks the proportion of points below the threshold (recommended)
Additional parameters for Ratio mode:
  • Min speed ratio — minimum fraction of event points below the threshold (0–1, default 0.5). For example, 0.5 = 50% of points must be stationary.
  • Min stop duration (sec) — minimum total stop time within the event. Helps ignore brief accidental stops.
This mode ensures correct detection even if the start or end of a refuel overlaps a short movement period.

Fuel change rate filter (L/h)

This filter removes slow “drains” that are actually normal fuel consumption during operation.
  • Min refuel speed (L/h) — minimum fuel level increase rate for an event to be considered a refuel
  • Min drain speed (L/h) — minimum fuel level decrease rate for an event to be considered a drain
If the rate is below the threshold, the event is treated as normal consumption, not refuel or drain.

Sensor noise sensitivity

  • Smoothing factor — degree of smoothing applied to the fuel graph before analysis. Higher values produce a smoother graph, reducing sharp jumps caused by sensor errors.
The system takes several points before and after each measurement, removes extremes, and calculates an average. For example, n = 3 uses three points on either side for smoothing.

Removing symmetric events

This feature helps exclude false events where refueling and draining occur with nearly identical volumes (e.g., due to slope or technical glitches):
  • Remove symmetric refuels/drains toggle — enables detection of “drain → refuel” or “refuel → drain” pairs with very similar volumes
  • Max difference (%) — allowed relative difference between paired volumes
  • Abs difference (L) — allowed absolute difference in liters
  • Max distance (h) — maximum time interval for events to be considered a pair, e.g., 12 hours
    Watch a short YouTube video showing how to set up the fuel refill and drain detection.