Difference between revisions of "Private/Business Driving Mode Functionality"

From Wiki Knowledge Base | Teltonika GPS
Line 59: Line 59:
  
  
* 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 164: Line 164:
 
==== 1.2.  Read Java parser  [https://wiki.teltonika-gps.com/view/Java_Parser_First_Start_Guide first start guide]====
 
==== 1.2.  Read Java parser  [https://wiki.teltonika-gps.com/view/Java_Parser_First_Start_Guide first start guide]====
  
=== '''2. Parsing example''' ===
+
=== '''2.Private mode periodic record parsing example''' ===
 
{| class="nd-othertables_2" style="width:100%;"
 
{| class="nd-othertables_2" style="width:100%;"
 
! rowspan="1" style="width:100%; vertical-align: middle; text-align: center;" |Unparsed received data in hexadecimal stream
 
! rowspan="1" style="width:100%; vertical-align: middle; text-align: center;" |Unparsed received data in hexadecimal stream
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" | 00000000000000328E010000017E065DE1B80000000000000000000000000000000000000003000300EF0000F000<span style="background:#0b9768">0187<span style="background:#d4f991">01</span></span>0000000000000000010000793F
  
 
|}
 
|}
Line 180: Line 180:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Data Field Length
 
| style="vertical-align: middle; text-align: center;" |Data Field Length
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |Codec ID
Line 186: Line 186:
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Number of Data 1 (Number of Total Records)
 
| style="vertical-align: middle; text-align: center;" |Number of Data 1 (Number of Total Records)
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |01
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Timestamp
 
| style="vertical-align: middle; text-align: center;" |Timestamp
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |Priority
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |00
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Longitude
 
| style="vertical-align: middle; text-align: center;" |Longitude
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |Latitude
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |Altitude
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |00 00
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Angle
 
| style="vertical-align: middle; text-align: center;" |Angle
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |00 00
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Satellites
 
| style="vertical-align: middle; text-align: center;" |Satellites
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |00
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |Speed
 
| style="vertical-align: middle; text-align: center;" |Speed
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |Event IO ID
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |N of Total ID
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |N1 of One Byte IO
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |1’st IO ID
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |1’st IO Value
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |2’nd IO ID
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |2’nd IO Value
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |3’rd IO ID
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |3’rd IO Value
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">01</span>
 +
|-
 +
| 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;" |4’th IO ID
+
| style="vertical-align: middle; text-align: center;" |N8 of Two Bytes IO
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |00 00
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |4’th IO Value
+
| style="vertical-align: middle; text-align: center;" |NX of X Byte IO
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |00 00
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |5’th IO ID
+
| style="vertical-align: middle; text-align: center;" |Number of Data 2 (Number of Total Records)
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |01
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |5’th IO Value
+
| style="vertical-align: middle; text-align: center;" |CRC-16
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |N2 of Two Bytes IO
+
| style="vertical-align: middle; text-align: center;" | 00000000000000328E010000017E065F2208010F0E5880209AAF5E00BF00D114000001870003000300EF0000F000<span style="background:#0b9768">0187<span style="background:#d4f991">00</span></span>0000000000000000010000D182
| style="vertical-align: middle; text-align: center;" |
+
 
 +
|}
 +
{| 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;" |1’st IO ID
+
| style="vertical-align: middle; text-align: center;" |Longitude
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |0F 0E 58 80
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |1’st IO Value
+
| style="vertical-align: middle; text-align: center;" |Latitude
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |20 9A AF 5E
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
+
| style="vertical-align: middle; text-align: center;" |Altitude
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |00 BF
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
+
| style="vertical-align: middle; text-align: center;" |Angle
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |00 D1
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |3’rd IO ID
+
| style="vertical-align: middle; text-align: center;" |Satellites
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |14
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
+
| style="vertical-align: middle; text-align: center;" |Speed
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |00 00
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |4’th IO ID
+
| style="vertical-align: middle; text-align: center;" |Event IO ID
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |01 87
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |4’th IO Value
+
| style="vertical-align: middle; text-align: center;" |N of Total ID
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |00 03
 
|-
 
|-
| style="vertical-align: middle; text-align: center;" |N4 of Two Bytes IO
+
| style="vertical-align: middle; text-align: center;" |N1 of One Byte IO
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |1’st IO ID
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |1’st IO Value
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |2’nd IO ID
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |2’nd IO Value
| style="vertical-align: middle; text-align: center;" |
+
| 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>
 +
|-
 +
| 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;" |N8 of Two Bytes IO
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |NX of X Byte IO
| style="vertical-align: middle; text-align: center;" |
+
| 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;" |Number of Data 2 (Number of Total Records)
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |01
 
|-
 
|-
 
| style="vertical-align: middle; text-align: center;" |CRC-16
 
| style="vertical-align: middle; text-align: center;" |CRC-16
| style="vertical-align: middle; text-align: center;" |
+
| style="vertical-align: middle; text-align: center;" |00 00 D1 82
 
|}
 
|}
 
+
<br>
Server response: 00000001
+
[[File:Bussines mode coordinate.jpg|alt=|center|thumb|600x600px|Zero coordinate in Private mode]]
Please see '''[[Codec#Codec_8_Extended|Codec 8 Extended]]''' for more information.
 

Revision as of 16:58, 29 December 2021

Main Page > General Information > Usage scenarios > Private/Business Driving Mode Functionality

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 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?

  • FMP100 device
  • 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)
  • SIM card in order to get data to your server
  • FOTA WEB to remotely send the configuration to the device.

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.


Figure 1. Recommended mounting location

Configuration

1. Prerequisites:

1.1. Read through First start guide

1.2. Understanding of possible Sleep modes.


2. Configuring Private/Business Mode Scenario

  • Configure the APN in GPRS settings.



  • 2001 – APN
  • 2002 – APN username (No APN username > leave the field blank)
  • 2003 – APN password (No APN password > leave the field blank)




  • Configure the server in GPRS settings.


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




  • Parameter ID: 113 – 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.


  • Select priority in Trip \ Odometer.




  • Parameter ID: 11800 – Priority settings (0 – Disable, 1 – Low priority, 2 - High priority, 3 - Panic priority)



  • Enable Eventual Records in Trip \ Odometer.




  • Choose a trigger to change trip mode in Trip \ Odometer.


  • Parameter ID: 11811Triggers (16 – BTApp, 32 – NBL-1 Button1, 64 – NBL-1 Button2, 128 – FMP100 Button, 255 – Enable All)




  • Choose what position should device send when Private mode is enabled in Trip \ Odometer.


  • Parameter ID: 11813GPS Data Masking (0 – Normal, 1 – Data sent as Zero, 2 – Last good known position)




  • Choose whether the distance traveled in private mode should be included in the total odometer in Trip \ Odometer.





  • Choose by what event device should deactivate Private mode in Trip \ Odometer.


  • Parameter ID: 11816Deactivate by (0 – Disable, 1 – Towing detection, 2 – Unplug detection, 4 – Crash detection, 8 – Autogeofence, 15 – Enable All)



  • Choose what trigger type will enable Private mode in Trip \ Odometer.





Quickstart: From default configuration to Pay As You Drive solution in one SMS:

<SMS Login> <SMS Password> setparam 113:1;11800:1;11814:1;11811:128;11813:2;11815:1;11816:4;11849:0

Parsing information

1.Prerequisites

1.1. Open TCP/UDP port

1.2. Read Java parser first start guide

2.Private mode periodic record parsing example

Unparsed received data in hexadecimal stream
00000000000000328E010000017E065DE1B80000000000000000000000000000000000000003000300EF0000F0000187010000000000000000010000793F
AVL Data Packet Part HEX Code Part
Zero Bytes 00 00 00 00
Data Field Length 00 00 00 32
Codec ID 8E (Codec 8 Extended)
Number of Data 1 (Number of Total Records) 01
Timestamp 00 00 01 7E 06 5D E1 B8
Priority 00
Longitude 00 00 00 00
Latitude 00 00 00 00
Altitude 00 00
Angle 00 00
Satellites 00
Speed 00 00
Event IO ID 00 00
N of Total ID 00 03
N1 of One Byte IO 00 03
1’st IO ID 00 EF (AVL ID 239, Name: Ignition)
1’st IO Value 00
2’nd IO ID 00 F0 (AVL ID 240, Name: Movement)
2’nd IO Value 00
3’rd IO ID 01 87 (AVL ID 391, Name: Private mode)
3’rd IO Value 01
N2 of Two Bytes IO 00 00
N4 of Two Bytes IO 00 00
N8 of Two Bytes IO 00 00
NX of X Byte IO 00 00
Number of Data 2 (Number of Total Records) 01
CRC-16 00 00 79 3F


Zero coordinate in Private mode

3.Private mode eventual record parsing example

Unparsed received data in hexadecimal stream
00000000000000328E010000017E065F2208010F0E5880209AAF5E00BF00D114000001870003000300EF0000F0000187000000000000000000010000D182
AVL Data Packet Part HEX Code Part
Zero Bytes 00 00 00 00
Data Field Length 00 00 00 32
Codec ID 8E (Codec 8 Extended)
Number of Data 1 (Number of Total Records) 01
Timestamp 00 00 01 7E 06 5F 22 08
Priority 01
Longitude 0F 0E 58 80
Latitude 20 9A AF 5E
Altitude 00 BF
Angle 00 D1
Satellites 14
Speed 00 00
Event IO ID 01 87
N of Total ID 00 03
N1 of One Byte IO 00 03
1’st IO ID 00 EF (AVL ID 239, Name: Ignition)
1’st IO Value 00
2’nd IO ID 00 F0 (AVL ID 240, Name: Movement)
2’nd IO Value 00
3’rd IO ID 01 87 (AVL ID 391, Name: Private mode)
3’rd IO Value 00
N2 of Two Bytes IO 00 00
N4 of Two Bytes IO 00 00
N8 of Two Bytes IO 00 00
NX of X Byte IO 00 00
Number of Data 2 (Number of Total Records) 01
CRC-16 00 00 D1 82


Zero coordinate in Private mode