View source for Green Driving Solution

==Solution description==
Growing world population and development of new technologies contribute to the growth in use of transport. Driving style is one of the factors directly influencing fuel consumption and vehicle life, e.g. aggressive acceleration, harsh braking, harsh cornering and over speeding. Inefficient driving produces more exhaust gas emissions, thus, increasing the negative environmental impact on our planet.

FYI

This solution helps to get only those parameters that are broadcast on the bus, and does not require sending a request command to get this parameter

==What you need for a solution?==
*All Teltonika FM devices are compatible with this use case. 
*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 to monitor and score driver behavior. Real time events notifications about harsh acceleration, braking, cornering, over speeding, idling and RPM. Solution designed to improve driver behavior and productivity.

==Installation==
[[File:Led.PNG|alt=|left|frameless|455x455px]]






Green driving functionality that collects data on acceleration, braking, over speeding, harsh cornering and no-load engine operation. This information is instantly analyzed. If the received values are beyond the set parameters, the device sends a command to the LED or Buzzer installed in the driver’s cab and alerts that he or she is driving inefficiently. In case of the driver alert function, please note that the device must have DOUT for this feature to work. 


There are two sources for Green Driving operation – GPS data and accelerometer. The desired one can be selected in Configurator. GPS data is pretty reliable and does not require any additional effort to make it work. On the other side, accelerometer data is more precise and ensures uninterrupted operation even when GPS signal is not available, for example, in tunnels or underground parking lots. 


What is also very important for green driving to work properly, device connection pins socket must point towards the vehicles front side. Deviations of +/- 2o are allowed. But it should be as straight as possible.
Deviations of maximum +/- 15o are allowed.
Horizontal position must be as flat as possible – parallel with vehicle plain. 








==Configuration==

=== '''1. Prerequisites:'''===

====1.1. Read through [https://wiki.teltonika-gps.com/view/FMB920_First_Start First start guide]====

=== '''2. Configuration of Green driving scenario:'''===
[[File:Gprs settings.png|left|thumb|229x229px]]


Parameter ID – Parameter name GPRS settings:

*<span style="background-color:#91b9d4;">2001</span> – APN
*<span style="background-color:#91d4b9;">2002</span> – APN username (if there are no APN username, empty field should be left)
*<span style="background-color:#b991d4;">2003</span> – APN password (if there are no APN password, empty field should be left)
<br />
<br />

[[File:Server settings.png|left|thumb|231x231px]]
Server settings:

*<span style="background-color:#b9d491;">2004</span> – Domain
*<span style="background-color:#d491b9;">2005</span> – Port
*<span style="background-color:#d4b991;">2006</span> – Data sending protocol (0 – TCP, 1 – UDP)
<br />
<br />After successful GPRS/SERVER settings configuration, FMB920 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]]. 
After familiarizing with devices first start guide and device's GPRS settings are set - configuration for Green driving can be done.

[[File:Greendout.PNG|left|thumb|400x400px]]


Configuration of Eco/Green driving scenario<br>''Parameter ID'' - ''Parameter name''
*<span style="background-color:#b9d491;">11000</span> - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).

*11004 - Maximum Acceleration (m/s<sup>2</sup>).
*11005 - Maximum Braking (m/s<sup>2</sup>)
*11006 - Maximum Cornering (m/s<sup>2</sup>)

*<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.
*11008 - Eco/Green Driving Duration (0 - Disable, 1 - Enable).
*11003 - (None - if event happens, it will not effect DOUT state; DOUT1 - Digital output 1 will be activated; DOUT2 - Digital output 2 will be activated)
*11001 - DOUT on duration
*11002 - DOUT off duration
*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.<br>

[[File:Idlingdout.PNG|left|thumb|350x350px]]






Configuration of Excessive Idling scenario
Parameter ID - Parameter name
*<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.
*11205 - Time To Stopped (s). Represents how long vehicle should not move with engine ON.
*11206 - To Moving (s). Represents how long vehicle should be moving with engine ON, to exit  idle state.
*7033 - ID of SMS recipient.
*11204 - (None - if event happens, it will not effect DOUT state; DOUT1 - Digital output 1 will be activated; DOUT2 - Digital output 2 will be activated)
*11201 - For how long DOUT should be active.
*11202 - For how long DOUT should be inactive. 
*7033 - 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.



[[File:Overdout.PNG|left|thumb|300x300px]]



Configuration of Over Speeding scenario

''Parameter ID'' - ''Parameter name''
*<span style="background-color:#d4b991;">11100</span> - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).
<br>
*11104 - Max speed (Default value - 90, Value range 0-260, Value - km/h)
*13217 - Speed source (0 - GNSS, 1 - OBD, 2 - Pulse counter).
*13223 - Overspeeding hysteresis (Default value - 28, Value range 0 - 100)
*11101 - DOUT ON duration
*11102 - DOUT OFF duration
*7032 - ID of SMS recipient.
*8032 - SMS Text.

<br>
'''Quick start:''' From default configuration to Green driving records in one [[FMB920 SMS/GPRS Commands|SMS]]:

 "  setparam <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;<span style="background-color:#d4b991;">11100</span>: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 [[FMB001_SMS/Call_settings|SMS / Call settings]].

===3. BTAPP Mobile application===
[[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 Bluetooth®. 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.
<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]]====

==='''2. Parsing example:'''===
{| class="nd-othertables_2" style="width:100%;"
! rowspan="1" style="width:100%; vertical-align: middle; text-align: center;" |Unparsed received data in hexadecimal stream
|-
| style="vertical-align: middle; text-align: center;" | 000000000000005E08010000017716AE03D8010F0F22D720982E9C007E00120A002F<span style="background:#0b9768">FD</span>1609E
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%;"
|-
! rowspan="1" style="width:50%; vertical-align: middle; text-align: center;" |AVL Data Packet 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;" |00 00 00 00
|-
| style="vertical-align: middle; text-align: center;" |Data Field Length
| 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;" |08 (Codec 8)
|-
| style="vertical-align: middle; text-align: center;" |Number of Data 1 (Number of Total Records)
| style="vertical-align: middle; text-align: center;" |01
|-
| style="vertical-align: middle; text-align: center;" |Timestamp
| 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;" |01
|-
| style="vertical-align: middle; text-align: center;" |Longitude
| 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;" |20 98 2E 9C
|-
| style="vertical-align: middle; text-align: center;" |Altitude
| style="vertical-align: middle; text-align: center;" |00 7E
|-
| style="vertical-align: middle; text-align: center;" |Angle
| style="vertical-align: middle; text-align: center;" |00 12
|-
| style="vertical-align: middle; text-align: center;" |Satellites
| style="vertical-align: middle; text-align: center;" |0A
|-
| style="vertical-align: middle; text-align: center;" |Speed
| 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;" |<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;" |16
|-
| style="vertical-align: middle; text-align: center;" |N1 of One Byte IO
| 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;" |EF (AVL ID: 239, Name: Ignition)
|-
| style="vertical-align: middle; text-align: center;" |1’st IO Value
| style="vertical-align: middle; text-align: center;" |01
|-
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
| style="vertical-align: middle; text-align: center;" |F0  (AVL ID: 240, Name: Movement)
|-
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
| 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;" |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;" |05
|-
| style="vertical-align: middle; text-align: center;" |4'th IO ID
| 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;" |01
|-
| style="vertical-align: middle; text-align: center;" |5'th IO ID
| 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;" | 00
|-
| style="vertical-align: middle; text-align: center;" |6'th IO ID
| 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;" | 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;" |7'th IO Value
| 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;" |B5 (AVL ID: 181, Name: GNSS PDOP)
|-
| style="vertical-align: middle; text-align: center;" |1’st IO Value
| 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;" |B6 (AVL ID: 182, Name: GNSS HDOP)
|-
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
| 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;" |42 (AVL ID: 66, Name: External Voltage)
|-
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
| 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;" |18 (AVL ID: 24, Name: Speed)
|-
| style="vertical-align: middle; text-align: center;" |4'th IO Value
| 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;" |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;" |6'th IO Value
| style="vertical-align: middle; text-align: center;" |00 00
|-
| 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;" |1'st IO ID
| style="vertical-align: middle; text-align: center;" |02 C7(AVL ID: 199, Name: Trip Odometer)
|-
| style="vertical-align: middle; text-align: center;" |1’st IO Value
| 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;" |10 03(AVL ID: 16, Name: Total Odometer)
|-
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
| style="vertical-align: middle; text-align: center;" |06 68 80 20
|-
| style="vertical-align: middle; text-align: center;" |Number of Data 2 (Number of Total Records)
| style="vertical-align: middle; text-align: center;" |01
|-
| style="vertical-align: middle; text-align: center;" |CRC-16
| style="vertical-align: middle; text-align: center;" |00 00 5F 75
|}

==Demonstration in platform==
BTAPP: ECO driving:[[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 device by clicking Bluetooth® icon, and selecting your device.
*Each event that was detected by our 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).
*Eco score is calculated by devices depending on total event amount and trip distance.
Eco score, distance, and duration is being updated periodically automatically.
*Trip status can be Ongoing and Finished. The trip finish is decided by device configuration. If the application will be connected to device during an ongoing trip – the application will update event count, score, distance, and trip duration for an ongoing trip.















TAVL: Open TAVL application → Select Client → Select Device → Select the date interval → Select Track→ Select Advanced → Chose Show button see in left down corner all the information.

[[File:Tavlito.PNG|alt=|frameless|1000x1000px]]



WIALON: Open WIALON → Open Messages → Select your device → Select the date interval → Select Message (data messages) → Select execute and you will see all the information.[[File:Turbo kosmos.jpg|left|frameless|1138x1138px]]

[[Category: Usage scenarios]]