Увійти Ruhavik

Документація

Device message parameters

The table below explains the data your tracking device may transmit. Not every device sends every parameter — the actual set depends on the device model, its configuration, and the connected hardware.

System Parameters

Parameter Meaning Units
ident Device identifier (IMEI, serial number, etc.)
timestamp Time when telemetry was collected by the device (UNIX UTC) seconds
server.timestamp Time when message was received by flespi channel (UNIX UTC) seconds
channel.id ID of the flespi channel that received the message
protocol.id ID of the protocol used by the channel
peer Device IP:port that opened connection to the channel
device.id ID of the registered flespi device (if matched)
device.name Name of the registered flespi device (if matched)
device.type.id ID of the device type for the matched device

Position & Navigation

Parameter Meaning Units
position.latitude Latitude coordinate (WGS-84) degrees
position.longitude Longitude coordinate (WGS-84) degrees
position.altitude Altitude above sea level meters
position.speed Instant speed at position fix km/h
position.direction Heading angle (0 = North, clockwise) degrees
position.satellites Number of satellites used for fix
position.valid Whether position data is accurate and usable boolean
position.hdop Horizontal dilution of precision (lower = better)
position.pdop Position dilution of precision
position.fix.age Time since the last position fix seconds
position.timestamp Timestamp when coordinates were calculated seconds
position.source Source of coordinates if not GNSS (e.g. lbs, wifi, ble)
gnss.status GNSS receiver on/off status boolean

Movement & Driving

Parameter Meaning Units
movement.status Current movement state boolean
movement.event Movement detected event boolean
engine.ignition.status Engine ignition / ACC status boolean
idle.status Vehicle is in idling state boolean
idle.status.duration Duration of current idling state seconds
overspeeding.event Overspeeding detected boolean
overspeeding.status Currently overspeeding boolean
overspeeding.duration Duration of overspeeding interval seconds
sleep.mode.status Device is in sleep mode boolean

Mileage & Odometer

Parameter Meaning Units
vehicle.mileage Total calculated mileage km
can.vehicle.mileage Total vehicle mileage read from CAN km
total.mileage Total mileage (device-calculated) km
trip.mileage Distance driven since engine start km
segment.vehicle.mileage Mileage on the last segment between messages km
gnss.vehicle.mileage Mileage calculated by GNSS km

Engine & CAN Bus

Parameter Meaning Units
engine.rpm Engine RPM rpm
can.engine.rpm Engine RPM read from CAN rpm
engine.motorhours Total engine motor hours hours
engine.temperature Engine temperature °C
can.engine.coolant.temperature Engine coolant temperature from CAN °C
can.engine.oil.temperature Engine oil temperature from CAN °C
can.vehicle.speed Vehicle speed read from CAN km/h

Fuel

Parameter Meaning Units
fuel.level Fuel level percentage %
can.fuel.level Fuel level from CAN %
fuel.consumed Total fuel consumed by vehicle liters
can.fuel.consumed Total fuel consumed from CAN liters
can.fuel.consumption Engine fuel rate from CAN liters/h
can.fuel.consumption.distance Fuel consumption per distance from CAN liters/100km
can.fuel.economy Instantaneous fuel economy from CAN km/liters
trip.fuel.consumed Fuel consumed in the last trip liters
average.fuel.consumption Average fuel consumption liters/100km

Power & Battery

Parameter Meaning Units
external.powersource.voltage External power supply voltage volts
battery.voltage Internal battery voltage volts
battery.level Internal battery level %
battery.charging.status Battery is charging boolean
battery.low.status Battery is low boolean
battery.low.alarm Battery low alarm event boolean
backup.battery.voltage Backup battery voltage volts
can.vehicle.battery.level EV/HEV battery level from CAN %
can.vehicle.battery.voltage Vehicle battery voltage from CAN volts
power.cut.alarm External power cut-off alarm boolean

GSM / Cellular Network

Parameter Meaning Units
gsm.signal.level Signal strength level %
gsm.signal.dbm Signal strength in dBm dBm
gsm.cellid Base station cell ID
gsm.lac Location area code
gsm.mcc Mobile country code
gsm.mnc Mobile network code
gsm.operator.code Operator code (MCC+MNC)
gsm.network.type Network type (2G, 3G, 4G, LTE, etc.)
gsm.network.roaming.status Device is in roaming boolean
gsm.jamming.event GSM signal jamming detected boolean
gsm.sim.iccid SIM card ICCID

Digital & Analog I/O

Parameter Meaning Units
din Digital inputs bitmask
din.1 .. din.N Individual digital input status (boolean) boolean
dout Digital outputs bitmask
dout.1 .. dout.N Individual digital output status (boolean) boolean
ain Analog input voltage (indexed) volts
ain.1 .. ain.N Individual analog input voltage volts

Sensors & Environment

Parameter Meaning Units
device.temperature Device internal temperature °C
sensor.temperature External temperature sensor value (indexed) °C
ibutton.code Hexadecimal code of connected iButton
driver.id Driver identification card ID

Accelerometer

Parameter Meaning Units
x.acceleration Accelerometer X-axis value g
y.acceleration Accelerometer Y-axis value g
z.acceleration Accelerometer Z-axis value g
absolute.acceleration Module of accelerometer vector g

Harsh Driving Events

Parameter Meaning Units
harsh.acceleration.event Harsh acceleration detected boolean
harsh.braking.event Harsh braking detected boolean
harsh.cornering.event Harsh cornering detected boolean
crash.event Crash event detected boolean

Alarms & Events

Parameter Meaning Units
alarm.event Generic alarm triggered boolean
sos.alarm SOS alarm triggered boolean
towing.event Towing detected boolean
tamper.alarm Tamper alarm event boolean
unplug.alarm Device unplugged alarm boolean
vibration.alarm Vibration alarm event boolean
geofence.alarm Geofence alarm event boolean
door.alarm Door alarm event boolean
temperature.alarm Temperature out of range boolean
fuel.loss.alarm.event Fuel loss alarm boolean

Doors & Body (CAN)

Parameter Meaning Units
door.open.status Door open status boolean
can.doors.status Any CAN door is opened boolean
can.front.left.door.status CAN front left door opened boolean
can.front.right.door.status CAN front right door opened boolean
can.rear.left.door.status CAN rear left door opened boolean
can.rear.right.door.status CAN rear right door opened boolean
can.trunk.status CAN trunk is opened boolean
can.hood.status CAN hood is opened boolean

ADAS & DSM (Driver Monitoring)

Parameter Meaning Units
adas.collision.warning.event Forward collision warning (ADAS) boolean
adas.pedestrian.event Pedestrian detected (ADAS) boolean
dsm.distraction.event Driver distraction detected (DSM) boolean
dsm.driver.phone.event Driver using phone (DSM) boolean
dsm.seatbelt.event Driver seatbelt not fastened (DSM) boolean
dsm.smoking.event Driver smoking (DSM) boolean
dsm.yawning.event Driver yawning (DSM) boolean
dsm.fatigue.event Driver fatigue detected (DSM) boolean

BLE Beacons

Parameter Meaning Units
ble.beacons Array of detected BLE beacons (id, rssi, temperature, humidity, battery, etc.) array

Diagnostic Trouble Codes

Parameter Meaning Units
can.dtc Array of DTC codes from CAN (spn, fmi, sa, status, etc.) array
can.dtc.number Number of active DTCs
obd.connected.status OBD-II device is connected to vehicle boolean

Message Metadata

Parameter Meaning Units
message.buffered.status Message was stored in device buffer (black box) before sending boolean
report.code Protocol-specific report/event code
event.enum Protocol-specific event type code

Trip Statistics

Parameter Meaning Units
trip.average.speed Average speed of the trip km/h
trip.max.speed Maximum speed of the trip km/h
trip.harsh.acceleration.number Harsh acceleration count in trip
trip.harsh.braking.number Harsh braking count in trip
trip.harsh.cornering.number Harsh cornering count in trip
trip.overspeed.events Overspeed events count in trip

Notes:

  • Indexed parameters like din.1, ain.2, sensor.temperature.3 use a numeric suffix to distinguish multiple inputs/sensors of the same type.
  • CAN parameters (can.*) require the vehicle's CAN bus to be connected and the tracker to support CAN reading.
  • ADAS/DSM parameters require devices with camera-based driver monitoring systems.
  • BLE beacons (ble.beacons) is a JSON array — each element contains fields like id, rssi, temperature, humidity, battery.voltage, etc.
  • DTC codes (can.dtc) is a JSON array — each element may contain spn, fmi, sa, status, standard, etc.

Note: Not every device sends every parameter — the actual set depends on your device's model, protocol, and configuration. For the complete, protocol-specific parameter reference with descriptions, data types, and units, see flespi.com/protocols → select your protocol → open the Parameters tab.