teltonika

The protocol for Teltonika GPS tracking devices. 

For the flespi channel to correctly detect the IO conversion schema, it is recommended to register devices on flespi with the correct device type. This is specifically important for proper processing of extended parameters like CAN bus, temperature, 1-wire sensors, etc. If the device with specified IMEI is not registered in the corresponding flespi account, such parameters will be presented as "custom.param.<AVL-ID>".

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 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.

To connect Teltonika to Wialon or other platforms via flespi please read this article.

Below is the list of parameters that can appear in the messages received by the channel via teltonika protocol. In most parameters, the name consists of tags split by dots: tag1.tag2.tag3.tag4... Each tag defines a certain area of an application, e.g. any parameter that contains mileage data has the 'mileage' tag in the name and any parameter related to fuel control contains the 'fuel' tag. By default JSON fields of the message received by a channel via this protocol can only contain the below-specified parameters. Any additional parameter will be prefixed by the "custom" tag, e.g. "custom.unspecified-name".

Name Type Unit Description
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
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.charging.status boolean Battery charging status
battery.current number amperes Battery current
battery.level number percentage Internal battery level
battery.status string Battery status
battery.temperature number celsius Battery temperature
battery.voltage number volts Internal battery voltage
ble.asset.battery.voltage number volts BLE (Bluetooth Low Energy) asset battery voltage
ble.asset.rssi number BLE (Bluetooth Low Energy) asset signal strength
ble.asset.tag.code string BLE (Bluetooth Low Energy) asset tag ID
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.direct.fuel.level.pressure number kPa Direct fuel rail pressure
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.rate number liters/h Engine fuel rate
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 absilute pressure
can.liquid.sensor.fuel.volume number liters Fuel volume in tank reported by LLS CAN
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.program.id number CAN program number
can.relative.fuel.level.pressure number kPa Relative fuel rail pressure
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.vehicle.vin string Vehicle VIN read from CAN
channel.id number ID of channel that received a message
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
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
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
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.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 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.status boolean Geofence entered status
gnss.antenna.status boolean GNSS receiver antenna status
gnss.sleep.mode.status boolean GNSS receiver is in sleep mode
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.event boolean GSM signal jamming detected
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
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
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
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.event boolean Movement detected
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.event boolean Overspeeding detected
overspeeding.status boolean Overspeeding detected
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
predicted.remaining.mileage number km Predicted remaining mileage
private.status boolean Device is in private mode
protocol.id number ID of protocol
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.vehicle.mileage number km Total mileage calculated by tacho
timestamp number seconds Message timestamp
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.event boolean Towing event detected
trip.average.speed number km/h Average speed of the trip
trip.driving.time number seconds Single riding time
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
x.acceleration number g Accelerometer value X
y.acceleration number g Accelerometer value Y
z.acceleration number g Accelerometer value Z

Below is the list of commands that can be sent to devices to change their configuration or to send signals to various outputs. When sending a command you can specify the transport type defining how the command will be delivered - the address parameter can take values connection (via network connection once the device goes online), sms (via SMS message), push (via PUSH notification). A comprehensive format of each command with all possible parameter values, parameter types, default values, etc. can be found in the REST API documentation in your flespi.io account.

Title Name Description Properties
AVL12 command codec12 Send command encoded in AVL12 codec 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