Changes

1,618 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.

+

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.

+

*[[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]]

+

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.

+

−

~~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.~~

−

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==

Line 23: Line 44:

====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:

−

~~ ~~

*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)

+

+

−

[[File:~~SERVER~~ settings.png|~~frameless~~|~~alt=|left~~|~~250x250px~~]]

+

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

−

~~ ~~Server settings:

+

Server settings:

*2004 – Domain

*2005 – Port

*2006 – Data sending protocol (0 – TCP, 1 – UDP)

+

+

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]]

−

~~ ~~

−

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 ''Parameter ID'' - ''Parameter name''

−

~~[[File:Green - Eco driving.png|left|thumb|348x348px]]~~

−

''Parameter ID'' - ''Parameter name''

*11000 - Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).

Line 63: Line 79:

*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.

*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.

−

~~ ~~

−

~~===='''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

*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.

+

*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.

+

*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. '''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]]

−

~~''Parameter ID'' - ''Parameter name''~~

−

*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.

−

~~===='''2.4. Configuration of Over Speeding scenario'''====~~

−

~~[[File:Idlingg.png|left|thumb|240x240px]]~~

+

Configuration of Over Speeding scenario

''Parameter ID'' - ''Parameter name''

−

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

+

*11100 - 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~~.

+

*11104 - Max speed (Default value - 90, Value range 0-260, Value - km/h)

−

*~~11205~~ - ~~Time To Stopped~~ (s)~~. Represents how long vehicle should not move with engine~~ ON.

+

*13217 - Speed source (0 - GNSS, 1 - OBD, 2 - Pulse counter).

−

*~~11206~~ - ~~To To Moving (s). Represents how long vehicle should be moving with engine ON, to exit idle state.~~

+

*13223 - Overspeeding hysteresis (Default value - 28, Value range 0 - 100)

−

*~~7033~~ - ID of SMS recipient.

+

*11101 - DOUT ON duration

−

*~~8033~~ - SMS Text.

+

*11102 - DOUT OFF duration

+

*7032 - ID of SMS recipient.

+

*8032 - SMS Text.

−

'''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 11800:1;11801:0;11806:1;11000:2;11007:1;11200:2"

+

" setparam 11800:1;11801:0;11806:1;11000:2;11007:1;11200:2;11100: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]].

+

'''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.

+

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.

Line 127: Line 148:

−

==Parsing ~~Green driving records~~==

+

==Parsing information==

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

Line 133: Line 154:

==== 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:'''===

{| class="nd-othertables_2" style="width:100%;"

! rowspan="1" style="width:100%; vertical-align: middle; text-align: center;" |Unparsed received data in hexadecimal stream

Line 321: Line 342:

|-

| 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;" |02 C7(AVL ID: 199, Name: Trip Odometer)

|-

| style="vertical-align: middle; text-align: center;" |1’st IO Value

Line 327: Line 348:

|-

| 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;" |10 03(AVL ID: 16, Name: Total Odometer)

|-

| style="vertical-align: middle; text-align: center;" |2’nd IO Value

Line 339: Line 360:

|}

+

==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]]

−

~~[[Image:EcoGreen_Driving.gif|{{{general|size}}}|right]] ~~

−

~~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/s2 units. The scenario is activated until~~ the ~~current Acceleration, Braking, or Cornering value decreases below the set parameter value~~.~~ Parameters used with ''Eco/Green Driving'' functionality are given in a table below~~.

+

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]]

−

~~<table class="nd-othertables" style="width: 68%;">~~

+

[[Category: Usage scenarios]]

−

~~<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>~~

Arnas.Zeb

Administrators

4,745

edits

Changes

Green Driving Solution (view source)

Revision as of 16:16, 28 December 2023