| Line 80: |
Line 80: |
| | * '''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. | | * '''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. |
| | | | |
| − | ==== EYE Sensor Capturing Configuration ====
| |
| − | 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]].
| |
| − | [[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>
| |
| | | | |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − | * '''Name''' - Eddystone and iBeacon were typed to name different sensors.
| |
| − | *'''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.
| |
| − |
| |
| − | '''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 ==== | | ==== EYE Beacon Capturing Configuration ==== |
| | | | |
| Line 121: |
Line 95: |
| | [[File:IBeacon_EYE_beacon_additional_data_Battery.PNG|thumb|1143x1143px|Parameter values]] | | [[File:IBeacon_EYE_beacon_additional_data_Battery.PNG|thumb|1143x1143px|Parameter values]] |
| | <br></br> | | <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. | | 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:EddyStone_EYE_beacon_additional_data.PNG|left|frameless|545x545px]] |
| Line 183: |
Line 146: |
| | | | |
| | 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''' | | 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> |
| | + | ==== EYE Sensor Capturing Configuration ==== |
| | + | 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]]. |
| | + | [[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> |
| | + | |
| | + | |
| | + | |
| | + | |
| | + | |
| | + | * '''Name''' - Eddystone and iBeacon were typed to name different sensors. |
| | + | *'''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. |
| | + | |
| | + | '''Note''': Due to differencies in iBeacon and Eddystone advertising packets, number of Additional Data offset is different as well. |
| | <br></br> | | <br></br> |
| | | | |
