FleetCommando · Manual
Fuel & trips

Fuel calibration, reading the chart, and making sense of trips

Calibrate the fuel sensor in the FleetCommando UI, learn to read the fuel chart, walk through a real fill-up step-by-step, and understand the difference between trips, replays, and the trips list on a driver's profile.

1. What the fuel calibration is for

GPS trackers report fuel as raw sensor counts, not litres. The calibration tells FleetCommando: "raw value X means Y litres." Without it, the dashboard cannot tell you "65 L remaining" or "burned 18 L on this trip" — every fuel chart and trip burn number would be guesses.

Calibration is per-vehicle (each truck's sensor has its own quirks) and two numbers:

You almost never type these numbers by hand. The UI guides you through a two-step wizard at the filling station and stamps both values for you.

2. The fuel calibration card — UI tour

Open Vehicles → pick a truck → Fuel tab. The card called Fuel sensor calibration is the cockpit. From the top:

Tip — every action is reversible. Every anchor + every refuel-fit leaves a one-click Revert button on its result banner. If you typed "I added 200 L" but actually added 250 L, click revert, redo with the right number. Nothing is permanent until you walk away from the page.

3. Real-case scenario — calibrating at the filling station

This is the walk-through to do once per truck, ideally on the day you install the tracker. After it's done the sensor will read true litres for the life of the install (re-calibrate only if the LLS probe is replaced or the tank is re-sized).

What you need

Step 1 — run the tank dry (or close to it)

  1. Drive the truck until the tank is as empty as you safely can. Most operators do this on the morning of the calibration — last delivery of the previous day ends near a pump, truck is parked overnight roughly empty.
  2. Park at the pump with the engine off and the ignition off. Wait ~60 seconds so the fuel-level sensor's reading settles (LLS probes oscillate while fuel sloshes).

Step 2 — anchor the sensor at empty (UI)

  1. Open the truck on your dashboard: Vehicles → tap the truck → Fuel tab.
  2. On the Fuel sensor calibration card, click Calibrate as empty.
  3. A confirm dialog appears asking you to confirm the tank is physically empty. Confirm. The system records the current raw sensor reading as "this is 0 L".
  4. A green banner appears: "Step 1 of 2 — Empty anchored ✓". The next sensor fix will display ~0 L on the fuel chart.
Important — only use this when truly empty. If you click "Calibrate as empty" while there's 50 L in the tank, the dashboard will read 50 L too low from then on. Use the Revert button on the green banner if you clicked by mistake.

Step 3 — fill the tank and capture the litre count

  1. Fill the tank to the level you normally run (full is best; the wider the gap between empty and the fill, the more accurate the slope).
  2. Note the litres dispensed from the pump display or receipt. Whole litres is fine — "203" is good, "203.4" is fine too.
  3. Wait another ~60 seconds for the sensor reading to stabilise after fuelling.

Step 4 — fit the scale (UI)

  1. On the same Fuel tab, under the green "Step 1 ✓" banner, click I refueled this truck — fit the scale.
  2. A small inline form opens: "How many litres did you just add?"
  3. Type the number from the pump (e.g. 203) and click Apply.
  4. A new banner appears: "Step 2 of 2 — Fuel sensor calibrated ✓". The fuel chart starts showing real litres on the next telemetry tick. You're done.
Drive a kilometre and refresh the chart — the first post-calibration fix takes 30–60 seconds to arrive. If you don't see fresh numbers immediately, give it a minute and refresh the Fuel tab.

4. How to read the fuel chart

The fuel chart on Vehicles → truck → Fuel plots tank level over time. The Y-axis is litres (assuming calibration is done), the X-axis is wall-clock time. Things you can read off it:

The chart's tooltip on hover gives the exact litre reading + the timestamp. Click + drag a window on the chart to zoom in on a specific period (e.g. the hour around an alert).

5. Understanding fuel burnt

Every Trip on the Trips page and every trip row on a driver's profile shows a Fuel column — the litres consumed across that one trip. FleetCommando computes this on a three-tier cascade so a number is always available:

On the Trips page each row also shows a 📦 badge if the trip overlapped a captured port visit, and a coloured classification chip (Trip / Yard / Dwell / Noise) — see the next section for what those mean.

If a row reads "0.0 L burnt" on a moving trip, the calibration is almost certainly the cause. Run the filling-station walkthrough above on that vehicle — the next trip will report a real number.

6. Trips, replays, and trips under drivers

Trips page

Sidebar → Trips. Every closed journey across the fleet, newest first. Each row shows From → To, distance, fuel, status, classification, and a Replay button. The page filters to real trips by default; yard shuffles, dwells, and GPS-noise rows hide behind the Show all toggle so the operator's first read is signal, not noise.

Trip classifications

Replay

Every trip row carries a Replay button. Click it → FleetCommando opens Journey playback filtered to that trip's exact time window. From there you get:

Replay is the answer when the chairman asks "what did this driver actually do on that run?" — you can show the route, the stops, the speed envelope, and the fuel burn in one shared screen.

Trips on a driver's profile

Sidebar → Drivers → tap a driver → Trips tab. The same data scoped to that driver's last 50 closed trips. Same default filter (real trips only) + same Replay button per row. A toggle at the top tells you how many rows are hidden as yard / dwell / noise — flip it on for audit.

Same-label loops collapse: a round-trip starting and ending in "Toma" renders as Toma · round trip in italic instead of repeating "Toma → Toma", so the list reads cleanly when a driver did three loops inside the same area on one shift.

7. Common questions

Related: Vehicles & drivers (registering a truck and entering the tank capacity), Live Map (watching the truck in real time), Alerts (responding to fuel anomalies).