Teltonika is one of the most popular protocols in flespi platform and in the world of Telematics. This topic will be used to post changes in protocol implementation. Here is a guide how to obtain telematics data from Teltonika devices over API . Supported devices list Teltonika FM1100 Teltonika FM1110 Teltonika FM1120 Teltonika FM1122 Teltonika FM1125 Teltonika FM1200 Teltonika FM1202 Teltonika FM2200 Teltonika FM3001 Teltonika FM3300 Teltonika FM3612 Teltonika FM3622 Teltonika FM36M1 Teltonika FM4100 Teltonika FM4200 Teltonika FM5300 Teltonika FM6300 Teltonika FM6320 Teltonika FMA110 Teltonika FMA120 Teltonika FMA202 Teltonika FMA204 Teltonika FMB001 Teltonika FMB002 Teltonika FMB003 Teltonika FMB010 Teltonika FMC001 Teltonika FMM001 Teltonika FMB110 Teltonika FMB120 Teltonika FMB122 Teltonika FMB125 Teltonika FMB130 Teltonika FMB202 Teltonika FMB204 Teltonika FMB630 Teltonika FMB640 Teltonika FMB641 Teltonika FMC650 Teltonika FMB900 Teltonika FMB910 Teltonika FMB920 Teltonika FMB962 Teltonika FMB964 Teltonika FMT100 Teltonika FMU125 Teltonika FMU130 Teltonika GH5200 Teltonika MTB100 Teltonika TMT250 Teltonika TST100 Teltonika FMM125 Teltonika FMC125 Teltonika FMM130 Teltonika FMC130 Teltonika FMB204 Teltonika FMB140 Teltonika TFT100 Teltonika FMM800 Teltonika FMC800 Teltonika FMM920 Teltonika FMM150 Teltonika FMM13A Teltonika FMC13A Teltonika FMM80A Teltonika FMM650 Teltonika FMB930 Teltonika FMM880 Teltonika FMC880 Teltonika FMC234

BLE temperature and humidity sensor values parsing added to device types FMB

Dear flespi users. We have added a new device type Teltonika TST100 to the list of supported Teltonika devices. With this update we also announce major refactoring of the whole Teltonika protocol implementation for all device types. The newly integrated TST100 already works on the new base, and has all possible settings integrated. In the nearest future we will move all other devices messages parsing and settings operations to the new base. We will report here the log of the migration. The main goal is to make parameters parsing more faster and more precise. Update will touch only "secondary" parameters without influencing time and position parameters.

Teltonika FM3001 moved to new parsing scheme. FM3001 settings have been remastered to correspond Teltonika Parameter list With this update we also moved "Generic Teltonika" device type to new parsing scheme. So if you do not register a device in Telematics Hub and use it only in channel level - the parsing will work with correspondence to Teltonika FMB table as it is the most popular device family. Again, this relates only to "secondary" parameters without influencing time and position parameters.

As described in previous post we do major refactoring here. The list of updates installed today: (and the main): All device types moved to new parsing scheme. Device types added: FMC125 , FMM125 , FMC130 , FMM130 , FMB206 Wide range of settings added for devices: MTB100 , TMT250 . Digital inputs settings remastered to fit clearly to all FMB devices family list.

Device types added: FMC001 , FMM001 And for the OBD device family device settings are almost full. (We skip Geofence settings and Bluetooth OBD settings as they require settings Arrays work which is under construction on Telematics Hub back-end side)

tags 253 and 254 remastered as specified in Teltonika wiki . As for now it is parsed as following: if parameter 253 is: 1 – harsh.acceleration.event = true (parameter 254 is parsed to absolute.acceleration in G) 2 – harsh.braking.event = true (parameter 254 is parsed to absolute.acceleration in G) 3 – harsh.cornering.event = true (parameter 254 is parsed to harsh.cornering.angle in degrees) For FMB640, FMB630, FM3612 and FM36m1 254 tag have been parsed to eco.driving.events.number which is not valid parsing. This parameter will be removed from 254 tag parsing in a week - 20 November, 2019

Teltonika protocol updated: Parameter can.liquid.sensor.fuel.volume is renamed to can.fuel.volume For backward compatibility both parameters are registered for now. Old parameter will be removed 25 Nov 2019. Multiplier 0.1 is applied to can.fuel.volume parameter to get resulting value in liters.

namo Teltonika protocol updated: can.liquid.sensor.fuel.volume parameter is removed

Dear flespi users, there are minor changes in Teltonika protocol: overspeeding.event parameter will be renamed to overspeeding.status parameter. movement.event parameter will be renamed to movement.status . For now both parameters are registered. movement.event and overspeeding.event will be removed on December 4th There are also some bugfixes: Several parameters has wrong signed/unsigned parsing. E.g. external.powersource.voltage generated bad values as it was parsed as signed integer, now it switched to unsigned and has correct values. The same with gsm.lac or gsm.cellid (it was parsed as signed, and now as unsigned, so on big values it was possible incorrect). FMB630 device series parameter can.engine.coolant.temperature parsing fixed towing.event parameter parsing was incorrect. We've fixed it and now correct parameter value is stored in towing.alarm.status gsm.jamming.event parameter parsing was incorrect. We've fixed it to gsm.jamming.alarm.status If you will find something suspicious in Teltonika parameter parsing - please, contact us.

we've implemented special logic for parsing BLE connected devices. Teltonika protocol send it under tag 385 and now it is parsed to parameter ble.beacons which is JSON object, where keys are BLE beacons UUID, and values - JSON objects with beacon parameters, e.g. {... "ble.beacons": { "E2C56DB5-DEAD-BEEF-B060-D0F5A71096E0:1234:9876": { "rssi": -79 }, "E2C56DB5-DEAD-BEEF-B060-D0F5A71096E0:4321:6789": { "rssi": -86 } }, "channel.id": 12345, "event.enum": 385, "event.priority.enum": 0, "ident": "123451234512345", "position.altitude": 126, "position.direction": 60, "position.latitude": 12.3456, "position.longitude": 65.4321 ...} if("undefined"!==typeof hljs)hljs._ha();else if("undefined"===typeof hljsLoading){hljsLoading=1;var a=document.getElementsByTagName("head")[0],e=document.createElement("link");e.type="text/css";e.rel="stylesheet";e.href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css";a.appendChild(e);e=document.createElement("script");e.type="text/javascript";e.onload=function(){var d={},f=0;hljs._hb=function(b){b.removeAttribute("data-hljs");var c=b.innerHTML;c in d?b.innerHTML=d[c]:(7

[Changelog] teltonika protocol

baja

FMB640 series parsing scheme update:

new parameters added:
224 - ultrasonic.fuel.level.1
225 - ultrasonic.fuel.level.2
208 - ultrasonic.software.state.enum.1
209 - ultrasonic.software.state.enum.2
10009 - eco.driving.events.number
10487 to 10492 - sensor.humidity.1 to sensor.humidity.6
109 - fms.software.version
110 - fms.diagnostics.supported
111 - fms.requests.supported
122 - fms.movement.direction
123 - fms.tacho.performance
124 - fms.handling.info
125 - fms.system.event
137 - pto.drive.engagement.enum
229 - fms.adblue.state.enum
357 - can.brake.pedal.level
10428 to 10431 - fms.tell.tale.1 to fms.tell.tale.4
10445 - can.adblue.level
176 - can.dtc.number
550 to 599 - geofence.status.51 and overspeeding.status.51 to geofence.status.100 and overspeeding.status.100
257 - acceleration.array json array of json objects with x, y,z keys showing acceleration on each axis
258 - max.x.acceleration, max.y.acceleration, max.z.acceleration
259 - average.x.acceleration, average.y.acceleration, average.z.acceleration
260 - eco.driving.event.duration
251 - immobilizer.state
183 - tacho.drive.recognize.status
189 to 190 - tacho.driver.time.state.enum.1 and tacho.driver.time.state.1 to tacho.driver.time.state.enum.2 and tacho.driver.time.state.2
56 to 57 - tacho.driver.continuous_driving.duration.1 to tacho.driver.continuous_driving.duration.2
58 to 59 - tacho.driver.cumulative_break.duration.1 to tacho.driver.cumulative_break.duration.2
60 to 61 - tacho.driver.selected.activity.duration.1 to tacho.driver.selected.activity.duration.2
69 - tacho.driver.cumulative_driving.duration.1
77 - tacho.driver.cumulative_driving.duration.2
48 - tacho.data.source

indexed parameter device.com.connection.status parsed from IDs 643 and 644 was removed, as it is not present in current data sending parameter ID list

bugfix:
327 to 356 are now stored to parameters geofence.status.21 and overspeeding.status.21 to geofence.status.50 and overspeeding.status.50. Before that they were stored with incorrect index from 1 to 30

baja

FMB series parsing update:
ID 10 boolean parameter sd.status
ID 116 parsing to battery.charging.status parameter removed, as it does not correspond the documentation
ID 238 parameter custom.user.id
ID 237 parameter gsm.network.type
ID 759 parameter can.fuel.type.enum
ID 11317 to array parameter eye.beacons
ID 10828 to array parameter visible.beacons
ID 10829 to array parameter found.beacons
ID 10831 to array parameter lost.beacons

FMB640 seires parsing update:
ID 10500 parsed as standard ble.beacons list
ID 548 is parsed as advanced ble.beacons list https://wiki.teltonika-gps.com/view/FMC640_Beacon_List

baja

baja fix in ID 11317 to array parameter eye.beacons storing: now temperature is stored with BIG endian as for new firmware update.

Device types added:
Teltonika FMM800
Teltonika FMC800
Teltonika FMM920
Teltonika FMM150

baja

baja remastering of previously added parameters
ID 10828: array parameter visible.beacons renamed to ble.beacons
ID 10829: array parameter found.beacons renamed to ble.beacons with field state: found at each beacon object
ID 10831: array parameter lost.beacons renamed to ble.beacons with field state: lost at each beacon object

ID 11317 now stored to array parameter eye.beacons will be renamed to ble.beacons in 10 days, May 5th

ID 1151 (OEM Battery State Of Health) stored as can.vehicle.battery.health multiplier 0.1 removed
ID 1152 (OEM Battery Temperature) stored as can.vehicle.battery.temperature multiplier 0.01 removed

shal

We added to flespi parameters information from which AVL ID they are detected.
You may investigate each specific parameter via teltonika protocol page or messages parameters tool built-in your flespi.io account:

kial

AVL ID 200, containing the "Sleep Mode" state, is now stored in a new parameter sleep.mode.enum of type number, for values other than 0. Current parameter sleep.mode.status: true, stored for the same non-zero values, will be deleted Friday, Jan 27, 2023.

baja

kial sleep.mode.enum is now stored if 0 too.

Device types added:
Teltonika FMM13A
Teltonika FMC13A

baja

kial sleep.mode.status removed

FMB640 series parsing for ID 548 implemented according to updated documentation

Parsing updated for all FMB series:
ID 258 is parsed to parameters max.x.acceleration, max.y.acceleration and max.z.acceleration
ID 259 is parsed to parameters average.x.acceleration, average.y.acceleration and average.z.acceleration
ID 259 is parsed to parameter eco.driving.event.duration
ID 387 is parsed as a string parameter iso6709.coordinates

YuryAheichyk

New parameters parsing added for TFT100 model

ID 1126: Maximum available power can.max.available.power
ID 1127: Handlebar lock status can.handlebar.lock.status
ID 1128: Rear brake status can.rear.brake.status
ID 1129: COM Error can.com.error.status
ID 1130: RPM can.engine.rpm
ID 1131: Torque current can.torque.current
ID 1132: SN High can.sn.high
ID 1133: SN Low can.sn.low
ID 1134: Lowest battery voltage can.lowest.battery.voltage
ID 1135: Lowest battery ID can.lowest.battery.code
ID 1136: Highest battery voltage can.highest.battery.voltage
ID 1137: Highest battery ID can.highest.battery.code
ID 1138: Highest mismatch voltage can.highest.mismatch.voltage
ID 1139: Highest Mismatch ID can.highest.mismatch.code
ID 1140: Lowest battery temperature can.lowest.battery.temperature
ID 1141: Lowest temperature battery ID can.lowest.battery.temperature.code
ID 1142: Highest battery temperature can.highest.battery.temperature
ID 1143: Highest temperature battery ID can.highest.battery.temperature.code
ID 1145: Time to empty can.discharge.time
ID 1146: Time full can.full.charge.time
ID 1147: Cluster state can.cluster.state.enum
ID 1148: Cluster SoC can.cluster.soc
ID 1149: Max discharge current can.max.discharge.current
ID 1150: Recuperation status can.recuperation.status
ID 1151: Switch process status can.switch.process.status
ID 1152: SoC switch level can.soc.switch.level
ID 1153: Part charge capacity can.part.charge.capacity
ID 1154: Cluster voltage can.cluster.voltage
ID 1155: Cluster current can.cluster.current
ID 1156: Major version can.major.version
ID 1157: Minor version can.minor.version
ID 1158: Patch version can.patch.version
ID 1159: Recognized batteries can.recognized.batteries
ID 1160: Activated batteries can.activated.batteries
ID 1161: Faulty batteries can.faulty.batteries
ID 1162: Battery 1 voltage can.battery1.voltage
ID 1163: Battery 1 current can.battery1.current
ID 1164: Battery 1 State can.battery1.state.enum
ID 1165: Battery 1 SoC can.battery1.soc
ID 1166: Battery 1 temperature 1 can.battery1.temperature
ID 1167: Battery 1 temperature 2 can.battery1.temperature
ID 1168: Battery 1 power stage temp 1 can.battery1.power.stage.temperature
ID 1169: Battery 1 remaining capacity can.battery1.remaining.capacity
ID 1170: Battery 2 voltage can.battery2.voltage
ID 1171: Battery 2 current can.battery2.current
ID 1172: Battery 2 state can.battery2.state.enum
ID 1173: Battery 2 SoC can.battery2.soc
ID 1174: Battery 2 temperature 1 can.battery2.temperature
ID 1175: Battery 2 temperature 2 can.battery2.temperature
ID 1176: Battery 2 power stage temp can.battery2.power.stage.temperature
ID 1177: Battery 2 remaining capacity can.battery2.remaining.capacity
ID 1178, ID 1179: Battery ID error code can.battery.error.code.1 and can.battery.error.code.2
ID 1180: Cluster error code can.cluster.error.code
ID 1181: Max charge current can.max.charge.current
ID 1182: Lowest battery 2 temperature can.lowest.battery2.temperature
ID 1183: Highest battery 2 temperature can.highest.battery2.temperature
ID 1184: Lowest battery 2 voltage can.lowest.battery2.voltage
ID 1185: Highest battery 2 voltage can.highest.battery2.voltage

YuryAheichyk

The device type FMC650 was added.

Settings were added for TAT100 device.
As TAT100 is an asset tracker that works mostly on battery power for a long time, it might be critical that the current setting value should not be requested from the device. Thus "Settings polling" device configuration field was set to "never" for all devices of such type. If you need the settings to be synced - you may do it in SetBox, or via updating the "Settings polling" field in the device configuration.

"Secondary GPRS server mode" field was added to "Secondary GPRS Server Setup" (applicable for Professional trackers only)

YuryAheichyk

Changed EYE sensor parameters:
custom.param.10824...10827 to eye.sensor.battery.voltage.1...4
custom.param.10804...10807 to eye.sensor.humidity.1...4
custom.param.10820...10823 to eye.sensor.low.battery.status.1...4
custom.param.10808...10811 to eye.sensor.magnet.status.1...4
custom.param.10836...10839 to eye.sensor.movement.count.1...4
custom.param.10812...10815 to eye.sensor.movement.status.1...4
custom.param.10816...10819 to eye.sensor.pitch.angle.1...4
custom.param.10832...10835 to eye.sensor.roll.angle.1...4
custom.param.10800...10803 to eye.sensor.temperature.1...4

We added a new command "Set IO param". This will allow you to configure IO params as you wish.
For example, you want to setup Battery voltage input to generate an event when the voltage leaves the range from 2500mv to 3300mv. The event should have a low priority and should be added to every AVL record.
This is how it can be done using the new command:

This is how it can be configured using Teltonika Configurator tool:

EvgenyShatilo

Changing the naming of parameters:

The change applies to models: FMB001, FMB002, FMB003, FMC001, FMC003, FMM003
389 - can.vehicle.mileage
390 - can.fuel.volume
402 - can.service.mileage
410 - can.vehicle.battery.charging.status
411 - can.vehicle.battery.level
412 - can.vehicle.battery.power.consumption
755 - can.vehicle.remaining.range
1151 - can.vehicle.battery.health
1152 - can.vehicle.battery.temperature

General parameter changes:
can.vehicle.battery.range and can.vehicle.remaining.range now displays values in kilometers.
also added:
543 - can.hybrid.onboard.power.voltage
544 - can.hybrid.onboard.current

Attention!

01.05.2023 the battery.charging.status parameter will be renamed to can.vehicle.battery.charging.status.
The changes have already been added to the server and the parameter are registered with a new name. When the time is reached, the old one will be deleted.

baja

Parsing update for FMB640 series:
ID 10507: (Driver 1 current daily driving time) to parameter tacho.driver.daily.driving.duration.1
ID 10508: (Driver 1 current weekly driving time) to parameter tacho.driver.weekly.driving.duration.1
ID 10509: (Driver 1 time left until new daily rest period) to parameter tacho.driver.daily.before.rest.duration.1
ID 10514: (Driver 2 current daily driving time) to parameter tacho.driver.daily.driving.duration.2
ID 10515: (Driver 2 current weekly driving time) to parameter tacho.driver.weekly.driving.duration.2
ID 10516: (Driver 2 time left until new daily rest period) to parameter tacho.driver.daily.before.rest.duration.2
IDs 10518 + 10519 to parameter driver.name.1
IDs 10520 + 10521 to parameter driver.name.2
ID 10522: (Driver 1 Time Left Until New Weekly Rest Period) to parameter tacho.driver.weekly.before.rest.duration.1
ID 10523: (Driver 2 Time Left Until New Weekly Rest Period) to parameter tacho.driver.weekly.before.rest.duration.2
ID 10528: (Driver 1 Duration Of Next Break Rest) to parameter tacho.driver.next.rest.duration.1
ID 10529: (Driver 2 Duration Of Next Break Rest) to parameter tacho.driver.next.rest.duration.2
ID 10530: (Driver 1 Remaining Time Until Next Break Or Rest) to parameter tacho.driver.remaining.before.rest.duration.1
ID 10531: (Driver 2 Remaining Time Until Next Break Or Rest) to parameter tacho.driver.remaining.before.rest.duration.2

Parsing update for FMB series as notfied here EvgenyShatilo :
battery.charging.status in security state flags renamed to can.vehicle.battery.charging.status. (Old parameter removed)

Together with this baja update, the parameters prefixed with eye.sensor. will be renamed to ble.sensor.

baja

Device types added:
FMM80A
FMM650
FMB930

baja
eye.beacons duplicated parameter removed
eye.sensor.temperature renamed to ble.sensor.temperature
eye.sensor.humidity renamed to ble.sensor.humidity
eye.sensor.magnet.status renamed to ble.sensor.magnet.status
eye.sensor.movement.status renamed to ble.sensor.movement.status
eye.sensor.pitch.angle renamed to ble.sensor.pitch.angle
eye.sensor.low.battery.status renamed to ble.sensor.low.battery.status
eye.sensor.battery.voltage renamed to ble.sensor.battery.voltage
eye.sensor.roll.angle renamed to ble.sensor.roll.angle
eye.sensor.movement.count renamed to ble.sensor.movement.count

shal

For Teltonika FMC640 series of devices new set of parameters integrated with readings from connected TK Transcan:

freezer.transcan.temperature: Sensor temperature reported by TK Transcan
freezer.transcan.state.enum: Status value as reported by TK Transcan
freezer.transcan.alarm.enum: Alarm value as reported by TK Transcan

baja

Parameters renaming schedule on June 19th:
AVL ID 331 to 334, ble.sensor.payload.hex.1 to ble.sensor.payload.hex.4 renamed to ble.1.custom.payload.hex.1 to ble.4.custom.payload.hex.1. Both parameters are stored now, old names will be removed in a week
New parameters parsing added for IDs 463 to 474. In Teltonika documentation they are described as
BLE X Custom #Y and may be unsigned 4 bytes integer or data chunk in HEX mode
so they are stored as
ble.X.custom.Y for integer mode
ble.X.custom.payload.hex.Y for HEX mode

baja

Parsing update for temperature and humidity sensors: when sensors report the code that shows that the value is incorrect, the parameter with the value will not be stored, but string error code will be stored instead
IDs 72 to 75: parameter sensor.temperature.1 to sensor.temperature.4 extra parameter sensor.temperature.error.code.1 to sensor.temperature.error.code.4
IDs 25 to 28: parameter ble.sensor.temperature.1 to ble.sensor.temperature.4 extra parameter ble.sensor.temperature.error.code.1 to ble.sensor.temperature.error.code.4
IDs 86, 104, 106, 108: parameter ble.sensor.humidity.1 to ble.sensor.humidity.4 extra parameter ble.sensor.humidity.error.code.1 to ble.sensor.humidity.error.code.4

YuryAheichyk

AVL ID 11317 parsing updated, added mac.address and magnet.count parameters to ble.beacons array

baja

Major update in ibutton.code parameter: Teltonika tech team reported to us that all the values for ibutton.code parameter parsed from ID 78 for all the device types are sent in reversed bytes order. So now flespi stores it in reversed order, and we need to reverse it back to be in touch with reality. So now, together with ibutton.code parameter we have parameters ibutton.code.old and ibutton.code.new. Now ibutton.code.old is the same as ibutton.code, ibutton.code.new is made of reversed bytes of ibutton.code. In 2 weeks, August 17th, ibutton.code will become reversed, the same as ibutton.new. In 1 month, September 3rd, ibutton.code.new and ibutton.code.old will be removed. You may now prepare your infrastructure and create a plugin that renames ibutton.code.new to ibutton.code. Contact our team in flespi chat if you need assist with that.

FMB640 series parsing update:
Bugfix in IO ID 109 that is parsed into fms.sfotware.version
FMS Eco driving parameters supported.

Parameter names

fms.event.enum
fms.vehicle.vin
fms.active.driver.id
fms.event.number
fms.coasting.mileage
fms.coasting.fuel.used
fms.coasting.time
fms.ecoroll.mileage
fms.ecoroll.fuel.used
fms.ecoroll.time
fms.braking.mileage
fms.braking.fuel.used
fms.braking.time
fms.braking.number
fms.retarder.mileage
fms.retarder.fuel.used
fms.retarder.time
fms.cruise.mileage
fms.cruise.fuel.used
fms.cruise.time
fms.torque.mileage
fms.torque.fuel.used
fms.torque.time
fms.pto.mileage
fms.pto.fuel.used
fms.pto.time
fms.driving.fuel.used
fms.idle.fuel.used
fms.engine.load.fuel.used
fms.total.mileage
fms.total.fuel.used
fms.total.time
fms.short.stops.number
fms.long.stops.number
fms.parking.brake.number
fms.harsh.acceleration.number
fms.harsh.braking.number
fms.harsh.cornering.number
fms.mileage.speed.range
fms.fuel.used.speed.range
fms.time.speed.range
fms.mileage.rpm.range
fms.fuel.used.rpm.range
fms.time.rpm.range
fms.mileage.torque.range
fms.fuel.used.torque.range
fms.time.torque.range
fms.mileage.braking.range
fms.fuel.used.braking.range
fms.time.braking.range

baja

baja ibutton.code first update postponed to August 24

EvgenyShatilo

DashCam Data Sending Parameters ID parsing parameters update:

Camera ping transmission and TF status checking parameters ID (id 498) recorded as 2 parameters:
camera.report.reason.enum - represented as numeric value.
camera.report.reason - and textual human-readable value with values:

0="Server request"
1="DIN1"
2="DIN2"
3="Crash"
4="Towing"
5="Idling"
6="Geofence"
7="Unplug"
8="Green Driving"

Image sending trigger parameters ID (id 499) recorded as 2 parameters:
camera.state.enum - represented as numeric value.
camera.state - and textual human-readable value with values:

    0="Camera not detected"
    1="No card"
    2="Card mount failed"
    3="Card mounted"
    4="Card faulty"