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
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
battery.charging.status boolean Battery charging status
battery.current number amperes Battery current
battery.level number percentage Internal battery level
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.voltage number volts BLE (Bluetooth Low Energy) sensor battery voltage
ble.sensor.humidity number percentage BLE (Bluetooth Low Energy) sensor Humidity value
ble.sensor.temperature number celsius BLE (Bluetooth Low Energy) sensor Temperature value
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 Barometric pressure
can.commanded.egr number percentage Commanded EGR
can.control.module.voltage number volts Control module voltage read from ODBII interface number kPa Direct fuel rail pressure number km Distance traveled since codes cleared
can.dtc.number number Number of diagnostic trouble codes
can.egr.error number percentage EGR Error
can.engine.load.level number percentage 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 number seconds Run time since engine start
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.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 number percentage Hybrid battery pack remaining life
can.intake.air.temperature number celsius Intake air temperature 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 number km Distance traveled with malfunction indicator lamp (MIL) on number minutes Time run with malfunction indicator lamp on number CAN module 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
can.throttle.pedal.level number percentage Throttle pedal push level read from CAN number minutes Time since trouble codes cleared
can.timing.advance number degrees Timing advance
can.vehicle.mileage number km Total vehicle mileage read from CAN
can.vehicle.speed number km/h Vehicle speed read from CAN number ID of channel that received a message
counter.impulses number Impulses counter
crash.accelerometer.status boolean Crash accelerometer is calibrated
crash.event boolean Crash event detected 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 number Configuration profile index number ID of device that received a message string Name of device that received a message number ID of device type of device that received a message
din number Digital inputs bitmask boolean Door open status
dout number Digital outputs bitmask number Average amount of events on some distance
engine.ignition.status boolean Engine ignition status
event.enum number Event code, full list of codes available at separate table
event.priority.enum number Event priority enum
external.powersource.voltage number volts External power voltage
fuel.level number percentage Fuel level percentage 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 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 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.event boolean Harsh cornering detected
harvest.area number m^2 Area of harvest 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
liquid.sensor.fuel.temperature number celsius Fuel temperature reported by LLS
liquid.sensor.fuel.volume number liters Fuel volume reported by LLS number LVC security state flags
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
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 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
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 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
towing.event boolean Towing event detected
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 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