Difference between revisions of "Car Sharing Solution"

From Wiki Knowledge Base | Teltonika GPS
 
(66 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 +
==Disclaimer==
  
==Project description==
+
[[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.
Recently, we have seen the development of car-sharing services used by private individuals, companies and public institutions alike. These client groups, even though different, all seek comfortable and efficient use of vehicles. Reasons to use such services include fleet optimization, convenience, a sudden need for vehicles, business trips, trips abroad, etc. Also, such matters as car insurance, tire change, maintenance, or car wash are taken care of for the client. We're glad that you have decided to test our “Car Sharing” solution.
+
 
 +
If you are using Bluetooth® we strongly recommend '''using AES encryption''' for enhanced security.
 +
 
 +
 
 +
==Introduction==
 +
 
 +
Recently, we have seen the development of car-sharing services used by private individuals, companies, and public institutions alike. These client groups, even though different, all seek comfortable and efficient use of vehicles. Reasons to use such services include fleet optimization, convenience, a sudden need for vehicles, business trips, trips abroad, etc. Also, such matters as car insurance, tire change, maintenance, or car wash are taken care of for the client. We're glad that you have decided to test our “Car Sharing” solution.
 +
 
 +
==Solution description==
 +
This solution allows vehicles to be used in car-sharing businesses by monitoring vehicles location and other useful parameters from the vehicle's CAN-BUS such as fuel level, speed, odometer, etc. The most important feature is the ability to lock and unlock the vehicle on demand without a key which is an essential feature for car-sharing businesses. To use this solution FMX1XY device paired with a CAN-CONTROL adapter is needed to allow data to be read from the vehicle and most importantly for door locking and unlocking to be accessible remotely via smartphone or server.
 +
 
 +
'''Note''': Active parameters are not sent when Ignition is Off when ODS, DS or UDS are configured because communication from device is turned off to conserve battery or lower consumption. To receive parameters - GPS sleep can be used, or no sleep should be used. GPS sleep only turns off GNSS part, everything else is left in operation. However, the consumption of this sleep mode is the highest.
 +
 
 +
Parameter list: [[FMB130 CAN adapters#Send%20data%20with%200.2C%20if%20ignition%20is%20off|https://wiki.teltonika-gps.com/view/FMB130_CAN_adapters#Send_data_with_0.2C_if_ignition_is_off]]
  
 
==What you need for a solution?==
 
==What you need for a solution?==
  
*'''FMB130''' which in this scenario is used to connect to a CAN-CONTROL adapter.
+
*'''FMx1YX''' device ([https://wiki.teltonika-gps.com/view/FMB130 '''FMB130''']is taken as example) which is used to connect to a CAN-CONTROL adapter.
*The '''SIM card''' in order to get data to your server
+
{| class="mw-collapsible mw-collapsed wikitable"
*'''CAN-CONTROL adapter'''. The adapter allows you to control car doors and it works with many of our products
+
| Other devices that work with this solution:
*'''FOTA WEB''' to remotely send the configuration to the device.<br />
+
|-
 +
| [https://wiki.teltonika-gps.com/view/FMB110 '''FMB110'''], [https://wiki.teltonika-gps.com/view/FMB120 '''FMB120'''], [https://wiki.teltonika-gps.com/view/FMB122 '''FMB122'''], [https://wiki.teltonika-gps.com/view/FMB125 '''FMB125'''], [https://wiki.teltonika-gps.com/view/FMU125 '''FMU125'''], [https://wiki.teltonika-gps.com/view/FMC125 '''FMC125'''], [https://wiki.teltonika-gps.com/view/FMM125 '''FMM125'''], [https://wiki.teltonika-gps.com/view/FMU130 '''FMU130'''], [https://wiki.teltonika-gps.com/view/FMC130 '''FMC130'''], [https://wiki.teltonika-gps.com/view/FMM130 '''FMM130'''], [https://wiki.teltonika-gps.com/view/FMU126 '''FMU126''']
 +
|}
 +
 
 +
*The [https://wiki.teltonika-gps.com/view/FMB130_First_Start#How_to_insert_Micro-SIM_card '''SIM card'''] in order to get data to your server
 +
*[https://wiki.teltonika-gps.com/view/CAN-CONTROL '''CAN-CONTROL adapter''']. The adapter allows you to control car doors and it works with many of our products
 +
*[https://wiki.teltonika-gps.com/view/FOTA_WEB '''FOTA WEB'''] to remotely send the configuration to the device.<br />
  
 
==Installation==
 
==Installation==
  
 
It’s important to 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/FMB130_First_Start#Mounting_recommendations mounting recommendations] as well.
 
It’s important to 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/FMB130_First_Start#Mounting_recommendations mounting recommendations] as well.
[[File:Can-control_connection_example_updated.png|alt=|right|frameless|760x357px]]
 
  
 
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.
  
 +
The main accessory for the solution is '''CAN-CONTROL adapter''', please make sure that the right contacts are connected. Also, check more detailed information [https://wiki.teltonika-gps.com/view/FMB130_CAN_adapters#Installing_LV-CAN200.2FALL-CAN300.2FCAN-CONTROL here] and [https://wiki.teltonika-gps.com/wikibase/images/f/f1/CANCONTROL_list_2020_09_16_en.pdf supported vehicle list].
  
To have a working solution it’s important to properly wire the devices.
+
To have a working solution it’s important to properly wire the devices. In the picture below it's shown how to correctly wire the devices.
 
 
The main accessory for the solution is '''CAN-CONTROL adapter''', please make sure that right contacts are connected. Also check more detailed information [https://wiki.teltonika-gps.com/view/FMB130_CAN_adapters#Installing_LV-CAN200.2FALL-CAN300.2FCAN-CONTROL here] and [https://wiki.teltonika-gps.com/wikibase/images/f/f1/CANCONTROL_list_2020_09_16_en.pdf supported vehicle list].
 
  
 +
[[File:Can-control_connection_example_updated.png|alt=|middle|frameless|1100x357px]]
  
 
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:
Line 36: Line 55:
 
====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_Sleep_modes Sleep modes].====
 
====1.2. Understanding of possible [https://wiki.teltonika-gps.com/view/FMB130_Sleep_modes Sleep modes].====
 
+
==='''2. Car sharing configuration:'''===
==='''2. Configuration:'''===
+
[[File:GPRS settings.png|alt=|left|thumb|258x258px]]
 
 
====2.1. Car sharing configuration====
 
[[File:GPRS settings.png|frameless|alt=|left|250x250px]]
 
  
 
Parameter ID – Parameter name GPRS settings:
 
Parameter ID – Parameter name GPRS settings:
Line 50: Line 66:
 
*<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)
  
[[File:SERVER settings.png|frameless|alt=|left|250x250px]]
+
[[File:SERVER settings.png|alt=|left|thumb|259x259px]]
 +
 
 +
 
 +
 
 
<br />Server settings:
 
<br />Server settings:
  
Line 58: Line 77:
  
 
<br />
 
<br />
<br />
 
  
After successful GPRS/SERVER settings configuration, FMB130 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 [[FMB130 Parameter list|SMS parameters]].
 
  
<br /><br />
+
 
[[File:Sleep_mode.png|alt=|frameless|left]]
+
 
 +
 
 +
 
 +
After successful GPRS/SERVER settings configuration, FMB130 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 [[FMB130 Parameter list|SMS parameters]].<br />
 +
[[File:Online_deep_sleep_carsharing.PNG|alt=|left|thumb]]
 +
 
 +
 
 
Sleep settings:
 
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)
 
*<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 [[FMB130 Sleep modes#Deep%20Sleep%20mode|Deep Sleep]], [[FMB130 Sleep modes#Ultra%20Deep%20Sleep%20mode|Ultra Deep Sleep]] and [[FMB130 Sleep modes#Online%20Deep%20Sleep%20mode|Online Deep Sleep]] modes, since they disable the device's GSM module to save power.
+
'''Note''': This scenario will not work with [[FMB130 Sleep modes#Deep%20Sleep%20mode|Deep Sleep]] and [[FMB130 Sleep modes#Ultra%20Deep%20Sleep%20mode|Ultra Sleep]] modes, since they disable the device's GSM module to save power.
  
  
  
[[File:Can adapter settings carsharing solution.JPG|frameless|alt=|left|250x250px]]
+
[[File:Can adapter settings carsharing solution.JPG|alt=|left|frame]]
 +
<br />
 +
<br />
 +
<br />
 
<br />
 
<br />
 
Can adapter settings:
 
Can adapter settings:
Line 77: Line 103:
 
*<span style="background-color:#E18DE7;">45002</span> – CAN Adapter program number (This code is written in every connection diagram and it is specific for every vehicle model and make year)
 
*<span style="background-color:#E18DE7;">45002</span> – CAN Adapter program number (This code is written in every connection diagram and it is specific for every vehicle model and make year)
  
 +
[[File:Can_adapter_door_status_settings.PNG|alt=|left|455x455px|thumb]]
 
<br />
 
<br />
 +
 +
 +
 +
 +
 +
 +
*<span style="background-color:#dee11d;">45170</span> – Door status, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
 +
 +
[[File:Can_adapter_fuel_level_settings.PNG|alt=|left|453x453px|thumb]]
 +
<br />
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
*<span style="background-color:#1de1d2;">45130</span> – Fuel level, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
 +
 +
[[File:Can_adapter_settings_total_milage_counted.PNG|alt=|left|452x452px|thumb]]
 
<br />
 
<br />
  
====3.1. Car sharing in one SMS====
 
  
 +
 +
 +
 +
 +
 +
 +
 +
*<span style="background-color:#e1701d;">45220</span> – Total milage (Counted), Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
 +
 +
[[File:Sec_state_flag_P2.PNG|alt=|left|453x453px|thumb]]
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
*<span style="background-color:#bce5d7;">45430</span> – Security State Flags, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
 +
<br />
 +
<br />
 +
<br />
 +
 +
<br />
 
'''Quickstart:''' From default configuration to Car sharing solution in one SMS:
 
'''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_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">45002</span>:CAN Adapter program number"
+
  "  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">45002</span>:ProgramNumber;<span style="background-color:#dee11d;">45170</span>:1;<span style="background-color:#1de1d2;">45130</span>:1;<span style="background-color:#e1701d;">45220</span>:1;<span style="background-color:#bce5d7;">45430</span>:1"
 +
This SMS will set up your device to report the Car Sharing scenario to the server and the possibility for remote control of vehicle components.
  
==Parsing==
+
'''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.Prerequisites:'''===
Line 99: Line 179:
 
| style="vertical-align: middle; text-align: center;" | 000000000000008F080100000177B0A5F838000000000000000000004400280D0000001F09EF00F0001504B301B40051005200590098000B42307443
 
| style="vertical-align: middle; text-align: center;" | 000000000000008F080100000177B0A5F838000000000000000000004400280D0000001F09EF00F0001504B301B40051005200590098000B42307443
 
0F8244000011001812002D13FFE85400BE5500005A0000970000A800000AF10000601A53000000005703CB6B986400002E
 
0F8244000011001812002D13FFE85400BE5500005A0000970000A800000AF10000601A53000000005703CB6B986400002E
97660000000069023B33856B000065B27B000000007D00000000BD000000000184<span style="background:#d4b991">0080000030000005</span>0100005C92  
+
97660000000069023B33856B000065B27B000000007D00000000BD000000000184<span style="background:#0b9768">0080000030000005</span>0100005C92  
  
 
|}
 
|}
Line 171: Line 251:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |4'th IO ID
 
| style="vertical-align: middle; text-align: center;" |4'th IO ID
| style="vertical-align: middle; text-align: center;" |B3 (AVL ID: 179, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |B3 (AVL ID: 179, Name: Digital Output 1)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |4'th IO Value
 
| style="vertical-align: middle; text-align: center;" |4'th IO Value
Line 177: Line 257:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |5'th IO ID
 
| style="vertical-align: middle; text-align: center;" |5'th IO ID
| style="vertical-align: middle; text-align: center;" |B4 (AVL ID: 180, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |B4 (AVL ID: 180, Name: Digital Output 2)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |5'th IO Value
 
| style="vertical-align: middle; text-align: center;" |5'th IO Value
Line 183: Line 263:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |6'th IO ID
 
| style="vertical-align: middle; text-align: center;" |6'th IO ID
| style="vertical-align: middle; text-align: center;" |51 (AVL ID: 81, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |51 (AVL ID: 81, Name: Vehicle Speed)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |6'th IO Value
 
| style="vertical-align: middle; text-align: center;" |6'th IO Value
Line 189: Line 269:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |7'th IO ID
 
| style="vertical-align: middle; text-align: center;" |7'th IO ID
| style="vertical-align: middle; text-align: center;" |52 (AVL ID: 82, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |52 (AVL ID: 82, Name: Accelerator Pedal Position)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |7'th IO Value
 
| style="vertical-align: middle; text-align: center;" |7'th IO Value
Line 195: Line 275:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |8'th IO ID
 
| style="vertical-align: middle; text-align: center;" |8'th IO ID
| style="vertical-align: middle; text-align: center;" |59 (AVL ID: 89, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |59 (AVL ID: 89, Name: Fuel level)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |8'th IO Value
 
| style="vertical-align: middle; text-align: center;" |8'th IO Value
Line 201: Line 281:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |9'th IO ID
 
| style="vertical-align: middle; text-align: center;" |9'th IO ID
| style="vertical-align: middle; text-align: center;" |98 (AVL ID: 152, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |98 (AVL ID: 152, Name: Geofence zone 05)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |9'th IO Value
 
| style="vertical-align: middle; text-align: center;" |9'th IO Value
Line 210: Line 290:
 
|-
 
|-
 
| 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;" |42 (AVL ID: 66, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |42 (AVL ID: 66, Name: External Voltage)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |1’st IO Value
 
| style="vertical-align: middle; text-align: center;" |1’st IO Value
Line 216: Line 296:
 
|-
 
|-
 
| 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;" |43 (AVL ID: 67, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |43 (AVL ID: 67, Name: Battery Voltage)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
 
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
Line 222: Line 302:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |3’rd IO ID
 
| style="vertical-align: middle; text-align: center;" |3’rd IO ID
| style="vertical-align: middle; text-align: center;" |44 (AVL ID: 68, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |44 (AVL ID: 68, Name: Battery Current)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
 
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
Line 228: Line 308:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |4'th IO ID
 
| style="vertical-align: middle; text-align: center;" |4'th IO ID
| style="vertical-align: middle; text-align: center;" |11 (AVL ID: 17, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |11 (AVL ID: 17, Name: Axis X)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |4'th IO Value
 
| style="vertical-align: middle; text-align: center;" |4'th IO Value
Line 234: Line 314:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |5'th IO ID
 
| style="vertical-align: middle; text-align: center;" |5'th IO ID
| style="vertical-align: middle; text-align: center;" |12 (AVL ID: 18,Name: ???)
+
| style="vertical-align: middle; text-align: center;" |12 (AVL ID: 18,Name: Axis Y)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |5'th IO Value
 
| style="vertical-align: middle; text-align: center;" |5'th IO Value
Line 240: Line 320:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" | 6'th IO ID
 
| style="vertical-align: middle; text-align: center;" | 6'th IO ID
| style="vertical-align: middle; text-align: center;" |13 (AVL ID: 19, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |13 (AVL ID: 19, Name: Axis Z)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |6'th IO Value
 
| style="vertical-align: middle; text-align: center;" |6'th IO Value
Line 246: Line 326:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |7'th IO ID
 
| style="vertical-align: middle; text-align: center;" |7'th IO ID
| style="vertical-align: middle; text-align: center;" |54 (AVL ID: 84,Name: ???)
+
| style="vertical-align: middle; text-align: center;" |54 (AVL ID: 84,Name: Fuel level)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |7'th IO Value
 
| style="vertical-align: middle; text-align: center;" |7'th IO Value
Line 252: Line 332:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |8'th IO ID
 
| style="vertical-align: middle; text-align: center;" |8'th IO ID
| style="vertical-align: middle; text-align: center;" |55 (AVL ID:85, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |55 (AVL ID:85, Name: Engine RPM)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |8’th IO Value
 
| style="vertical-align: middle; text-align: center;" |8’th IO Value
Line 258: Line 338:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |9'th IO ID
 
| style="vertical-align: middle; text-align: center;" |9'th IO ID
| style="vertical-align: middle; text-align: center;" |5A (AVL ID:90, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |5A (AVL ID:90, Name: Door Status)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |9’th IO Value
 
| style="vertical-align: middle; text-align: center;" |9’th IO Value
Line 264: Line 344:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |10'th IO ID
 
| style="vertical-align: middle; text-align: center;" |10'th IO ID
| style="vertical-align: middle; text-align: center;" |97 (AVL ID:151, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |97 (AVL ID:151, Name: Battery Temperature)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |10'th IO Value
 
| style="vertical-align: middle; text-align: center;" |10'th IO Value
Line 270: Line 350:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |11'th IO ID
 
| style="vertical-align: middle; text-align: center;" |11'th IO ID
| style="vertical-align: middle; text-align: center;" |A8 (AVL ID: 168, ???)
+
| style="vertical-align: middle; text-align: center;" |A8 (AVL ID: 168, Battery Voltage)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |11'th IO Value
 
| style="vertical-align: middle; text-align: center;" |11'th IO Value
Line 279: Line 359:
 
|-
 
|-
 
| 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;" |F1 (AVL ID: 241, Name: ???)
+
| 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;" |1’st IO Value
Line 285: Line 365:
 
|-
 
|-
 
| 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;" |53 (AVL ID: 83, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |53 (AVL ID: 83, Name: Fuel Consumed)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
 
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
Line 291: Line 371:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |3’rd IO ID
 
| style="vertical-align: middle; text-align: center;" |3’rd IO ID
| style="vertical-align: middle; text-align: center;" |57 (AVL ID: 87, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |57 (AVL ID: 87, Name: Total Mileage)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
 
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
Line 297: Line 377:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |4’th IO ID
 
| style="vertical-align: middle; text-align: center;" |4’th IO ID
| style="vertical-align: middle; text-align: center;" |64 (AVL ID: 100, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |64 (AVL ID: 100, Name: Program Number)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |4’th IO Value
 
| style="vertical-align: middle; text-align: center;" |4’th IO Value
Line 303: Line 383:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |5’th IO ID
 
| style="vertical-align: middle; text-align: center;" |5’th IO ID
| style="vertical-align: middle; text-align: center;" |66 (AVL ID: 102, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |66 (AVL ID: 102, Name: Engine Worktime)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |5’th IO Value
 
| style="vertical-align: middle; text-align: center;" |5’th IO Value
Line 309: Line 389:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |6’th IO ID
 
| style="vertical-align: middle; text-align: center;" |6’th IO ID
| style="vertical-align: middle; text-align: center;" |69 (AVL ID: 105, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |69 (AVL ID: 105, Name: Total Mileage (counted))
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |6’th IO Value
 
| style="vertical-align: middle; text-align: center;" |6’th IO Value
Line 315: Line 395:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |7’th IO ID
 
| style="vertical-align: middle; text-align: center;" |7’th IO ID
| style="vertical-align: middle; text-align: center;" |6B (AVL ID: 107, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |6B (AVL ID: 107, Name: Fuel Consumed(counted))
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |7’th IO Value
 
| style="vertical-align: middle; text-align: center;" |7’th IO Value
Line 321: Line 401:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |8’th IO ID
 
| style="vertical-align: middle; text-align: center;" |8’th IO ID
| style="vertical-align: middle; text-align: center;" |7B (AVL ID: 123, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |7B (AVL ID: 123, Name: Control State Flags)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |8’th IO Value
 
| style="vertical-align: middle; text-align: center;" |8’th IO Value
Line 327: Line 407:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |9’th IO ID
 
| style="vertical-align: middle; text-align: center;" |9’th IO ID
| style="vertical-align: middle; text-align: center;" |7D (AVL ID: 125, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |7D (AVL ID: 125, Name: Harvesting Time)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |9’th IO Value
 
| style="vertical-align: middle; text-align: center;" |9’th IO Value
Line 333: Line 413:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |10’th IO ID
 
| style="vertical-align: middle; text-align: center;" |10’th IO ID
| style="vertical-align: middle; text-align: center;" |BD (AVL ID: 189, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |BD (AVL ID: 189, Name: Cruise Time)
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |10’th IO Value
 
| style="vertical-align: middle; text-align: center;" |10’th IO Value
Line 342: Line 422:
 
|-
 
|-
 
| 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;" |84 (AVL ID: 132, Name: ???)
+
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">84 (AVL ID: 132, Name: Security State Flags)</span>
 
|-
 
|-
 
| 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;" |00 80 00 00 30 00 00 05
+
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 80 00 00 30 00 00 05</span>
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Number of Data 2 (Number of Total Records)
 
| style="vertical-align: middle; text-align: center;" |Number of Data 2 (Number of Total Records)
Line 354: Line 434:
 
|}
 
|}
  
==In platform==
+
Security State Flag Examples:
 +
*1) Locked doors <span style="background:#0b9768">00 80 00 00 30 00 00 05</span>
 +
*2) Unlocked doors <span style="background:#d4f991">00 80 00 00 00 00 00 05</span>
 +
 
 +
Convert HEX value to BIN value:
 +
 
 +
Then count 28'th BIT from the back (28'th bit value shows locked/unlocked states)
 +
*1) 100000000000000000000000001<span style="background:#0b9768">1</span>0000000000000000000000000101
 +
*2) 100000000000000000000000000<span style="background:#d4f991">0</span>0000000000000000000000000101
 +
If car is locked value is <span style="background:#0b9768>1</span> and if car is unlocked value is <span style="background:#d4f991">0</span>
 +
 
 +
To test the car unlocking and locking use these GPRS commands
 +
*1) To unlock all doors use this command: "lvcanopenalldoors"
 +
*2) To lock all doors use this command: "lvcanclosealldoors"
 +
 
 +
 
 +
[[Category: Usage scenarios]]

Latest revision as of 10:37, 28 March 2024

Main Page > General Information > Usage scenarios > Car Sharing Solution

Disclaimer

Alert.png


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.


Introduction

Recently, we have seen the development of car-sharing services used by private individuals, companies, and public institutions alike. These client groups, even though different, all seek comfortable and efficient use of vehicles. Reasons to use such services include fleet optimization, convenience, a sudden need for vehicles, business trips, trips abroad, etc. Also, such matters as car insurance, tire change, maintenance, or car wash are taken care of for the client. We're glad that you have decided to test our “Car Sharing” solution.

Solution description

This solution allows vehicles to be used in car-sharing businesses by monitoring vehicles location and other useful parameters from the vehicle's CAN-BUS such as fuel level, speed, odometer, etc. The most important feature is the ability to lock and unlock the vehicle on demand without a key which is an essential feature for car-sharing businesses. To use this solution FMX1XY device paired with a CAN-CONTROL adapter is needed to allow data to be read from the vehicle and most importantly for door locking and unlocking to be accessible remotely via smartphone or server.

Note: Active parameters are not sent when Ignition is Off when ODS, DS or UDS are configured because communication from device is turned off to conserve battery or lower consumption. To receive parameters - GPS sleep can be used, or no sleep should be used. GPS sleep only turns off GNSS part, everything else is left in operation. However, the consumption of this sleep mode is the highest.

Parameter list: https://wiki.teltonika-gps.com/view/FMB130_CAN_adapters#Send_data_with_0.2C_if_ignition_is_off

What you need for a solution?

  • FMx1YX device (FMB130is taken as example) which is used to connect to a CAN-CONTROL adapter.
Other devices that work with this solution:
FMB110, FMB120, FMB122, FMB125, FMU125, FMC125, FMM125, FMU130, FMC130, FMM130, FMU126
  • The SIM card in order to get data to your server
  • CAN-CONTROL adapter. The adapter allows you to control car doors and it works with many of our products
  • FOTA WEB to remotely send the configuration to the device.

Installation

It’s important to 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 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.

The main accessory for the solution is CAN-CONTROL adapter, please make sure that the right contacts are connected. Also, check more detailed information here and supported vehicle list.

To have a working solution it’s important to properly wire the devices. In the picture below it's shown how to correctly wire the devices.

During installation please follow recommendations in order to avoid damaging 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.
  • The ground wire is connected to the vehicle frame or metal parts that are fixed to the frame.

Configuration

1. Prerequisites:

1.1. Read through First start guide

1.2. Understanding of possible Sleep modes.

2. Car sharing configuration:

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)



Server settings:

  • 2004 – Domain
  • 2005 – Port
  • 2006 – Data sending protocol (0 – TCP, 1 – UDP)





After successful GPRS/SERVER settings configuration, FMB130 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 SMS parameters.


Sleep settings:

  • 102 – Sleep settings(0 – Disable, 1 – Gps sleep, 2 – Deep sleep, 3 – Online Deep sleep, 4 – Ultra sleep)

Note: This scenario will not work with Deep Sleep and Ultra Sleep modes, since they disable the device's GSM module to save power.






Can adapter settings:

  • 45002 – CAN Adapter program number (This code is written in every connection diagram and it is specific for every vehicle model and make year)





  • 45170 – Door status, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )






  • 45130 – Fuel level, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )






  • 45220 – Total milage (Counted), Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )







  • 45430 – Security State Flags, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )





Quickstart: From default configuration to Car sharing solution in one SMS:

"  setparam 2001:APN;2002:APN_user;2003:APN_password;2004:Domain;2005:Port;2006:0;102:3;45002:ProgramNumber;45170:1;45130:1;45220:1;45430:1"

This SMS will set up your device to report the Car Sharing scenario to the server and the possibility for remote control of vehicle components.

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 TCP/UDP port

1.2. Read Java parser first start guide

2. Parsing example:

Unparsed received data in hexadecimal stream
000000000000008F080100000177B0A5F838000000000000000000004400280D0000001F09EF00F0001504B301B40051005200590098000B42307443

0F8244000011001812002D13FFE85400BE5500005A0000970000A800000AF10000601A53000000005703CB6B986400002E 97660000000069023B33856B000065B27B000000007D00000000BD00000000018400800000300000050100005C92

AVL Data Packet Part HEX Code Part
Zero Bytes 00 00 00 00
Data Field Length 00 00 00 8F
Codec ID 08 (Codec 8)
Number of Data 1 (Number of Total Records) 01
Timestamp 00 00 01 77 B0 A5 F8 38 (Thursday, February 18, 2021 3:43:00 PM GMT+02:00)
Priority 00
Longitude 00 00 00 00
Latitude 00 00 00 00
Altitude 00 44
Angle 00 28
Satellites 0D
Speed 00 00
Event IO ID 00
N of Total ID 1F
N1 of One Byte IO 09
1’st IO ID EF (AVL ID: 239, Name: Ignition)
1’st IO Value 00
2’nd IO ID F0 (AVL ID: 240, Name: Movement)
2’nd IO Value 00
3’rd IO ID 15 (AVL ID: 21, Name: GSM Signal)
3’rd IO Value 04
4'th IO ID B3 (AVL ID: 179, Name: Digital Output 1)
4'th IO Value 01
5'th IO ID B4 (AVL ID: 180, Name: Digital Output 2)
5'th IO Value 00
6'th IO ID 51 (AVL ID: 81, Name: Vehicle Speed)
6'th IO Value 00
7'th IO ID 52 (AVL ID: 82, Name: Accelerator Pedal Position)
7'th IO Value 00
8'th IO ID 59 (AVL ID: 89, Name: Fuel level)
8'th IO Value 00
9'th IO ID 98 (AVL ID: 152, Name: Geofence zone 05)
9'th IO Value 00
N2 of Two Byte IO 0B
1’st IO ID 42 (AVL ID: 66, Name: External Voltage)
1’st IO Value 30 74
2’nd IO ID 43 (AVL ID: 67, Name: Battery Voltage)
2’nd IO Value 0F 82
3’rd IO ID 44 (AVL ID: 68, Name: Battery Current)
3’rd IO Value 00 00
4'th IO ID 11 (AVL ID: 17, Name: Axis X)
4'th IO Value 00 18
5'th IO ID 12 (AVL ID: 18,Name: Axis Y)
5'th IO Value 0F 8A
6'th IO ID 13 (AVL ID: 19, Name: Axis Z)
6'th IO Value FF E8
7'th IO ID 54 (AVL ID: 84,Name: Fuel level)
7'th IO Value 00 BE
8'th IO ID 55 (AVL ID:85, Name: Engine RPM)
8’th IO Value 00 00
9'th IO ID 5A (AVL ID:90, Name: Door Status)
9’th IO Value 00 00
10'th IO ID 97 (AVL ID:151, Name: Battery Temperature)
10'th IO Value 00 00
11'th IO ID A8 (AVL ID: 168, Battery Voltage)
11'th IO Value 00 00
N4 of Four Byte IO 0A
1'st IO ID F1 (AVL ID: 241, Name: Active GSM Operator)
1’st IO Value 00 00 60 1A
2’nd IO ID 53 (AVL ID: 83, Name: Fuel Consumed)
2’nd IO Value 00 00 00 00
3’rd IO ID 57 (AVL ID: 87, Name: Total Mileage)
3’rd IO Value 03 CB 6B 98
4’th IO ID 64 (AVL ID: 100, Name: Program Number)
4’th IO Value 00 00 2E 97
5’th IO ID 66 (AVL ID: 102, Name: Engine Worktime)
5’th IO Value 00 00 00 00
6’th IO ID 69 (AVL ID: 105, Name: Total Mileage (counted))
6’th IO Value 02 3B 33 85
7’th IO ID 6B (AVL ID: 107, Name: Fuel Consumed(counted))
7’th IO Value 00 00 65 B2
8’th IO ID 7B (AVL ID: 123, Name: Control State Flags)
8’th IO Value 00 00 00 00
9’th IO ID 7D (AVL ID: 125, Name: Harvesting Time)
9’th IO Value 00 00 00 00
10’th IO ID BD (AVL ID: 189, Name: Cruise Time)
10’th IO Value 00 00 00 00
N8 of Eight Byte IO 01
1'st IO ID 84 (AVL ID: 132, Name: Security State Flags)
1’st IO Value 00 80 00 00 30 00 00 05
Number of Data 2 (Number of Total Records) 01
CRC-16 00 00 5C 92

Security State Flag Examples:

  • 1) Locked doors 00 80 00 00 30 00 00 05
  • 2) Unlocked doors 00 80 00 00 00 00 00 05

Convert HEX value to BIN value:

Then count 28'th BIT from the back (28'th bit value shows locked/unlocked states)

  • 1) 10000000000000000000000000110000000000000000000000000101
  • 2) 10000000000000000000000000000000000000000000000000000101

If car is locked value is 1 and if car is unlocked value is 0

To test the car unlocking and locking use these GPRS commands

  • 1) To unlock all doors use this command: "lvcanopenalldoors"
  • 2) To lock all doors use this command: "lvcanclosealldoors"