Jump to content

Secure vehicle disabling: Difference between revisions

From Teltonika Telematics Wiki
No edit summary
No edit summary
 
(25 intermediate revisions by 10 users not shown)
Line 1: Line 1:
==Project description==
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.
==Introduction==
'''Secure Engine Cut Off (SECO)''' is a functionality that safely disables a vehicle’s engine based on predefined speed or movement conditions. It is typically activated remotely and used for security, immobilization, or theft prevention purposes.


We glad that you decided to test our “Secure vehicle disabling” solution.
==Solution Description==
SECO feature is available from firmware version '''03.28.02'''.  


Here you will find how to prepare and to test this solution.
Secure Engine Cut Off enhances vehicle security by allowing the engine to be disabled under controlled conditions. It helps prevent theft by stopping unauthorized movement, supports fleet security through remote immobilization when suspicious activity occurs, and limits unauthorized usage by shutting down the engine when vehicles operate outside permitted times or areas.


==What you need for a solution?==
==Solution Requirements==


* 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 (excluding FMX6 series trackers) that 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.
*SIM card for data transmition 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.
*[[Automotive_Relay|Automotive Relay]] to cut off the fuel pump.
* FOTA WEB to remotely send the configuration to the device.
*SECO functionality is only available with Teltonika FMB series GPS trackers starting with the firmware version '''03.28.02'''.
*FOTA WEB for remote configuration of the device.


==Installation==
==Installation==
The device should be installed according to the principal diagram. Connect a digital output to the relay's pin 85, the power supply to the pins 86 and 87a, and the fuel pump power cable to the pin 30.[[File:Wiring scheme.png|alt=|right|frameless|357x357px]]
It is important to position the tracker so it would not be easy to locate.
'''Note:''' Any of the digital outputs can be used for this function.


It’s important to well hide tracker, so it would not be a simple task for the thieves to find and unplug it. But also, please do not forget to follow [https://wiki.teltonika-gps.com/view/FMB130_First_Start#Mounting_recommendations mounting recommendations] as well.
Additionally, please refer to [[FMB130_First_Start#Mounting_recommendations mounting recommendations|Mounting Recommendations]] for recommended mounting instructions.
Although devices have high gain antennas it’s important to mount devices with stickers on top and in metal-free space. The device should be firmly fixed to the surface or cables. Please make sure, that device is not fixed to heat emitting or moving parts.
 
[[File:Wiring scheme.png|alt=|right|frameless|357x357px]]
 
Although devices have high gain antennas it is important to mount devices with stickers on top and in metal-free space. The device should be firmly fixed to the surface or cables. Please make sure, that device is not fixed to heat emitting or moving parts.


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 within 5 to 30.
*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 to see 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:'''===
Line 36: Line 41:
[[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)
Line 45: Line 50:
<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>
Line 57: Line 62:
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>
<br>
<br>
<br>
<br>
Line 76: Line 79:
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 added at the end of 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 is 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 is consistently lower than configured during "Speed check period". After activation digital output will be activated and disabled continuously until speed will be lower then configured in "Speed" field and longer then "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 activated (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>
<br>
<br>
<br>
<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.
Line 105: Line 100:


==SECO SMS Commands==
==SECO SMS Commands==


Secure engine cut-off (SECO) functionality is available for device with at least one DOUT.  For SECO functionality to work, DOUT must to be selected. SECO has DOUT control priority higher than immobilizer scenario.  
Secure engine cut-off (SECO) functionality is available for device with at least one DOUT.  For SECO functionality to work, DOUT must to be selected. SECO has DOUT control priority higher than immobilizer scenario.  


SECO scenario can only be enabled or disabled by SMS commands:
SECO scenario can only be enabled or disabled by SMS commands:


*"secoon" - to activate SECO functionality.
*"[[SMS/GPRS command - secoon|secoon]]" - to activate SECO functionality.
 
*"secooff" - to disable SECO functionality.


*"[[SMS/GPRS command - secooff|secooff]]" - to disable SECO functionality.


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


To SMS command <code>secooff</code> device will give response: „Seco off received. DOUTX off“.


To SMS command „secooff“ device will give response: „Seco off received. DOUTX off“.
To SMS command <code>secoon</code> response:


To SMS command „secoon“ response:
#„Seco on received. Waiting for conditions“.
#„Seco on received. DOUTX pulsing“.
#„Seco on received. DOUTX on“.


1. „Seco on received. Waiting for conditions“.
When response is not 3 all later SMS will be received.  
 
2. „Seco on received. DOUTX pulsing“.
 
3. „Seco on received. DOUTX on“.
 
When response is not 3 all later SMS will be received. Example: SMS 1 received and pulse configured, then SMS 2 will be received when speed is lower than configured and SMS 3 will be received when speed reaches 0 km/h.


'''Example:''' SMS 1 received and pulse configured, then SMS 2 will be received when speed is lower than configured and SMS 3 will be received when speed reaches 0 km/h.


'''Note:'''  Sending commands to the device without DOUT will give response "SECO not available for this device". When DOUT is not selected in configuration response will be: "Error. no DOUT configured".
'''Note:'''  Sending commands to the device without DOUT will give response "SECO not available for this device". When DOUT is not selected in configuration response will be: "Error. no DOUT configured".
Line 139: Line 129:
===2. SECO Pulse functionality===
===2. SECO Pulse functionality===


In case '''SECO pulse (12253)''' is enabled device will not activate DOUT immediately.


In sace SECO pulse (12253) is enabled device will not activate DOUT immediatly.
'''GNSS fix present''': when speed is lower than the configured '''Speed Pulse Scenario (12259)''' for the configured amount of '''time (12255)''', the device will pulse DOUT until GNSS speed reaches configured '''speed (12254)''' then DOUT will stop pulsing and stay active (ON) until „secooff“ SMS is received.
 
'''GNSS fix present''': when speed is lower than configured Speed Pulse Scenario (12259) for configured amount of time (12255), device will pulse DOUT until GNSS speed reaches configured speed (12254) then DOUT will stop pulsing and stay active (ON) until „secooff“ SMS is received.
 


'''GNSS fix unavailable:''' wait until movement timeout (12256) is reached then DOUT will stay active until „secooff“ SMS is received.
'''GNSS fix unavailable:''' wait until '''movement timeout (12256)''' is reached then DOUT will stay active until <code>secooff</code> SMS is received.


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 the device memory and check vehicle speed. When speed is lower than configured (12254) for configured amount of time (12255), device will activate configured DOUT.
After <code>secoon</code
> SMS is received, command will be saved to the device memory and check vehicle speed. When '''speed (12254)''' is lower than configured for the configured amount of '''time (12255)''', device will activate configured '''DOUT'''.


===4. GNSS fix unavailable===
===4. GNSS fix unavailable===


After <code>secoon</code> 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 SECO records==


==='''1.Prerequisites:'''===
==='''1.Prerequisites:'''===
Line 165: Line 152:
====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:'''===
{| class="nd-othertables_2" style="width:100%;"
{| class="nd-othertables_2" style="width:100%;"
|+
|+
Line 184: Line 171:
! 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
|-
|-
Line 193: Line 180:
| 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
|-
|-
Line 205: Line 192:
| 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
|-
|-
Line 217: Line 204:
| 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
Line 256: Line 243:
| 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
|-
|-
Line 274: Line 261:
| 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
|-
|-
Line 286: Line 273:
| 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
|-
|-
Line 341: Line 328:
|}
|}


==In platform==
==Demonstration in platform==
TAVL: Open TAVL → select client → select Street Map → select device → choose the date from which to which to show the records push advanced → push show button and then you will see in left down corner all information.
===TAVL===
 
Open '''TAVL''' → select '''client''' → select '''Street Map''' → select '''device''' → choose the '''date''' range select '''advanced''' select '''show'''  → information will appear in the '''bottom left''' corner.


[[File:Tavl Seco 1.png|alt=|frameless|1153x1153px]]
[[File:Tavl Seco 1.png|alt=|frameless|1153x1153px]]


[[File:Tavl Seco 2.png|alt=|frameless|1153x1153px]]
[[File:Tavl Seco 2.png|alt=|frameless|1153x1153px]]


 
===WIALON===
WIALON: Open WIALON → open messages → push unit ( select your device) → choose the date from which to show the records → select message  (data messages) → push execute button and you will see all information.
Open '''WIALON''' select '''messages''' select '''unit''' (select your device) → choose the '''date range''' → select '''message''' (data messages) → select '''execute'''.
 


[[File:Wialon Seco 1.png|alt=|frameless|1153x1153px]]
[[File:Wialon Seco 1.png|alt=|frameless|1153x1153px]]
Line 359: Line 344:
<br>
<br>
<br>
<br>
==External links==
[[Category: Usage scenarios]]
https://teltonika-gps.com/industries/use-cases/secure-vehicle-disabling-system-seco/
<br>
https://www.youtube.com/watch?v=LAvqXoVC9C4
<br>

Latest revision as of 10:34, 4 May 2026

Main Page > General Information > Usage scenarios > Secure vehicle disabling