Difference between revisions of "GPS Electronic Logbook"

From Wiki Knowledge Base | Teltonika GPS
m (Text replacement - "Bluetooth(?!®)" to "Bluetooth®")
 
(94 intermediate revisions by 6 users not shown)
Line 1: Line 1:
== Project description ==
+
==Solution description==
It is a good practice for the companies all over the world a vehicle log to be kept for each automobile so that a fleet manager can keep tracking the operational cost of any particular car and/or the entire fleet. Although, manually handled paper reports leave a lot of space for failure. Starting of basic human errors, paperwork overload, lack of drivers accountability, communication and coordination issues, chaotic routing, excessive idling and up to no clear differentiation between business and personal vehicle use. These challenges will inevitably take an effect on the fleet operational cost, company cash flow, competitive advantage and reputation. All these obstacles can not be ignored and should be taken into account. And that is where Teltonika GPS electronic logbook solution comes into the play.
+
If you are one of those drivers or fleet managers who find doing your logbook a tedious and time-consuming process, we have got good news for you. Thanks to Teltonika GPS trackers, you can automate nearly the whole process by using an accurate and reliable GPS electronic logbook.
  
Teltonika GPS electronic logbook offers two operational modes: Private Mode and Business Mode. In the latter mode - location and the date of departure, driver's ID, mileage at the beginning and the end of the journey (distance travelled in total), green driving parameters, purpose of the trip will be tracked automatically. If Private Mode is chosen by the driver, the logbook will be turned off and no events will be registered.
+
Here You will find how to prepare and test this solution.
  
We are glad that You decided to test our "GPS electronic logbook" solution.
+
==What you need for the solution?==
  
Here You will find how to prepare and to test this solution.
+
*
 +
*Teltonika FM device which is compatible with this use case. Recommended products are: [[FMB001]], [[FMC001]], [[FMM001]], [[FM3001]], [[FMB002]], [[FMB010]], [[FMB003]], [[FMB020]], [[FMP100]] ( FMP100 is connected via cigarette light socket).
 +
*The SIM card in order to receive data to Your server.
 +
*[[Teltonika Configurator]] to set up FM device correctly for the solution.
 +
*[[FOTA WEB]] to remotely send the configuration to the device.
 +
*[[BTAPP Mobile application|BTAPP]] / Driver application for Private Mode or Business Mode selection.
  
== What will You need for the solution? ==
+
==Installation==
 +
All of the recommended products are "Plug and Play" devices. It means that devices are directly plugged into vehicles OBDII socket and after configuration is complete - devices are set for use. Although, if plugged OBDII device is too hard to reach and vehicle parts are interfering with GPS signal or vehicle parts need to be removed/opened to access OBDII socket and afterward parts no longer fit or close - Teltonika offers OBDII extension cable. [https://teltonika-gps.com/product/obdii-cable/]
  
*
+
Apart from device configuration (more later) and installation into the vehicle, the GPS electronic logbook doesn't require additional hands-on work.
* Teltonika FM device which is compatible with this use case. Recommended products: FMB001, FMC001, FMM001, FM3001, FMU126, FMB002, FMB010, FMB003 or FMB020.
 
* The SIM card in order to receive data to Your server.
 
* [[Teltonika Configurator]] to set up FM device correctly for the solution.
 
* [[FOTA WEB]] to remotely send the configuration to the device.
 
* [[BTAPP Mobile application|BTAPP]] / Driver application for Private Mode or Business Mode selection.
 
  
== Installation  ==
+
==Configuration==
Most of recommended products are "Plug and Play" devices. It means that devices are directly plugged into vehicles OBDII socket and after configuration is complete - devices are set. Although, if plugged OBDII device is too hard to reach and vehicle parts are interfering with GPS signal or vehicle parts need to be removed/opened to access OBDII socket and afterwards parts no longer fit or close - Teltonika offers OBDII extension cable. [https://teltonika-gps.com/product/obdii-cable/]
 
  
Keep in mind, that FMU126 device is not "Plug and Play" type and requires more advanced installation. [https://wiki.teltonika-gps.com/view/FMU126_First_Start] Also, particular FM device is specially built for Thailand region.
+
=== '''1. Prerequisites:'''===
  
Apart from device configuration (more later) and installation into vehicle, GPS electronic logbook doesn't require additional hands on work.
+
====1.1. Read through [https://wiki.teltonika-gps.com/view/FMB001_First_Start First start guide]====
  
== Configuration ==
+
=== '''2. Configuration of GPS electronic logbook scenario:'''===
 +
[[File:Gprs settings.png|left|thumb|225x225px]]''Parameter ID'' - ''Parameter name''
  
=== Prerequisites ===
+
*<span style="background-color:#71c5f9;">2001</span> – APN
Before configuring GPS electronic logbook solution it is mandatory to set up GPRS settings for a device. Quick first start guide can be found [[FMB001 First Start|'''here''']].
+
*<span style="background-color:#50b6b1;">2002</span> – APN username (if there are no APN username, empty field should be left)
 +
*<span style="background-color:#c123d9;">2003</span> – APN password (if there are no APN password, empty field should be left)
  
=== Configuring GPS electronic logbook ===
 
After familiarizing with devices first start guide and device's GPRS settings are set - configuration for GPS electronic logbook can be done.
 
[[File:Trip settings.png|left|thumb|439x439px]]
 
''Parameter ID'' - ''Parameter name''
 
  
==='''Trip settings''': ====
+
[[File:Server settings.png|left|thumb|222x222px]]
* '''11800''' - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).
+
<br>
 +
<br>
 +
<br>
 +
Server settings:
 +
*<span style="background-color:#b1c623;">2004</span> – Domain
 +
*<span style="background-color:#f450e2;">2005</span> – Port
 +
*<span style="background-color:#d4b011;">2006</span> – Data sending protocol (0 – TCP, 1 – UDP
 +
<br>
 +
<br>
 +
After successful GPRS/SERVER settings configuration, device will '''synchronize time''' and '''update records''' to '''the configured server'''. Time intervals and default I/O elements can be changed by using [[Teltonika Configurator]] or [[FMB920 Parameter list|SMS parameters]].
  
* '''11801''' - Eventual settings (0 - Disable, 1 - Enable), if disabled - trip settings will come with periodical data.
 
  
* 11802 - Mode (0 - Continuous, 1 Between Records). If Between Records option is selected distance will be counted until any record is made. Then odometer will be reset to zero and start counting until next record is made.
+
[[File:Trip settings.png|left|thumb|439x439px]]
 +
<br>
 +
Configuration of Trip scenario:
  
* 11803 - Start Speed (km/h).
+
*<span style="background-color:#91b9d4;">11800</span> - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).
 +
<br>
 +
*<span style="background-color:#91d4b9;">11801</span> - Eventual settings (0 - Disable, 1 - Enable), if disabled - trip settings will come with periodical data.
  
* 11804 - Ignition OFF timeout (s).
+
*11802 - Mode (0 - Continuous, 1 Between Records). If the ''Between Records'' option is selected - distance will be counted until any record is made. Then odometer will be reset to zero and start counting until the next record is made. If the ''Continues'' option is selected - the distance will continue counting between the trip start and trip stop and the odometer will not reset.
 +
*11803 - Start Speed (km/h). When selecting a value for Start Speed - only after this value (speed) is exceeded, the Trip scenario will be activated. If the Start Speed value is set to 0 (km/h) - the scenario will be activated after the ignition turns on. ''More about ignition settings - below.''
 +
*11804 - Ignition OFF timeout (s).
 +
* 7031 - ID of SMS recipient.
 +
*8031 - SMS Text.
 +
*700 - Eco Score Allowed Events.
 +
<br>
 +
*<span style="background-color:#b991d4;">11806</span> - Odometer Calculation Source (0 - GNSS, 1 - OBD).
 +
* 11807 - current Odometer Value (km). Odometer data will be counted from provided value.
 +
[[File:Screenshot 2021-03-07 162223.png|left|thumb|231x231px]]
  
* 7031 - ID of SMS recipient.
 
  
* 8031 - SMS Text.
 
  
  
* 700 - Eco Score Allowed Events.
 
  
* '''11806''' - Odometer Calculation Source (0 - GNSS, 1 - OBD).
+
Configuration of Ignition Source:
* 11807 - current Odometer Value (km). Odometer data will be counted from provided value.
 
  
[[File:Green - Eco driving.png|left|thumb|348x348px]]
+
* 101 - Ignition Settings ( Ignition has 14 different settings, for more information click [[FMB001 Parameter list|'''here''']]).
  
 +
'''Note''': if Ignition Source is selected only to Accelerometer - ignition will be activated when the vehicle starts moving. Engine RPM - cannot be used for every vehicle model. Direct OBDII devices gather information received via the OBDII socket. If the vehicle doesn't provide Engine RPM via mentioned socket - Engine RPM cannot be used as Ignition Source.
  
 +
* 104 - High Voltage ( value range: 13200 - 30000 mV).
 +
* 105 - Low Voltage ( value range: 0 - 29999 mV).
 +
[[File:Green - Eco driving.png|left|thumb|348x348px]]
  
==== '''Eco/Green Driving settings''': ====
 
* '''11000''' - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).
 
  
* 11004 - Maximum Acceleration (m/s<sup>2</sup>).
+
<br>Configuration of Eco/Green driving scenario:
* 11005 - Maximum Braking (m/s<sup>2</sup>)
+
*<span style="background-color:#b9d491;">11000</span> - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).
* 11006 - Maximum Cornering (m/s<sup>2</sup>)
 
  
 +
*11004 - Maximum Acceleration (m/s<sup>2</sup>).
 +
*11005 - Maximum Braking (m/s<sup>2</sup>)
 +
*11006 - Maximum Cornering (m/s<sup>2</sup>)
  
* '''11007''' - Source (0 - GPS, 1 - Accelerometer). Green driving scenario according to selected data source.
+
*<span style="background-color:#d491b9;">11007</span> - Source (0 - GPS, 1 - Accelerometer). Green driving scenario according to selected data source.
 +
<br>
  
* 11019 - Advanced Eco Driving (0 - Disable, 1 - Enable). If enabled, Eco Driving Average (ID.: 11011) and / or Eco Driving Maximum (ID.: 11015) settings can be changed.
+
*11019 - Advanced Eco Driving (0 - Disable, 1 - Enable). If enabled, Eco Driving Average (ID.: 11011) and/or Eco Driving Maximum (ID.: 11015) settings can be changed.
  
 
* 11008 - Eco/Green Driving Duration (0 - Disable, 1 - Enable).
 
* 11008 - Eco/Green Driving Duration (0 - Disable, 1 - Enable).
  
* 7034 - ID of SMS recipient.
+
*7034 - ID of SMS recipient.
* 8034 - SMS Text.<br /> '''Note''': Maximum acceleration, braking and cornering values should be set according to vehicle type, power, weight and etc. Best values can be approached by practical testing.
+
*8034 - SMS Text.
 
+
<br />
 +
<br />
 +
<br /> '''Note''': Maximum acceleration, braking, and cornering values should be set according to vehicle type, power, weight and etc. Best values can be approached by practical testing. E.g. testing cornering parameters - take the same turn at a different speed (30km/h, 20 km/h, 40 km/h) and check if Eco/Green Driving event has been triggered for cornering - if it feels as turning on 30km/h is harsh but the event is not triggered - lower Max Cornering values and reattempt the test.<br>
 +
<br>
 
[[File:Idlingg.png|left|thumb|240x240px]]
 
[[File:Idlingg.png|left|thumb|240x240px]]
  
 +
Configuration of Excessive idling scenario:
 +
*<span style="background-color:#d4b991;">11200</span> - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).
 +
<br>
 +
*11203 - Eventual settings (0 - Disable, 1 - Enable), if disabled - excessive idling data will come with periodical data.
  
==== '''Excessive Idling settings''': ====
+
*11205 - Time To Stopped (s). Represents how long vehicle should not move with engine ON.
* '''11200''' - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).
+
*11206 - To To Moving (s). Represents how long vehicle should be moving with engine ON, to exit  idle state.
 +
*7033 - ID of SMS recipient.
 +
*8033 - SMS Text.
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
'''Quick start:''' From default configuration to [[FMB001_SMS/GPRS_Commands|GPS electronic logbook records in one SMS]]:
  
* 11203 - Eventual settings (0 - Disable, 1 - Enable), if disabled - excessive idling data will come with periodical data.
+
"  setparam <span style="background-color:#71c5f9;">2001</span>:APN;<span style="background-color:#50b6b1;">2002</span>:APN_username;<span style="background-color:#c123d9;">2003</span>:APN_password;<span style="background-color:#b1c623;">2004</span>:Domain;<span style="background-color:#f450e2;">2005</span>:Port;<span style="background-color:#d4b011;">2006</span>:0;<span style="background-color:#91b9d4;">11800</span>:1;<span style="background-color:#91d4b9;">11801</span>:0;<span style="background-color:#b991d4;">11806</span>:1;<span style="background-color:#b9d491;">11000</span>:2;<span style="background-color:#d491b9;">11007</span>:1;<span style="background-color:#d4b991;">11200</span>:2"
* 11205 - Time To Stopped (s). Represents how long vehicle should not move with engine ON.
 
* 11206 - To To Moving (s). Represents how long vehicle should be moving with engine ON, to exit  idle state.
 
* 7033 - ID of SMS recipient.
 
* 8033 - SMS Text.
 
  
 +
This SMS will set up Your device to send Trip, Eco/Green driving, and Excessive idling data to Your previously provided server.
  
'''Quick start:''' From default configuration to GPS electronic logbook records in one SMS:
+
'''Note''': Before SMS text, two space symbols should be inserted if no SMS username or password was set in [[FMB001_SMS/Call_settings|SMS / Call settings]].
  
"  setparam '''11800''':1;'''11801''':0;'''11806''':1;'''11000''':2;'''11007''':1;'''11200''':2"
+
===3. BTAPP Mobile application===
 
 
This SMS will set up Your device to send Trip, Eco/Green driving and Excessive idling data to Your previously provided server.
 
 
 
'''Note''': Before SMS text, two space symbols should be inserted if no SMS username or password was set in SMS / Call settings.
 
 
 
=== BTAPP Mobile application ===
 
 
[[File:Business private.png|left|thumb|253x253px]]
 
[[File:Business private.png|left|thumb|253x253px]]
After making configuration for Your device, it is time to [[BTAPP Mobile application|'''download BTAPP''']]. Keep in mind, app and device connection is established via Blue-tooth. Devices by default come with Blue-tooth enabled and visible. After pairing to device - You can change the trip type of Your trips by performing a long press on the icon and confirming the change.
+
After making configuration for Your device, it is time to [[BTAPP Mobile application|'''download BTAPP''']]. Keep in mind, app and device connection is established via Blue-tooth. Devices by default come with Bluetooth® enabled and visible. After pairing to the device - You can change the trip type of Your trips by performing a long press on the icon and confirming the change.
 
+
<br>
 
+
<br>
 
+
<br>
 
+
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
  
 +
==Parsing information==
  
 +
==='''1. Prerequisites:'''===
  
 +
==== 1.1. Open [[Opening TCP/UDP port|TCP/UDP port]] ====
  
 +
==== 1.2. Go to [[Java Parser First Start Guide|Java parser first start guide]] ====
  
== Parsing GPS electronic logbook records ==
+
==='''2.Parsing example:'''===
 
 
=== Prerequisites ===
 
First of all, in order to parse packets with GPS electronic logbook records it is mandatory to open TCP or UDP port. Instructions can be found [[Opening TCP/UDP port|'''here''']].
 
 
 
After establishing TCP or UDP port, packets can be parsed automatically. In order to learn how it is done, please visit '''[[Java Parser First Start Guide]]'''.
 
 
 
=== Parsing example ===
 
 
{| class="nd-othertables_2" style="width:100%;"
 
{| class="nd-othertables_2" style="width:100%;"
 
! rowspan="1" style="width:100%; vertical-align: middle; text-align: center;" |Unparsed received data in hexadecimal stream
 
! rowspan="1" style="width:100%; vertical-align: middle; text-align: center;" |Unparsed received data in hexadecimal stream
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" | 000000000000004608010000017501DAF828010F0E4792209AC4FB00C200D70C0000<span style="background:#0b9768">F9</span>0D06EF01F00
+
| style="vertical-align: middle; text-align: center;" | 000000000000005E08010000017716AE03D8010F0F22D720982E9C007E00120A002F<span style="background:#0b9768">FD</span>1609E
01503C8004501<span style="background:#0b9768">F900</span>B50005B6000342334D43000044000002F10000601A100000000000010000732E
+
F01F00150011505C80045010101<span style="background:#0b9768">FD</span><span style="background:#0b9768">03</span><span style="background:#0b9768">FE</span><span style="background:#0b9768">23</span>0BB5000BB60006423A0018002F430F8A4400000
 +
 
 +
901301100161200EC13FBD90F0384<span style="background:#0b9768">02C7</span>000003BD<span style="background:#0b9768">1003</span>066802000100005F75
 
|}
 
|}
 
{| class="nd-othertables_2" style="width:100%;"
 
{| class="nd-othertables_2" style="width:100%;"
Line 128: Line 160:
 
! rowspan="1" style="width:50%; vertical-align: middle; text-align: center;" |HEX Code Part
 
! rowspan="1" style="width:50%; vertical-align: middle; text-align: center;" |HEX Code Part
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |Zero Bytes
+
| style="vertical-align: middle; text-align: center;" | Zero Bytes
 
| style="vertical-align: middle; text-align: center;" |00 00 00 00
 
| style="vertical-align: middle; text-align: center;" |00 00 00 00
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Data Field Length
 
| style="vertical-align: middle; text-align: center;" |Data Field Length
| style="vertical-align: middle; text-align: center;" |00 00 00 D6
+
| style="vertical-align: middle; text-align: center;" |00 00 00 5E
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Codec ID
 
| style="vertical-align: middle; text-align: center;" |Codec ID
Line 141: Line 173:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Timestamp
 
| style="vertical-align: middle; text-align: center;" |Timestamp
| style="vertical-align: middle; text-align: center;" |00 00 01 75 01 DA F8 28 (Wed Oct 07 06:58:49 UTC 2020)
+
| style="vertical-align: middle; text-align: center;" |00 00 01 77 16 AE 03 D8 (Mon Jan 18 18:07:19 UTC 2021)
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |Priority
+
| style="vertical-align: middle; text-align: center;" | Priority
 
| style="vertical-align: middle; text-align: center;" |01
 
| style="vertical-align: middle; text-align: center;" |01
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Longitude
 
| style="vertical-align: middle; text-align: center;" |Longitude
| style="vertical-align: middle; text-align: center;" |0F 0E 47 92
+
| style="vertical-align: middle; text-align: center;" |0F 0F 22 D7
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Latitude
 
| style="vertical-align: middle; text-align: center;" |Latitude
| style="vertical-align: middle; text-align: center;" |20 9A C4 FB
+
| style="vertical-align: middle; text-align: center;" |20 98 2E 9C
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Altitude
 
| style="vertical-align: middle; text-align: center;" |Altitude
| style="vertical-align: middle; text-align: center;" |00 C2
+
| style="vertical-align: middle; text-align: center;" |00 7E
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Angle
 
| style="vertical-align: middle; text-align: center;" |Angle
| style="vertical-align: middle; text-align: center;" |00 D7
+
| style="vertical-align: middle; text-align: center;" |00 12
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Satellites
 
| style="vertical-align: middle; text-align: center;" |Satellites
| style="vertical-align: middle; text-align: center;" |0C
+
| style="vertical-align: middle; text-align: center;" |0A
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Speed
 
| style="vertical-align: middle; text-align: center;" |Speed
| style="vertical-align: middle; text-align: center;" |00 00
+
| style="vertical-align: middle; text-align: center;" |00 2F
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Event IO ID
 
| style="vertical-align: middle; text-align: center;" |Event IO ID
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">F9 (AVL ID: 249, Name: Jamming)</span>
+
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">FD</span> (AVL ID: 253, Name: Green driving type)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |N of Total ID
 
| style="vertical-align: middle; text-align: center;" |N of Total ID
| style="vertical-align: middle; text-align: center;" |00 0D
+
| style="vertical-align: middle; text-align: center;" |16
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |N1 of One Byte IO
 
| style="vertical-align: middle; text-align: center;" |N1 of One Byte IO
| style="vertical-align: middle; text-align: center;" |06
+
| style="vertical-align: middle; text-align: center;" |09
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |1’st IO ID
 
| style="vertical-align: middle; text-align: center;" |1’st IO ID
Line 183: Line 215:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
 
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
| style="vertical-align: middle; text-align: center;" |00
+
| style="vertical-align: middle; text-align: center;" |01
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |3’rd IO ID
+
| style="vertical-align: middle; text-align: center;" | 3’rd IO ID
 
| style="vertical-align: middle; text-align: center;" |15 (AVL ID: 21, Name: GSM Signal)
 
| style="vertical-align: middle; text-align: center;" |15 (AVL ID: 21, Name: GSM Signal)
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
+
| style="vertical-align: middle; text-align: center;" | 3’rd IO Value
| style="vertical-align: middle; text-align: center;" |03
+
| style="vertical-align: middle; text-align: center;" |05
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |4'th IO ID
 
| style="vertical-align: middle; text-align: center;" |4'th IO ID
| style="vertical-align: middle; text-align: center;" |C8 (AVL ID: 200, Name: Sleep Mode)
+
| style="vertical-align: middle; text-align: center;" |50 (AVL ID: 80, Name: Data mode)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |4'th IO Value
 
| style="vertical-align: middle; text-align: center;" |4'th IO Value
| style="vertical-align: middle; text-align: center;" |00
+
| style="vertical-align: middle; text-align: center;" |01
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |5'th IO ID
 
| style="vertical-align: middle; text-align: center;" |5'th IO ID
| style="vertical-align: middle; text-align: center;" |45 (AVL ID: 69, Name: GNSS Status)
+
| style="vertical-align: middle; text-align: center;" |C8 (AVL ID: 200, Name: Sleep Mode)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |5'th IO Value
 
| style="vertical-align: middle; text-align: center;" |5'th IO Value
| style="vertical-align: middle; text-align: center;" |01
+
| style="vertical-align: middle; text-align: center;" | 00
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |6'th IO ID
 
| style="vertical-align: middle; text-align: center;" |6'th IO ID
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">F9 (AVL ID: 249, Name: Jamming) </span>
+
| style="vertical-align: middle; text-align: center;" |45 (AVL ID: 69, Name: GNSS Status)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |6'th IO Value
 
| style="vertical-align: middle; text-align: center;" |6'th IO Value
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 (0 – jamming stop, 1 – jamming start)</span>
+
| style="vertical-align: middle; text-align: center;" | 01
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |7'th IO ID
 +
| style="vertical-align: middle; text-align: center;" |01 (AVL ID: 1, Name: Digital Input 1)
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |N1 of Two Byte IO
+
| style="vertical-align: middle; text-align: center;" |7'th IO Value
| style="vertical-align: middle; text-align: center;" |05
+
| style="vertical-align: middle; text-align: center;" |01
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |8'th IO ID
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">FD</span> (AVL ID: 253, Name: Green driving type)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |8'th IO Value
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">03</span> (01 - harsh acceleration, 02 - harsh braking, 03 - harsh cornering)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |9'th IO ID
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">FE</span> (AVL ID: 254, Name: Green Driving Value)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |9'th IO Value
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">23</span> ( Depending on green driving type: if harsh acceleration or braking - g*100 (value 123 ->1,23g). If Green driving source is "GPS" - harsh cornering value is rad/s*100. If source is "Accelerometer" - g*100.
 +
|-
 +
| style="vertical-align: middle; text-align: center;" | N2 of Two Byte IO
 +
| style="vertical-align: middle; text-align: center;" |0B
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |1’st IO ID
 
| style="vertical-align: middle; text-align: center;" |1’st IO ID
Line 216: Line 266:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |1’st IO Value
 
| style="vertical-align: middle; text-align: center;" |1’st IO Value
| style="vertical-align: middle; text-align: center;" |00 05
+
| style="vertical-align: middle; text-align: center;" |00 0B
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
 
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
Line 222: Line 272:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
 
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
| style="vertical-align: middle; text-align: center;" |00 03
+
| style="vertical-align: middle; text-align: center;" |00 06
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |3’rd IO ID
 
| style="vertical-align: middle; text-align: center;" |3’rd IO ID
Line 228: Line 278:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
 
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
| style="vertical-align: middle; text-align: center;" |33 4D
+
| style="vertical-align: middle; text-align: center;" |3A 00
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |4'th IO ID
 
| style="vertical-align: middle; text-align: center;" |4'th IO ID
| style="vertical-align: middle; text-align: center;" |43 (AVL ID: 67, Name: Battery Voltage)
+
| style="vertical-align: middle; text-align: center;" |18 (AVL ID: 24, Name: Speed)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |4'th IO Value
 
| style="vertical-align: middle; text-align: center;" |4'th IO Value
| style="vertical-align: middle; text-align: center;" |00 00
+
| style="vertical-align: middle; text-align: center;" |00 2F
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |5'th IO ID
 
| style="vertical-align: middle; text-align: center;" |5'th IO ID
 +
| style="vertical-align: middle; text-align: center;" |43 (AVL ID: 67,Name: Battery Voltage)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |5'th IO Value
 +
| style="vertical-align: middle; text-align: center;" |0F 8A
 +
|-
 +
| style="vertical-align: middle; text-align: center;" | 6'th IO ID
 
| style="vertical-align: middle; text-align: center;" |44 (AVL ID: 68, Name: Battery Current)
 
| style="vertical-align: middle; text-align: center;" |44 (AVL ID: 68, Name: Battery Current)
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |5'th IO Value
+
| style="vertical-align: middle; text-align: center;" |6'th IO Value
 
| style="vertical-align: middle; text-align: center;" |00 00
 
| style="vertical-align: middle; text-align: center;" |00 00
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |N4 of Four Bytes IO
+
| style="vertical-align: middle; text-align: center;" |7'th IO ID
 +
| style="vertical-align: middle; text-align: center;" |09 (AVL ID: 9, Analog input 1
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |7'th IO Value
 +
| style="vertical-align: middle; text-align: center;" |01 30
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |8'th IO ID
 +
| style="vertical-align: middle; text-align: center;" |11 (AVL ID:17, Name: Axis X)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |8’th IO Value
 +
| style="vertical-align: middle; text-align: center;" |00 16
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |9'th IO ID
 +
| style="vertical-align: middle; text-align: center;" |12 (AVL ID:18, Name: Axis Y)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |9’th IO Value
 +
| style="vertical-align: middle; text-align: center;" |00 EC
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |10'th IO ID
 +
| style="vertical-align: middle; text-align: center;" |13 (AVL ID:19, Name: Axis Z)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |10'th IO Value
 +
| style="vertical-align: middle; text-align: center;" |FB D9
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |11'th IO ID
 +
| style="vertical-align: middle; text-align: center;" |0F (AVL ID: 15, Name: Eco score)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |11'th IO Value
 +
| style="vertical-align: middle; text-align: center;" |03 84
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |N4 of Four Byte IO
 
| style="vertical-align: middle; text-align: center;" |02
 
| style="vertical-align: middle; text-align: center;" |02
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |1’st IO ID
+
| style="vertical-align: middle; text-align: center;" |1'st IO ID
| style="vertical-align: middle; text-align: center;" |F1 (AVL ID: 241, Name: Active GSM Operator)
+
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">02 C7</span>(AVL ID: 199, Name: Trip Odometer)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |1’st IO Value
 
| style="vertical-align: middle; text-align: center;" |1’st IO Value
| style="vertical-align: middle; text-align: center;" |00 00 60 1A
+
| style="vertical-align: middle; text-align: center;" | 00 00 03 BD
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
 
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
| style="vertical-align: middle; text-align: center;" |10 (AVL ID: 16, Name: Total Odometer)
+
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">10 03</span>(AVL ID: 16, Name: Total Odometer)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
 
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
| style="vertical-align: middle; text-align: center;" |00 00 00 00
+
| style="vertical-align: middle; text-align: center;" |06 68 80 20
|-
 
| style="vertical-align: middle; text-align: center;" |N8 of Eight Bytes IO
 
| style="vertical-align: middle; text-align: center;" |00
 
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Number of Data 2 (Number of Total Records)
 
| style="vertical-align: middle; text-align: center;" |Number of Data 2 (Number of Total Records)
Line 264: Line 347:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |CRC-16
 
| style="vertical-align: middle; text-align: center;" |CRC-16
| style="vertical-align: middle; text-align: center;" |00 00 73 2E
+
| style="vertical-align: middle; text-align: center;" |00 00 5F 75
 
|}
 
|}
== In platform ==
+
==Demonstration in platform==
 +
Packet information can be displayed visually. In the picture below, the event location is displayed on the map. The dot on the map represents a record. By clicking on it, it is possible to see what kind of information is gathered in the particular entry.
 +
 
 +
In order to visually see received information on the platforms:
 +
 
 +
'''[[Teltonika TAVL|TAVL]]''': Open TAVL → select client → select Street Map → select device → to choose the date from which to show the records → push advanced → push show button and then you will see in the left down corner all information.
 +
[[File:Viz.png|center|thumb|1024x1024px]]
 +
 
 +
 
 +
'''[https://gurtam.com/en/wialon WIALON]''': Open WIALON → open messages → push unit ( select your device) → choose the date from which to show the records → select message  (data messages) → push execute button and you will see all information. (Note''':''' ''Figure below is an example and doesn't represent the actual visualization of the packet in the parsing example'').[[File:Wialon snip.png|center|thumb|1028x1028px]]
 +
[[Category:Usage scenarios]]
 +
 
 +
'''BTAPP''': [[File:Eco.PNG|left|thumb|600x600px]]
 +
 
 +
Bluetooth® connection to monitor and score driver behavior. Real-time events notifications about harsh acceleration, braking, cornering, overspeeding, idling, and RPM. Solution designed to improve driver behavior and productivity.
 +
 
 +
*You must connect to the FMB device by clicking the Bluetooth® icon, and selecting your FMB device.
 +
*Each event that was detected by the FMB device will be displayed in the application as well. Users can be notified visually, the event icon will turn yellow and the event count will be increased accordingly, and by sound alert as well (can be optionally enabled in application settings).
 +
*Eco score is calculated by FMB device depending on total event amount and trip distance.
 +
Eco score, distance, and duration are being updated periodically automatically.
 +
*Trip status can be Ongoing and Finished. The trip finish is decided by FMB configuration. If the application will be connected to an FMB device during an ongoing trip – the application will update event count, score, distance, and trip duration for an ongoing trip.

Latest revision as of 15:22, 28 December 2023

Main Page > General Information > Usage scenarios > GPS Electronic Logbook

Solution description

If you are one of those drivers or fleet managers who find doing your logbook a tedious and time-consuming process, we have got good news for you. Thanks to Teltonika GPS trackers, you can automate nearly the whole process by using an accurate and reliable GPS electronic logbook.

Here You will find how to prepare and test this solution.

What you need for the solution?

  • Teltonika FM device which is compatible with this use case. Recommended products are: FMB001, FMC001, FMM001, FM3001, FMB002, FMB010, FMB003, FMB020, FMP100 ( FMP100 is connected via cigarette light socket).
  • The SIM card in order to receive data to Your server.
  • Teltonika Configurator to set up FM device correctly for the solution.
  • FOTA WEB to remotely send the configuration to the device.
  • BTAPP / Driver application for Private Mode or Business Mode selection.

Installation

All of the recommended products are "Plug and Play" devices. It means that devices are directly plugged into vehicles OBDII socket and after configuration is complete - devices are set for use. Although, if plugged OBDII device is too hard to reach and vehicle parts are interfering with GPS signal or vehicle parts need to be removed/opened to access OBDII socket and afterward parts no longer fit or close - Teltonika offers OBDII extension cable. [1]

Apart from device configuration (more later) and installation into the vehicle, the GPS electronic logbook doesn't require additional hands-on work.

Configuration

1. Prerequisites:

1.1. Read through First start guide

2. Configuration of GPS electronic logbook scenario:

Gprs settings.png

Parameter ID - Parameter name

  • 2001 – APN
  • 2002 – APN username (if there are no APN username, empty field should be left)
  • 2003 – APN password (if there are no APN password, empty field should be left)


Server settings.png




Server settings:

  • 2004 – Domain
  • 2005 – Port
  • 2006 – Data sending protocol (0 – TCP, 1 – UDP



After successful GPRS/SERVER settings configuration, device will synchronize time and update records to the configured server. Time intervals and default I/O elements can be changed by using Teltonika Configurator or SMS parameters.


Trip settings.png


Configuration of Trip scenario:

  • 11800 - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).


  • 11801 - Eventual settings (0 - Disable, 1 - Enable), if disabled - trip settings will come with periodical data.
  • 11802 - Mode (0 - Continuous, 1 Between Records). If the Between Records option is selected - distance will be counted until any record is made. Then odometer will be reset to zero and start counting until the next record is made. If the Continues option is selected - the distance will continue counting between the trip start and trip stop and the odometer will not reset.
  • 11803 - Start Speed (km/h). When selecting a value for Start Speed - only after this value (speed) is exceeded, the Trip scenario will be activated. If the Start Speed value is set to 0 (km/h) - the scenario will be activated after the ignition turns on. More about ignition settings - below.
  • 11804 - Ignition OFF timeout (s).
  • 7031 - ID of SMS recipient.
  • 8031 - SMS Text.
  • 700 - Eco Score Allowed Events.


  • 11806 - Odometer Calculation Source (0 - GNSS, 1 - OBD).
  • 11807 - current Odometer Value (km). Odometer data will be counted from provided value.
Screenshot 2021-03-07 162223.png



Configuration of Ignition Source:

  • 101 - Ignition Settings ( Ignition has 14 different settings, for more information click here).

Note: if Ignition Source is selected only to Accelerometer - ignition will be activated when the vehicle starts moving. Engine RPM - cannot be used for every vehicle model. Direct OBDII devices gather information received via the OBDII socket. If the vehicle doesn't provide Engine RPM via mentioned socket - Engine RPM cannot be used as Ignition Source.

  • 104 - High Voltage ( value range: 13200 - 30000 mV).
  • 105 - Low Voltage ( value range: 0 - 29999 mV).
Green - Eco driving.png



Configuration of Eco/Green driving scenario:

  • 11000 - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).
  • 11004 - Maximum Acceleration (m/s2).
  • 11005 - Maximum Braking (m/s2)
  • 11006 - Maximum Cornering (m/s2)
  • 11007 - Source (0 - GPS, 1 - Accelerometer). Green driving scenario according to selected data source.


  • 11019 - Advanced Eco Driving (0 - Disable, 1 - Enable). If enabled, Eco Driving Average (ID.: 11011) and/or Eco Driving Maximum (ID.: 11015) settings can be changed.
  • 11008 - Eco/Green Driving Duration (0 - Disable, 1 - Enable).
  • 7034 - ID of SMS recipient.
  • 8034 - SMS Text.




Note: Maximum acceleration, braking, and cornering values should be set according to vehicle type, power, weight and etc. Best values can be approached by practical testing. E.g. testing cornering parameters - take the same turn at a different speed (30km/h, 20 km/h, 40 km/h) and check if Eco/Green Driving event has been triggered for cornering - if it feels as turning on 30km/h is harsh but the event is not triggered - lower Max Cornering values and reattempt the test.

Idlingg.png

Configuration of Excessive idling scenario:

  • 11200 - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).


  • 11203 - Eventual settings (0 - Disable, 1 - Enable), if disabled - excessive idling data will come with periodical data.
  • 11205 - Time To Stopped (s). Represents how long vehicle should not move with engine ON.
  • 11206 - To To Moving (s). Represents how long vehicle should be moving with engine ON, to exit idle state.
  • 7033 - ID of SMS recipient.
  • 8033 - SMS Text.






Quick start: From default configuration to GPS electronic logbook records in one SMS:

"  setparam 2001:APN;2002:APN_username;2003:APN_password;2004:Domain;2005:Port;2006:0;11800:1;11801:0;11806:1;11000:2;11007:1;11200:2"

This SMS will set up Your device to send Trip, Eco/Green driving, and Excessive idling data to Your previously provided server.

Note: Before SMS text, two space symbols should be inserted if no SMS username or password was set in SMS / Call settings.

3. BTAPP Mobile application

Business private.png

After making configuration for Your device, it is time to download BTAPP. Keep in mind, app and device connection is established via Blue-tooth. Devices by default come with Bluetooth® enabled and visible. After pairing to the device - You can change the trip type of Your trips by performing a long press on the icon and confirming the change.










Parsing information

1. Prerequisites:

1.1. Open TCP/UDP port

1.2. Go to Java parser first start guide

2.Parsing example:

Unparsed received data in hexadecimal stream
000000000000005E08010000017716AE03D8010F0F22D720982E9C007E00120A002FFD1609E

F01F00150011505C80045010101FD03FE230BB5000BB60006423A0018002F430F8A4400000

901301100161200EC13FBD90F038402C7000003BD1003066802000100005F75

AVL Data Packet Part HEX Code Part
Zero Bytes 00 00 00 00
Data Field Length 00 00 00 5E
Codec ID 08 (Codec 8)
Number of Data 1 (Number of Total Records) 01
Timestamp 00 00 01 77 16 AE 03 D8 (Mon Jan 18 18:07:19 UTC 2021)
Priority 01
Longitude 0F 0F 22 D7
Latitude 20 98 2E 9C
Altitude 00 7E
Angle 00 12
Satellites 0A
Speed 00 2F
Event IO ID FD (AVL ID: 253, Name: Green driving type)
N of Total ID 16
N1 of One Byte IO 09
1’st IO ID EF (AVL ID: 239, Name: Ignition)
1’st IO Value 01
2’nd IO ID F0 (AVL ID: 240, Name: Movement)
2’nd IO Value 01
3’rd IO ID 15 (AVL ID: 21, Name: GSM Signal)
3’rd IO Value 05
4'th IO ID 50 (AVL ID: 80, Name: Data mode)
4'th IO Value 01
5'th IO ID C8 (AVL ID: 200, Name: Sleep Mode)
5'th IO Value 00
6'th IO ID 45 (AVL ID: 69, Name: GNSS Status)
6'th IO Value 01
7'th IO ID 01 (AVL ID: 1, Name: Digital Input 1)
7'th IO Value 01
8'th IO ID FD (AVL ID: 253, Name: Green driving type)
8'th IO Value 03 (01 - harsh acceleration, 02 - harsh braking, 03 - harsh cornering)
9'th IO ID FE (AVL ID: 254, Name: Green Driving Value)
9'th IO Value 23 ( Depending on green driving type: if harsh acceleration or braking - g*100 (value 123 ->1,23g). If Green driving source is "GPS" - harsh cornering value is rad/s*100. If source is "Accelerometer" - g*100.
N2 of Two Byte IO 0B
1’st IO ID B5 (AVL ID: 181, Name: GNSS PDOP)
1’st IO Value 00 0B
2’nd IO ID B6 (AVL ID: 182, Name: GNSS HDOP)
2’nd IO Value 00 06
3’rd IO ID 42 (AVL ID: 66, Name: External Voltage)
3’rd IO Value 3A 00
4'th IO ID 18 (AVL ID: 24, Name: Speed)
4'th IO Value 00 2F
5'th IO ID 43 (AVL ID: 67,Name: Battery Voltage)
5'th IO Value 0F 8A
6'th IO ID 44 (AVL ID: 68, Name: Battery Current)
6'th IO Value 00 00
7'th IO ID 09 (AVL ID: 9, Analog input 1
7'th IO Value 01 30
8'th IO ID 11 (AVL ID:17, Name: Axis X)
8’th IO Value 00 16
9'th IO ID 12 (AVL ID:18, Name: Axis Y)
9’th IO Value 00 EC
10'th IO ID 13 (AVL ID:19, Name: Axis Z)
10'th IO Value FB D9
11'th IO ID 0F (AVL ID: 15, Name: Eco score)
11'th IO Value 03 84
N4 of Four Byte IO 02
1'st IO ID 02 C7(AVL ID: 199, Name: Trip Odometer)
1’st IO Value 00 00 03 BD
2’nd IO ID 10 03(AVL ID: 16, Name: Total Odometer)
2’nd IO Value 06 68 80 20
Number of Data 2 (Number of Total Records) 01
CRC-16 00 00 5F 75

Demonstration in platform

Packet information can be displayed visually. In the picture below, the event location is displayed on the map. The dot on the map represents a record. By clicking on it, it is possible to see what kind of information is gathered in the particular entry.

In order to visually see received information on the platforms:

TAVL: Open TAVL → select client → select Street Map → select device → to choose the date from which to show the records → push advanced → push show button and then you will see in the left down corner all information.

Viz.png


WIALON: Open WIALON → open messages → push unit ( select your device) → choose the date from which to show the records → select message  (data messages) → push execute button and you will see all information. (Note: Figure below is an example and doesn't represent the actual visualization of the packet in the parsing example).

Wialon snip.png

BTAPP:

Eco.PNG

Bluetooth® connection to monitor and score driver behavior. Real-time events notifications about harsh acceleration, braking, cornering, overspeeding, idling, and RPM. Solution designed to improve driver behavior and productivity.

  • You must connect to the FMB device by clicking the Bluetooth® icon, and selecting your FMB device.
  • Each event that was detected by the FMB device will be displayed in the application as well. Users can be notified visually, the event icon will turn yellow and the event count will be increased accordingly, and by sound alert as well (can be optionally enabled in application settings).
  • Eco score is calculated by FMB device depending on total event amount and trip distance.

Eco score, distance, and duration are being updated periodically automatically.

  • Trip status can be Ongoing and Finished. The trip finish is decided by FMB configuration. If the application will be connected to an FMB device during an ongoing trip – the application will update event count, score, distance, and trip duration for an ongoing trip.