Wiki Knowledge Base | Teltonika GPS

Changes

Private/Business Driving Mode Functionality (view source)

Revision as of 12:52, 7 August 2023

13,431 bytes added ,  12:52, 7 August 2023
→‎Enabling and Disabling private mode via SMS command
Line 3: Line 3:     
==Solution description==
 
==Solution description==
−
Allowing employees to drive company vehicles for personal reasons is a widespread practice. It is an attractive perk for employees, assisting business owners to hire skilled people and boost its competitiveness. But how to effectively monitor and manage this process, generate reports and avoid a car misuse trouble-free way? To assist businesses with this, Teltonika Telematics has developed a special GPS tracker mode.
+
This solution will allow your company car to be used by employees for personal purposes without violating the [https://gdpr-info.eu/ EU General Data Protection Regulations] by masking all the personal data while vehicle is used in Private mode. Moreover, self-employed people can easily convert their own car into a business asset and ensure that the data provided (Example - distance traveled) is correct and shown only working hours' driven distance, because using '''FMP100''' is simple as it can be.
−
<br>
  −
This solution will allow your company car to be used by employees for personal purposes without violating the [https://gdpr-info.eu/ EU General Data Protection Regulations]. Moreover, self-employed people can easily convert their own car into a business asset and ensure that the data provided (such as distance traveled) is correct, because using '''FMP100''' is simple as it can be.
      
==What you need for a solution?==
 
==What you need for a solution?==
−
*[[FMP100]] device
+
*For this solution we will use [[FMP100]] device. However, any '''FMBXXX''' series device can be used (excluding FMX640 series) with this scenario depending on how you want to change the trip mode (via BLE or a button connected to DIN)
 
*[[Teltonika_Configurator|Teltonika Configurator]] to set up FM device correctly for the solution.
 
*[[Teltonika_Configurator|Teltonika Configurator]] to set up FM device correctly for the solution.
 
*Dedicated firmware version '''03.27.07.Rev.461''' (please contact you sales manager for the newest version)
 
*Dedicated firmware version '''03.27.07.Rev.461''' (please contact you sales manager for the newest version)
Line 15: Line 13:     
==Installation==
 
==Installation==
−
The device is easy to install, but keep in mind that although the devices have high-gain antennas, it is important to mount the devices with engraving on top and in metal-free space. For example if you have several 12V sockets in a van, you should not choose one in the back cabin.
+
The device is easy to install, but keep in mind that although the device have high-gain antennas, it is important to mount the device with engraving on top and in metal-free space. For example if you have several 12V sockets in a van, you should not choose one in the back cabin.
      Line 59: Line 57:       −
* Enable Codec 8 Extended in '''System settings'''.
+
* Enable [[Codec#Codec_8_Extended|Codec 8 Extended]] in '''System settings'''.
    
[[File:Codec8ExtendedPositive.png|alt=|left|thumb|259x259px]]
 
[[File:Codec8ExtendedPositive.png|alt=|left|thumb|259x259px]]
Line 70: Line 68:  
<br />
 
<br />
   −
* Select priority in '''Trip \ Odometer'''.
+
* Select priority in '''Trip \ Odometer''' - ''Private/Business mode settings''.
    
[[File:Private Business Mode Priority.jpg|alt=|left|thumb|259x259px]]
 
[[File:Private Business Mode Priority.jpg|alt=|left|thumb|259x259px]]
Line 78: Line 76:       −
*<span style="background-color:#b9d491;">Parameter ID: 11800</span> – Priority settings (0 – Disable, 1 – Low priority, 2 - High priority, 3 - Panic priority)
+
*<span style="background-color:#b9d491;">Parameter ID: 11850</span> – Priority settings (0 – Disable, 1 – Low priority, 2 - High priority, 3 - Panic priority)
       
<br />
 
<br />
   −
* Enable Eventual Records in '''Trip \ Odometer'''.
+
* Enable Eventual Records in '''Trip \ Odometer''' - ''Private/Business mode settings''.
    
[[File:Eventual Records.jpg|alt=|left|thumb|259x259px]]
 
[[File:Eventual Records.jpg|alt=|left|thumb|259x259px]]
Line 90: Line 88:       −
*<span style="background-color:#d5fdf4;">Parameter ID: 11814</span> – Eventual Records (0 – Disable, 1 – Low priority, 2 - High priority, 3 - Panic priority)
+
*<span style="background-color:#d5fdf4;">Parameter ID: 11814</span> – [[FMP100_Trip/Odometer_settings#Eventual_records|Eventual Records]] (0 – Disable, 1 – Enable)
    
<br />
 
<br />
   −
* Choose a trigger to change trip mode in '''Trip \ Odometer'''.
+
* Choose a trigger to change trip mode in '''Trip \ Odometer''' - ''Private/Business mode settings''.
    
[[File:Triggers.gif|alt=|left|thumb|259x259px]]
 
[[File:Triggers.gif|alt=|left|thumb|259x259px]]
Line 100: Line 98:  
<br>
 
<br>
   −
*<span style="background-color:#6A5ACD;">Parameter ID: 11811</span> – Triggers (16 – BTApp, 32 – NBL-1 Button1, 64 – NBL-1 Button2, 128 – FMP100 Button, 255 – Enable All)
+
*<span style="background-color:#6A5ACD;">Parameter ID: 11811</span> – [[FMP100_Trip/Odometer_settings#Triggers|Triggers]] (16 – BTApp, 32 – NBL-1 Button1, 64 – NBL-1 Button2, 128 – FMP100 Button, 255 – Enable All)
    
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
−
* Choose what position should device send when Private mode is enabled in '''Trip \ Odometer'''.
+
* Choose which position should device send when Private mode is enabled in '''Trip \ Odometer''' - ''Private/Business mode settings''.
    
[[File:GPS Data Masking.jpg|alt=|left|thumb|259x259px]]
 
[[File:GPS Data Masking.jpg|alt=|left|thumb|259x259px]]
Line 111: Line 109:  
<br />
 
<br />
   −
*<span style="background-color:#B0E0E6;">Parameter ID: 11811</span> – GPS Data Masking (0 – Normal, 1 – Data sent as Zero, 2 – Last good known position)
+
*<span style="background-color:#B0E0E6;">Parameter ID: 11813</span> – [[FMP100_Trip/Odometer_settings#GPS_Data_Masking|GPS Data Masking]] (0 – Normal, 1 – Data sent as Zero, 2 – Last good known position)
 +
 
 +
<br>
 +
<br>
 +
<br>
 +
* Choose whether the distance traveled in private mode should be included in the total odometer IO element in '''Trip \ Odometer''' - ''Private/Business mode settings''.
 +
 
 +
[[File:Odometer Calculation.jpg|alt=|left|thumb|259x259px]]
 +
 
 +
<br />
 +
 
 +
*<span style="background-color:#FFFFE0;">Parameter ID: 11815</span> – [[FMP100_Trip/Odometer_settings#Odometer_calculation|Odometer calculation]] (0 – Disable, 1 – Enable)
 +
 
 +
<br>
 +
<br>
 +
<br>
 +
* Choose which event will deactivate Private mode and switch to Business in '''Trip \ Odometer''' - ''Private/Business mode settings''.
 +
 
 +
[[File:Deactivate.gif|alt=|left|thumb|259x259px]]
 +
 
 +
<br />
 +
 
 +
*<span style="background-color:#eaf3ff;">Parameter ID: 11816</span> – [[FMP100_Trip/Odometer_settings#Deactivate_by|Deactivate by]] (0 – Disable, 1 – Towing detection, 2 – Unplug detection, 4 – Crash detection, 8 – Autogeofence, 15 – Enable All)
 +
 
 +
<br>
 +
<br>
 +
* Choose a trigger type to change between Private/Business modes in '''Trip \ Odometer''' - ''Private/Business mode settings''.
 +
 
 +
[[File:Trigger Type.jpg|alt=|left|thumb|259x259px]]
 +
 
 +
<br />
 +
 
 +
*<span style="background-color:#BC8F8F;">Parameter ID: 11849</span> – [[FMP100_Trip/Odometer_settings#Trigger_Type|Trigger Type]] (0 – External, 1 – [[FMP100_Trip/Odometer_settings#Weekly_Schedule_Settings|Weekly Schedule]])
 +
 
 +
<br>
 +
<br>
 +
 
 +
*Also you can configure [[FMP100_User_Interface|User Interface]] and [[FMP100_Keyboard|Keyboard]] in the dedicated Teltonika Configurator section
 +
 
 +
<br>
 +
 
 +
'''Quickstart:''' From default configuration to Private/Business scenario in one SMS:
 +
<br>
 +
''Note that this SMS command does not include APN, Domain and port parameters''
 +
 
 +
''<SMS Login> <SMS Password>'' '''setparam 113:1;11850:1;11814:1;11811:128;11813:2;11815:1;11816:4;11849:0'''
 +
 
 +
You can check how this SMS configures device - [https://wiki.teltonika-gps.com/wikibase/images/6/62/Private_business_mode_in_one_sms.jpg Teltonika Configurator]
 +
 
 +
==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.Private mode periodic record 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;" | 00000000000000328E010000017E065DE1B80000000000000000000000000000000000000003000300EF0000F000<span style="background:#0b9768">0187<span style="background:#d4f991">01</span></span>0000000000000000010000793F
 +
 
 +
|}
 +
{| 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 32
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Codec ID
 +
| style="vertical-align: middle; text-align: center;" |8E (Codec 8 Extended)
 +
|-
 +
| 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 7E 06 5D E1 B8
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Priority
 +
| style="vertical-align: middle; text-align: center;" |00
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Longitude
 +
| style="vertical-align: middle; text-align: center;" |00 00 00 00
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Latitude
 +
| style="vertical-align: middle; text-align: center;" |00 00 00 00
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Altitude
 +
| style="vertical-align: middle; text-align: center;" |00 00
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Angle
 +
| style="vertical-align: middle; text-align: center;" |00 00
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Satellites
 +
| style="vertical-align: middle; text-align: center;" |00
 +
|-
 +
| 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;" |00 00
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |N of Total ID
 +
| style="vertical-align: middle; text-align: center;" |00 03
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |N1 of One Byte IO
 +
| style="vertical-align: middle; text-align: center;" |00 03
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |1’st IO ID
 +
| style="vertical-align: middle; text-align: center;" |00 EF (AVL ID 239, Name: Ignition)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |1’st IO Value
 +
| style="vertical-align: middle; text-align: center;" |00
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
 +
| style="vertical-align: middle; text-align: center;" |00 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;" |<span style="background:#0b9768">01 87</span> (AVL ID 391, Name: Private mode)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">01</span> (Private mode state 1 - Private mode on)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |N2 of Two Bytes IO
 +
| 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;" |00 00
 +
|-
 +
| 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;" |NX of X Byte IO
 +
| style="vertical-align: middle; text-align: center;" |00 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 79 3F
 +
|}
 +
<br>
 +
[[File:0 coordinate.jpg|alt=|center|thumb|600x600px|Zero coordinate in Private mode]]
 +
 
 +
=== '''3.Private mode eventual record 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;" | 00000000000000328E010000017E065F2208010F0E5880209AAF5E00BF00D114000001870003000300EF0000F000<span style="background:#0b9768">0187<span style="background:#d4f991">00</span></span>0000000000000000010000D182
 +
 
 +
|}
 +
{| 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 32
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Codec ID
 +
| style="vertical-align: middle; text-align: center;" |8E (Codec 8 Extended)
 +
|-
 +
| 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 7E 06 5F 22 08
 +
|-
 +
| 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 58 80
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Latitude
 +
| style="vertical-align: middle; text-align: center;" |20 9A AF 5E
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Altitude
 +
| style="vertical-align: middle; text-align: center;" |00 BF
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Angle
 +
| style="vertical-align: middle; text-align: center;" |00 D1
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Satellites
 +
| style="vertical-align: middle; text-align: center;" |14
 +
|-
 +
| 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;" |01 87 (AVL ID 391, Name: Private mode)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |N of Total ID
 +
| style="vertical-align: middle; text-align: center;" |00 03
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |N1 of One Byte IO
 +
| style="vertical-align: middle; text-align: center;" |00 03
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |1’st IO ID
 +
| style="vertical-align: middle; text-align: center;" |00 EF (AVL ID 239, Name: Ignition)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |1’st IO Value
 +
| style="vertical-align: middle; text-align: center;" |00
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
 +
| style="vertical-align: middle; text-align: center;" |00 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;" |<span style="background:#0b9768">01 87</span> (AVL ID 391, Name: Private mode)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">00</span> (Private mode state 0 - Private mode off)
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |N2 of Two Bytes IO
 +
| 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;" |00 00
 +
|-
 +
| 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;" |NX of X Byte IO
 +
| style="vertical-align: middle; text-align: center;" |00 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 D1 82
 +
|}
 +
<br>
 +
[[File:Bussines mode coordinate.jpg|alt=|center|thumb|600x600px|Private mode off]]
 +
 
 +
 
 +
==Demonstration in platform==
 +
 
 +
'''TAVL''': Open TAVL application → Select Client → Select Device → In "Track" tab Select the date interval → Select Advanced → Press Show button. All the information will appear in left down corner.
 +
 
 +
[[File:Tavl Private mode.jpg|alt=|frameless|1000x1000px]]
 +
<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.
 +
<Br>
 +
[[File:Wialon Private mode.jpg|left|frameless|1138x1138px]]<Br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
 
 +
 
 +
 
 +
==Enabling and Disabling private mode via SMS command==
 +
<br>
 +
After appropriate configuration, private mode can be toggled with privatemode SMS command:
 +
 
 +
<br>
 +
<sms login><sms password><b>privatemode</b> <option><br>
 +
{| class="wikitable"
 +
|Option
 +
|Effect
 +
|Return on success
 +
|-
 +
|ON
 +
|Turns private mode on
 +
|Privatemode ON
 +
|-
 +
|OFF
 +
|Turns private mode off
 +
|Privatemode OFF
 +
|-
 +
|?
 +
|Check private mode state
 +
|Privatemode ON
 +
 
 +
or
 +
 
 +
Privatemode OFF
 +
|}
 +
<b><big>Note:</big></b><br>
 +
<br>
 +
* Command privatemode must be lower case, followed by one space. The options ON and OFF must be upper case, otherwise Wrong arguments error is returned.
 +
<br>
 +
*The privatemode command for all arguments is disabled if Trigger Type is Weekly Schedule. Sending the command returns error Weekly Schedule is Active! Can’t control Privatemode state.
 +
<br>
 +
 
 +
 
 +
[[Category: Usage scenarios]]
Retrieved from "https://wiki.teltonika-gps.com/view/Special:MobileDiff/69710...87992"