Telemetry Data Glossary

Comprehensive reference for dual-fuel vehicle telemetry data format and field definitions

Example Data Record

"Vehicle","imei","time","d","g","e","c","p","j","r","t","k","x","n","y","o","z","q","f","w","v"
"AB123CD","1234567890123456","2025-09-15 13:00:46.696",12,7394,0,86,1306,1571,1052,22,237500,1118,27938,409,12351,8612,244818,,2

* This example is taken from actual telemetry data in the system

Field Definitions

identification Fields

Vehicle
String
Vehicle identifier/registration number
Example:
AB123CD
imei
String
Unique device identifier for the telemetry unit
Example:
1234567890123456

temporal Fields

time
DateTime
Timestamp when the data was recorded (format: YYYY-MM-DD HH:mm:ss.fff)
Example:
2025-09-15 13:00:46.696

fuel flow Fields

d
Number
Diesel flow rate in litres per hour (L/h)
Example:
12
g
Number
Gas flow rate in arbitrary units (requires calibration conversion)
Example:
7394

status Fields

e
Number
Error/system state (0=gas mode active, 1=diesel only, 99=boot sequence)
Example:
0

engine Fields

c
Number
Engine coolant temperature in degrees Celsius (°C)
Example:
86
p
Number
System pressure reading
Example:
1306
r
Number
Engine RPM (revolutions per minute)
Example:
1052
t
Number
Engine torque as percentage of maximum (0-100%)
Example:
22

system Fields

j
Number
Additional system parameter
Example:
1571
f
Number/Null
Firmware sub version (e.g., 27 = v3.2.7) - only present on boot (e=99)
Example:
null
w
Number/Null
Calibration constant - only present on boot (e=99)
Example:
null
v
Number
Tank level (currently unused)
Example:
2

distance Fields

k
Number
Vehicle odometer reading in kilometres
Example:
237500

cumulative uptime Fields

x
Number
Runtime system uptime in seconds (resets on system restart)
Example:
1118

fuel Fields

n
Number
Instantaneous fuel rate from CAN (LFE2) - equivalent to d
Example:
27938

cumulative gas Fields

y
Number
Runtime cumulative gas usage (resets on system restart)
Example:
409

cumulative diesel Fields

o
Number
Total trip fuel from LFC - diesel in 100th of a litre
Example:
12351
z
Number
Persistent cumulative diesel usage (lifetime counter)
Example:
8612
q
Number
High resolution liquid fuel consumption (HRFLC) in 1000th of a litre
Example:
244818

Key Concepts

Data Collection

  • • Records are collected approximately every second
  • • Timestamps are in UTC format
  • • Missing data periods can be detected by time gaps >10 seconds
  • • Boot sequences show e=99 during system initialization

Fuel Calculations

  • • Diesel (d): Direct L/h measurement, divide by 3600 for litres consumed
  • • Diesel (n): Instantaneous fuel rate from CAN (LFE2) equivalent to 'd'
  • • Gas (g): Requires calibration constant (~1650) for conversion
  • • Cumulative values (o,q) are diesel: o÷100, q÷1000
  • • Gas substitution active when e=0, diesel only when e=1

System States

  • • e=0: Gas substitution system active
  • • e=1: Diesel only mode (gas system off/error)
  • • e=99: System boot/initialization sequence
  • • Temperature c<40°C indicates engine warmup period

Data Quality

  • • Compare flow-rate vs cumulative calculations for validation
  • • Runtime values (x,y) reset on system restart
  • • Cumulative values (o,z,q) are lifetime/trip counters
  • • Large discrepancies may indicate missing telemetry periods

Data Calculation Methods

  • • Uptime: x (runtime seconds, resets on restart)
  • • Diesel: d,n (instantaneous L/h), o (trip ÷100), q (HRFLC ÷1000)
  • • Gas: g (instantaneous), y (runtime cumulative)
  • • Boot diagnostics: f (firmware), w (calibration) when e=99