Difference between revisions of "Anti-Theft Solution and Stolen Vehicle Recovery"

From Wiki Knowledge Base | Teltonika GPS
m (Correction of supported devices. FMC and FMM now support jamming according to datasheet.)
(27 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 
+
==Project description ==
__TOC__
 
 
 
==Disclaimer==
 
 
 
[[File:Alert.png|left|link=]] <br> If you are not using Bluetooth®, '''please consider turning it off''' or '''change Bluetooth® PIN''' to remove potential risks.
 
 
 
If you are using Bluetooth® we strongly recommend '''using AES encryption''' for enhanced security.
 
 
 
==Solution description==
 
 
Vehicle theft is one of the world’s fastest-growing crimes as thieves turn to use highly advanced equipment, e.g. jammers. By jamming GSM signals, the criminals aim to interfere and inhibit the performance of a tracking device – its ability to monitor and gather important information. Luckily, Teltonika trackers have a functionality that can detect jamming and help to prevent theft or to recover a stolen vehicle.
 
Vehicle theft is one of the world’s fastest-growing crimes as thieves turn to use highly advanced equipment, e.g. jammers. By jamming GSM signals, the criminals aim to interfere and inhibit the performance of a tracking device – its ability to monitor and gather important information. Luckily, Teltonika trackers have a functionality that can detect jamming and help to prevent theft or to recover a stolen vehicle.
  
We are glad that you decide to test our “Anti-Theft and stolen vehicle recovery” solution.  
+
We glad that you decide to test our “Anti-Theft and stole vehicle recovery” solution.  
 
+
Here you will find how to prepare and to test this solution.
Here you will find how to prepare and test this solution.
 
  
 
==What you need for a solution?==
 
==What you need for a solution?==
 +
# Anti-Theft solution is supported by any of Teltonika device, which has DOUT
 +
# The SIM card in order to get data to your server
 +
# Relay, which will be controlled by DOUT and depending on which option you will choose, will turn on the alarm, disable engine start or lock doors. The relay can be ordered from Teltonika. Please contact your sales representative. If you will order it by yourself please make sure for which voltage range relay support.
 +
# FMB configurator, to configure the device in order to work with this solution.
 +
# FOTA WEB to remotely send the configuration to the device.
  
*The anti-theft solution is supported by '''FMBxyz''' series (including FMB640), '''FMUxyz''', '''FMCxyz''' and '''FMMxyz Teltonika devices, which have DOUT''' which in this scenario is used to connect a buzzer or use starter cut-off relay.
 
  
*The SIM card in order to get data to your server
+
==Installation==
*Relay, which will be controlled by DOUT may turn on the alarm, disable engine start, or lock doors. Please contact your sales representative to order the relay from Teltonika. If you want to use your own relay please double-check the type of relay and its supported voltage range. FMB platform configurator, to configure the device in order to work with this solution.
 
*FOTA WEB to remotely send the configuration to the device.<br />
 
  
==Installation==
+
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 mounting recommendations as well.
  
It’s important to well hide the 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/FMB920_First_Start#Mounting_recommendations mounting recommendations] as well.
 
[[File:FMB900-FMB920 wiring scheme 1.1.png|alt=|right|frameless|357x357px]]
 
 
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.
 
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.
  
 +
[[image:FMB920_1_demo.png|500px]]
  
To have a working solution it’s important to properly make wiring.
+
To have a working solution it’s important to properly make wairing.
  
As the main solution accessory is a relay, please make sure that the right contacts are connected
+
As the main solution accessory is a relay, please make sure that right contacts are connected
  
  
During installation please follow recommendations in order to avoid damaging device and vehicle:
+
[[image:Theft_solution_relay.png|150px]]
  
*Wires should be connected while the module is not plugged in.
+
Contact 86 and 87a should be connected to vehicle power, 85 to Teltonika device DOUT which corresponds to the ground and when jamming is detected is activated by device and contact should be connected to start, alarm or door lock
*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.
 
*The ground wire is connected to the vehicle frame or metal parts that are fixed to the frame.<br>
 
  
==Configuration==
+
[[image:Theft_solution_buzz.png]]
  
==='''1. Prerequisites:'''===
 
  
====1.1. Read through [https://wiki.teltonika-gps.com/view/FMB920_First_Start First start guide]====
+
During installation please follow recommendations in order to avoid damage device and vehicle:
====1.2. Understanding of possible [https://wiki.teltonika-gps.com/view/FMB920_System_settings#Sleep_Mode Sleep modes].====
+
• Wires should be connected while the module is not plugged in. <br>
<br />
+
• 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. <br>
 +
• When the module is connected, be sure to measure the voltage again if it did not decrease. <br>
 +
• Ground wire is connected to the vehicle frame or metal parts that are fixed to the frame. <br>
  
==='''2. Configuring Jamming scenario'''===
+
==Configuration==
[[File:GPRS settings.png|frameless|alt=|left|250x250px]]
+
<br>
 
+
* Please do not worry that the device is already mounted to the vehicle, you can make offline configuration and with FOTA WEB solution remotely send it to the device. <br>
Parameter ID – Parameter name GPRS settings:
+
Please make sure, that sleep mode is disabled as jamming scenarios do not work while the device is in sleep mode.  
 
+
'''To read more about sleep mode  [[FMB204_Sleep_modes|press here]]'''
<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, 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]].  
 
<br /><br />
 
[[File:Sleep_mode.png|alt=|frameless|left]]
 
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)
 
*'''Note''': This scenario will not work with [[FMB920 Sleep modes#Deep%20Sleep%20mode|Deep Sleep]] and [[FMB920 Sleep modes#Ultra%20Deep%20Sleep%20mode|Ultra Deep Sleep]] modes, since they disable the device's GSM module to save power.
 
 
 
<br />
 
<br />
 
[[File:Jamming_settings.png|alt=|frameless|250x250px|left]]
 
Jamming scenario settings:
 
 
 
*<span style="background:#E18DE7">11300</span> – Scenario priority
 
*11303 – Eventual settings (0 – Disable, 1 – Enable)
 
*<span style="background:#24FFD4">11304</span> – Output Control (0 – None, 1  – DOUT1, 2 – DOUT2, 3 – DOUT3)
 
*11301 – DOUT ON Duration (ms)
 
*11302– DOUT OFF Duration (ms)
 
*11305 – Time Until Jamming Event Detection (s)
 
 
 
'''Note''': It's not recommended to set 11305 parameter to a very value(few seconds) because jamming scenario might be triggered while driving in the city.
 
<br />
 
<br />'''Quickstart:''' From default configuration to Jamming 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:#05CC6F">102</span>:1;<span style="background:#E18DE7">11300</span>:2;<span style="background:#24FFD4">11304</span>:1"
 
  
This SMS will set up your device to report the Jamming Detection scenario to the server and toggle ON DOUT1 during jamming.
+
[[image:Sleep_mode.gif|250px]]
  
'''Note''': Before SMS text, two space symbols should be inserted if no SMS username or password was set in SMS \ Call settings.
+
* Please select the proper ignition source. We recommend the use of Digitial input 1. But in case if during installation you do not connect DIN you can use power voltage as well, just select low and hight values depending on your vehicle.
==Parsing information==
+
'''More information about ignition source [[FMB920_System_settings#Ignition_Source|press here]]'''
  
==='''1.Prerequisites:'''===
+
[[image:Ignition_settings.gif|250px]]
  
==== 1.1.  Open [https://wiki.teltonika-gps.com/view/Opening_TCP/UDP_port TCP/UDP port]====
+
* In the GPRS tab, you need to configure your SIM card APN settings, server and make sure, that FOTA WEB is enabled.  
 +
'''More information about GPRS settings [[FMB920_GPRS_settings|press here|200px]]'''
  
==== 1.2. Go to [https://wiki.teltonika-gps.com/view/Java_Parser_First_Start_Guide Java parser first start guide]====
+
Please make sure that GPRS context is enabled and enter your SIM card provider APN settings:
  
=== '''2. Parsing example:''' ===
+
[[image:Theft_solution_gprs.png|250px]]
{| 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;" |000000000000004608010000017501DAF828010F0E4792209AC4FB00C200D70C0000<span style="background:#0b9768">F9</span>0D06EF01F00
 
01503C8004501<span style="background:#0b9768">F900</span>B50005B6000342334D43000044000002F10000601A100000000000010000732E
 
|-
 
|}
 
  
 +
* Configure the server to which device should send data:
  
{| class="nd-othertables_2" style="width:100%;"
+
[[image:Theft_solution_server_settings.png|250px]]
|+
 
! colspan="2" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |AVL Data Packet
 
|-
 
! 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 D6
 
|-
 
| 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 75 01 DA F8 28 (Wed Oct 07 06:58:49 UTC 2020)
 
|-
 
| 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 0E 47 92
 
|-
 
| style="vertical-align: middle; text-align: center;" |Latitude
 
| style="vertical-align: middle; text-align: center;" |20 9A C4 FB
 
|-
 
| style="vertical-align: middle; text-align: center;" |Altitude
 
| style="vertical-align: middle; text-align: center;" |00 C2
 
|-
 
| style="vertical-align: middle; text-align: center;" |Angle
 
| style="vertical-align: middle; text-align: center;" |00 D7
 
|-
 
| style="vertical-align: middle; text-align: center;" |Satellites
 
| style="vertical-align: middle; text-align: center;" |0C
 
|-
 
| style="vertical-align: middle; text-align: center;" |Speed
 
| style="vertical-align: middle; text-align: center;" |00 00
 
|-
 
| style="vertical-align: middle; text-align: center;" |Event IO ID
 
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">F9 (AVL ID: 249, Name: Jamming)</span>
 
|-
 
| style="vertical-align: middle; text-align: center;" |N of Total ID
 
| style="vertical-align: middle; text-align: center;" |0D
 
|-
 
| style="vertical-align: middle; text-align: center;" |N1 of One Byte IO
 
| style="vertical-align: middle; text-align: center;" |06
 
|-
 
| 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;" |00
 
|-
 
| 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;" |03
 
|-
 
| style="vertical-align: middle; text-align: center;" |4'th IO ID
 
| style="vertical-align: middle; text-align: center;" |C8 (AVL ID: 200, Name: Sleep Mode)
 
|-
 
| style="vertical-align: middle; text-align: center;" |4'th IO Value
 
| style="vertical-align: middle; text-align: center;" |00
 
|-
 
| style="vertical-align: middle; text-align: center;" |5'th IO ID
 
| style="vertical-align: middle; text-align: center;" |45 (AVL ID: 69, Name: GNSS Status)
 
|-
 
| style="vertical-align: middle; text-align: center;" |5'th IO Value
 
| style="vertical-align: middle; text-align: center;" |01
 
|-
 
| style="vertical-align: middle; text-align: center;" |6'th IO ID
 
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">F9 (AVL ID: 249, Name: Jamming) </span>
 
|-
 
| style="vertical-align: middle; text-align: center;" |6'th IO Value
 
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 (0 – jamming stop, 1 – jamming start)</span>
 
|-
 
| style="vertical-align: middle; text-align: center;" |N1 of Two Byte IO
 
| style="vertical-align: middle; text-align: center;" |05
 
|-
 
| 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 05
 
|-
 
| 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 03
 
|-
 
| 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;" |33 4D
 
|-
 
| style="vertical-align: middle; text-align: center;" |4'th IO ID
 
| style="vertical-align: middle; text-align: center;" |43 (AVL ID: 67, Name: Battery Voltage)
 
|-
 
| style="vertical-align: middle; text-align: center;" |4'th IO Value
 
| style="vertical-align: middle; text-align: center;" |00 00
 
|-
 
| style="vertical-align: middle; text-align: center;" |5'th IO ID
 
| style="vertical-align: middle; text-align: center;" |44 (AVL ID: 68, Name: Battery Current)
 
|-
 
| style="vertical-align: middle; text-align: center;" |5'th IO Value
 
| style="vertical-align: middle; text-align: center;" |00 00
 
|-
 
| style="vertical-align: middle; text-align: center;" |N4 of Four Bytes 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;" |F1 (AVL ID: 241, Name: Active GSM Operator)
 
|-
 
| style="vertical-align: middle; text-align: center;" |1’st IO Value
 
| style="vertical-align: middle; text-align: center;" |00 00 60 1A
 
|-
 
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
 
| style="vertical-align: middle; text-align: center;" |10 (AVL ID: 16, Name: Total Odometer)
 
|-
 
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
 
| style="vertical-align: middle; text-align: center;" |00 00 00 00
 
|-
 
| style="vertical-align: middle; text-align: center;" |N8 of Eight Bytes IO
 
| style="vertical-align: middle; text-align: center;" |00
 
|-
 
| 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 73 2E
 
|-
 
|}
 
  
==Demonstration in platform==
+
* Make sure that FOTA WEB is enabled
  
TAVL: Open TAVL → select client → select Street Map → select device → choose the date from which to show the records → push advanced → push show button and then you will see in left down corner all information.
+
[[image:Theft_solution_fota.png|250px]]
  
[[File:TAVL_jamming.png|alt=|frameless|1153x1153px]]
+
* In Feature tab you need configure Jamming scenario which will detect GSM signal jamming ant control DOUT in order to turn on the alarm, lock door, or disable engine start.
 +
'''More information about Jamming [[FMB920_Features_settings#Jamming|press here]]'''
  
 +
* When the configuration is ready you need to upload it to the device. Please login to fm.teltonika.lt. If you do not have logins please contact your sales representative.
  
 +
1. In FOTA WEB upload your created configuration file:
  
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.
+
[[image:Theft_solution_fota1.png|250px]]
[[File:Wialonturbo.jpg|left|frameless|1155x1155px]]
 
  
 +
2. Select the device and assign configuration:
  
[[Category: Usage scenarios]]
+
[[image:Theft_solution_fota2.png|500px]]

Revision as of 13:59, 28 May 2020

Main Page > General Information > Usage scenarios > Anti-Theft Solution and Stolen Vehicle Recovery

Project description

Vehicle theft is one of the world’s fastest-growing crimes as thieves turn to use highly advanced equipment, e.g. jammers. By jamming GSM signals, the criminals aim to interfere and inhibit the performance of a tracking device – its ability to monitor and gather important information. Luckily, Teltonika trackers have a functionality that can detect jamming and help to prevent theft or to recover a stolen vehicle.

We glad that you decide to test our “Anti-Theft and stole vehicle recovery” solution. Here you will find how to prepare and to test this solution.

What you need for a solution?

  1. Anti-Theft solution is supported by any of Teltonika device, which has DOUT
  2. The SIM card in order to get data to your server
  3. Relay, which will be controlled by DOUT and depending on which option you will choose, will turn on the alarm, disable engine start or lock doors. The relay can be ordered from Teltonika. Please contact your sales representative. If you will order it by yourself please make sure for which voltage range relay support.
  4. FMB configurator, to configure the device in order to work with this solution.
  5. FOTA WEB to remotely send the configuration to the device.


Installation

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 mounting recommendations as well.

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.

FMB920 1 demo.png

To have a working solution it’s important to properly make wairing.

As the main solution accessory is a relay, please make sure that right contacts are connected


Theft solution relay.png

Contact 86 and 87a should be connected to vehicle power, 85 to Teltonika device DOUT which corresponds to the ground and when jamming is detected is activated by device and contact should be connected to start, alarm or door lock

Theft solution buzz.png


During installation please follow recommendations in order to avoid damage device and vehicle: • 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.
• When the module is connected, be sure to measure the voltage again if it did not decrease.
• Ground wire is connected to the vehicle frame or metal parts that are fixed to the frame.

Configuration


  • Please do not worry that the device is already mounted to the vehicle, you can make offline configuration and with FOTA WEB solution remotely send it to the device.

Please make sure, that sleep mode is disabled as jamming scenarios do not work while the device is in sleep mode. To read more about sleep mode press here

Sleep mode.gif

  • Please select the proper ignition source. We recommend the use of Digitial input 1. But in case if during installation you do not connect DIN you can use power voltage as well, just select low and hight values depending on your vehicle.

More information about ignition source press here

Ignition settings.gif

  • In the GPRS tab, you need to configure your SIM card APN settings, server and make sure, that FOTA WEB is enabled.

More information about GPRS settings press here|200px

Please make sure that GPRS context is enabled and enter your SIM card provider APN settings:

Theft solution gprs.png

  • Configure the server to which device should send data:

Theft solution server settings.png

  • Make sure that FOTA WEB is enabled

Theft solution fota.png

  • In Feature tab you need configure Jamming scenario which will detect GSM signal jamming ant control DOUT in order to turn on the alarm, lock door, or disable engine start.

More information about Jamming press here

  • When the configuration is ready you need to upload it to the device. Please login to fm.teltonika.lt. If you do not have logins please contact your sales representative.

1. In FOTA WEB upload your created configuration file:

Theft solution fota1.png

2. Select the device and assign configuration:

Theft solution fota2.png