View source for Proximity functionality Quick Start Guide

__TOC__

==Proximity with GH5200 Quick start guide==

Proximity functionality is used to detect personal space violations by measuring RSSI values between GH5200 devices.<br>
More information about how proximity works could be found [[Proximity|here]].<br><br>
<b>NOTE!</b> We recommend to use the latest version of the firmware. Contact your sales manager to get Teltonika Drive link for those files. Firmware version which is shown in the pictures below it's an example only.


<b>1.</b> In order to start GH5200 proximity testing you should download testing firmware, configurator and configuration. 

{|style="width: 100%;" 
<b>2.</b> Open configurator and connect GH5200: 
<br><br>[[File:First window GH.png|frameless|center|800px]]
<br><br>
|<b>3.</b> Update device with the latest Proximity firmware version:
<br>
[[File:FW update GH open.png|frameless|center|800px]]
<br>
<b>NOTE!</b> After firmware update – format device memory by pressing Format as shown below. Format button is on "Status" section.
[[File:Format GH.png|frameless|center|800px]]
<br><br>
<b>4.</b> Upload downloaded starting configuration to device:
<br><br>
[[File:Cfg upload.png|frameless|center|800px]]
<br><br>
<b>5.</b> If you plan to use server - configure APN, server address and port. These settings can be found in GPRS section.
<br><br>
[[File:Server info GH.png|frameless|center|800px]]
<br><br>
<b>6.</b> Important Proximity parameters in Bluetooth features section:<br>
{|style="width: 100%;"
[[Image:Proximity 349.png|right|frameless|500px]]

*Proximity detection must be <b>Enabled</b> 
*RUTX support selection. This feature allows to transfer the data of Proximity events via Bluetooth using RUTX router.
*Proximity violator type. Beacons could be used to trigger the Proximity events as well. In this case Beacon detection must be configured in <b>Beacon List</b> section. <b>All</b> or <b>Configured</b> should be selected as in the picture below. If <b>Configured</b> is selected, Beacons's UUID, Major and Minor must be entered in the Beacon List. More information about Beacons configuration could be found [[GH5200_Beacon_List|here]].
[[File:Beacon List 349.png|frameless]]

If <b>Teltonika devices</b> is selected as a violator type, in Beacon List section must be selected <b>Teltonika</b> as well:
[[File:Beacon List 349 Teltonika.png|frameless|none]]
*Group ID <b>0</b>  detects all GH5200 devices
*Group ID <b>1 - 255</b> will not detect those GH5200 devices, which has the same Group ID
*<b>Proximity RSSI (dBm)</b> - threshold, which describes maximum allowed RSSI value of surrounding GH5200 devices.
*<b>Proximity RSSI exit threshold </b> - RSSI threshold of exiting the Proximity event.<br>
<b>Example</b>: if <b>Proximity RSSI (dBm)</b> set to -60 and <b>Proximity RSSI exit threshold </b> to 5 - device starts Alarm when signal reached -60, but ends Alarm when RSSI value becomes lower than -65. This function is used to avoid fake exits from the Alarm event, because of RSSI jumps.
<br>
*<b>Proximity RSSI moving average</b> - is used to reduce unexpected RSSI jumps, Proximity feature could use RSSI moving average of values, which were measured in the past time. 
*<b>Proximity RSSI moving average samples</b> describes on how many values are used to calculate an average of the RSSI.
<br>
<b>NOTE! </b>Proximity feature could be disabled or enabled while device is charging. Just click Disable/Enable on <b>Proximity while charging</b> option. Also the device can <b>Advertise only</b>, in this case events won't be generated and indications won't work, but other devices will be able to detect the device.
{|style="width: 100%;"
*<b>Lockdown Indication settings</b> - Proximity and Home Zone Pre-Alarm duration could be configured here.
|[[Image:Lockdown Indication settings.png]]
|}
|}

<br><br>
<b>Important Proximity parameters in Bluetooth 4.0 section:</b>
*Recommended Update Frequency: <b>1</b>
*Recommended BLE Scan duration: <b>1</b>
*Recommended BT Power Level: <b>4</b>


<b>NOTE!</b> Higher Update frequency/BLE Scan Duration value will cause longer delay of Proximity detection.
[[File:BLE 4.0 349.png|frameless|center|800px]]
<br><br>
<b>7. </b>Indication of the Proximity Pre-Alarm and Alarm could be set in <b>User Interface</b> section. It is the same option as Home Zone:
<br><br>
[[File:Indication 349.png|frameless|center|1000px]]
|}
<br><br>

{| class="wikitable" style="border-style: solid; border-width: 0px;"
|<b>Configuration example for medium range with 55.00.08.Rev.349 firmware</b>
|
*Proximity RSSI (dBm): <b>-63</b>
*Proximity RSSI exit threshold: <b>2</b>
*Proximity RSSI moving average samples: <b>2</b>
*Update Frequency: <b>1</b><br>
*BLE Scan duration: <b>1</b>
*BT Power Level: <b>4</b>
|}

==AVL ID’s and Data Structure==
<br>
AVL ID <b>889</b> record describe the causes of violation:<br>
<b>0</b> – No violation;<br>
<b>16</b>  - RSSI threshold Proximity violation.<br><br>
AVL ID <b>875</b> record represents device <b>IMEI</b> address which violates personal space.
<br><br>

<b>Example of the IMEI conversion from raw data (HEX) to decimal:</b><br><br>
1. HEX -> ASCII (String) <br>
3031343731353942383241454643 -> 0147159B82AEFC <br>
2. HEX -> DEC<br> 
0147159B82AEFC -> <b>359633105628924</b>
<br><br>
AVL ID <b>890</b> - Violation time. It's time which counts from getting AVL 889 with value 16 (RSSI threshold Proximity violation) to AVL 889 with value 0 (No violation) of each separate device.
<br><br>
<b>Proximity states:</b><br><br>
[[File:Proximity States v3.png|frameless|center|800px]]
<br><br><br>

===Example of the data packet:===

<br>
When Proximity is violated:<br>
{| class="wikitable" style="border-style: solid; border-width: 0px;"
|00000000000000548E0100000174D44B614000000000000000000000000000000000036B0004000103791000000001037A0000000000000002036B000E3031343
731353546443338414342037B000C434330324332364131454244010000A1F3 
|}
[[File:Prox start.png|frameless|center|800px]]
<br>
When violator leaves personal space (end of Proximity violation):<br>
{| class="wikitable" style="border-style: solid; border-width: 0px;"
|00000000000000548E0100000174D44B74C800000000000000000000000000000000036B0004000103790000000001037A0000000400000002036B000E303134373
1353546443338414342037B000C4343303243323641314542440100006512 
|}
[[File:Prox end.png|frameless|center|800px]]
<br>
<br><br>
Example of the server view:
<br><br>
[[File:Server proximimimimi.png|frameless|center|1000px]]


[[Category: GH5200 FAQ]]