Teltonika protocol

Integration level: params + settings
Protocol used by GPS tracking devices manufactured by Teltonika headquartered in Lithuania.
flespi parses the Teltonika protocol messages into a JSON object with the fields listed below in the Parameters tab.
absolute.acceleration
number
g
Module of accelerometer vector
acceleration.array
array
g
Array of objects with acceleration data by x, y, and z axis
actual.remaining.mileage
number
km
Actual remaining mileage
agro.vehicle.state.bitmask
number
Agricultural machinery flags
ain
number
volts
Voltage on the analog input
alarm.event
boolean
Alarm event triggered
available.status
boolean
Vehicle available status: true - available, false - not available
average.x.acceleration
number
g
Harsh acceleration event average accelerometer value on X-axis
average.y.acceleration
number
g
Harsh acceleration event average accelerometer value on Y-axis
average.z.acceleration
number
g
Harsh acceleration event average accelerometer value on Z-axis
barcode.id
string
Barcode ID
battery.capacity.full
number
Ah
Full battery capacity
battery.capacity.remaining
number
Ah
Remaining battery capacity
battery.charging.status
boolean
Battery charging status
battery.current
number
amperes
Battery current
battery.health
number
percentage
Battery health level (SoH)
battery.level
number
percentage
Internal battery level
battery.overvoltage.status
boolean
Battery overvoltage status: true - battery overvoltage, false - no battery overvoltage
battery.regeneration.status
boolean
Battery regeneration status: true - disabled, false - enabled
battery.short.circuit
boolean
Battery short circuit (overcurrent) warning status: true - battery short circuit, false - no battery short circuit
battery.status
boolean
Battery on/off status: true - battery is on, false - battery is off
battery.temperature
number
celsius
Battery temperature
battery.temperature.status
boolean
Battery temperature status: true - temperature is over or under the normal, false - temperature is normal
battery.undervoltage.status
boolean
Battery undervoltage status: true - battery undervoltage, false - no battery undervoltage
battery.voltage
number
volts
Internal battery voltage
ble.beacons
array
Object with all detected BLE beacons. Each object key is a string uniquely identifying each BLE beacon. The value of this key is an object containing data received from the BLE beacon, like RSSI, temperature, battery level, etc.
ble.mac.address
string
BLE (Bluetooth Low Energy) MAC address
ble.sensor.battery.level
number
percentage
BLE (Bluetooth Low Energy) sensor battery level
ble.sensor.battery.voltage
number
volts
BLE (Bluetooth Low Energy) sensor battery voltage
ble.sensor.humidity
number
percentage
BLE (Bluetooth Low Energy) sensor Humidity value
ble.sensor.illuminance
number
lux
BLE (Bluetooth Low Energy) sensor illuminance
ble.sensor.payload.hex
string
HEX Payload received from BLE sensor
ble.sensor.temperature
number
celsius
BLE (Bluetooth Low Energy) sensor Temperature value
buzzer.alarm.status
boolean
Buzzer alarm status
can.absolute.fuel.rail.pressure
number
kPa
Absolute Fuel Rail Pressure
can.absolute.load
number
percentage
Absolute load value
can.adblue.level
number
percentage
Adblue level read from CAN
can.adblue.volume
number
liters
Adblue volume read from CAN
can.ambient.air.temperature
number
celsius
CAN ambient air temperature
can.axle.weight
number
kg
Weight on the axle read from CAN
can.barometric.pressure
number
kPa
Absolute barometric pressure read fron CAN
can.commanded.egr
number
percentage
Commanded EGR value read from CAN
can.control.module.voltage
number
volts
Control module voltage read from CAN
can.cruise.status
boolean
CAN cruise control is active
can.direct.fuel.rail.pressure
number
kPa
Fuel rail gauge pressure for diesel or gasoline direct injection
can.distance.since.codes.cleared
number
km
Distance traveled since codes cleared
can.dtc
string
Diagnostic trouble code read from CAN
can.dtc.number
number
Number of diagnostic trouble codes
can.egr.error
number
percentage
EGR Error read from CAN
can.engine.coolant.temperature
number
celsius
Engine coolant temperature read from CAN
can.engine.load.level
number
percentage
Calculated engine load level read from CAN
can.engine.motorhours
number
hours
Total engine motorhours read from CAN
can.engine.oil.temperature
number
celsius
Engine oil temperature
can.engine.rpm
number
rpm
Engine RPM read from CAN
can.engine.run.time
number
seconds
Run time since engine start read from CAN
can.engine.temperature
number
celsius
Engine temperature read from CAN
can.fuel.consumed
number
liters
Fuel volume totally consumed by vehicle read from CAN
can.fuel.consumption
number
liters/h
Engine fuel rate read from CAN
can.fuel.economy
number
km/liters
CAN instantaneous fuel economy
can.fuel.injection.timing
number
degrees
Fuel injection timing
can.fuel.level
number
percentage
Fuel level in tank read from CAN
can.fuel.pressure
number
kPa
Fuel pressure
can.fuel.volume
number
liters
CAN fuel volume
can.hybrid.battery.pack.life
number
percentage
Hybrid battery pack remaining life
can.intake.air.temperature
number
celsius
Intake air temperature
can.intake.map
number
kPa
Intake manifold absolute pressure
can.lvc.module.control.bitmask
number
LVC control state flags
can.maf.air.flow.rate
number
g/sec
MAF air flow rate read from CAN
can.mil.mileage
number
km
Distance traveled while malfunction indicator lamp is activated, read from CAN
can.mil.status
boolean
Malfunction indicator lamp status read from CAN
can.mil.time
number
hours
Time run with malfunction indicator lamp activated, read from CAN
can.module.id
number
CAN module ID
can.pedal.brake.status
boolean
CAN brake pedal pressed
can.pedal.clutch.status
boolean
CAN clutch pedal pressed
can.powersource.takeoff.enum
number
CAN power takeoff bitmask
can.program.id
number
CAN program number
can.relative.fuel.rail.pressure
number
kPa
Fuel rail pressure relative to manifold vacuum
can.service.distance
number
km
Service distance read from CAN
can.short.fuel.trim
number
percentage
Short term fuel trim read from CAN
can.throttle.pedal.level
number
percentage
Throttle pedal push level read from CAN
can.time.since.codes.cleared
number
minutes
Time since trouble codes cleared
can.timing.advance
number
degrees
Ignition timing advance read from CAN
can.vehicle.mileage
number
km
Total vehicle mileage read from CAN
can.vehicle.speed
number
km/h
Vehicle speed read from CAN
can.wheel.speed
number
km/h
Vehicle wheel based speed, read from CAN
central.standup.status
boolean
Central stuandup up status: true - up, false - down
channel.id
number
ID of channel that received a message
charger.bms.timeout.status
boolean
Charfer BMS COM timeout: true - not expired, false - expired
charger.control.mode
number
Charger control mode currently in use
charger.crc.violation.status
boolean
Charger CRC violation: true - violation happened, false - no violation
charger.current
number
amperes
Charger actual current
charger.energy
number
Wh
Charger actual energy
charger.fault.status
boolean
Charger internal fault status: true - no internal fault happened, false - internal fault happened
charger.mc.violation.status
boolean
Charger MC violation: true - violation happened, false - no violation
charger.mode
boolean
Selected charge mode, read from CAN: 0 - default, 1 - fast
charger.mode.state
number
Charger mode state
charger.plug.status
boolean
Charger plug status: true - not plugged, false - plugged
charger.setpoint.current
number
amperes
Charger current setpoint
charger.setpoint.voltage
number
volts
Charger svoltage setpoint
charger.state
number
Charger state
charger.voltage
number
volts
Charger actual voltage
charge.time.remining
number
minutes
Remaining charge time
control.module.voltage
number
volts
Supply voltage of the central control (system driving voltage)
counter.impulses
number
Impulses counter
crash.accelerometer.status
boolean
Crash accelerometer is calibrated
crash.event
boolean
Crash event detected
crash.event.enum
number
Crash report reason code
crash.events.number
number
Crash event counter
crash.fake.event
boolean
Fake crash detected (crash by X or Y but without essiantial speed change)
crash.pothole.event
boolean
Crash pothole detected
crash.trace.changes.event
boolean
Crash trace changes data after crash event
crash.trace.full.event
boolean
Crash trace is full after crash event
custom.user.id
number
Custom number sent as AVL ID 854, can be set via User ID setting
deadman.alarm.status
boolean
Man down is active and no movement for configured timeout
device.configuration.id
number
Configuration profile index
device.id
number
ID of device that received a message
device.name
string
Name of device that received a message
device.serial.number
string
Device serial number
device.temperature
number
celsius
Temperature of device
device.type.id
number
ID of device type of device that received a message
din
number
Digital inputs bitmask
door.open.status
boolean
Door open status
dout
number
Digital outputs bitmask
dout.overcurrent.status
boolean
Overcurrent status for digital output
driving.state
number
Vehicle current driving direction state
eco.driving.event.duration
number
seconds
Duration of event that did generate Green driving
eco.driving.events.number
number
Average amount of events on some distance
engine.ignition.status
boolean
Engine ignition status
engine.motorhours
number
hours
Total calculated engine motorhours
engine.rpm
number
rpm
Engine RPM read from CAN
error.type
number
Error type identification number
escort.liquid.sensor.battery.voltage
number
volts
Escort LLS Battery Voltage
escort.liquid.sensor.fuel.level
number
Escort LLS fuel level
escort.liquid.sensor.temperature
number
celsius
Escort LLS Temperature
event.code
string
Unique event identifier string
event.enum
number
Event code, full list of codes available at separate table
event.priority.enum
number
Event priority enum
external.battery.capacity
number
percentage
Current residual capacity percentage of external battery
external.battery.level
number
percentage
External battery level
external.battery.status
boolean
External battery status
external.battery.temperature
number
celsius
External battery temperature
external.battery.voltage
number
volts
External battery voltage
external.powersource.status
boolean
External power source connection status
external.powersource.voltage
number
volts
External power voltage
external.sensor.temperature
number
degrees
External sensor temperature
extnav.position.speed
number
km/h
External receiver instant speed at position detection moment
fuel.consumed
number
liters
Fuel volume totally consumed by vehicle
fuel.level
number
percentage
Fuel level percentage
geofence.id
number
Geofence ID
geofence.overspeeding.status
boolean
Geofence overspeeding status
geofence.status
boolean
Geofence entered status
gnss.antenna.short.circuit.status
boolean
GNSS antenna short circuit status
gnss.antenna.status
boolean
GNSS receiver antenna status
gnss.jamming.state
number
GNSS jamming state
gnss.sleep.mode.status
boolean
GNSS receiver is in sleep mode
gnss.state.enum
number
GNSS state code. May contain information about GNSS fix status, sleep status, ON/OFF, Overcurrent/protect state. Full list of codes available at separate table
gnss.status
boolean
GNSS receiver on/off status
gps.fuel.rate
number
liters/h
GPS-based fuel rate
gps.fuel.used
number
liters
GPS-based fuel used
grain.moisture.level
number
percentage
Grain moisture
grain.mowing.efficiency.meters2_h
number
m^2/h
Mowing efficiency
grain.mowing.volume.kg
number
kg
Mown volume
gsm.cellid
number
GSM base station ID
gsm.jamming.alarm.status
boolean
Alarm status for GSM jamming
gsm.lac
number
GSM location area code
gsm.mnc
string
GSM mobile network code
gsm.network.roaming.status
boolean
GSM network in roaming mode
gsm.signal.level
number
percentage
GSM signal strength level
gsm.sim.iccid
string
Integrated Circuit Card Id of SIM card
gsm.sim.imsi
string
IMSI of SIM card
gsm.sim.status
boolean
SIM card is active
harsh.acceleration.duration
number
seconds
Harsh acceleration event duration
harsh.acceleration.event
boolean
Harsh acceleration detected
harsh.braking.event
boolean
Harsh braking detected
harsh.cornering.angle
number
degrees
Harsh cornering angle
harsh.cornering.event
boolean
Harsh cornering detected
harvest.area
number
m^2
Area of harvest
harvest.drum.gap
number
mm
Gap under harvesting drum
harvest.drum.rpm
number
rpm
Harvesting drum RPM
harvest.duration
number
seconds
Harvesting time
helmet.status
boolean
Helmet status: true - helmet is in, false - helmet is not in
ibutton.authorized.status
boolean
iButton authorized status
ibutton.code
string
Hexadecimal code of connected iButton
ibutton.connected.status
boolean
iButton connection status
ident
string
Device unique identificator and optional password
idle.status
boolean
Vehicle is in idling state
ignition.state
number
Ignition state according to device manual
internal.battery.capacity
number
percentage
Current residual capacity percentage of internal battery
internal.battery.voltage
number
volts
Internal battery voltage
kickstand.status
boolean
Kickstand status: true - not released, false - released
kill.switch.status
boolean
Kill switch status: true - not active, false - active
liquid.sensor.fuel.temperature
number
celsius
Fuel temperature reported by LLS
liquid.sensor.fuel.volume
number
liters
Fuel volume reported by LLS
lock.status
boolean
Lock status
lvc.security.state.bitmask
number
LVC security state flags
malfunction.indicator.status
boolean
Malfunction indicator status: true - active, false - not active
mandown.alarm.status
boolean
Man down alarm activated
max.x.acceleration
number
g
Harsh acceleration event max accelerometer value on X-axis
max.y.acceleration
number
g
Harsh acceleration event max accelerometer value on Y-axis
max.z.acceleration
number
g
Harsh acceleration event max accelerometer value on Z-axis
movement.status
boolean
Current movement state
onewire.sensor.serial
string
External 1-Wire sensor serial number in HEX representation
operating.mode.enum
number
Operating mode
overspeeding.status
boolean
Overspeeding detected
park.brake.status
boolean
Park brake status: true - active, false - not active
payload.hex
string
HEX Payload received from device
payload.text
string
Text Payload received from device
pcb.temperature
number
celsius
PCB temperature
peer
string
IP:port from which device connecting to the channel
position.altitude
number
meters
Altitude value for position
position.direction
number
degrees
Heading angle at position detection moment
position.hdop
number
Horizontal dilution of precision
position.latitude
number
degrees
Latitude coordinate value
position.longitude
number
degrees
Longitude coordinate value
position.pdop
number
Position dilution of precision
position.satellites
number
Quantity of satellites used to calculate coordinates for given position information
position.speed
number
km/h
Instant speed at position detection moment
position.valid
boolean
Is position information accurate and valid for given timestamp
power.consumtion
number
Wh/km
Vehicle power consumtion
powertrain.state
number
Powertrain state
predicted.remaining.mileage
number
km
Predicted remaining mileage
private.status
boolean
Device is in private mode
protocol.id
number
ID of protocol
proximity.duration
number
seconds
Proximity violation duration
proximity.violation.mac.address
string
MAC address which violates personal space
proximity.violation.state
number
Bitmask describing the causes of proximity violation
remaining.range
number
km
Current remaining range
rfid.code
string
Hexadecimal code of connected RFID
segment.can.fuel.consumed
number
liters
Fuel volume consumed by vehicle on the last segment using CAN data
segment.can.vehicle.mileage
number
km
Vehicle mileage on the last segment using CAN data
segment.vehicle.mileage
number
km
Segment mileage
sensor.temperature
number
celsius
Temperature sensor value
server.timestamp
number
seconds
Timestamp when server received a message
sleep.mode.status
boolean
Device is in sleep mode
software.version.enum
number
Software version enum
tacho.driver.card.code
string
Driver identification card id for tacho
tacho.driver.card.status
boolean
Tacho driver card presence
tacho.driver.continuous_driving.duration
number
seconds
Driver continuous driving time
tacho.driver.cumulative_break.duration
number
seconds
Driver cumulative break time
tacho.driver.cumulative_driving.duration
number
seconds
Driver cumulative driving time
tacho.driver.current.activity.duration
number
seconds
Current driver activity duration
tacho.driver.work.state.enum
string
Driver work state
tacho.position.speed
number
km/h
Instant speed reported by tacho
tacho.timestamp
number
seconds
Time reported by tacho
tacho.vehicle.mileage
number
km
Total mileage calculated by tacho
timestamp
number
seconds
Message timestamp
top.case.status
boolean
Top case opened status: true - opened, false - closed
total.driving.time
number
seconds
Total riding time
total.operate.time
number
seconds
Total operation time
total.vehicle.weight
number
kg
Total vehicle weight
towing.alarm.status
boolean
Towing alarm state
trip.average.speed
number
km/h
Average speed of the trip
trip.driving.time
number
seconds
Single riding time
trip.mileage
number
km
Distance driven since engine start
trip.operate.time
number
seconds
Single operation time
trip.status
boolean
Trip status, true if trip started, false - if stopped
vehicle.mileage
number
km
Total calculated mileage
vehicle.vin
string
VIN of vehicle
x.acceleration
number
g
Accelerometer value X
y.acceleration
number
g
Accelerometer value Y
z.acceleration
number
g
Accelerometer value Z
Properties
Codec 12 command
codec12
Send command encoded in Codec 12
hex: Payload is encoded as HEX string
crlf: Add CR and LF bytes after text payload
payload: Text or hex data to send
Set output 3 to ON for 5 seconds, and set outputs 1,2,4 to OFF
{"payload":"setdigout 0010 0 0 5 0"}
Get configuration param
getparam
Get configuration parameter by it's number
param: Param number
Set configuration param
setparam
Set configuration parameter by it's number
param: Param number
value: Param value

Step-by-step guide on how-to obtain telematics data from Teltonika devices via API in 5 easy steps.

Here are some issues with Teltonika trackers that flespi can fix:

  • Confusing parameters ID mapping. Parameter IDs for different models and firmware versions point to different settings — flespi uses unified protocol description technology to automatically resolve IDs into meaningful names.
  • Tricky firmware updates. Older configurators might not be able to update to the latest firmware release — flespi universal online configuration tool works for multiple manufacturers and adapts to the device type and firmware capabilities.
  • Difficulties sending commands via SMS. Changing tracker parameters via text messages requires compliance with command syntax — flespi configurator helps generate SMS content as per the protocol specification.