3,261
edits
Changes
no edit summary
== Project description ==
==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.
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 to test this solution.
Here You will find how to prepare and test this solution.
==What will You need for the solution?==
==What will You need for the solution?==
==Installation==
==Installation==
All 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 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 afterwards parts no longer fit or close - Teltonika offers OBDII extension cable. [https://teltonika-gps.com/product/obdii-cable/]
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 vehicle, GPS electronic logbook doesn't require additional hands on work.
Apart from device configuration (more later) and installation into the vehicle, the GPS electronic logbook doesn't require additional hands-on work.
==Configuration==
==Configuration==
*<span style="background-color:#91d4b9;">11801</span> - Eventual settings (0 - Disable, 1 - Enable), if disabled - trip settings will come with periodical data.
*<span style="background-color:#91d4b9;">11801</span> - 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. If ''Continues'' option is selected - distance will continue counting between trip start and trip stop and odometer will not reset.
*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 value for Start Speed - only after this value (speed) is exceeded, Trip scenario will be activated. If Start Speed value is set to 0 (km/h) - scenario will be activated after ignitions turns on. ''More about ignition settings - below.''
*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).
*11804 - Ignition OFF timeout (s).
* 7031 - ID of SMS recipient.
* 7031 - ID of SMS recipient.
* 101 - Ignition Settings ( Ignition has 14 different settings, for more information click [[FMB001 Parameter list|'''here''']]).
* 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 vehicle starts moving. Engine RPM - cannot be used for every vehicle model. Direct OBDII devices gather information received via OBDII socket. If vehicle doesn't provide Engine RPM via mentioned socket - Engine RPM cannot be used as Ignition Source.
'''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).
* 104 - High Voltage ( value range: 13200 - 30000 mV).
<br>
<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).
<br />
<br />
<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 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 event is not triggered - lower Max Cornering values and reattempt the test.<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>
<br>
[[File:Idlingg.png|left|thumb|240x240px]]
[[File:Idlingg.png|left|thumb|240x240px]]
" 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"
" 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"
This SMS will set up Your device to send Trip, Eco/Green driving and Excessive idling data to Your previously provided server.
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 [[FMB001_SMS/Call_settings|SMS / Call settings]].
'''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]].
===3. BTAPP Mobile application===
===3. 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 Bluetooth 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>
==Parsing GPS electronic logbook records==
==Parsing informations==
==='''1. Prerequisites:'''===
==='''1. Prerequisites:'''===
| style="vertical-align: middle; text-align: center;" |00 00 5F 75
| 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, event location is displayed on the map. 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.
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:
In order to visually see received information on the platforms:
'''[[Teltonika TAVL|TAVL]]''': Open TAVL → select client → select Street Map → select device → choose the date from which to which to show the records → push advanced → push show button and then you will see in left down corner all information.
'''[[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]]
[[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 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]]
'''[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]]
[[Category:Usage scenarios]]
'''BTAPP''': [[File:Eco.PNG|left|thumb|600x600px]]
'''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.
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 Bluetooth icon, and selecting your FMB device.
*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, event icon will turn yellow and event count will be increased accordingly, and by sound alert as well (can be optionally enabled in application settings).
*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 is calculated by FMB device depending on total event amount and trip distance.
Eco score, distance, and duration is being updated periodically automatically.
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 FMB device during an ongoing trip – the application will update event count, score, distance, and trip duration for an ongoing trip.
*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.
