How to read ELD data with FM3001?

From Wiki Knowledge Base | Teltonika GPS

Introduction

This document contains information required for developing an application for receiving Electronic Logging Devices data via Bluetooth® from FM3001 series devices.

Acronyms and terms used in the document:

  • BT – Bluetooth®
  • ELD – Electronic Logging Devices

Configurable parameters

ELD functionality has 3 additional parameters: ELD data send period and ELD VIN.

Parameter ID Parameter Type Default Value Value Range Value Parameter Name
Min Max
40000 Uint8 1 0 2 0 - Disable

1 - OBD
2 - ELD

OBD Feature
40002 Uint16 10 2 65535 Seconds ELD data send period
40003 String "" 17 17 Charactes ELD VIN


ELD VIN number has to be exactly 17-character long, contain uppercase letters and do not include letters I(i), O(o) and Q(q) (to avoid confusion with numerals 1 and 0).

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

ELD data packets have JSON structure as shown below:
{
"dashboard_mileage": "919483",
"obd_rpm": "0",
"obd_vin": "4V4NC9EH4FN187825",
"ignition": "0",
"loc": "-10310092,3517679",
"obd_speed": "4",
"engine_hours": "0",
"time": "1518588000",
“can_data”:”0”.
}
Braces “{” and “}” marks packet start and end.

Parameters definitions

Parameter name Parameter definition
dashboard_mileage Units in km, vehicle Total Distance PGN 65217 SPN 917
obd_rpm Vehicle RPM PGN 61444 SPN 19065217 SPN 917
obd_vin Vehicle VIN PGN 65260 SPN 237
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
obd_speed Units in km/h, wheel based speed PGN 65265 SPN 84
engine_hours Total Engine hours PGN 65253 SPN 247
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 FM3001 record saving.
Can_data Shows whether CAN data is being read. 0 – CAN data is not being read; 1 – CAN data is being read.


Bw nb.png Can_data parameter has been added from firmware version 03.18.00.


Ignition is set depending on RPM value received from TLT chip:

  • ignition is set to 1 if RPM is more than 0 and is set to 0 if RPM is equal to 0.


RPM and Speed are also saved to Engine RPM and Vehicle Speed OBD IO elements.