293
edits
Changes
→EYE Sensor Capturing Configuration
'''Note''': Due to differencies in iBeacon and Eddystone advertising packets, number of Additional Data offset is different as well.
'''Note''': Due to differencies in iBeacon and Eddystone advertising packets, number of Additional Data offset is different as well.
<br></br>
==== EYE Beacon Capturing Configuration ====
As an example on how to set Beacons Capturing Configuration parameters EYE Beacon can be used. Protocols used can be found [[EYE BEACON / BTSID1|here]].
<br></br>
'''Capturing Flags and Battery voltage example:'''
[[File:Beacon_config_example_flags_and_battery.png|thumb|1143x1143px|Parameter
values]]
<br></br>
'''Capturing Flags example:'''
[[File:IBeacon_EYE_beacon_additional_data_Flag.PNG|thumb|1143x1143px|Parameter values]]
<br></br>
'''Capturing Battery voltage example:'''
[[File:IBeacon_EYE_beacon_additional_data_Battery.PNG|thumb|1143x1143px|Parameter values]]
<br></br>
* '''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.
'''Note''': Due to differences in iBeacon and Eddystone advertising packets, number of Additional Data offset is different as well.
<br></br>
Information shown after setting the parameters. Red rectangle indicates configured EYE Beacons additional data with Flag and Battery Voltage.
[[File:EddyStone_EYE_beacon_additional_data.PNG|left|frameless|545x545px]]
[[File:IBeacon_EYE_beacon_additional_data.PNG|center|frameless|552x552px|Eddystone
temperature]]
<br></br>
In the bellow picture is EddyStone and iBeacon protocol break down, according to Flag and Battery Voltage configuration in additional data. Same logic applies when configuring Flags or Battery Voltage separately
[[File:Protocol_break_down.PNG|center|frameless|1200x800px]]
<br></br>
'''Parsing additional data for iBeacon and EddyStone:'''
<br></br>
'''Example 1'''
Additional Data sent by the EddyStone protocol: '''<span style="background-color:#fff700;">80</span><span style="background-color:#1de1d2;">5F</span>'''
<br></br>
How to parse '''Flags''':
Flag > '''<span style="background-color:#fff700;">80</span>''', Value needs to be converted to Binary > '''<span style="background-color:#8be509;">1</span><span style="background-color:#ff8b00;">0</span>000000'''
'''Note:''' only bits 6 and 7 can have value 1, on BTSID1
Bit <span style="background-color:#ff8b00;">6</span> ā€“ Low Battery indication. 0 ā€“ Means device battery is from 100 to 15 % (When value changes to 1 Battery level is lower than 15 %.
Bit <span style="background-color:#8be509;">7</span> ā€“ Battery voltage value presence. 1 Means device is reading and transmitting battery voltage value.
<br></br>
How to parse '''Battery Voltage''':
Battery > '''<span style="background-color:#1de1d2;">5F</span>''' Value needs to be converted to Decimal > '''<span style="background-color:#1de1d2;">95</span>''' to get the actual voltage this formula has to be used '''<span style="background-color:#1de1d2;">95</span> * 10 + 2000 = 2950 mV'''
<br></br>
'''Example 2'''
Additional Data sent by the iBeacon protocol: '''<span style="background-color:#fff700;">80</span><span style="background-color:#1de1d2;">63</span>'''
<br></br>
How to parse '''Flags''':
Flag > '''<span
style="background-color:#fff700;">80</span>''', Value needs to be converted to Binary > '''<span style="background-color:#8be509;">1</span><span style="background-color:#ff8b00;">0</span>000000'''
'''Note:''' only bits 6 and 7 can have value 1, on BTSID1
Bit <span style="background-color:#ff8b00;">6</span> ā€“ Low Battery indication. 0 ā€“ Means device battery is from 100 to 15 % (When value changes to 1 Battery level is lower than 15 %.
Bit <span style="background-color:#8be509;">7</span> ā€“ Battery voltage value presence. 1 Means device is reading and transmitting battery voltage value.
<br></br>
How to parse '''Battery Voltage''':
Battery > '''<span style="background-color:#1de1d2;">63</span>''' Value needs to be converted to Decimal > '''<span style="background-color:#1de1d2;">99</span>''' to get the actual voltage this formula has to be used '''<span style="background-color:#1de1d2;">99</span> * 10 + 2000 = 2990mV'''
<br></br>
===Beacon List===
===Beacon List===
