How to read ELD data with FMX00A
From Wiki Knowledge Base | Teltonika GPS
Revision as of 13:43, 28 August 2023 by Justinas.strelciunas (talk | contribs)
Terms and definitions
Acronyms and terms used in the document:
- BT – Bluetooth;
- ELD – Electronic Logging Devices.
Introduction
This document contains information required for developing an application for receiving Electronic Logging Devices data via Bluetooth from FMC00A and FMM00A series devices.
The ELD synchronizes with the CMV engine to automatically record:
- Engine power status
- Vehicle motion status
- Miles driven
- Engine hours
- Identification of driver/authorized user, vehicle, and motor carrier
- Duty status
Configurable parameters
ELD functionality has 3 additional parameters:
| Parameter ID | Parameter Type | Default Value | Value Range | Value | Parameter Name | |
|---|---|---|---|---|---|---|
| Min | Max | |||||
| 40000 | Uint8 | 1 | 0 | 3 |
0 - Disable |
OBD Feature |
| 40002 | Uint16 | 10 | 2 | 65535 | Seconds | ELD data send period |
| 40008 | Uint8 | 0 | 0 | 1 | 0 - Disable 1 - Enable |
Send ELD data via Bluetooth |
ELD APP workflow
ELD functionality start to send data periodically via BT right after external BT device has been connected if OBD Feature (parameter ID 40000) is set to ELD (option 2). ELD data sending is paused if Configurator is connected. ELD data is resumed after configurator disconnects. ELD data sending resumes automatically when external BT device reconnects after connection loss.
ELD data packet structure
{
"obd_vin": "4V4NC9EH4FN187825",
"loc": "-10310092,3517679",
"time": "1675874086",
"can_data": "1",
"engine_hours": "315",
"dashboard_mileage": "919483",
"obd_rpm": "3224",
"obd_speed": "25",
"ignition": "1",
"total_fuel": "182",
"engine_idle_hours": "156",
"dtc_count": "2",
"fuel_level_1": "35",
"fuel_level_2": "46",
"battery_voltage": "24",
"total_idle_fuel": "3152",
"trip_distance": "306",
"fuel_economy": "12",
"ambient_air_temp": "21",
"engine_coolant_temp": "50",
"engine_load": "89",
"engine_throttle": "94",
"trip_fuel_used": "17",
"oil_temp": "90",
"oil_pressure": "6",
"seat_belt_status": "0",
"cruise_control_state": "3",
"throttle_pedal_pos": "90",
"engine_coolant_level": "60",
"engine_coolant_press": "4",
"transmission_oil_temp": "60",
"parking_brake_switch": "0",
"brake_application_press": "9",
"brake_pedal_pos": "32"
}
ELD J1939 Parameters definitions
| AVL ID | Config ID | Parameter ID for JSON | J1939 PGN | J1939 SPN | Units | Description |
|---|---|---|---|---|---|---|
| 1176 | 40630 | dashboard_mileage | 65217 | 917 | km | Vehicle Total Distance |
| 36 | 40160 | obd_rpm | 61444 | 190 | rpm | Vehicle RPM |
| 256 | 40410 | obd_vin | 65260 | 237 | Vehicle VIN | |
| 1178 | 40650 | ignition | Ignition state according to RPM, possible values: 0 – RPM=0 or 1– RPM>0 | |||
| loc | Current coordinates (longitude and latitude), example value “-10310092,3517679”, actual position is lon=-103.10092, lat=35.17679 | |||||
| 24 | 50090 | obd_speed | 65265 | 84 | km/h | Wheel based speed |
| 24 | 50090 | obd_speed | 65132 | 1624 | km/h | if PGN 65265 is not available data from PGN 65132 is used. |
| 1202 | 40890 | ignition | 64980 | 10145 | Indicates that the ignition (or “run”) state of the operator key switch is active. This state is also known in DIN 75552 as “KL15”.
| |
| 1177 | 40640 | engine_hours | 65253 | 247 | h | Total Engine hours |
| time | A point in time, defined as the number of seconds that have elapsed since 00:00:00 Coordinated Universal Time (UTC), Thursday, 1 January 1970. Current timestamp used in record saving. | |||||
| can_data | Is CAN data available or not | |||||
| 1180 | 40670 | total_fuel | 64777 | 5054 | l | Fuel consumed during all or part of a journey. High resolution used for calculations and fleet management systems. |
| 1180 | 40670 | total_fuel | 65257 | 182 | l | If PGN 64777 is not available data from PGN 65257 is used. |
| 1181 | 40680 | engine_idle_hours | 65244 | 235 | h | Accumulated time of operation of the engine while under idle conditions. |
| 1182 | 40690 | dtc_count | 40448 | 4106 | MIL-On DTCs | |
| 48 | 40280 | fuel_level_1 | 65276 | 96 | % | Ratio of volume of fuel to the total volume of fuel storage container. When Fuel Level 2 (SPN 38) is not used, Fuel Level 1 represents the total fuel in all fuel storage containers. When Fuel Level 2 is used, Fuel Level 1 represents the fuel level in the primary or left-side fuel storage container. |
| 1183 | 40700 | fuel_level_2 | 65276 | 38 | % | Ratio of volume of fuel to the total volume of fuel in the second or right-side storage container. When Fuel Level 2 is not used, Fuel Level 1 (SPN 96) represents the total fuel in all fuel storage containers. |
| 1184 | 40710 | battery_voltage | 61733 | 9025 | V | SLI battery terminal voltage |
| 1185 | 40720 | total_idle_fuel | 65244 | 236 | l | Accumulated amount of fuel used during vehicle operation while under idle conditions. |
| 1186 | 40730 | trip_distance | 65217 | 918 | m | Distance traveled during all or part of a journey. |
| 1187 | 40740 | fuel_economy | 65266 | 184 | km/L | Current fuel economy at current vehicle velocity. |
| 1188 | 40750 | ambient_air_temp | 65269 | 171 | °C | Temperature of air surrounding vehicle. |
| engine_coolant_temp | 65262 | 110 | °C | Temperature of liquid found in engine cooling system. | ||
| 1189 | 40760 | engine_load | 64523 | 13131 | % | The desired position of the Throttle valve 1 (SPN 51) that is regulating the fluid, usually air/fuel mixture to the engine as commanded by the Engine Control unit. 0% represents no supply and 100% is full supply. |
| 1192 | 40790 | trip_fuel_used | 64777 | 5053 | l | Fuel consumed during all or part of a journey. |
| 1191 | 40780 | oil_temp | 65262 | 175 | °C | Temperature of the engine lubricant. |
| 1191 | 40780 | oil_temp | 65188 | 1135 | °C | If PGN 65262 is not available data from PGN 65188 is used. |
| 1193 | 40800 | oil_pressure | 64751 | 7468 | kPa | Gage pressure of oil in engine lubrication system as provided by oil pump. |
| 1194 | 40810 | seat_belt_status | 57344 | 1856 | State of switch used to determine if Seat Belt is buckled
| |
| 1195 | 40820 | cruise_control_state | 61651 | 7317 | Indicates the state of the PCC controller.
| |
| 1196 | 40830 | throttle_pedal_pos | 61443 | 91 | % | Accelerator Pedal Position |
| 1197 | 40840 | engine_coolant_level | 65263 | 111 | % | Ratio of volume of liquid found in engine cooling system to total cooling system volume. Typical monitoring location is in the coolant expansion tank. |
| 1198 | 40850 | engine_coolant_press | 65263 | 109 | kPa | Gage pressure of liquid found in engine cooling system. |
| 1199 | 40860 | transmission_oil_temp | 65272 | 177 | °C | Transmission Oil Temperature |
| 1179 | 40660 | parking_brake_switch | 65265 | 70 | Switch signal which indicates when the parking brake is set.
| |
| 1120 | 40870 | brake_application_press | 65274 | 116 | kPa | Gage pressure of compressed air or fluid in vehicle braking system measured at the brake chamber when brake shoe (or pad) is placed against brake drum (or disc). |
| 1201 | 40880 | brake_pedal_pos | 61441 | 521 | % | Ratio of brake pedal position to maximum pedal position. |
ELD functionality settings
ELD settings
J1939 IO elements
