Changes

Configuring EYE beacons (view source)

Revision as of 11:58, 14 April 2023

20,223 bytes added ,  11:58, 14 April 2023
Created page with " __TOC__ ==EYE App Configuration== Devices work constantly and are ready to perform out of the box. Default basic Sensor settings are set to: <br>• Transmitting at 2 dBm po..."

__TOC__
==EYE App Configuration==

Devices work constantly and are ready to perform out of the box. Default basic Sensor settings are set to:
<br>• Transmitting at 2 dBm power.
<br>• Data advertising at 3 second intervals.
<br>• Eddystone protocol
<br>
<br> If you would like to change these settings you will need to:
<br>1) Download and install EYE APP - Teltonika application to change sensor settings.
<br>[[File:QR.jpg]]
<br>

===Eye App Overview===
'''With the application you will be able to scan for visible Teltonika EYE devices, check their statuses or connect for configuration or firmware update.'''
<br>
{|
|- align="TOP"
|
|[[File:Detailed list - collapsed(2).jpg|border|360x640px|none]]
|
|[[File:Overview - without update (beacon)(2).png|border|360x640px|none]]
|
|[[File:Basic settings(2).png|right|border|360x640px]]
|
|[[File:Advance settings 4.png|right|border|360x640px]]
|}

<br>
[[File:Frame 115.png|bottom|frameless|upright=0.2|link=|alt=]] '''Devices in view''': In this window you will see all visible devices. You have options to see devices in Short list [[File:Shortlist.jpg|30px]] or in default list. When looking at devices in default list you will be able to open Detailed view [[File:Detailed.jpg]] of devices and check transmitted data statuses. Additionaly if you are looking for specific devices you will be able to use Search [[File:Search button eye app.jpg|30px]] function to filter search options. When in this window select a device of your choice to connect and after passing pin code (default pin code is 123456) you will go to device overview window<br>
<br>
[[File:Group 125.png|baseline|frameless|upright=0.2|link=|alt=]]'''Overview window''': In overview window you can see device details, check firmware version and update if available , go to device configuration settings. If you select to Configure device new window will open with Basic and Advanced settings.
<br>
<br>
[[File:Group 116.png|sub|frameless|upright=0.2|link=|alt=]]'''Configure window''': In this window you can check and change device configuration settings. In main tab Basic Settings you can change main settings. Change Device name, Power signal strength, Advertising interval and Packet transmition type*. For more settings go to Advanced settings tab to enable various events.
<br>
<br>
[[File:Group 117.png|sub|frameless|upright=0.2|link=|alt=]]'''Advanced configuration window''': Beacon information (iBeacon ID*, Eddystone ID). UUID/MINOR/MAJOR parameter can be changed for iBeacon ID*. Namespace ID/Instance ID can be changed for Eddystone ID

{|
|- align="TOP"
|
[[File:IBeacon ID settings.png|frameless]]
|
|[[File:Eddystone ID settings.png|frameless]]
|}
'''*iOS doesn't show devices with iBeacon protocol'''

==Configuring device==
[[File:Alert.png|30px]] <b>Before Beacon configuration, visit how to set up your device for the very first data sending to the server:</b>
[[First_time_with_Teltonika_device#Setting_up_your_configuration_for_the_very_first_data_sending_to_the_server | Setting up your configuration for the very first data sending to the server]]

These are instructions on how to easily configure EYE beacon with Teltonika Configurator on GH5200 device.<br>

<b>1.</b> First the device <b>Bluetooth settings</b> need to be configured. These are the required steps:<br>
* Press Bluetooth settings
* Turn on BT Radio by pressing Enable (hidden) or Enable (visible)

[[Image:BLE_enable.gif|1000px|frame|center]]<br>

<b>2.</b> Press <b>Beacon list</b> tab.<br>
* Select <code>All</code> or <code>Configured</code> (for seeing only preferred beacons) in Beacon Detection options.<br>
* If you have selected <code>Configured</code> to see preferred beacons, you must add beacons to the Beacons list.<br>
* Select <code>Periodic</code> option
* Set <b>Periodic settings</b> according to your needs.<br>
* After all these steps press Save to device to save the configuration.<br>

[[File:Alert.png|30px]] <b>To find out how to add beacons to the Beacons list, click on one of the devices:</b>
[[TST100 Beacon List|TST100]] | [[TFT100 Beacon List|TFT100]] | [[GH5200 Beacon List|GH5200]] | [[TMT250 Beacon List|TMT250]]
<br>

[[Image:Beaconlistall.gif|100px|frame|center]]<br>


<b>3.</b> Now you can see detected Beacons in <b>Status -> Beacons List</b><br>
<br>
[[Image:Beacons_list.png|100px|frame|center]]<br>

<b>4.</b> Example of the server view:<br>
<br>
[[Image:Serverview_beacon1.png|1000px|center]]<br>

In the server view picture above, displayed:
* The date when the packet arrived to the server
* Device IMEI number
* AVL ID 385 – Beacon AVL ID
* Beacon ID and RSSI <br>

Beacon 1 ID: <code>0102030405060708090A0B0C0D0E0F00020B010A</code><br>
Beacon 1 Major: <code>020B</code><br>
Beacon 1 Minor: <code>010A</code><br>
RSSI: <code>-60</code> <br>
<br>
Beacon 2 ID: <code>AAAAAAAAAAAAAAAAAABBCC526F6F6D31</code><br>
Beacon 2 Major: <code>5231</code><br>
Beacon 2 Minor: <code>010A</code><br>
RSSI: <code>-56</code>
<br>

==EYE Beacon Protocol Overview==

===Beacon advertising===
<br>
[[image:Beacon and sensors data.png|center|819x819px|alt=|frameless]]
<br>
<br>
====Protocol description====
At the highest-level Bluetooth LE advertising packet consists of Advertising Indication and Scan Response. Both packets can be maximum of 31 bytes in size. Advertising Indication packet is always broadcasted when Scan Response is broadcasted only if Observer device requests it by using Active Scan.
<br><br>
BTSMP1 uses Advertising Indication to send beacon data which can be configured to select between iBeacon and Eddystone protocols or to be disabled at all. In that case, data which is shown as Scan Response in protocol overview will be sent as Advertising Indication without Scan Response following it.
<br><br>
Scan Response is used to send device name and manufacturer specific data. Manufacturer specific data includes Teltonika Company ID (0x089A) and protocol version (0x01). It is followed by Flag Encoded Data.
<br><br>
Device Name has the following default value for Beacon – ID1_XXXXXXX
<br>

====Flag Encoded Data====
{| class="wikitable" style="width:100%; align:center;"
|+
! style="width:10%;border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |Data
! style="width:30%;border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: center;" |Size(Bytes)
! style="width:30%;border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: center;" |Description
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Flags
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: center; vertical-align: center; background: white;" |1
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Each set bit (0-7) means the presence of value (0-7). Bits:
<br>0 – Temperature value presence
<br>1 – Humidity value presence
<br>2 – Magnetic sensor presence
<br>3 – Magnetic sensor state (1 magnetic field is detected/0 magnetic field is not detected) Valid value is present only if bit 2 flag is set.
<br>4 – Movement sensor counter
<br>5 – Movement sensor angle
<br>'''6 – Low Battery indication (if set to 1 low battery voltage detected)
<br>'''7 – Battery voltage value presence'''
<br>'''Note:''' only bolded bits (6 and 7) can have value 1, on BTSID1
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |7 - Battery voltage value presence
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: center; vertical-align: center; background: white;" |1
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Battery Voltage
<br>Battery voltage in mV = 2000 + VALUE * 10
<br><b>Note:</b> present only if bit 7 is set, otherwise is not being sent
|}

===GATT Characteristics===
{| class="wikitable" style="width: 100%; background-color: white; border-bottom: 2px solid #0054A6;"
|-
! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6; width: 20px;" |Name
! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6; width: 280px;" |Service UUID
! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6; width: 280px;" |Characteristic UUID
! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6;" |Data Type
! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6;" |Min
! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6;" |Max
! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6; width: 120px" |Default Value
! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6;" |Notes
|-
|Device Name||e61c0000-7df2-4d4e-8e6d-c611745b92e9||e61c0016-7df2-4d4e-8e6d-c611745b92e9||ASCII||0||11||Unique for each device||-
|-
|Tx Power Lever||1804||00002a07-0000-1000-8000-00805f9b34fb||SINT8||-14||8||2||Possible values: -14, -11, -8, -5, -2, 2, 4, 8
|-
|Protocol Type||e61c0000-7df2-4d4e-8e6d-c611745b92e9||e61c0001-7df2-4d4e-8e6d-c611745b92e9||UINT8||0||4||1 for EYE_Beacon,
4 for EYE_Sensor
|0 - iBeacon
1 - EddyStone
2 - EYE Sensor
3 - iBeacon + EYE Sensor
4 - Eddsytone + EYE Sensor
|-
|Advertising Interval||e61c0000-7df2-4d4e-8e6d-c611745b92e9||e61c0002-7df2-4d4e-8e6d-c611745b92e9||UINT16||20||10000||1000||miliseconds
|-
|Sub Advertising Interval||e61c0000-7df2-4d4e-8e6d-c611745b92e9||e61c0003-7df2-4d4e-8e6d-c611745b92e9||UINT16||20||1000||100||Used by repeats, miliseconds
|-
|Advertising Repeats||e61c0000-7df2-4d4e-8e6d-c611745b92e9||e61c0004-7df2-4d4e-8e6d-c611745b92e9||UINT16||1||10||1||Repeats work only if Advertising Interval is more than 2000 ms and Repeats set to more than 1
|-
|iBeacon ID||e61c0000-7df2-4d4e-8e6d-c611745b92e9||e61c0005-7df2-4d4e-8e6d-c611745b92e9||BYTE ARRAY||20 bytes||20 bytes||Unique for each device||16 B - UUID
2 B - major
2 B - minor
|-
|Eddystone ID||e61c0000-7df2-4d4e-8e6d-c611745b92e9||e61c0006-7df2-4d4e-8e6d-c611745b92e9||BYTE ARRAY||16 bytes||16 bytes||Unique for each device||10 B - Namespace
6 B - Instance
|-
|Password||e61c0000-7df2-4d4e-8e6d-c611745b92e9||e61c0008-7df2-4d4e-8e6d-c611745b92e9||BYTE ARRAY||4 bytes||4 bytes||123456||Always 6 Digits
|-
|Manufacturer||180A||2A29||BYTE ARRAY||-||-||Not Configurable||Read Only. Ex. "Teltonika"
|-
|Model||180A||2A24||BYTE ARRAY||-||-||Not Configurable||Read Only. Ex. "BTSID1"
|-
|Serial||180A||2A25||BYTE ARRAY||-||-||Not Configurable||Not used
|-
|Hardware||180A||2A27||BYTE ARRAY||-||-||Not Configurable||Read Only. Ex. "Table:1 Volt:325
|-
|Firmware||180A||2A26||BYTE ARRAY||-||-||Not Configurable||Read Only. Ex. "1.1.0-beta"
|-
|System ID||180A||2A23||BYTE ARRAY||-||-||Not Configurable||Not used
|-
|MAC||180A||652143dc-dec6-4fb1-bd46-3e919d2410a6||BYTE ARRAY||6||6||Not Configurable||Read Only. ex. 112233445566 -> 11:22:33:44:55:66
|-
|Scan Response Data||e61c0000-7df3-4d4e-8e6d-c611745b92e9||e61c0001-7df3-4d4e-8e6d-c611745b92e9||BYTE ARRAY||17||17||Not Configurable||Scan Response Data, see picture for detail view of data structure
|}[[File:GATT_Beacon.png|800px|frameless|center]]


===Packet parsing example===
Beacon AVL ID:385 has the following structure:
{| class="nd-othertables_2" style="width:100%;"
|+
! colspan="7" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |AVL ID 385 Parsing
|+
|Data part
|BLE beacon flags #1
|Beacon ID #1
|Signal Strength #1
|Beacon data #2
|-
|1 Byte
|1 Byte
|20/16 Bytes
|1 Byte
|…
|-
|First half byte – current data part

Second half byte – total number of data parts
|Bitwise parameter, specify BLE beacon type and parameters.

Two options available are:

21 iBeacon with RSSI

01 Eddystone with RSSI
|Beacon – 20B (UUDI, major, minor)

Eddystone – 16B (Namespace, Instance ID)
|Signed 2's complement
|
|
|
|}
==== Eddystone example with 1 beacon ====
{| 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 40
|-
| 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;" |01
|-
| style="vertical-align: middle; text-align: center;" |Longitude
| style="vertical-align: middle; text-align: center;" |0F 0E 50 2A
|-
| style="vertical-align: middle; text-align: center;" |Latitude
| style="vertical-align: middle; text-align: center;" |20 9A B4 61
|-
| style="vertical-align: middle; text-align: center;" |Altitude
| style="vertical-align: middle; text-align: center;" |00 74
|-
| style="vertical-align: middle; text-align: center;" |Angle
| style="vertical-align: middle; text-align: center;" |00 C6
|-
| style="vertical-align: middle; text-align: center;" |Satellites
| style="vertical-align: middle; text-align: center;" |0E
|-
| 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;" |N’th IO ID - AVL ID.
| style="vertical-align: middle; text-align: center;" |01 81 (385)
|-
| style="vertical-align: middle; text-align: center;" |Length of Variable Length IO
| style="vertical-align: middle; text-align: center;" |00 13
|-
| style="vertical-align: middle; text-align: center;" |Value of Variable Length IO
| style="vertical-align: middle; text-align: center;" |1101E39B606AA38255AA8E460B154E2D0055CF
|-
| 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 00 56
|-
|}
==== iBeacon example with 2 beacons ====
{| 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 5A
|-
| 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 6B 69 B0 C9 51(GMT: Tuesday, 18 June 2019 08:25:22.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;" |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;" |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;" |N’th IO ID - AVL ID.
| style="vertical-align: middle; text-align: center;" |01 81 (385)
|-
| style="vertical-align: middle; text-align: center;" |Length of Variable Length IO
| style="vertical-align: middle; text-align: center;" |00 2D
|-
| style="vertical-align: middle; text-align: center;" |Value of Variable Length IO
| style="vertical-align: middle; text-align: center;" |11216B817F8A274D4FBDB62D33E1842F8DF8014D022B<br>BF21A579723675064DC396A7C3520129F61900000000BF
|-
| 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 3E 5D
|-
|}
Martyna.D
0

edits

Retrieved from "https://wiki.teltonika-gps.com/view/Special:MobileDiff/84521"

Navigation menu