Wiki Knowledge Base | Teltonika GPS

Changes

How to start with FMB devices and Beacons? (view source)

Revision as of 09:39, 12 February 2020

15,923 bytes added ,  09:39, 12 February 2020
Created page with "__TOC__ ==Beacon Configuration and data sending== <br> '''Beacon configuration'''<br> Below are short instructions which show how we recommend to configure the device to En..."
__TOC__

==Beacon Configuration and data sending==
<br>
'''Beacon configuration'''<br>

Below are short instructions which show how we recommend to configure the device to Enable the Beacon functionality for testing.


[[Image:Beacon_project_V3.gif]]


'''Beacon data parsing'''<br>

Shown how Beacon data is represented on [[Gurtam_Wialon_with_Fleet_Management_(FM)|Wialon platform]].


[[Image:Wialon Project V3.gif]]

__TOC__

==Parsing of Beacon records==

Beacon records are sent as seperate Records with Event I/O ID 385 and also include I/O element 385 (Codec8 Extended has to be used, because the I/O element 385 uses Variable size IO element).

Received data in hexadecimal stream: <br>
<code>00000000000000D68E01000001701F9B3FA9000F0E5732209AB450006800290400000181000100000000000000000001018100A911214B5C049F515341</code>

<code>FCA950D2C264414E1000050006BA21E2C56DB5DFFB48D2B060D0F5A71096E000000000A92131A74BB76A79423196C916CFB9FAED45002D00159F0700112</code>

<code>233445566778899ABCDE0810047AE0BE80015210F86676BEC91420A94409110029AFAC415B31A0AA101DE9C18E92CA5AA689697365434663222BA21EBBB</code>

<code>DE835D7F4965B5F06C2EDCB3A55300010080A501736B79686F73742E646B000010000128AD01000030CB</code> <br> <br>

'''Example Beacon Record'''<br>
{| class="nd-othertables_2" style="width:100%;"
|+
! colspan="3" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |AVL Data Packet
|-
! colspan="2" rowspan="1" style="width:60%; vertical-align: middle; text-align: center;" |AVL Data Packet Part
! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |HEX Code Part
|-
| rowspan="4" style="vertical-align: middle; text-align: center;" |
| 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 D6
|-
| style="vertical-align: middle; text-align: center;" |Codec ID
| style="vertical-align: middle; text-align: center;" |8E (Codec8 Extended)
|-
| style="vertical-align: middle; text-align: center;" |Number of Data 1 (Number of Total Records)
| style="vertical-align: middle; text-align: center;" |01
|-
| rowspan="24" style="vertical-align: middle; text-align: center;" |AVL Data
| style="vertical-align: middle; text-align: center;" |Timestamp
| style="vertical-align: middle; text-align: center;" |00 00 01 70 1F 9B 3F A9 (GMT: Friday, 07 February 2020 12:23:53.001)
|-
| 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;" |0F 0E 57 32
|-
| style="vertical-align: middle; text-align: center;" |Latitude
| style="vertical-align: middle; text-align: center;" |20 9A B4 50
|-
| style="vertical-align: middle; text-align: center;" |Altitude
| style="vertical-align: middle; text-align: center;" |00 68
|-
| style="vertical-align: middle; text-align: center;" |Angle
| style="vertical-align: middle; text-align: center;" |00 29
|-
| style="vertical-align: middle; text-align: center;" |Satellites
| style="vertical-align: middle; text-align: center;" |04
|-
| 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 81 (385)
|-
| style="vertical-align: middle; text-align: center;" |N of Total ID
| style="vertical-align: middle; text-align: center;" |00 01
|-
| style="vertical-align: middle; text-align: center;" |N1 of One Byte IO
| style="vertical-align: middle; text-align: center;" |00 00
|-
| 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 Four Bytes IO
| style="vertical-align: middle; text-align: center;" |00 00
|-

| style="vertical-align: middle; text-align: center;" |N8 of Eight Bytes IO
| style="vertical-align: middle; text-align: center;" |00 00
|-
| style="vertical-align: middle; text-align: center;" |NX of X Bytes IO
| style="vertical-align: middle; text-align: center;" |00 01
|-
| style="vertical-align: middle; text-align: center;" |Length of Variable Length IO
| style="vertical-align: middle; text-align: center;" |00 A9
|-
| style="vertical-align: middle; text-align: center;" |Value of Variable Length IO
| style="vertical-align: middle; text-align: center;" |11214B5C049F515341FCA950D2C264414E1000050006BA21E2C56DB5<br>DFFB48D2B060D0F5A71096E000000000A92131A74BB76A79423196C916CFB9FAED45002D00159F0700112233445566778899ABCDE081004<br>7AE0BE80015210F86676BEC91420A94409110029AFAC415B31A0AA101DE9C18E92CA5AA689697365434663222BA21EBBBDE835D7F4965B5<br>F06C2EDCB3A55300010080A501736B79686F73742E646B000010000128AD
|-
| 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 30 CB
|-
|}

==Parsing Beacon data from record==
<br>
{| class="nd-othertables_2" style="width:100%;"
|+
! colspan="3" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Beacon data
|-
! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |Unparsed Beacon data
|-
| style="vertical-align: middle; text-align: center;" |11<span style="background:#87CEEB">214B5C049F515341FCA950D2C264414E1000050006BA</span><span style="background:#05CC6F">21E2C56DB5<br>DFFB48D2B060D0F5A71096E000000000A9</span><span style="background:#E6F105">2131A74BB76A79423196C916CFB9FAED45002D00159F</span><span style="background:#E18DE7">0700112233445566778899ABCDE081004<br>7AE0BE80015</span><span style="background:#E84949">210F86676BEC91420A94409110029AFAC415B31A0AA1</span><span style="background:#FF9524">01DE9C18E92CA5AA689697365434663222BA</span><span style="background:#24FFD4">21EBBBDE835D7F4965B5<br>F06C2EDCB3A55300010080A5</span><span style="background:#F700CE">01736B79686F73742E646B000010000128AD</span>
|-
|}
<br>
'''Beacon Flags'''<br>

Below table represents possible Beacon flags. Supported Beacon protocols are iBeacon and Eddystone.
{| class="nd-othertables_2" style="width:25%;"
|+
! colspan="2" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Flags
|-
! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |21
| style="vertical-align: middle; text-align: center;" |iBeacon with RSSI
|-
! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |23
| style="vertical-align: middle; text-align: center;" |iBeacon with RSSI, Battery Voltage
|-
! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |27
| style="vertical-align: middle; text-align: center;" |iBeacon with RSSi, Battery Voltage, Temperature
|-
! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |01
| style="vertical-align: middle; text-align: center;" |Eddystone with RSSI
|-
! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |03
| style="vertical-align: middle; text-align: center;" |Eddystone with RSSI, Battery Voltage
|-
! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |07
| style="vertical-align: middle; text-align: center;" |Eddystone with RSSi, Battery Voltage, Temperature
|}
{| class="nd-othertables_2" style="width:100%;"
|+
! colspan="3" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Parsed Beacon data
|-
! colspan="2" rowspan="1" style="width:60%; vertical-align: middle; text-align: center;" |Parsed Beacon data part
! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |HEX Code Part
|-
| rowspan="50" style="vertical-align: middle; text-align: center;" |
| style="vertical-align: middle; text-align: center;" |Data part<br> (First half byte – current data part, Second half byte – total number of data parts)
| style="vertical-align: middle; text-align: center;" |11
|-

| style="vertical-align: middle; text-align: center;" |BLE beacon flags #1<br> 21 - iBeacon, RSSI is sent
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">21
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon UUID #1
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">4B5C049F515341FCA950D2C264414E10
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Major #1
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">0005
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Minor #1
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">0006
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon RSSI #1
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">BA</span> - Signed 2's Complement -70 dBm
</span>
|-
| style="vertical-align: middle; text-align: center;" |BLE beacon flags #2<br> 21 - iBeacon, RSSI is sent
| style="vertical-align: middle; text-align: center;" |<span style="background:#05CC6F">21
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon UUID #2
| style="vertical-align: middle; text-align: center;" |<span style="background:#05CC6F">E2C56DB5DFFB48D2B060D0F5A71096E0
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Major #2
| style="vertical-align: middle; text-align: center;" |<span style="background:#05CC6F">0000
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Minor #2
| style="vertical-align: middle; text-align: center;" |<span style="background:#05CC6F">0000
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon RSSI #2
| style="vertical-align: middle; text-align: center;" |<span style="background:#05CC6F">A9</span> - Signed 2's Complement -87 dBm
|-
| style="vertical-align: middle; text-align: center;" |BLE beacon flags #3<br> 21 - iBeacon, RSSI is sent
| style="vertical-align: middle; text-align: center;" |<span style="background:#E6F105">21
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon UUID #3
| style="vertical-align: middle; text-align: center;" |<span style="background:#E6F105">31A74BB76A79423196C916CFB9FAED45
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Major #3
| style="vertical-align: middle; text-align: center;" |<span style="background:#E6F105">002D
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Minor #3
| style="vertical-align: middle; text-align: center;" |<span style="background:#E6F105">0015
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon RSSI #3
| style="vertical-align: middle; text-align: center;" |<span style="background:#E6F105">9F</span> - Signed 2's Complement -97 dBm
|-
| style="vertical-align: middle; text-align: center;" |BLE beacon flags #4<br> 07 - Eddystone, Battery Voltage, Temperature, RSSI is sent
| style="vertical-align: middle; text-align: center;" |<span style="background:#E18DE7">07
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Namespace #4
| style="vertical-align: middle; text-align: center;" |<span style="background:#E18DE7">00112233445566778899
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Instance ID #4
| style="vertical-align: middle; text-align: center;" |<span style="background:#E18DE7">ABCDE0810047
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon RSSI #4
| style="vertical-align: middle; text-align: center;" |<span style="background:#E18DE7">AE</span> - Signed 2's Complement -82 dBm
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Battery Voltage #4
| style="vertical-align: middle; text-align: center;" |<span style="background:#E18DE7">0BE8</span> - 3048 mV
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Temperature #4
| style="vertical-align: middle; text-align: center;" |<span style="background:#E18DE7">0015</span> - 21°C
|-
| style="vertical-align: middle; text-align: center;" |BLE beacon flags #5<br> 21 - iBeacon, RSSI is sent
| style="vertical-align: middle; text-align: center;" |<span style="background:#E84949">21
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon UUID #5
| style="vertical-align: middle; text-align: center;" |<span style="background:#E84949">0F86676BEC91420A94409110029AFAC4
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Major #5
| style="vertical-align: middle; text-align: center;" |<span style="background:#E84949">15B3
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Minor #5
| style="vertical-align: middle; text-align: center;" |<span style="background:#E84949">1A0A
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon RSSI #5
| style="vertical-align: middle; text-align: center;" |<span style="background:#E84949">A1</span> - Signed 2's Complement -95 dBm
|-
| style="vertical-align: middle; text-align: center;" |BLE beacon flags #6<br> 01 - Eddystone, RSSI is sent
| style="vertical-align: middle; text-align: center;" |<span style="background:#FF9524">01
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Namespace #6
| style="vertical-align: middle; text-align: center;" |<span style="background:#FF9524">DE9C18E92CA5AA689697
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Instance ID #6
| style="vertical-align: middle; text-align: center;" |<span style="background:#FF9524">365434663222
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon RSSI #6
| style="vertical-align: middle; text-align: center;" |<span style="background:#FF9524">BA</span> - Signed 2's Complement -70 dBm
|-
| style="vertical-align: middle; text-align: center;" |BLE beacon flags #7<br> 21 - iBeacon, RSSI is sent
| style="vertical-align: middle; text-align: center;" |<span style="background:#24FFD4">21
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon UUID #7
| style="vertical-align: middle; text-align: center;" |<span style="background:#24FFD4">EBBBDE835D7F4965B5F06C2EDCB3A553
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Major #7
| style="vertical-align: middle; text-align: center;" |<span style="background:#24FFD4">0001
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Minor #7
| style="vertical-align: middle; text-align: center;" |<span style="background:#24FFD4">0080
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon RSSI #7
| style="vertical-align: middle; text-align: center;" |<span style="background:#24FFD4">A5</span> - Signed 2's Complement -91 dBm
|-
| style="vertical-align: middle; text-align: center;" |BLE beacon flags #8<br> 01 - Eddystone, RSSI is sent
| style="vertical-align: middle; text-align: center;" |<span style="background:#F700CE">01
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Namespace #8
| style="vertical-align: middle; text-align: center;" |<span style="background:#F700CE">736B79686F73742E646B
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon Instance ID #8
| style="vertical-align: middle; text-align: center;" |<span style="background:#F700CE">000010000128
|-
| style="vertical-align: middle; text-align: center;" |BLE Beacon RSSI #8
| style="vertical-align: middle; text-align: center;" |<span style="background:#F700CE">AD</span> - Signed 2's Complement -83 dBm
|-
|}
Retrieved from "https://wiki.teltonika-gps.com/view/Special:MobileDiff/54952"