Changes

325 bytes removed ,  16:16, 28 December 2023
m
Text replacement - "Bluetooth(?!®)" to "Bluetooth®"
Line 1: Line 1: −
=='''Project description'''==
+
==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.
 
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.
   −
=='''What you need for a solution?'''==
+
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.  
 
*All Teltonika FM devices are compatible with this use case.  
 
*The SIM card in order to receive data to Your server.
 
*The SIM card in order to receive data to Your server.
*Teltonika Configurator to set up FM device correctly for the solution.
+
*[[Teltonika Configurator]] to set up FM device correctly for the solution.
*FOTA WEB to remotely send the configuration to the device.
+
*[[FOTA WEB]] to remotely send the configuration to the device.
*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.
+
*[[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]]
 +
 
 +
 
 +
 
   −
=='''Installation'''==
     −
It is good to know that this functionality is supported by all Teltonika vehicle trackers.
      
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.  
 
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.  
  −
[[File:Led.PNG|alt=|frameless|400x400px]]
        −
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. However, in order to utilize accelerometer data correctly, the device has to perform autocalibration process, which is automatic, as the name implicates, but may take some time.
+
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.  
      Line 24: Line 30:  
Deviations of maximum +/- 15o are allowed.
 
Deviations of maximum +/- 15o are allowed.
 
Horizontal position must be as flat as possible – parallel with vehicle plain.  
 
Horizontal position must be as flat as possible – parallel with vehicle plain.  
[[File:Mount3.PNG|alt=|frameless|800x800px]]
     −
=='''Configuration'''==
+
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
==Configuration==
    
=== '''1. Prerequisites:'''===
 
=== '''1. Prerequisites:'''===
   −
===='''1.1. Read through [https://wiki.teltonika-gps.com/view/FMB920_First_Start First start guide]'''====
+
====1.1. Read through [https://wiki.teltonika-gps.com/view/FMB920_First_Start First start guide]====
    
=== '''2. Configuration of Green driving scenario:'''===
 
=== '''2. Configuration of Green driving scenario:'''===
 +
[[File:Gprs settings.png|left|thumb|229x229px]]
   −
Before configuring Green driving solution it is important to set up GPRS settings for a device.
  −
  −
===='''2.1 GPRS settings'''====
  −
[[File:GPRS settings.png|frameless|alt=|left|250x250px]]
      
Parameter ID – Parameter name GPRS settings:
 
Parameter ID – Parameter name GPRS settings:
  −
<br />
      
*<span style="background-color:#91b9d4;">2001</span> – APN
 
*<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:#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)
 
*<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|frameless|alt=|left|250x250px]]
+
[[File:Server settings.png|left|thumb|231x231px]]
<br />Server settings:
+
Server settings:
    
*<span style="background-color:#b9d491;">2004</span> – Domain
 
*<span style="background-color:#b9d491;">2004</span> – Domain
 
*<span style="background-color:#d491b9;">2005</span> – Port
 
*<span style="background-color:#d491b9;">2005</span> – Port
 
*<span style="background-color:#d4b991;">2006</span> – Data sending protocol (0 – TCP, 1 – UDP)
 
*<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.
   −
<br />
+
[[File:Greendout.PNG|left|thumb|400x400px]]
<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.
     −
===='''2.2. Configuration of Eco/Green driving scenario'''====
+
Configuration of Eco/Green driving scenario<br>''Parameter ID'' - ''Parameter name''
[[File:Green - Eco driving.png|left|thumb|348x348px]]
  −
<br>''Parameter ID'' - ''Parameter name''
   
*<span style="background-color:#b9d491;">11000</span> - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).
 
*<span style="background-color:#b9d491;">11000</span> - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).
   Line 72: Line 79:  
<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).
 +
*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.
 
*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>
 
*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>
<br>
     −
===='''2.3. Configuration of Excessive idling scenario'''====
+
[[File:Idlingdout.PNG|left|thumb|350x350px]]
[[File:Idlingg.png|left|thumb|240x240px]]
+
 
 +
 
 +
 
 +
 
      −
''Parameter ID'' - ''Parameter name''
+
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).
 
*<span style="background-color:#d4b991;">11200</span> - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).
 
<br>
 
<br>
Line 88: Line 101:  
*11206 - To Moving (s). Represents how long vehicle should be moving with engine ON, to exit  idle state.
 
*11206 - To Moving (s). Represents how long vehicle should be moving with engine ON, to exit  idle state.
 
*7033 - ID of SMS recipient.
 
*7033 - ID of SMS recipient.
*8033 - SMS Text.
+
*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.
      −
''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.
  −
*8033 - SMS Text.
     −
===='''2.4. Configuration of Over Speeding scenario'''====
+
[[File:Overdout.PNG|left|thumb|300x300px]]
[[File:Capture4444.PNG|left|thumb|240x240px]]
+
 
       +
Configuration of Over Speeding scenario
    
''Parameter ID'' - ''Parameter name''
 
''Parameter ID'' - ''Parameter name''
Line 117: Line 126:     
<br>
 
<br>
'''Quick start:''' From default configuration to [[FMB920_SMS/GPRS_Commands|Green driving records in one SMS]]:
+
'''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"
 
  "  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"
Line 123: Line 132:  
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 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 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>
Line 139: Line 148:  
<br>
 
<br>
 
<br>
 
<br>
=='''Parsing Green driving records'''==
+
==Parsing information==
    
==='''1. Prerequisites:'''===
 
==='''1. Prerequisites:'''===
   −
==== '''1.1. Open [[Opening TCP/UDP port|TCP/UDP port]] '''====
+
==== 1.1. Open [[Opening TCP/UDP port|TCP/UDP port]] ====
   −
==== '''1.2. Go to [[Java Parser First Start Guide|Java parser first start guide]]''' ====
+
==== 1.2. Go to [[Java Parser First Start Guide|Java parser first start guide]]====
    
==='''2. Parsing example:'''===
 
==='''2. Parsing example:'''===
Line 151: Line 160:  
! 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;" | 000000000000005E08010000017716AE03D8010F0F22D720982E9C007E00120A002F<span style="background:#d4b991">FD</span>1609E
+
| style="vertical-align: middle; text-align: center;" | 000000000000005E08010000017716AE03D8010F0F22D720982E9C007E00120A002F<span style="background:#0b9768">FD</span>1609E
F01F00150011505C80045010101<span style="background:#d4b991">FD</span><span style="background:#d4b991">03</span><span style="background:#d4b991">FE</span><span style="background:#d4b991">23</span>0BB5000BB60006423A0018002F430F8A4400000
+
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:#d4b991">02C7</span>000003BD<span style="background:#d4b991">1003</span>066802000100005F75
+
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 198: Line 207:  
|-
 
|-
 
| 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:#d4b991">FD</span> (AVL ID: 253, Name: Green driving type)
+
| 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
Line 249: Line 258:  
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |8'th IO ID
 
| style="vertical-align: middle; text-align: center;" |8'th IO ID
| style="vertical-align: middle; text-align: center;" |<span style="background:#d4b991">FD</span> (AVL ID: 253, Name: Green driving type)
+
| 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;" |8'th IO Value
| style="vertical-align: middle; text-align: center;" |<span style="background:#d4b991">03</span> (01 - harsh acceleration, 02 - harsh braking, 03 - harsh cornering)
+
| 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;" |9'th IO ID
| style="vertical-align: middle; text-align: center;" |<span style="background:#d4b991">FE</span> (AVL ID: 254, Name: Green Driving Value)
+
| 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;" |9'th IO Value
| style="vertical-align: middle; text-align: center;" |<span style="background:#d4b991">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;" |<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;" | N2 of Two Byte IO
Line 333: Line 342:  
|-
 
|-
 
| 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;" |02 C7</span>(AVL ID: 199, Name: Trip Odometer)
+
| 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;" |1’st IO Value
Line 339: Line 348:  
|-
 
|-
 
| 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 03</span>(AVL ID: 16, Name: Total Odometer)
+
| 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;" |2’nd IO Value
Line 351: Line 360:  
|}
 
|}
   −
=='''In platform'''==
+
==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.
 +
 
 +
 
   −
==='''1.1. 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 FMB device by clicking Blue-tooth 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).
  −
*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.
  −
*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.
        Line 373: Line 384:       −
==='''1.2. 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.
+
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]]
 
[[File:Tavlito.PNG|alt=|frameless|1000x1000px]]
   −
==='''1.3. 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]]
+
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]]