Changes

no edit summary
Line 1: Line 1:  
__TOC__
 
__TOC__
    +
==Beacon List Settings==
 +
This page is dedicated for explanation of Bluetooth settings and also Beacon parameters in [[Teltonika_Configurator_versions#For_FMB_series|'''FMB device configurator''']]. A more extensive guide can be found [[How to start with FMB devices and Beacons?|'''How to start with FMB devices and Beacons?''']].
 +
===Beacon Settings===
 +
[[File:NewBeaconSettings.png]]
   −
==Beacon Settings==
+
'''Beacon Detection'''
<br>
+
* '''''Disabled''''' – Beacon detection is disabled.
This page is dedicated for explanation of Bluetooth settings and also Beacon parameters in [[Teltonika_Configurator_versions#For_FMB_series|'''FMB device configurator''']]. A more extensive guide can be found [[How to start with FMB devices and Beacons?|'''How to start with FMB devices and Beacons?''']].<br>
+
* '''''All''''' – All visible beacons are detected (Max. 100).
 +
* '''''Configured''''' – device will only capture beacons by given data in Beacon list.
 +
 
 +
'''Beacon Mode'''
 +
* '''''Simple''''' – When simple mode is selected beacon parsing is done automatically (Eddystone and iBeacon protocols are supported) ('''AVL ID 10500''').
 +
* '''''Advanced''''' – When advanced beacon mode is selected, beacon data capturing can be configured manually ('''AVL ID 10500''').
 +
 
 +
'''Beacon Record'''
 +
* '''''On Change''''' device will not create Beacon record after every scan procedure is completed unless scanned Beacon list will change.
 +
* '''''Periodic''''' – All beacons are sent to the server. (Record will be saved according to configured period).
 +
 
 +
'''Beacon Record Priority''' - Beacon record saving period:
 +
*'''''None''''' - No records will be generated
 +
*'''''Low''''' - Beacon record will be generated and sent once link with the server is established
 +
*'''''High''''' - Beacon record will be generated and sent immediately
 +
 
 +
=== Advanced Beacon Capturing Configuration ===
 +
Prior to capturing specific Beacon data it is mandatory to have Beacons communication protocol - advertising packet structure. Without knowing packet structure - it is impossible to configure device properly to capture important data.
 +
 
 +
Functionality allows to capture advertising packet of any kind of Beacon which broadcasts its information automatically. Beacon Capturing Configuration list also can be called as the set of rules to capture and transfer Beacon data. Advanced mode main purpose is to capture additional or only specific data (''by Manufacturers ID'') according to configured Offsets and Data sizes.
   −
'''Beacon Detection'''<br>
+
==== Configurable parameters in Beacons Capturing Configuration table (Advanced Mode) ====
 +
[[File:BeaconMode.gif|right]]
 +
In advanced mode device can detect any Beacon type, the device can be configured to capture data from Universal beacons as seen in the configured in table (The fields in the Beacons Capturing Configuration will be empty), for example this configuration is set to detect iBeacon and EddyStone Beacons, also with additional data(in this case whole packet).
 +
[[File:Beaconsss.png|thumb|1154x1154px]]
 +
* '''Name''' - particular parameter does not affect Beacon capturing at all. You can name particular beacon capturing line as you wish. Note that if "dot" symbol is placed prior to the name - whole line in the table is disabled and beacons will not be captured;
 +
* '''Manufacturer ID''' - most crucial and important part of the configuration. Device will look for provided ID and capture beacons if ID matches. Manufacturer ID consists of 4 Bytes (8bits) and it is required to write in the table full ID of 4 Bytes. Of course, in some cases Manufacturer ID of some Beacons may be shorter - in such case shorter ID can be configured but do not forget to add zeroes after the ID inside configuration – otherwise configuration will not be valid. Actually any numbers could be written because ID size in found Beacon advertising packet can be configured with further parameters;
 +
'''Note:''' Manufacturer ID can be any set of bytes from the advertisement packet but selected bytes must never change in advertised packet.
 +
* '''Manufacturer ID Offset''' - when device finds advertising packet from a beacon, device will check for the Manufacturer ID in specific part of the packet. Particular parameter commands device from which byte in the advertised packet to look for the ID;
 +
* '''Manufacturer ID Size''' - maximum size is 4 Bytes (''same as maximum configurable parameter in Manufacturer ID''). This parameter indicates how many bytes in found advertising packet after offsetting to check. These bytes must match ID configured in Manufacturer ID section. If bytes match - Beacon advertisement packet is captured, if bytes do not match - packet is neglected;
 +
* '''Beacon ID Offset''' - parameter works the same way as Manufacturer ID Offset but main purpose is to capture e.g. UUID of the beacon because Manufacturer ID never changes on the same provider Beacons;
 +
* '''Beacon ID Size''' - parameter works the same way as Manufacturer ID Size but purpose is to capture specific part or whole e.g. UUID (major, minor);
 +
* '''Additional Data Offset''' and '''Additional Data Size''' - allows to capture specific data of the Beacons advertised packet e.g. battery voltage or status. These additional parameters depend on Beacon type and advertisement packet. In order to capture full packet of the Beacon - Offset can be left at 0 and Size matched by actual length of the advertised packet.
 +
* '''Beacon ID Source'''- Beacon ID source can be selected. When Beacon ID is used, source is used as configured in Beacon ID offset and Beacon ID size columns. When Beacon MAC address is selected, Beacon ID will be replaced with MAC address. IO structure remains the same, but Beacon ID size will always be reported as 0x06.
   −
0 (Disabled) – Functionality disabled.<br>
+
==== EYE Sensor Capturing Configuration ====
1 (All) – All visible beacons are detected (Max. 100).<br>
+
As an example on how to set Beacons Capturing Configuration parameters EYE Sensor can be used. Protocols used can be found [[EYE SENSOR / BTSMP1|here]].
2 (Configured) – Only beacons from the list are sent to server<br>
+
[[File:Beacons Capturing Configuration set.png|thumb|1143x1143px|Parameter values]]
 +
[[File:Beacon temp marked.png|right|frameless|545x545px]]
 +
Information shown after setting the parameters. Red rectangle indicates configured EYE sensors.
 +
[[File:Eddystone temperature.png|left|frameless|552x552px|Eddystone temperature]]
 +
<br></br>
 +
<br></br>
 +
<br></br>
 +
<br></br>
 +
<br></br>
   −
'''Beacon Record'''<br>
  −
0 (After Scan) -  Record is sent after succesfull BLE scan. This parameter depends from the [[FMC640 Bluetooth 4.0 settings|'''Bluetooth 4.0 Scan Settings'''.]]<br>
  −
1 (Eventual) – Record is sent after new beacon is detected or previously scanned one is out of range after BLE scan.<br>
  −
2 (Periodic) – All beacons are sent to server. (Record will be saved according to configured period).<br>
     −
'''Record Period''' - Beacon record saving period<br>
     −
Record Period on Move & Record Period on Stop. Timers for record generation when device is moving and staying at place. <br>
  −
Record Period on Move (Default value 60 seconds)<br>
  −
Record Period on Stop (Default value 60 seconds)<br>
     −
[[Image:Beacon_1.PNG|300px|none]]
     −
While selecting the '''Beacons Detection''' as '''All''', the device will detect all beacons which are located around the device.
+
* '''Name''' -  Eddystone and iBeacon were typed to name different sensors.
[[Image:Beacon_2.PNG|300px|none]]
+
*'''Manufacturer ID''' - is taken from protocol description, which can be found [[EYE SENSOR / BTSMP1#Beacon and sensors data|here]]. UUID and Type value is AAFE00 for Eddystone. CompanyID and Beacon Type are used for iBeacon which is 4C000215.
 +
*'''Manufacturer ID Offset''' - passes 9bytes in advertising packet to indicate when Manufacturer ID starts. 5bytes for iBeacon.
 +
*'''Manufacturer ID Size''' - number which indicates size of Manufacturer ID. 3bytes for Eddystone 4bytes for iBeacon.
 +
*'''Beacon ID Offset''' - number used to indicate when Beacon ID starts in advertising packet.
 +
*'''Beacon ID Size''' - number which indicates length of Beacon ID size, Instance ID is set in Eddystone and whole ID in iBeacon.
 +
*'''Additional Data Offset''' and '''Additional Data Size''' - allows to capture specific data of the Beacons advertised packet e.g. Temperature.  
 +
*'''Beacon ID Source'''- configured ID output is shown in pictures. MAC address can be used as Source ID as well, in this case, It would be showed in ID section.
   −
Select '''Beacons Detection''' as the '''Configured''', in this case, the beacons will only be detected and send if they were added to the Beacons List.
+
'''Note''': Due to differencies in iBeacon and Eddystone advertising packets, number of Additional Data offset is different as well.
[[Image:Beacon_3.PNG|300px|none]]
     −
==Beacon List==
+
===Beacon List===
<br>
+
List of authorized beacons, Eddystone and iBeacon protocols are ''supported*.'' Example of the configured beacons detection in the List:<br>
List of authorized beacons. Eddystone and iBeacon protocols are supported*.<br>
+
[[File:BeaconCongif.mp4|1750px]]
   −
[[File:Beacon List.PNG|Beacon List]]
+
''*Beacon Ids can be entered the following way: Namspace:CompanyID, UUID:Major:Minor. Any of the ID parts''
<br>
+
can be omitted ex., Namespace:. UUID::, UUID::Minor, etc
''*''Beacon Ids can be entered the following way: Namspace:CompanyID, UUID:Major:Minor. Any of the ID parts
  −
can be omitted ex., Namespace:. UUID::, UUID::Minotr, etc
      +
The Beacons settings are configured as showed. The iBeacon or Eddystone is added to the list with the following structure:
 +
*'''''iBeacon''''' – 20 Bytes ('''UUDI''' (16-bytes : '''Major'''(2-bytes) : '''Minor''' (2-bytes))
 +
*'''''Eddystone''''' – 16 Bytes ('''Namespace''' (10-bytes) : '''Instance ID'''(6-bytes))
    +
There is a possibility to detect the devices just by UUID or Namespace (see the 2 and 6 elements in the list).
 +
Or by the Major/Minor for iBeacons and Namespace for Eddystone. (see the 3 and 7 elements in the list).<br />
 
There is also possible to select Beacons Detection as the Configured, in this case, the beacons will only be detected and send if they were added to the Beacons List.
 
There is also possible to select Beacons Detection as the Configured, in this case, the beacons will only be detected and send if they were added to the Beacons List.
   −
Example for the configured beacons detection in the List.
+
When Advanced Beacon mode is selected - Beacon list acquires new option too. No longer it is required to insert full UUID, major or minor. In advanced mode it is possible to mask / ignore specific parts of UUID or major, or minor. Symbol " * " is used for masking. This allows to write shorter or only partial UUIDs in the Beacon list. Note: it is not possible to use " * " symbol to mask Manufacturer ID in the Advanced list.
 +
 
 +
===Beacon On Change/Periodic===
 +
[[File:BeaconRecords.png|right] The purpose of it is to create Beacon records only when  there are changes in Beacon List. The parameter Beacon Record '''(Parameter ID: 136)''' has  two possible settings: On Change  (0) and Periodic (1). When On Change is selected, Beacon records are generated only when there are changes in the Beacon list. When Periodic is selected records will be saved according to configured period:
 +
[[File:Beanconperiod.png|frame|left]]<br><br><br><br>
 +
 
      −
Below there is provided the example of the List, while using the '''Beacons Detection source as Configured.''' The provided example is showing the configuration for the iBeacon and Eddy-stone.
+
==== Beacon On Change Scenarios: ====
[[Image:Beacon_list_1.PNG|800px|none]]
+
'''Example 1.'''
 +
 
 +
''Non-Stop Scan'' is Disabled. Scan starts. Beacon is detected and added to the list. Scan ends and Beacon records are created. <br>
 +
*The second scan starts. The same Beacon is still present. Scan ends and the Beacon record is not created because the list has not changed.
 +
*The third scan starts. The same Beacon is still present but disappeared during that scan. Scan ends and Beacon record is not created because it is still considered that this Beacon is valid thus Beacon List hasn’t updated.
 +
*The fourth scan starts. The same Beacon is not present from the start of the scan. Scan ends and Beacon is removed from Beacon list. Record is created since Beacon List has changed.
 +
 
 +
'''Example 2.'''
 +
 
 +
''Non-Stop Scan'' is Disabled. Scan starts. Beacon is detected and added to the list. Scan ends and Beacon records are created.
 +
*The second scan starts. The same Beacon is still present but is lost during that scan. Scan ends and the Beacon record is not created because the list has not changed.
 +
*The third scan starts. At the start of the scan, Beacon was not present but during that scanning period, it has been detected again. At the end of the scan, the Beacon record is not created since Beacon List has not changed.
 +
 
 +
'''Example 3.'''
 +
 
 +
''Non-Stop Scan'' is Enabled. Beacon Timeout is set to 10s. Beacon is detected and added to the list. Beacon record is created immediately after it is detected. The scan continues and during that time Beacon is lost. After 10s if Beacon has not been detected anymore Beacon record will be created. If that Beacon reappears after the set Beacon Timeout (in this case 10s) period has passed for that particular Beacon, a new Beacon record will be created. If That Beacon reappears before set Beacon Timeout (in this case 10s) period has passed. Beacon record will not be created.
 +
 
 +
===Parsing Advanced Beacon data from record (AVL ID 548)===
 +
<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;" |01<span style="background:#87CEEB">360001b10110f34b6f6aa38255aa9ef619154e2d0055021f0201060303aafe1716aafe0002f34b6f6aa38255a<br>a9ef619154e2d00550000</span><span style="background:#4ab92f">360001ab0110e987706aa38255aa94321b154e2d0055021f0201060303aafe1716aafe0<br>002e987706aa38255aa94321b154e2d00550000</span><span style="background:#e6e144">360001a801101e74706aa38255faabcd000000000000021f0201060303aafe1716<br>aafe00021e74706aa38255faabcd0000000000000000</span><span style="background:#fa623d">360001a201100c8c6f6ba38255aab7361a164e2d0055021f0201060303aafe171<br>6aafe00020c8c6f6ba38255aab7361a164e2d00550000</span>
 +
|-
 +
|}
 +
<br>
 +
'''Beacon Parameters'''
   −
The Beacons settings is configured as showed. The iBeacon or Eddystone is added to the list with the following structure:
+
The below table represents possible Beacon Parameters.
 +
{| class="nd-othertables_2" style="width:25%;"
 +
|+
 +
! colspan="2" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Parameters
 +
|-
 +
! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |00
 +
| style="vertical-align: middle; text-align: center;" |RSSI
 +
|-
 +
! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |01
 +
| style="vertical-align: middle; text-align: center;" |Beacon ID
 +
|-
 +
! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |02
 +
| style="vertical-align: middle; text-align: center;" |Additional beacon data
 +
|}
 +
{| 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;" |(Constant)
 +
| style="vertical-align: middle; text-align: center;" |01
 +
|-
   −
iBeacon – 20 Bytes (UUDI (16-bytes:major(2-bytes):minor (2-bytes))
+
| style="vertical-align: middle; text-align: center;" |1st Beacon data length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">36
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |RSSI (Parameter 00)
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">00
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |RSSI length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">01
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |RSSI value
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">B1
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Beacon ID (Parameter 01)
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">01
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Beacon ID length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">10
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Beacon ID
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">F34B6F6AA38255AA9EF619154E2D0055
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Additional data (Parameter 02)
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">02
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Additional data length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">1F
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Additional data
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">0201060303AAFE1716AAFE0002F34B6F6AA38255AA9EF619154E2D00550000
 +
|-
   −
Eddystone – 16B (Namespace (10-bytes):Instance ID(6-bytes))
+
| style="vertical-align: middle; text-align: center;" |2nd Beacon data length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">36
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |RSSI (Parameter 00)
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">00
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |RSSI length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">01
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |RSSI value
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">AB
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Beacon ID (Parameter 01)
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">01
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Beacon ID length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">10
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Beacon ID
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">E987706AA38255AA94321B154E2D0055
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Additional data (Parameter 02)
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">02
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Additional data length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">1F
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Additional data
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">0201060303AAFE1716AAFE0002E987706AA38255AA94321B154E2D00550000
 +
|-
   −
There is possibility to detect the devices just by UUID or Namespace (see the 2 and 6 element in the list).
+
| style="vertical-align: middle; text-align: center;" |3rd Beacon data length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">36
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |RSSI (Parameter 00)
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">00
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |RSSI length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">01
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |RSSI value
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">A8
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Beacon ID (Parameter 01)
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">01
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Beacon ID length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">10
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Beacon ID
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">1E74706AA38255FAABCD000000000000
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Additional data (Parameter 02)
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">02
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Additional data length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">1F
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Additional data
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">0201060303AAFE1716AAFE00021E74706AA38255FAABCD0000000000000000
 +
|-
   −
Or by the Major/Minor for iBeacons and Namespace for Eddystone. (see the 3 and 7 element in the list).<br />
+
| style="vertical-align: middle; text-align: center;" |4th Beacon data length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">36
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |RSSI (Parameter 00)
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">00
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |RSSI length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">01
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |RSSI value
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">A2
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Beacon ID (Parameter 01)
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">01
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Beacon ID length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">10
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Beacon ID
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">0C8C6F6BA38255AAB7361A164E2D0055
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Additional data (Parameter 02)
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">02
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Additional data length
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">1F
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Additional data
 +
| style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">0201060303AAFE1716AAFE00020C8C6F6BA38255AAB7361A164E2D00550000
 +
|-
 +
|}