Difference between revisions of "EYE BEACON / BTSID1"
(138 intermediate revisions by 16 users not shown) | |||
Line 1: | Line 1: | ||
__TOC__ | __TOC__ | ||
− | ==<p style="font-size:32px | + | ==<p style="font-size:32px><span style="color:#0054A6">Introduction</span></p>== |
Wireless solutions open up new horizons for your business and help to keep an eye on your assets. Discover our | Wireless solutions open up new horizons for your business and help to keep an eye on your assets. Discover our | ||
− | brand-new and certified | + | brand-new and certified Bluetooth Low Energy ID beacon model from Teltonika with robust waterproof |
casing and a long-lifetime battery. The model designed for a low-cost fast and easy configuration and integration to | casing and a long-lifetime battery. The model designed for a low-cost fast and easy configuration and integration to | ||
save precious time, resources, and ensure accountability. | save precious time, resources, and ensure accountability. | ||
− | [[File: | + | [[File:EYE device.png|center|frameless|1157x1157px]] |
==<p style="font-size:32px><span style="color:#0054A6">About BTSID1</span></p>== | ==<p style="font-size:32px><span style="color:#0054A6">About BTSID1</span></p>== | ||
Line 53: | Line 53: | ||
|- | |- | ||
| style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Battery life (Tx=2 dBm; interval: 3 s) | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Battery life (Tx=2 dBm; interval: 3 s) | ||
− | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |5+ years |
− | + | (Tx=2 dBm; interval: 3 s) | |
− | |||
− | |||
|- | |- | ||
| style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Battery life (Tx=2 dBm; interval: 10 s) | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Battery life (Tx=2 dBm; interval: 10 s) | ||
− | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |10 years | + | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |10+ years |
+ | (Tx=2 dBm; interval: 10s) | ||
|} | |} | ||
{| class="wikitable" | {| class="wikitable" | ||
Line 74: | Line 73: | ||
! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | | ! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | | ||
|- | |- | ||
− | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Bluetooth |
− | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Bluetooth 4.2 compliant, |
+ | Bluetooth 5.2 certified | ||
|- | |- | ||
| style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Range | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Range | ||
Line 120: | Line 120: | ||
| style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Yes | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Yes | ||
|} | |} | ||
− | |||
===Dimensions=== | ===Dimensions=== | ||
[[File:Eye dimensions.png]] | [[File:Eye dimensions.png]] | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==<p style="font-size:32px><span style="color:#0054A6">Mounting recomendations</span></p>== | ==<p style="font-size:32px><span style="color:#0054A6">Mounting recomendations</span></p>== | ||
Line 171: | Line 132: | ||
Devices work constantly and are ready to perform out of the box. Default basic Sensor settings are set to: | 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>• Transmitting at 2 dBm power. | ||
− | <br>• Data advertising at | + | <br>• Data advertising at 3 second intervals. |
<br>• Eddystone protocol | <br>• Eddystone protocol | ||
<br> | <br> | ||
Line 180: | Line 141: | ||
===<p style="font-size:24px><span style="color:#0054A6">Eye App Overview</span>=== | ===<p style="font-size:24px><span style="color:#0054A6">Eye App Overview</span>=== | ||
− | '''With the application you will be able to scan for visible Teltonika EYE devices, check their statuses | + | '''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" | |- align="TOP" | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| | | | ||
+ | |[[File:Detailed list - collapsed(2).jpg|border|360x640px|none]] | ||
| | | | ||
− | |[[File: | + | |[[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]] | |
− | |[[File:4. | ||
|} | |} | ||
− | |||
<br> | <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> | [[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> | <br> | ||
− | [[File:Group 125.png|baseline|frameless|upright=0.2|link=|alt=]]'''Overview window | + | [[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> | ||
− | |||
<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 | [[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 | ||
Line 219: | Line 177: | ||
==<p style="font-size:32px><span style="color:#0054A6">FM Tracker Configuration</span></p>== | ==<p style="font-size:32px><span style="color:#0054A6">FM Tracker Configuration</span></p>== | ||
− | ===<p style="font-size:24px"><span style="color:#0054A6">Teltonika configurator ( | + | ===<p style="font-size:24px"><span style="color:#0054A6">Teltonika configurator (standard functionality)</span>=== |
− | If you have firmware / configurator which does not support EYE Beacon tab in | + | If you have firmware / configurator which does not support EYE Beacon tab in Bluetooth 4.0 section, then you can use Beacon list section of the configurator to scan available EYE Beacons. |
<br> | <br> | ||
Below are short instructions which show how we recommend configuring the device to Enable the Beacon functionality for testing. | Below are short instructions which show how we recommend configuring the device to Enable the Beacon functionality for testing. | ||
Line 228: | Line 186: | ||
#In System Settings Enable [[Codec#Codec_8_Extended|Codec8 Extended]]; | #In System Settings Enable [[Codec#Codec_8_Extended|Codec8 Extended]]; | ||
− | #In [[ | + | #In [[FMB120_Bluetooth_settings|Bluetooth]] settings Enable Bluetooth, set this setting as either "Enable (hidden)" or "Enable (visible)", otherwise Bluetooth will be disabled; |
− | #In [[ | + | #In [[FMB120_Bluetooth_4.0_settings|Bluetooth 4.0]] settings, set Non Stop Scan to "Disable", configure "Update Frequency" and "Scan duration" as 30 seconds. These settings will bring the best results for BLE scanning with our device; |
#In [[FMB120_Beacon_List|Beacon list]] settings, configure Beacon Detection as "All" and Beacon Record as "Eventual". This will detect all surrounding Beacons and create Beacon records every 30 seconds. | #In [[FMB120_Beacon_List|Beacon list]] settings, configure Beacon Detection as "All" and Beacon Record as "Eventual". This will detect all surrounding Beacons and create Beacon records every 30 seconds. | ||
[[Image:Beacon_project_V3.gif]] | [[Image:Beacon_project_V3.gif]] | ||
− | ===<p style="font-size:24px"><span style="color:#0054A6">Teltonika configurator new functionalities ( | + | ===<p style="font-size:24px"><span style="color:#0054A6">Teltonika configurator new functionalities (not released yet)</span>=== |
− | ''' | + | '''Bluetooth 4.0''' |
+ | <br> | ||
+ | Functionalities were reorganized and transferred to Bluetooth 4.0 configuration tab with additional horizontal tabs selection for specific settings: | ||
<br> | <br> | ||
+ | * '''Global''' - Parameters responsible for device scanning ability like power and duratations. | ||
+ | * '''Beacon''' - Parameters to enable Beacon scanning scenarios. | ||
<br> | <br> | ||
'''Common settings''' | '''Common settings''' | ||
Line 245: | Line 207: | ||
* '''BLE Scan Duration''' - Sensors data reading time. Recommended value 30. | * '''BLE Scan Duration''' - Sensors data reading time. Recommended value 30. | ||
* '''Scan retries until error''' - Scan retries count, till start to show the value as Error '3000' - sensor disconnected. Recommended value 30. | * '''Scan retries until error''' - Scan retries count, till start to show the value as Error '3000' - sensor disconnected. Recommended value 30. | ||
− | * '''BT Power Level''' - Telematics device | + | * '''BT Power Level''' - Telematics device Bluetooth power level setting. |
* '''BLE Broadcasting service ID''' - Telematics device can broadcast configured ID. | * '''BLE Broadcasting service ID''' - Telematics device can broadcast configured ID. | ||
* ''' BLE connection control''' - Connection mode settings. If broadcasting ID is configured, parameter should be set to Prohibit. | * ''' BLE connection control''' - Connection mode settings. If broadcasting ID is configured, parameter should be set to Prohibit. | ||
<br> | <br> | ||
− | [[File: | + | [[File:Configurator GUI changes.png]] |
− | |||
− | |||
<br> | <br> | ||
− | |||
<br> | <br> | ||
+ | '''Beacons''' | ||
<br> | <br> | ||
Beacons configuration instruction: [https://wiki.teltonika-gps.com/view/How_to_start_with_FMB_devices_and_Beacons%3F How to start with FMB devices and Beacons?] | Beacons configuration instruction: [https://wiki.teltonika-gps.com/view/How_to_start_with_FMB_devices_and_Beacons%3F How to start with FMB devices and Beacons?] | ||
<br> | <br> | ||
<br> | <br> | ||
− | [[File: | + | [[File:EYE Beacons configurator.png]] |
<br> | <br> | ||
<br> | <br> | ||
− | + | '''Beacon detection''' - Parameter controls over all Beacons scanning: [[File:Beacon detection configurator.png|right|border]] | |
− | '''Beacon detection''' - Parameter controls over all Beacons scanning: | ||
* '''Disabled''' – Beacon scanning and transmitting disabled. | * '''Disabled''' – Beacon scanning and transmitting disabled. | ||
* '''All''' – Read all visible beacons; | * '''All''' – Read all visible beacons; | ||
* '''Configured''' – Read only beacons set in Beacon List; | * '''Configured''' – Read only beacons set in Beacon List; | ||
− | '''Beacon Mode''' | + | * '''Teltonika MAC''' – Filter and transmit only Teltonika EYE packets*. |
+ | *It allows to filter only MAC addresses which will be assigned to BTSX device. The MAC address that is currently filtered by this parameter is 7C:D9:F4:0X:XX:XX. | ||
+ | <br> | ||
+ | <br> | ||
+ | '''Beacon record''' [[File:Beacon record on change.png|right|border]] | ||
+ | '''Eventual''' settings have two modes: | ||
+ | * '''Monitoring''' - Beacon record generating every scan period | ||
+ | * '''On change''' - Beacon records are generated only when there are changes in scanned list. | ||
+ | '''Periodic''' - records are generated according to Period settings. When there is no visible beacons, empty record will be generated. | ||
+ | <br> | ||
+ | <br> | ||
+ | '''Beacon Mode''' [[File:Beacon Mode SImple.png|right|border]] | ||
* '''Simple''' - beacon parsing is done automatically (Eddystone and iBeacon protocols are supported). | * '''Simple''' - beacon parsing is done automatically (Eddystone and iBeacon protocols are supported). | ||
− | * '''Advanced''' - beacon data capturing can be configured.<br> | + | * '''Advanced''' - beacon data capturing can be configured. |
− | + | <br> | |
− | + | <br> | |
− | + | '''Filter type''' [[File:Filter Type.png|right|border]] | |
− | + | New firmware has two Beacon lists, so it is possible to create two separate lists of beacons, standard one with Beacons ID (UUID:Major:Minor, or Namespace:InstanceID) and new one according Beacon Name (by name or prefix, for example all beacons with prefix "ID1" can be saved. | |
<br> | <br> | ||
− | ''' | + | * '''Beacon ID''' - configurator allows to configure beacon id in iBeacon or Eddystone format. |
+ | * '''Beacon Name''' - user can enter names of beacons which needs to be filtered. It would filter the full name or only if the prefix of the name is configured like “BTS”. | ||
<br> | <br> | ||
+ | Both ID and Name filters can work at the same time. If beacon doesn’t match ID filter, but matches the name, it will be added to beacon list. Filtering only works Beacon Mode is set to Simple. | ||
<br> | <br> | ||
− | |||
<br> | <br> | ||
− | + | '''Proximity''' [[File:Proximity.png|right|border]] | |
<br> | <br> | ||
− | + | '''Proximity Events''' allow to configure 3 different zones: Near, Away, Far Away. There is additional Lost parameter for beacons which were lost from any of the 3 zones. Averaging timeout determines period how often results are evaluated to avoid fake event detection. Periodic option will generate records at known interval while On Change option will generate record when beacon enters/exits certain zone. | |
− | |||
− | |||
<br> | <br> | ||
− | |||
<br> | <br> | ||
− | ''' | + | '''Proximity IO''' elements have the following structure [[File:1st beacon protocol version.png|bottom|border]] |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==<p style="font-size:32px><span style="color:#0054A6">EYE Beacon Protocol overview</span></p>== | ==<p style="font-size:32px><span style="color:#0054A6">EYE Beacon Protocol overview</span></p>== | ||
Line 359: | Line 262: | ||
===Beacon advertising=== | ===Beacon advertising=== | ||
<br> | <br> | ||
− | [[image:Beacon and sensors data.png|center| | + | [[image:Beacon and sensors data.png|center|819x819px|alt=|frameless]] |
<br> | <br> | ||
<br> | <br> | ||
− | |||
===Protocol description=== | ===Protocol description=== | ||
− | At the highest-level | + | 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> | <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. | 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. | ||
Line 401: | Line 303: | ||
===GATT Characteristics=== | ===GATT Characteristics=== | ||
+ | |||
{| class="wikitable" style="width: 100%; background-color: white; border-bottom: 2px solid #0054A6;" | {| class="wikitable" style="width: 100%; background-color: white; border-bottom: 2px solid #0054A6;" | ||
Line 423: | Line 326: | ||
|- | |- | ||
− | | Device Name || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0016-7df2-4d4e-8e6d-c611745b92e9 || ASCII || 0 || | + | | Device Name || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0016-7df2-4d4e-8e6d-c611745b92e9 || ASCII || 0 || 11 || Unique for each device || - |
|- | |- | ||
Line 431: | Line 334: | ||
|- | |- | ||
− | | Protocol Type|| e61c0000-7df2-4d4e-8e6d-c611745b92e9 || | + | | Protocol Type|| e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0016-7df2-4d4e-8e6d-c611745b92e9 || UINT8 || 0 || 4 || 1 for EYE_Beacon, <br> 4 for EYE_Sensor || 0 - iBeacon <br> 1 - EddyStone <br> 2 - EYE Sensor <br> 3 - iBeacon + EYE Sensor <br> 4 - Eddsytone + EYE Sensor |
− | |||
− | |||
− | |||
− | | 1 for EYE_Beacon, | ||
− | |||
− | |||
− | |||
− | < | ||
− | | 0 - iBeacon | ||
− | 1 - | ||
− | 2 - EYE Sensor | ||
− | 3 - iBeacon + EYE Sensor | ||
− | 4 - | ||
− | |||
− | |||
|- | |- | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
+ | | Advertising Interval|| e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0016-7df2-4d4e-8e6d-c611745b92e9 || UINT16 || 20 || 10000 || 1000 || miliseconds | ||
− | |||
|- | |- | ||
− | | Advertising Interval|| e61c0000-7df2-4d4e-8e6d-c611745b92e9 || | + | | Sub Advertising Interval || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0016-7df2-4d4e-8e6d-c611745b92e9 || UINT16 || 20 || 1000 || 100 || Used by repeats, miliseconds |
|- | |- | ||
− | | | + | | Advertising Repeats || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0016-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 || e61c0016-7df2-4d4e-8e6d-c611745b92e9 || BYTE ARRAY || 20 bytes || 20 bytes || Unique for each device || 16 B - UUID<br>2 B - major<br>2 B - minor |
|- | |- | ||
− | | | + | | Eddystone ID || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0016-7df2-4d4e-8e6d-c611745b92e9 || BYTE ARRAY || 16 bytes || 16 bytes || Unique for each device || 10 B - Namespace<br>6 B - Instance |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | |Password||e61c0000-7df2-4d4e-8e6d-c611745b92e9|| | + | | Password || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0016-7df2-4d4e-8e6d-c611745b92e9 || BYTE ARRAY || 4 bytes ||4 bytes || 123456 || Always 6 Digits |
|- | |- | ||
− | | | + | | Sensor Interval || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0016-7df2-4d4e-8e6d-c611745b92e9 || UINT16 || 0 || 10000 || 1000 || miliseconds |
|- | |- | ||
− | | | + | | Event Interval || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0016-7df2-4d4e-8e6d-c611745b92e9 || UINT16 || 0 || 10000 || 1000 || miliseconds |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | | Event Duration || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0016-7df2-4d4e-8e6d-c611745b92e9 || UINT8 || 0 || 30 || 30 || seconds | |
− | | | ||
− | | | ||
− | |e61c0000-7df2-4d4e-8e6d-c611745b92e9 | ||
− | | | ||
− | |UINT8 | ||
− | |0 | ||
− | | | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | |Manufacturer||180A||2A29||BYTE ARRAY||-||-||Not Configurable ||Read Only. Ex. "Teltonika" | + | | Manufacturer || 180A || 2A29 || BYTE ARRAY || - || - || Not Configurable || Read Only. Ex. "Teltonika" |
|- | |- | ||
− | | Model|| 180A||2A24|| BYTE ARRAY|| -||-|| Not Configurable||Read Only. Ex. "BTSID1" | + | | Model || 180A || 2A24 || BYTE ARRAY || - || - || Not Configurable || Read Only. Ex. "BTSID1" |
|- | |- | ||
− | |Serial||180A||2A25 ||BYTE ARRAY||-||-||Not Configurable ||Not used | + | | Serial || 180A || 2A25 || BYTE ARRAY || - || - || Not Configurable || Not used |
|- | |- | ||
− | | Hardware||180A|| 2A27 ||BYTE ARRAY||-||-||Not Configurable||Read Only. Ex. "Table:1 Volt:325 | + | | 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" | + | | Firmware || 180A || 2A26 || BYTE ARRAY || - || - || Not Configurable || Read Only. Ex. "1.1.0-beta" |
|- | |- | ||
− | | System ID ||180A||2A23||BYTE ARRAY||-||-|| Not Configurable||Not used | + | | 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 | + | | 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 | + | | 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: | + | [[File:GATT_Beacon.png|800px|frameless|center]] |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===FM packet parsing example=== | ===FM packet parsing example=== | ||
Line 648: | Line 422: | ||
|- | |- | ||
|1 Byte | |1 Byte | ||
− | | 1 Byte | + | |1 Byte |
|20/16 Bytes | |20/16 Bytes | ||
− | | 1 Byte | + | |1 Byte |
|… | |… | ||
|- | |- | ||
Line 663: | Line 437: | ||
01 Eddystone with RSSI | 01 Eddystone with RSSI | ||
− | |Beacon – 20B ( | + | |Beacon – 20B (UUDI, major, minor) |
Eddystone – 16B (Namespace, Instance ID) | Eddystone – 16B (Namespace, Instance ID) | ||
Line 672: | Line 446: | ||
|} | |} | ||
− | ====Eddystone example with 1 beacon==== | + | ==== Eddystone example with 1 beacon ==== |
{| class="nd-othertables_2" style="width:100%;" | {| class="nd-othertables_2" style="width:100%;" | ||
|+ | |+ | ||
Line 722: | Line 496: | ||
| style="vertical-align: middle; text-align: center;" |01 81 (385) | | 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;" |N of Total ID |
| style="vertical-align: middle; text-align: center;" |00 01 | | style="vertical-align: middle; text-align: center;" |00 01 | ||
|- | |- | ||
Line 761: | Line 535: | ||
{| class="nd-othertables_2" style="width:100%;" | {| class="nd-othertables_2" style="width:100%;" | ||
|+ | |+ | ||
− | ! colspan="7" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |AVL 385 Parsing | + | ! colspan="7" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" | AVL 385 Parsing |
|- | |- | ||
|Data part | |Data part | ||
Line 769: | Line 543: | ||
|Beacon data #2 | |Beacon data #2 | ||
|- | |- | ||
− | | 1 Byte | + | |1 Byte |
|1 Byte | |1 Byte | ||
|20/16 Bytes | |20/16 Bytes | ||
− | | 1 Byte | + | |1 Byte |
|… | |… | ||
|- | |- | ||
Line 786: | Line 560: | ||
0B154E2D0055 – BLE Beacon Instance ID | 0B154E2D0055 – BLE Beacon Instance ID | ||
− | | | + | | -49 |
| - | | - | ||
| - | | - | ||
Line 792: | Line 566: | ||
|} | |} | ||
− | ====iBeacon example with 2 beacons==== | + | ==== iBeacon example with 2 beacons ==== |
{| class="nd-othertables_2" style="width:100%;" | {| class="nd-othertables_2" style="width:100%;" | ||
Line 843: | Line 617: | ||
| style="vertical-align: middle; text-align: center;" |01 81 (385) | | 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;" |N of Total ID |
| style="vertical-align: middle; text-align: center;" |00 01 | | style="vertical-align: middle; text-align: center;" |00 01 | ||
|- | |- | ||
Line 890: | Line 664: | ||
|Beacon data #2 | |Beacon data #2 | ||
|- | |- | ||
− | | 1 Byte | + | |1 Byte |
− | | 1 Byte | + | |1 Byte |
|20/16 Bytes | |20/16 Bytes | ||
− | | 1 Byte | + | |1 Byte |
|… | |… | ||
|- | |- | ||
|11 – Data part, 1 Record out of 1 Beacon Packet. | |11 – Data part, 1 Record out of 1 Beacon Packet. | ||
|21 – iBeacon with RSSI | |21 – iBeacon with RSSI | ||
− | | | + | |17F8A274D4FBDB62D33E1842F8DF8 – UUID |
014D – Major | 014D – Major | ||
022B – Minor | 022B – Minor | ||
− | | -65 | + | | -65 |
− | |21A579723675064DC396A7C3520129F61900 | + | | 21A579723675064DC396A7C3520129F61900 |
000000BF | 000000BF | ||
|- | |- | ||
Line 919: | Line 693: | ||
|} | |} | ||
− | + | ==<p style="font-size:32px><span style="color:#0054A6">Safety information</span></p>== | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ==<p style="font-size:32px | ||
This message contains information on how to operate BTSID1 safely. By following these requirements and recommendations, you will avoid dangerous situations. You must read these instructions carefully and follow them strictly before operating the device! | This message contains information on how to operate BTSID1 safely. By following these requirements and recommendations, you will avoid dangerous situations. You must read these instructions carefully and follow them strictly before operating the device! | ||
1. To avoid mechanical damage, it is advised to transport the device in an impact-proof package. | 1. To avoid mechanical damage, it is advised to transport the device in an impact-proof package. | ||
− | 2. In case of malfunction contact | + | 2. In case of malfunction contact yours Teltonika account manager or write to technical support team over VIP helpdesk.<br> |
− | [[File:Safety | + | [[File:Safety.jpg]] |
− | ==<p style="font-size:32px | + | ==<p style="font-size:32px><span style="color:#0054A6">Certification & Approvals</span></p>== |
{| class="wikitable" | {| class="wikitable" | ||
|+ | |+ | ||
! style="width:50%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |Certificates | ! style="width:50%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |Certificates | ||
− | ! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | | + | ! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | |
− | |||
|- | |- | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |E-Mark (EU) | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | E-Mark (EU) |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[ | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | [[BTS_E-Mark|YES]] |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | FCC (USA) |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[ | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | [[BTS_FCC|YES]] |
|- | |- | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | CE/RED (EU) |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[ | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | [[BTS_CE_/_RED|YES]] |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | RoHS (EU) |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[ | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | [[BTS_RoHS|YES]] |
|- | |- | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | REACH (EU) |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[ | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | [[BTS_REACH|YES]] |
|- | |- | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Anatel(EU) |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[ | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[BTS_ANATEL|YES]] |
|} | |} | ||
− | ==<p style="font-size:32px | + | ==<p style="font-size:32px><span style="color:#0054A6">External Links</span></p>== |
− | |||
− | ===Product Page=== | + | === Product Page === |
https://teltonika-gps.com/eye/ | https://teltonika-gps.com/eye/ | ||
− | ===Product Change Notifications=== | + | === Product Change Notifications === |
The latest Product Change Notifications can be found: [[BTSID1_Product_Change_Notifications|Product Change Notifications]] | The latest Product Change Notifications can be found: [[BTSID1_Product_Change_Notifications|Product Change Notifications]] | ||
− | === | + | === Frequently asked questions === |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
*[[EYE FAQ#Questions%20about%20Power%20and%20Electrical%20characteristics|Questions about Power and Electrical characteristics]] | *[[EYE FAQ#Questions%20about%20Power%20and%20Electrical%20characteristics|Questions about Power and Electrical characteristics]] | ||
Line 1,450: | Line 744: | ||
*[[EYE FAQ#Other%20questions%20.28Questions%20without%20category.29|Other questions (Questions without category)]] | *[[EYE FAQ#Other%20questions%20.28Questions%20without%20category.29|Other questions (Questions without category)]] | ||
− | === | + | === Quick Manual === |
− | + | [[Media:EYE manual.pdf|Manual PDF]] | |
− | + | [[File:Download_zip.png|x30px|link=Special:Redirect/file/EYE_manual.zip]] | |
− | + | [[Category:EYE Accessories]] | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | [[Category: |
Revision as of 07:19, 7 July 2022
Main Page > Sensors > EYE BEACON / BTSID1Introduction
Wireless solutions open up new horizons for your business and help to keep an eye on your assets. Discover our brand-new and certified Bluetooth Low Energy ID beacon model from Teltonika with robust waterproof casing and a long-lifetime battery. The model designed for a low-cost fast and easy configuration and integration to save precious time, resources, and ensure accountability.
About BTSID1
Perfect for traceability use cases, delivery tracking, monitoring of various movable objects in logistics (trailers, containers), agriculture (tractor attachments), and constructions (tools and inventory). Also, it suitable for indoor tracking solutions for items tracking in warehouses, hospitals, transport hubs and other types of industrial areas. EYE beacon supports iBeacon and Eddystone protocols. The device is fully compatible with the Teltonika firmware platform which provides extended functionality. Configure, scan, and update anytime anywhere with a dedicated Teltonika mobile app.
Product Specification
Features
Functionalities |
---|
Beacon ID, LED |
Dimensions and weight | |
---|---|
Dimensions | 56,6 mm x 38 mm x 13 mm |
Weight 19 g | 18g |
Battery and power (not confirmed) | |
---|---|
Model | CR2450 |
Type | Type Lithium, Manganese Dioxide |
Total Capacity | 600 mAh |
Replaceable | No |
Battery life (Tx=2 dBm; interval: 3 s) | 5+ years
(Tx=2 dBm; interval: 3 s) |
Battery life (Tx=2 dBm; interval: 10 s) | 10+ years
(Tx=2 dBm; interval: 10s) |
Electronic | |
---|---|
Microcontroller | ST Microelectronics BlueNRG-2 |
Connectivity | |
---|---|
Bluetooth | Bluetooth 4.2 compliant,
Bluetooth 5.2 certified |
Range | 80 m |
Available transmission power levels | Up to 8 dBm |
Sensitivity | -88 dBm |
Casing | |
---|---|
Protection | IP67 |
Mounting | Two holes to screw/leash/strip, tape |
Customization | Custom logo upon request (Special conditions) |
Environmental Requirements | |
---|---|
Operational temperature | -20 °C / +60 °C (-4 °F / +140 °F) |
Protocols compatibility | |
---|---|
iBeacon | Yes
*iOS doesn't show devices with iBeacon protocol |
Eddystone | Yes |
Dimensions
Mounting recomendations
EYE App Configuration
Devices work constantly and are ready to perform out of the box. Default basic Sensor settings are set to:
• Transmitting at 2 dBm power.
• Data advertising at 3 second intervals.
• Eddystone protocol
If you would like to change these settings you will need to:
1) Download and install EYE APP - Teltonika application to change sensor settings.
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.
Devices in view: In this window you will see all visible devices. You have options to see devices in Short list or in default list. When looking at devices in default list you will be able to open Detailed view of devices and check transmitted data statuses. Additionaly if you are looking for specific devices you will be able to use Search 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
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.
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.
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
*iOS doesn't show devices with iBeacon protocol
FM Tracker Configuration
Teltonika configurator (standard functionality)
If you have firmware / configurator which does not support EYE Beacon tab in Bluetooth 4.0 section, then you can use Beacon list section of the configurator to scan available EYE Beacons.
Below are short instructions which show how we recommend configuring the device to Enable the Beacon functionality for testing.
Steps to follow according to the visual representation
- In System Settings Enable Codec8 Extended;
- In Bluetooth settings Enable Bluetooth, set this setting as either "Enable (hidden)" or "Enable (visible)", otherwise Bluetooth will be disabled;
- In Bluetooth 4.0 settings, set Non Stop Scan to "Disable", configure "Update Frequency" and "Scan duration" as 30 seconds. These settings will bring the best results for BLE scanning with our device;
- In Beacon list settings, configure Beacon Detection as "All" and Beacon Record as "Eventual". This will detect all surrounding Beacons and create Beacon records every 30 seconds.
Teltonika configurator new functionalities (not released yet)
Bluetooth 4.0
Functionalities were reorganized and transferred to Bluetooth 4.0 configuration tab with additional horizontal tabs selection for specific settings:
- Global - Parameters responsible for device scanning ability like power and duratations.
- Beacon - Parameters to enable Beacon scanning scenarios.
Common settings
- Non Stop Scan - Enable Non Stop Scan feature, the device will try to scan for the sensors all the time if any of them are configured.
- Sensors and Beacons Update frequency - changes sensors temperature/humidity/battery voltage data update frequency. Minimum value: 30s, maximum value: 65535s. Recommended value 30.
- BLE Scan Duration - Sensors data reading time. Recommended value 30.
- Scan retries until error - Scan retries count, till start to show the value as Error '3000' - sensor disconnected. Recommended value 30.
- BT Power Level - Telematics device Bluetooth power level setting.
- BLE Broadcasting service ID - Telematics device can broadcast configured ID.
- BLE connection control - Connection mode settings. If broadcasting ID is configured, parameter should be set to Prohibit.
Beacons
Beacons configuration instruction: How to start with FMB devices and Beacons?
Beacon detection - Parameter controls over all Beacons scanning:
- Disabled – Beacon scanning and transmitting disabled.
- All – Read all visible beacons;
- Configured – Read only beacons set in Beacon List;
- Teltonika MAC – Filter and transmit only Teltonika EYE packets*.
*It allows to filter only MAC addresses which will be assigned to BTSX device. The MAC address that is currently filtered by this parameter is 7C:D9:F4:0X:XX:XX.
Beacon record
Eventual settings have two modes:
- Monitoring - Beacon record generating every scan period
- On change - Beacon records are generated only when there are changes in scanned list.
Periodic - records are generated according to Period settings. When there is no visible beacons, empty record will be generated.
Beacon Mode
- Simple - beacon parsing is done automatically (Eddystone and iBeacon protocols are supported).
- Advanced - beacon data capturing can be configured.
Filter type
New firmware has two Beacon lists, so it is possible to create two separate lists of beacons, standard one with Beacons ID (UUID:Major:Minor, or Namespace:InstanceID) and new one according Beacon Name (by name or prefix, for example all beacons with prefix "ID1" can be saved.
- Beacon ID - configurator allows to configure beacon id in iBeacon or Eddystone format.
- Beacon Name - user can enter names of beacons which needs to be filtered. It would filter the full name or only if the prefix of the name is configured like “BTS”.
Both ID and Name filters can work at the same time. If beacon doesn’t match ID filter, but matches the name, it will be added to beacon list. Filtering only works Beacon Mode is set to Simple.
Proximity
Proximity Events allow to configure 3 different zones: Near, Away, Far Away. There is additional Lost parameter for beacons which were lost from any of the 3 zones. Averaging timeout determines period how often results are evaluated to avoid fake event detection. Periodic option will generate records at known interval while On Change option will generate record when beacon enters/exits certain zone.
Proximity IO elements have the following structure
EYE Beacon Protocol overview
Beacon advertising
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.
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.
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 (Table 1).
Device Name has the following default value for Beacon – ID1_XXXXXXX
Data | Size (Bytes) | Description |
---|---|---|
Flags | 1 | Each set bit (0-7) means the presence of value (0-7). Bits:
Note: only bolded bits (6 and 7) can have value 1, on BTSID1 |
Value 7 | 1 | Battery Voltage
|
GATT Characteristics
Name | Service UUID | Characteristic UUID | Data Type | Min | Max | Default Value | Notes |
---|---|---|---|---|---|---|---|
Device Name | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0016-7df2-4d4e-8e6d-c611745b92e9 | ASCII | 0 | 11 | Unique for each device | - |
Tx Power Lever | 1804 | 2a07 | SINT8 | -14 | 8 | 2 | Possible values: -14, -11, -8, -5, -2, 2, 4, 8 |
Protocol Type | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0016-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 | e61c0016-7df2-4d4e-8e6d-c611745b92e9 | UINT16 | 20 | 10000 | 1000 | miliseconds |
Sub Advertising Interval | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0016-7df2-4d4e-8e6d-c611745b92e9 | UINT16 | 20 | 1000 | 100 | Used by repeats, miliseconds |
Advertising Repeats | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0016-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 | e61c0016-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 | e61c0016-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 | e61c0016-7df2-4d4e-8e6d-c611745b92e9 | BYTE ARRAY | 4 bytes | 4 bytes | 123456 | Always 6 Digits |
Sensor Interval | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0016-7df2-4d4e-8e6d-c611745b92e9 | UINT16 | 0 | 10000 | 1000 | miliseconds |
Event Interval | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0016-7df2-4d4e-8e6d-c611745b92e9 | UINT16 | 0 | 10000 | 1000 | miliseconds |
Event Duration | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0016-7df2-4d4e-8e6d-c611745b92e9 | UINT8 | 0 | 30 | 30 | seconds |
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 |
FM packet parsing example
Beacon (AVL ID:385) has the following structure:
AVL 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
AVL Data Packet | ||
---|---|---|
AVL Data Packet Part | HEX Code Part | |
Zero Bytes | 00 00 00 00 | |
Data Field Length | 00 00 00 40 | |
Codec ID | 8E (Codec8 Extended) | |
Number of Data 1 (Number of Total Records) | 01 | |
AVL Data | Timestamp | 00 00 01 70 1F 9B 3F A9 (GMT: Friday, 07 February 2020 12:23:53.001) |
Priority | 01 | |
Longitude | 0F 0E 50 2A | |
Latitude | 20 9A B4 61 | |
Altitude | 00 74 | |
Angle | 00 C6 | |
Satellites | 0E | |
Speed | 00 00 | |
Event IO ID | 01 81 (385) | |
N of Total ID | 00 01 | |
N1 of One Byte IO | 00 00 | |
N2 of Two Bytes IO | 00 00 | |
N4 of Four Bytes IO | 00 00 | |
N8 of Eight Bytes IO | 00 00 | |
NX of X Bytes IO | 00 01 | |
N’th IO ID - AVL ID. | 01 81 (385) | |
Length of Variable Length IO | 00 13 | |
Value of Variable Length IO | 1101E39B606AA38255AA8E460B154E2D0055CF | |
Number of Data 2 (Number of Total Records) | 01 | |
CRC-16 | 00 00 00 56 |
AVL 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 | … | ||
11 – Data part, 1 Record out of 1 Beacon Packet. | 01 – Eddystone with RSSI | Eddystone – 16B (Namespace, Instance ID)
E39B606AA38255AA8E46 – BLE Beacon Namespace 0B154E2D0055 – BLE Beacon Instance ID |
-49 | - | - | - |
iBeacon example with 2 beacons
AVL Data Packet | ||
---|---|---|
AVL Data Packet Part | HEX Code Part | |
Zero Bytes | 00 00 00 00 | |
Data Field Length | 00 00 00 5A | |
Codec ID | 8E (Codec8 Extended) | |
Number of Data 1 (Number of Total Records) | 01 | |
AVL Data | Timestamp | 00 00 01 6B 69 B0 C9 51(GMT: Tuesday, 18 June 2019 08:25:22.001) |
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 | 01 81 (385) | |
N of Total ID | 00 01 | |
N1 of One Byte IO | 00 00 | |
N2 of Two Bytes IO | 00 00 | |
N4 of Four Bytes IO | 00 00 | |
N8 of Eight Bytes IO | 00 00 | |
NX of X Bytes IO | 00 01 | |
N’th IO ID - AVL ID. | 01 81 (385) | |
Length of Variable Length IO | 00 2D | |
Value of Variable Length IO | 11216B817F8A274D4FBDB62D33E1842F8DF8014D022BBF21A579723675064DC396A7C3520129F61900000000BF | |
Number of Data 2 (Number of Total Records) | 01 | |
CRC-16 | 00 00 3E 5D |
AVL 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 | … | ||
11 – Data part, 1 Record out of 1 Beacon Packet. | 21 – iBeacon with RSSI | 17F8A274D4FBDB62D33E1842F8DF8 – UUID
014D – Major 022B – Minor |
-65 | 21A579723675064DC396A7C3520129F61900
000000BF | ||
- | 21 – iBeacon with RSSI | A579723675064DC396A7C3520129F619 – UUID
0000 – Major 0000 – Minor |
-65 | - | - | - |
Safety information
This message contains information on how to operate BTSID1 safely. By following these requirements and recommendations, you will avoid dangerous situations. You must read these instructions carefully and follow them strictly before operating the device!
1. To avoid mechanical damage, it is advised to transport the device in an impact-proof package.
2. In case of malfunction contact yours Teltonika account manager or write to technical support team over VIP helpdesk.
Certification & Approvals
Certificates | |
---|---|
E-Mark (EU) | YES |
FCC (USA) | YES |
CE/RED (EU) | YES |
RoHS (EU) | YES |
REACH (EU) | YES |
Anatel(EU) | YES |
External Links
Product Page
https://teltonika-gps.com/eye/
Product Change Notifications
The latest Product Change Notifications can be found: Product Change Notifications
Frequently asked questions
- Questions about Power and Electrical characteristics
- Questions about EYE Accessory configuration (EYE APP)
- Questions about FMBxxx compatibility with EYE Accessories
- Questions about Protocols
- Other questions (Questions without category)