Description:
There are multiple sources of mileage for TT2, some are based on GNSS positions while others are instead based on the vehicle's internal odometer (and obtained through CANBUS):
GNSS based:
IO ID | Name | Size, B | Type | Min. Value | Max. Value | Multiplier; offset | Units | Error values | IO Explanation and Notes |
65 | Virtual odometer | 4 | Unsigned int. | 0 | 4294967295 | - | m | - | Mileage calculated by the GNSS module |
Additionally, there is a virtual TT2 parameter that is calculated by TT2 itself called "Virtual gps odometer", more information below.
CANBUS based (only CAN/TCO/OBD compatible devices):
IO ID | Name | Size, B | Type | Min. Value | Max. Value | Multiplier; offset | Units | Error values | IO Explanation and Notes |
114 | CAN high resolution total vehicle distance | 4 | Unsigned int. | 0 | 4211081215 | 5; 0 | m | 4261412864 to 4278190079 | FMS parameter SPN 917 |
163 | TCO distance | 4 | Unsigned int. | 0 | 4294967295 | 5 | m | 4294967295 | 10000=50000m |
645 | OBD Odometer, Km* | 4 | Unsigned int. | 0 | 0xFFFFFFFF | - | km | 0xFFFFFFFF - Odometer readings not available | Indicates mileage from OBD socket |
*All OBD parameters are only read when ignition is on, when ignition is off, they will read "0", so "0" values must be filtered out on the SW side to avoid fluctuations. More information below.
More information: FMIO Parameter List
Steps:
Virtual Odometer
Virtual Odometer is a parameter based on the all time accumulated distance (in meters) based on GNSS positions the device gets while ignition is ON.
Device Center (Advanced mode)
1- Enable Virtual Odometer as a parameter in the configuration. Event on Monitoring and Priority Low.
2- Set a reliable Engine (ignition) source in the configuration, as Virtual Odometer only adds distance while ignition is on.
3- Send the configuration to the device.
LCM (Admin Panel)
4- Login to your LCM account.
5- Go to Objects
6- Search your object or create it if needed.
7- Click on Edit
8- Go to the Inputs table, tick Mileage and set it as follows:
Parameter1 = Virtual Odometer
Function = Custom
Set constants = p1/1000 (in order to receive final results in Kilometers)
MIN = 0
MAX = 99999999
9- Click on “Save” at the bottom of the Input list.
Virtual gps odometer
Virtual gps odometer is a virtual parameter based on the accumulated distance (in meters) between GNSS positions the server gets from the device (irregardless of the ignition state). It does not need to be enabled in the device configuration.
LCM (Admin Panel)
4- Login to your LCM account.
5- Go to Objects
6- Search your object or create it if needed.
7- Click on Edit
8- Go to the Inputs table, tick Mileage and set it as follows:
Parameter1 = Virtual gps odometer
Function = Custom
Set constants = p1/1000 (in order to receive final results in Kilometers)
MIN = 0
MAX = 99999999
9- Click on “Save” at the bottom of the Input list.
CAN high resolution total vehicle distance (CANBUS distance)
Vehicle's internal odometer in meters. To get it, you first need to connect tracker to a CANbus supported vehicle via CAN using a CAN compatible device.
Device Center (Advanced mode)
1- Enable CAN high resolution total vehicle distance as a parameter in the configuration. Event on Monitoring and Priority Low. CAN needs to be enabled beforehand.
3- Send the configuration to the device.
LCM (Admin Panel)
4- Login to your LCM account.
5- Go to Objects
6- Search your object or create it if needed.
7- Click on Edit
8- Go to the Inputs table, tick Mileage and set it as follows:
Parameter1 = CAN high resolution total vehicle distance
Function = Custom
Set constants = p1*0.005 (in order to receive final results in Kilometers)
MIN = 1 (this minimum is set in order to filter out erroneous 0 values whenever CANbus is unavailable).
MAX = 99999999
9- Click on “Save” at the bottom of the Input list.
TCO distance
Tachograph odometer in meters. To get it, you first need to connect tracker to a Tachograph using vehicle via CAN using a TCO compatible device.
Device Center (Advanced mode)
1- Enable TCO distance as a parameter in the configuration. Event on Monitoring and Priority Low. CAN needs to be enabled beforehand.
3- Send the configuration to the device.
LCM (Admin Panel)
4- Login to your LCM account.
5- Go to Objects
6- Search your object or create it if needed.
7- Click on Edit
8- Go to the Inputs table, tick Mileage and set it as follows:
Parameter1 = TCO Distance
Function = Custom
Set constants = p1*0.005 (in order to receive final results in Kilometers)
MIN = 1 (this minimum is set in order to filter out erroneous 0 values whenever CANbus is unavailable).
MAX = 99999999
9- Click on “Save” at the bottom of the Input list.