Changes

m
Protected "FAMILY CAR TRACKING AND MONITORING WITH OBD GPS DEVICES" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)) [cascading]
Line 1: Line 1: −
FAMILY CAR TRACKING AND MONITORING WITH OBD GPS DEVICES
+
[[Category: Usage scenarios]]
 +
 
 +
==Introduction==
 +
 
 +
Private passenger cars and family vehicles global market is not only huge, but it keeps growing year after year. So, the demand for responsible driving, safety, behaviour awareness, fuel efficiency, timely maintenance, auto theft risk reduction using the latest technologies. To fulfil the needs of the B2C market, here at Teltonika Telematics we have developed the practical vehicle GPS tracking, monitoring, and messaging solution.
 +
 
 +
==Solution description==
 +
This solution makes it easy to connect your device to your vehicle. For installation, there is no need for additional equipment or skills, you just need to insert the device into the OBDII interface and you're done! Thanks to this solution, you can not only track the current location of the object, but also receive a wide range of standard OBDII parameters from the car's ECU, and thanks to the advanced FMB003 model, advanced OBD OEM (PID) parameters: odometer and fuel consumption parameters in real time from the available list of supported vehicles. The device sends the gathered data, combined with its GNSS location details, via a GSM network to a server for analysis. The data can be monitored via PC, laptop, tablet or smartphone using the dedicated software or mobile app, or both.
 +
 
 +
==What you need for a solution?==
 +
 
 +
*'''FMB003''' device ([https://teltonika-gps.com/product/fmb003/ '''FMB003''']is taken as example).
 +
{| class="mw-collapsible mw-collapsed wikitable"
 +
| Other devices that work with this solution:
 +
|-
 +
| [https://teltonika-gps.com/product/fmc001/ '''FMC001'''], [https://teltonika-gps.com/product/fmm001/ '''FMM001'''], [https://teltonika-gps.com/product/fmb001/ '''FMB001''], [https://teltonika-gps.com/product/fmb002/ '''FMB002'''], [https://teltonika-gps.com/product/fmb003/  '''FMB003'''], [https://teltonika-gps.com/product/fmb010/ '''FMB010'''], [https://teltonika-gps.com/product/fmb020/ '''FMB020''']
 +
|}
 +
 
 +
*The [https://wiki.teltonika-gps.com/view/FMB003_First_Start#How_to_insert_Nano-SIM_card_and_connect_battery '''SIM card'''] in order to get data to your server
 +
 
 +
*[https://wiki.teltonika-gps.com/view/FOTA_WEB '''FOTA WEB'''] to remotely send the configuration to the device.<br />
 +
 
 +
 
 +
 
 +
==Installation==
 +
 
 +
[[File:MountingOBD.png|thumb]]
 +
 
 +
Installing the device is easy, but don't forget about [https://wiki.teltonika-gps.com/view/FMB003_First_Start mounting recommendations] as well. If the location of the OBDll interface is in a hard-to-reach place, then you can always use a special cable to install the device in a convenient place. [https://teltonika-gps.com/product/obdii-cable/ OBDII connection extension cable]
 +
 
 +
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.
 +
 
 +
During installation please follow recommendations in order to '''avoid damaging''' device and vehicle:
 +
* The device uses SELV limited power source. The nominal voltage is +12 V DC. The allowed voltage range is +10..+30V DC.
 +
* To avoid mechanical damage, it is advised to transport the device in an impact-proof package. Before usage, the device should be placed so that its LED indicators are visible. They show the status of device operation.
 +
* Before unmounting the device from the vehicle, ignition MUST be OFF.
 +
 
 +
<br />
 +
 
 +
== How to check available OBDII data? ==
 +
 
 +
Please follow this [[How to check available OBDII data? | tutorial]] to check what OBD data is available from the vehicle
 +
How to check available OBDII data?
 +
<br>
 +
List of AVL id OBDll parameters you can find at [[FMB003_Teltonika_Data_Sending_Parameters_ID#OBD_elements| Wiki page]].
 +
<br>
 +
 
 +
==Configuration==
 +
 
 +
==='''1. Prerequisites:'''===
 +
 
 +
====1.1. Read through [https://wiki.teltonika-gps.com/view/FMB003_First_Start start guide]====
 +
====1.2. Understanding of possible [https://wiki.teltonika-gps.com/view/FMB003_Sleep_modes Sleep modes].====
 +
==='''2. OBD GPS trackers:'''===
 +
<br />
 +
 
 +
 
 +
[[File:GPRS settings.png|alt=|left|thumb|258x258px]]
 +
 
 +
'''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|alt=|left|thumb|259x259px]]
 +
 
 +
 
 +
 
 +
<br />
 +
<br />
 +
 
 +
<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 />
 +
 
 +
After successful GPRS/SERVER settings configuration, FMB003 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 [[FMB003 Parameter list|SMS parameters]].<br />
 +
 
 +
<br />
 +
 
 +
[[File:8E.png|thumb|alt=|left]]
 +
'''Data protocol settings:'''
 +
 
 +
*<span style="background:#05CC2F">113</span> – Data protocol (0 – Codec8, 1 – Codec8Extended)
 +
<br />
 +
'''Note''': To get OEM parameters, you need to use [[Codec#Codec_8_Extended|Codec8Extended]].
 +
 
 +
<br />
 +
 
 +
[[File:Online_deep_sleep_carsharing.PNG|alt=|left|thumb]]
 +
'''Sleep settings:'''
 +
<br />
 +
*<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 [[FMB003 Sleep modes#Deep%20Sleep%20mode|Deep Sleep]] and [[FMB003 Sleep modes#Ultra%20Deep%20Sleep%20mode|Ultra Sleep]] modes, since they disable the device's GSM module to save power.
 +
 
 +
<br />
 +
 
 +
 
 +
[[File:OBD.png|thumb|alt=|left]]
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
 
 +
'''OBDll settings:'''
 +
 
 +
*<span style="background-color:#E18DE7;">40000</span> – OBDll data activation, enabled by default  (0 – Disable 1 - Enable)
 +
 
 +
[[File:VINauto.png|thumb|alt=|left|455x455px]]
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
 
 +
*<span style="background-color:#dee11d;">40005</span> – VIN read mode, Auto by default  (0 – Auto 1 – Manual)
 +
 
 +
[[File:VINmanual.png|alt=|left|453x453px|thumb]]
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
 
 +
 
 +
 
 +
*<span style="background-color:#dee15d;">40003</span> – Manual VIN number entry
 +
 
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
 
 +
 
 +
[[File:OEM-VIN.png|thumb|alt=|left|452x452px]]
 +
<br />
 +
*<span style="background-color:#1de1d2;">40440</span> – OEM Fuel level, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
 +
*<span style="background-color:#e1701d;">40430</span> – OEM Total milage (Counted), Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
 +
*<span style="background-color:#1de2d2;">40410</span> – VIN, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
 +
<br />
 +
<br />
 +
<br />
 +
[[File:RPM.png|alt=|left|453x453px|thumb]]
 +
 
 +
*<span style="background-color:#bce5d7;">40160</span> – Engine RPM, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
 
 +
'''Quickstart:''' From default configuration to Car sharing solution in one SMS:
 +
"  setparam <span style="background-color:#91b9d4;">2001</span>:APN;<span style="background-color:#91d4b9;">2002</span>:APN_user;<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>:3;<span style="background:#E18DE7">40000</span>: 1;<span style="background-color:#dee11d;">40005</span>:0;<span style="background-color:#1de1d2;"> 40410</span>:1;<span style="background-color:#e1701d;"> 40160</span>:1;<span style="background-color:#bce5d7;"> 40430</span>:1;<span style="background-color:#e1701d;"> 40440</span>:1;<span style="background-color:#02BD2F;"> 113</span>:1"
 +
This SMS will set up your device to report object location to the server and possibility for read Engine RPM, VIN and OEM parameters.
 +
 
 +
'''Note''': Before SMS text, two space symbols should be inserted if no SMS username or password was set in SMS \ Call settings.
 +
 
 +
==Parsing information==
 +
 
 +
==='''1.Prerequisites:'''===
 +
 
 +
==== 1.1.  Open [https://wiki.teltonika-gps.com/view/Opening_TCP/UDP_port TCP/UDP port]====
 +
 
 +
==== 1.2.  Read Java parser  [https://wiki.teltonika-gps.com/view/Java_Parser_First_Start_Guide 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;" |02 C7(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;" |10 03(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
 +
|}
 +
 
 +
 
 +
==Demonstration in platform==
 +
'''FMBT : OBDll info'''[[File:FMBT.png|left|thumb|600x600px]]
 +
 
 +
Bluetooth's connection to monitor OBDll parameters. Real time OBDll data, events notifications about harsh acceleration, braking, cornering, overspeeding, idling, RPM etc.
 +
<br />
 +
 
 +
*You must connect to the device by clicking Bluetooth icon, and selecting your device.
 +
*Next, you need to select the OBDll info tab, where information about the car in real time will be displayed.
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
 
 +
 
 +
'''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:WialonOBD.png|thumb|left|1138x1138px]]

Navigation menu