Changes

Green Driving Solution (view source)

Revision as of 12:47, 31 January 2021

20,235 bytes added ,  12:47, 31 January 2021
no edit summary
Line 10: Line 10:     
==Installation==
 
==Installation==
−
It is good to know that this functionality is supported by all Teltonika vehicle trackers. In case of the driver alert function, please note that the device must have DOUT for this feature to work.
+
 
−
Configuration:
+
It is good to know that this functionality is supported by all Teltonika vehicle trackers.  
−
It is easily enabled and parameterized in our Configurator.
+
 
 +
In case of the driver alert function, please note that the device must have DOUT for this feature to work.
 +
 
 +
What is also important, 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.
 +
 
 +
==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:===
 +
 
 +
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:
 +
 
 +
<br />
 +
 
 +
*<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)
 +
 
 +
[[File:SERVER settings.png|frameless|alt=|left|250x250px]]
 +
<br />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.
 +
 
 +
===='''2.2. Configuration of Eco/Green driving scenario'''====
 +
[[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).
 +
 
 +
*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).
 +
*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>
 +
<br>
 +
 
 +
===='''2.3. Configuration of Excessive idling scenario'''====
 +
[[File:Idlingg.png|left|thumb|240x240px]]
 +
 
 +
 
 +
''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 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:Idlingg.png|left|thumb|240x240px]]
 +
 
 +
 
 +
''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 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>
 +
'''Quick start:''' From default configuration to [[FMB920_SMS/GPRS_Commands|Green driving records in one 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"
 +
 
 +
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 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.
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
==Parsing Green driving records==
 +
 
 +
==='''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;" |<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;" | 00 00 03 BD
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
 +
| 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;" |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
 +
|}
 +
 
 +
 
 +
 
 +
 
 +
[[Image:EcoGreen_Driving.gif|{{{general|size}}}|right]]<br>
 +
 
 +
When vehicle parameters exceed the values of ''Max Acceleration'', ''Max Braking'' or ''Max Cornering'' parameters, the scenario is activated: a record is generated, and digital output status is changed to 1 when configured. You can configure all three parameters in m/s<sup>2</sup> units. The scenario is activated until the current Acceleration, Braking, or Cornering value decreases below the set parameter value.<br />Parameters used with ''Eco/Green Driving'' functionality are given in a table below.
 +
 
 +
<table class="nd-othertables" style="width: 68%;">
 +
<tr>
 +
        <th style="width: 10%; text-align:left; vertical-align:middle; color:black">Parameter name</th>
 +
        <th style="width: 20%; text-align:center; vertical-align:middle; color:black">Description</th>
 +
    </tr>
 +
<tr>
 +
        <td style="width: 8%; text-align:left;">Scenario Settings</td>
 +
        <td style="width: 8%; text-align:left">Enable/Disable Green driving functionality</td>
 +
    </tr>
 +
<tr>
 +
        <td style="width: 8%; text-align:left">Max Acceleration</td>
 +
        <td style="width: 8%; text-align:left">Value which can be reached while accelerating without triggering harsh acceleration event.</td>
 +
    </tr>
 +
<tr>
 +
        <td style="width: 8%; text-align:left">Max Braking Acceleration</td>
 +
        <td style="width: 8%; text-align:left">Value which can be reached while braking without triggering harsh braking event.</td>
 +
    </tr>
 +
<tr>
 +
        <td style="width: 8%; text-align:left">Max Cornering Acceleration</td>
 +
        <td style="width: 8%; text-align:left">Value which can be reached while cornering without triggering harsh cornering event.</td>
 +
    </tr>
 +
<tr>
 +
        <td style="width: 8%; text-align:left">Source</td>
 +
        <td style="width: 8%; text-align:left">Which source (GPS or accelerometer) data will be collected from.</td>
 +
    </tr>
 +
{{{txt_advanced|<tr>
 +
        <td style="width: 8%; text-align:left">[[{{{model|FMB1YX}}} Features settings#Advanced Eco Driving|Advanced Eco Driving]]</td>
 +
        <td style="width: 8%; text-align:left">When this parameter is enabled device uses an advanced Eco Driving algorithm and sends different IO (maximum, average) elements instead of IO to server. More details about this option is decribed below.</td>
 +
    </tr>}}}
 +
<tr>
 +
        <td style="width: 8%; text-align:left">Eco/Green Driving Duration</td>
 +
        <td style="width: 8%; text-align:left">If enabled, additional record with Eco/Green Driving event duration (ms) will be saved and send to server. When GPS is selected as the data source duration accuracy will be in seconds.</td>
 +
    </tr>
 +
{{{txt_ecodout|<tr>
 +
        <td style="width: 8%; text-align:left">Output Control</td>
 +
        <td style="width: 8%; text-align:left">Which [[{{{model|FMB1YX}}}]] Digital Output will be used for accesory (buzzer, LED and etc.) activation/deactivation.</td>
 +
    </tr>
 +
<tr>
 +
        <td style="width: 8%; text-align:left">DOUT ON Duration</td>
 +
        <td style="width: 8%; text-align:left">A value in miliseconds (ms), for how long DOUT should be active.</td>
 +
    </tr>
 +
<tr>
 +
        <td style="width: 8%; text-align:left">DOUT OFF Duration</td>
 +
        <td style="width: 8%; text-align:left">A value in miliseconds (ms), for how long DOUT should be inactive.</td>
 +
    </tr>}}}
 +
<!--<tr>
 +
        <td style="width: 8%; text-align:left">Send SMS to</td>
 +
        <td style="width: 8%; text-align:left">GSM number of receiver which will get notifications of Eco/Green Driving feature.</td>
 +
    </tr>
 +
<tr>
 +
        <td style="width: 8%; text-align:left">SMS Text</td>
 +
        <td style="width: 8%; text-align:left">SMS text, which the receiver will get.</td>
 +
    </tr> -->
 +
</table>
KarolisKru
0

edits

Retrieved from "https://wiki.teltonika-gps.com/view/Special:MobileDiff/62535"

Navigation menu