View source for Private/Business Driving Mode Functionality


__TOC__

==Solution description==
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.

==What you need for a solution?==
*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.
*Dedicated firmware version '''03.27.07.Rev.461''' (please contact you sales manager for the newest version)
*[[FMP100_First_Start#How_to_insert_Micro-SIM_card_and_connect_the_battery|SIM card]] in order to get data to your server
*[[FOTA_WEB|FOTA WEB]] to remotely send the configuration to the device.<br />

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


[[File:FMP100.png|none|thumb|397x397px|Figure 1. Recommended mounting location]]

==Configuration==

==='''1. Prerequisites:'''===

====1.1. Read through [https://wiki.teltonika-gps.com/view/FMP100_First_Start First start guide]====
====1.2. Understanding of possible [https://wiki.teltonika-gps.com/view/FMP100_System_settings#Sleep_Mode Sleep modes].====
<br />

==='''2. Configuring Private/Business Mode Scenario'''===
* Configure the APN in '''GPRS settings'''.

[[File:Gprs settings.png|alt=|left|thumb|259x259px]]

<br />


*<span style="background-color:#fc3;">2001</span> – APN
*<span style="background-color:#00af89;">2002</span> – APN username (No APN username > leave the field blank)
*<span style="background-color:#d33;">2003</span> – APN password (No APN password > leave the field blank)

<br />





* Configure the server in '''GPRS settings'''.

[[File:Server settings.png|alt=|left|thumb|259x259px]]

<br />

*<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 />


* Enable [[Codec#Codec_8_Extended|Codec 8 Extended]] in '''System settings'''.

[[File:Codec8ExtendedPositive.png|alt=|left|thumb|259x259px]]

<br />

*<span style="background-color:#05CC2F;">Parameter ID: 113</span> – Codec 8 Extended (0 – Codec 8, 1 – Codec 8 Extended)
AVL parameters greater than 255 (HEX 0xFF) require “Codec 8 extended” to be sent to the server.

<br />

* Select priority in '''Trip \ Odometer''' - ''Private/Business mode settings''.

[[File:Private Business Mode Priority.jpg|alt=|left|thumb|259x259px]]


<br />


*<span style="background-color:#b9d491;">Parameter ID: 11850</span> – Priority settings (0 – Disable, 1 – Low priority, 2 - High priority, 3 - Panic priority)


<br />

* Enable Eventual Records in '''Trip \ Odometer''' - ''Private/Business mode settings''.

[[File:Eventual Records.jpg|alt=|left|thumb|259x259px]]

<br />


*<span style="background-color:#d5fdf4;">Parameter ID: 11814</span> – [[FMP100_Trip/Odometer_settings#Eventual_records|Eventual Records]] (0 – Disable, 1 – Enable)

<br />

* Choose a trigger to change trip mode in '''Trip \ Odometer''' - ''Private/Business mode settings''.

[[File:Triggers.gif|alt=|left|thumb|259x259px]]

<br>

*<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>
* 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]]

<br />

*<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]]