Changes
→Solution description
==Solution description==
==Introduction==
Motor vehicle theft is one of the world’s biggest concerns and the fastest growing crimes in many countries around the world. This great challenge for car rental agencies, car sharing clubs, businesses, state organizations and private car owners caused properly losses of over 6 billion US dollar globally in 2018. Luckily for them, Teltonika GPS trackers gave a remote secure engine cut-off (SECO) functionality that can help to recover a stolen vehicle and prevent the loss.
Motor vehicle theft is one of the world’s biggest concerns and the fastest growing crimes in many countries around the world. This great challenge for car rental agencies, car sharing clubs, businesses, state organizations and private car owners caused properly losses of over 6 billion US dollar globally in 2018. Luckily for them, Teltonika GPS trackers gave a remote secure engine cut-off (SECO) functionality that can help to recover a stolen vehicle and prevent the loss.
We glad that you decided to test our “Secure vehicle disabling” solution.
We glad that you decided to test our “Secure vehicle disabling” solution.
Here you will find how to prepare and to test this solution.
Here you will find how to prepare and to test this solution.
==Solution description ==
This solution is intended to stop the stolen vehicle regardless of the thief's actions. Best way to do so is to disable fuel pump in order to prevent vehicle to be driven further away. However, disconnecting fuel pump on high speed will definitely cause an accident and innocent people may be harmed.
Therefore we came up with a logic how to force vehicle to stop without causing an accident. Pulsing digital output disables fuel pump in intervals until vehicle slows down to configured speed from which pump is fully disabled.
==What you need for a solution?==
==What you need for a solution?==
* The secure vehicle disabling solution is supported by '''any Teltonika FMB series tracker which has''' one or more '''digital output''' (DOUT) which in this scenario is used to control fuel pump of the car.
*The secure vehicle disabling solution is supported by '''any Teltonika FMB series tracker which has''' one or more '''digital output''' (DOUT) which in this scenario is used to control fuel pump of the car.
* The SIM card in order to get data to your server.
*The SIM card in order to get data to your server.
* The secure engine cut-off (SECO) functionality is only available in Teltonika FMB series GPS trackers starting with the firmware version 03.25.10.Rev.111 or higher.
*The secure engine cut-off (SECO) functionality is only available in Teltonika FMB series GPS trackers starting with the firmware version 03.25.10.Rev.111.
* FOTA WEB to remotely send the configuration to the device.
*FOTA WEB to remotely send the configuration to the device.
==Installation==
==Installation==
During installation please follow recommendations in order to avoid damaging device and vehicle:
During installation please follow recommendations in order to avoid damaging device and vehicle:
*Wires should be connected while the module is not plugged in.
* Wires should be connected while the module is not plugged in.
*Be sure that after the car computer falls asleep, power is still available on the chosen wire. Depending on the car, this may happen in a 5 to 30 minutes period.
*Be sure that after the car computer falls asleep, power is still available on the chosen wire. Depending on the car, this may happen in a 5 to 30 minutes period.
*When the module is connected, be sure to measure the voltage again if it did not decrease.
*When the module is connected, be sure to measure the voltage again if it did not decrease.
*The ground wire is connected to the vehicle frame or metal parts that are fixed to the frame.
*The ground wire is connected to the vehicle frame or metal parts that are fixed to the frame.
==Configuration==
== Configuration==
==='''1. Prerequisites:'''===
==='''1. Prerequisites:'''===
====1.1. Read through [https://wiki.teltonika-gps.com/view/FMB130_First_Start First start guide]====
====1.1. Read through [https://wiki.teltonika-gps.com/view/FMB130_First_Start First start guide]====
====1.2. Understanding of possible [https://wiki.teltonika-gps.com/view/FMB130_System_settings#Sleep_Mode Sleep modes].====
==== 1.2. Understanding of possible [https://wiki.teltonika-gps.com/view/FMB130_System_settings#Sleep_Mode Sleep modes].====
==='''2. Configuring SECO scenario'''===
==='''2. Configuring SECO scenario'''===
[[File:GPRS settings.png|alt=|left|257x257px|thumb]]
[[File:GPRS settings.png|alt=|left|257x257px|thumb]]
Parameter ID - Parameter name GPRS settings:<br>
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|alt=|left|258x258px|thumb]]Server settings:
[[File:SERVER settings.png|alt=|left|258x258px|thumb]]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)<br>
*<span style="background-color:#d4b991;">2006</span> – Data sending protocol (0 – TCP, 1 – UDP)<br>
System settings:
System settings:
<br>
<br>
*<span style="background:#E18DE7">113</span> - Data protocol
*<span style="background:#E18DE7">113</span> - Data protocol (0 – Codec 8, 1 – Codec 8 Extended)
<br>
<br>
[[File:Sleep_mode.png|alt=|left|thumb]]
[[File:Sleep_mode.png|alt=|left|thumb]]
<br>
<br>
Sleep settings:
Sleep settings:
*<span style="background:#05CC6F">102</span> – Sleep settings(0 – Disable, 1 – Gps sleep, 2 – Deep sleep, 3 – Online Deep sleep, 4 – Ultra sleep)
*<span style="background:#05CC6F">102</span> – Sleep settings (0 – Disable, 1 – Gps sleep, 2 – Deep sleep, 3 – Online Deep sleep, 4 – Ultra sleep)
<br>
<br>
<br>
<br>
SECO scenario settings:
SECO scenario settings:
<br>
<br>
*<span style="background:#E18DE7">12250</span> – Scenario priority
*<span style="background:#E18DE7">12250</span> – Scenario priority (0 - Disable, 1 - Low, 2 - High, 3 - Panic).
* 12251 – Eventual settings (0 – Disable, 1 – Enable)
*12251 – Eventual settings (0 – Disable, 1 – Enable), if disabled - scenario status value will be appended in each AVL record.
*<span style="background:#24FFD4">12252</span> – Output Control (0 – None, 1 – DOUT1, 2 – DOUT2, 3 – DOUT3)
*<span style="background:#24FFD4">12252</span> – Output Control (0 – None, 1 – DOUT1, 2 – DOUT2, 3 – DOUT3)
*12254 - Speed (km/h)
*12254 - Speed (km/h). Digital output will be activated if vehicle speed consistently lower than configured during speed check period.
*12259 - Speed Pulse Scenario (km/h)
*12259 - Speed Pulse Scenario (km/h). Valid if "Output Pulse" feature enabled. Scenario will be activated if vehicle speed consistently lower than configured during speed check period. After activation digital output will be enabled and disabled continuously until speed will be lower then configured in "Speed" field and for longed period of time then configured "Speed check period".
*12255 - Speed check period (s)
* 12255 - Speed check period (s). Time span during which vehicle speed must be lower than configured for output to activate.
*12256 - Movement timeout (s)
*12256 - Movement timeout (s). Accelerometer's instant movement timeout after which output will be generated (GNSS OFF).
*12253 - Output Pulse (0 – Disable, 1 – Enable)
*12253 - Output Pulse (0 – Disable, 1 – Enable). Pulse scenario adds additional output control which helps to slow down vehicle before fully disabling fuel pump.
* 12257 – DOUT ON Duration (ms)
*12257 – DOUT ON Duration (ms)
*12258 – DOUT OFF Duration (ms)
* 12258 – DOUT OFF Duration (ms)
* 7377 - Send SMS To
*7377 - Send SMS To
*8377 – SMS text
*8377 – SMS text<br>
<br>
<br>
<br>
'''Quick start''': From default configuration to SECO detection in one SMS:
'''Quick start''': From default configuration to SECO detection in one SMS:
" setparam <span style="background-color:#91b9d4;">2001</span>:APN;<span style="background-color:#91d4b9;">2002</span>:APN_username;<span style="background-color:#b991d4;">2003</span>:APN_password;<span style="background-color:#b9d491;">2004</span>:Domain;<span style="background-color:#d491b9;">2005</span>:Port;<span style="background-color:#d4b991;">2006</span>:0;<span style="background:#E18DE7">113</span>:1;<span style="background:#05CC6F">102</span>:1;<span style="background:#E18DE7">12250</span>:2;<span style="background:#24FFD4">12252</span>:1"
" setparam <span style="background-color:#91b9d4;">2001</span>:APN;<span style="background-color:#91d4b9;">2002</span>:APN_username;<span style="background-color:#b991d4;">2003</span>:APN_password;<span style="background-color:#b9d491;">2004</span>:Domain;<span style="background-color:#d491b9;">2005</span>:Port;<span style="background-color:#d4b991;">2006</span>:0;<span style="background:#E18DE7">113</span>:1;<span style="background:#05CC6F">102</span>:1;<span style="background:#E18DE7">12250</span>:2;<span style="background:#24FFD4">12252</span>:1"
This SMS will set up your device for Secure Vehicle Disabling scenario - remote secure engine cut-off (SECO) functionality.
This SMS will set up your device for Secure Vehicle Disabling scenario - remote secure engine cut-off (SECO) functionality.
'''Note''': Before SMS text, two space symbols should be inserted if no SMS username or password was set in SMS \ Call settings.
'''Note''': Before SMS text, two space symbols should be inserted if no SMS username or password was set in SMS \ Call settings.
==SECO SMS Commands==
== SECO SMS Commands==
The structure of sending SMS commands: [[FMB130 SMS/GPRS Commands]]
The structure of sending SMS commands: [[FMB130 SMS/GPRS Commands]]
===1. SMS responses ===
===1. SMS responses===
In case SECO pulse is disabled while pulsing, device will activate DOUT.
In case SECO pulse is disabled while pulsing, device will activate DOUT.
===3. GNSS fix available ===
===3. GNSS fix available===
After "secoon" SMS is received, command will be saved to device memory and movement timeout. When movement timeout (12256) is reached, device will activate configured DOUT.
After "secoon" SMS is received, command will be saved to device memory and movement timeout. When movement timeout (12256) is reached, device will activate configured DOUT.
==Parsing information==
==Parsing information ==
==='''1.Prerequisites:'''===
==='''1.Prerequisites:'''===
====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%;"
{| class="nd-othertables_2" style="width:100%;"
|+
|+
! rowspan="1" style="width:50%; vertical-align: middle; text-align: center;" |HEX Code 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;" |Zero Bytes
| style="vertical-align: middle; text-align: center;" |00 00 00 00
| 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;" |Data Field Length
| style="vertical-align: middle; text-align: center;" |00 00 00 67
| style="vertical-align: middle; text-align: center;" |00 00 00 67
|-
|-
| style="vertical-align: middle; text-align: center;" |8E (Codec 8 Extended)
| style="vertical-align: middle; text-align: center;" |8E (Codec 8 Extended)
|-
|-
| style="vertical-align: middle; text-align: center;" | Number of Data 1 (Records)
| style="vertical-align: middle; text-align: center;" |Number of Data 1 (Records)
| style="vertical-align: middle; text-align: center;" |02
| style="vertical-align: middle; text-align: center;" |02
|-
|-
| style="vertical-align: middle; text-align: center;" |0F 12 67 D2
| style="vertical-align: middle; text-align: center;" |0F 12 67 D2
|-
|-
| style="vertical-align: middle; text-align: center;" | Latitude
| style="vertical-align: middle; text-align: center;" |Latitude
| style="vertical-align: middle; text-align: center;" |20 97 9F C6
| style="vertical-align: middle; text-align: center;" | 20 97 9F C6
|-
|-
| style="vertical-align: middle; text-align: center;" |Altitude
| style="vertical-align: middle; text-align: center;" |Altitude
| style="vertical-align: middle; text-align: center;" |00 BE
| style="vertical-align: middle; text-align: center;" |00 BE
|-
|-
| style="vertical-align: middle; text-align: center;" |Angle
| style="vertical-align: middle; text-align: center;" | Angle
| style="vertical-align: middle; text-align: center;" |00 C1
| style="vertical-align: middle; text-align: center;" |00 C1
|-
|-
| style="vertical-align: middle; text-align: center;" |Satellites
| style="vertical-align: middle; text-align: center;" |Satellites
| style="vertical-align: middle; text-align: center;" |05
| style="vertical-align: middle; text-align: center;" | 05
|-
|-
| style="vertical-align: middle; text-align: center;" | Speed
| style="vertical-align: middle; text-align: center;" |Speed
| style="vertical-align: middle; text-align: center;" | 00 28
| style="vertical-align: middle; text-align: center;" | 00 28
|-
|-
| 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:#0b9768">01 8C (AVL ID: 396, Name: Seco)</span>
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">01 8C (AVL ID: 396, Name: Seco)</span>
|-
|-
| style="vertical-align: middle; text-align: center;" | of Total ID
| style="vertical-align: middle; text-align: center;" |of Total ID
| style="vertical-align: middle; text-align: center;" |00 04
| style="vertical-align: middle; text-align: center;" | 00 04
|-
|-
| style="vertical-align: middle; text-align: center;" |of One Byte IO
| style="vertical-align: middle; text-align: center;" |of One Byte IO
| style="vertical-align: middle; text-align: center;" | 00 04
| style="vertical-align: middle; text-align: center;" |00 04
|-
|-
| 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;" |1’st IO Value
| 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;" | 01
|-
|-
| 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;" |00 00
| style="vertical-align: middle; text-align: center;" |00 00
|-
|-
| style="vertical-align: middle; text-align: center;" | N4 of Two Bytes IO
| style="vertical-align: middle; text-align: center;" |N4 of Two Bytes IO
| style="vertical-align: middle; text-align: center;" |00 00
| style="vertical-align: middle; text-align: center;" |00 00
|-
|-
| style="vertical-align: middle; text-align: center;" | N8 of Two Bytes IO
| style="vertical-align: middle; text-align: center;" |N8 of Two Bytes IO
| style="vertical-align: middle; text-align: center;" |00 00
| style="vertical-align: middle; text-align: center;" |00 00
|-
|-
| style="vertical-align: middle; text-align: center;" |01
| style="vertical-align: middle; text-align: center;" |01
|-
|-
| style="vertical-align: middle; text-align: center;" |Longitude
| style="vertical-align: middle; text-align: center;" | Longitude
| style="vertical-align: middle; text-align: center;" |0F 12 66 3
| style="vertical-align: middle; text-align: center;" |0F 12 66 3
|-
|-
| style="vertical-align: middle; text-align: center;" | Latitude
| style="vertical-align: middle; text-align: center;" |Latitude
| style="vertical-align: middle; text-align: center;" |20 97 9B FF
| style="vertical-align: middle; text-align: center;" | 20 97 9B FF
|-
|-
| style="vertical-align: middle; text-align: center;" |Altitude
| style="vertical-align: middle; text-align: center;" |Altitude
| style="vertical-align: middle; text-align: center;" |00 BE
| style="vertical-align: middle; text-align: center;" |00 BE
|-
|-
| style="vertical-align: middle; text-align: center;" |Angle
| style="vertical-align: middle; text-align: center;" | Angle
| style="vertical-align: middle; text-align: center;" |00 C1
| style="vertical-align: middle; text-align: center;" |00 C1
|-
|-
| style="vertical-align: middle; text-align: center;" |Satellites
| style="vertical-align: middle; text-align: center;" |Satellites
| style="vertical-align: middle; text-align: center;" |05
| style="vertical-align: middle; text-align: center;" | 05
|-
|-
| style="vertical-align: middle; text-align: center;" | Speed
| style="vertical-align: middle; text-align: center;" |Speed
| style="vertical-align: middle; text-align: center;" | 00 28
| style="vertical-align: middle; text-align: center;" | 00 28
|-
|-
| 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:#0b9768">01 8C (AVL ID: 396, Name: Seco)</span>
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">01 8C (AVL ID: 396, Name: Seco)</span>
|-
|-
| style="vertical-align: middle; text-align: center;" | of Total ID
| style="vertical-align: middle; text-align: center;" |of Total ID
| style="vertical-align: middle; text-align: center;" |00 04
| style="vertical-align: middle; text-align: center;" | 00 04
|-
|-
| style="vertical-align: middle; text-align: center;" | of One Byte IO
| style="vertical-align: middle; text-align: center;" |of One Byte IO
| style="vertical-align: middle; text-align: center;" |00 04
| style="vertical-align: middle; text-align: center;" |00 04
|-
|-