# \[APP\]\[Pro\] Beacon - Detect your presence with BLE beacons

**URL:** <https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550>\
**Category:** Apps\
**Tags:** app, tools, homey-pro\
**Created:** [November 1, 2018, 5:45pm UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550 "2018-11-01T17:45:20Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![Koktail](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/koktail/32/51498_2.png) [@Koktail](https://community.homey.app/u/Koktail)\
**Post date:** [November 1, 2018, 5:45pm UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/1 "2018-11-01T17:45:20Z")

</div>

![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/9/911189bc0fcb70cf9a8a350a0d8ae4a208282d67.jpeg)

# Beacon

# Links:

> **[Beacon | Homey](https://homey.app/en-us/app/com.koktail.beacon/Beacon/)**
>
> Detect your presence with BLE beacons

> **[GitHub - koktaildotcom/com.beacon: Integrate BLE beacons into Homey](https://github.com/koktaildotcom/com.beacon)**
>
> Integrate BLE beacons into Homey

## Introduction

This app integrate the basic flows for BLE beacons into Homey. Once the app is installed it will do a discovery of BLE devices, after a short adjustable timeout it wil keep discovering. After each discovery the app compares the found devices with the one paired. If the beacon is not found within the new “discovered list” the beacon is changed in state.

For filtering out false positives there is a verification amount inside or outside the range available in the settings. This setting is the amount of times the beacon needs to be changed before it wil marked as such. The amount will be reset if the beacon is not in that current state.

## Support

Do you like the app? [Donate me a beer!](https://www.paypal.me/koktaildotcom)

## Q&A

> **Q1** Why is the beacon marked ‘outside range’ when i use the beacon with my phone?

_If a BLE beacon is connected to a device (phone) it cannot be discovered anymore and the app set the device as away. You can prevent this by removing the app from your phone._

> **Q2** Why is the beacon marked ‘outside range’ after a couple of minutes?

_Your beacon is powering down for saving energy. Sometimes this is configurable by the manufacturer his software._

> **Q3** Is the app compatibel with v2.0.0?

_The app will be compatible from version v1.2.1 on Homey firmware \> v2.0.5_

### Supported devices:

- Generic BLE beacon (every BLE device that is public discoverable)

#### Tested devices

Here is a list of used devices

| Beacon name | Max range (through concrete) |
| --- | --- |
| _Tile Pro_ | _8m_ |
| _Tile Mate_ | _8m_ |
| _Nordic nRF51822_ | _5m_ |
| _Keeper_ | _8m_ |
| _iTag_ | _5m_ |
| _Nedis mini_ | _3m_ |
| _Lapa_ | _?m_ |

> ‼ WARNING: The tile pro 2020 and tile mate 2020 does not work because it is not publicly discover-able

## Usage

1. Install app
2. Make the device discover-able.
3. Add device(s) to Homey.
4. Make a flow with one of the cards.

## Settings

There are some settings to improve and tweak the apps behaviour.

> ‼ WARNING: Changing this settings can result into an unstable situation.

#### Update settings

The delay between reading sensor values in seconds. (default 10 seconds)

#### Discovery timeout

The amount of seconds that is given to discover the beacons. (5 seconds)

#### VerificationAmountInside

The amount of verifications the app need to mark a beacon inside the range. (1 time)

#### VerificationAmountOutside

The amount of verifications the app need to mark a beacon outside the range. (5 times)

## Cards

An overview of all the trigger cards that can be used

Triggers  
(Global) A beacon detected state is changed (beacon name, detected)  
(Global) A beacon is inside range (beacon name)  
(Global) A beacon is outside range (beacon name)  
(Global) A beacon has been discovered (beacon name, uuid)  
(Global) The app generates a log (log)  
(Device) The beacon detected state is changed (beacon name, detected)  
(Device) The beacon is inside range (beacon name)  
(Device) The beacon is outside range (beacon name)

## History

### v1.0.0 - 04.10.18

- first alpha to app store.

### v1.0.1 - 05.10.18

- add support for NRF51822
- add app icon
- refactoring the drivers

### v1.0.2 - 07.10.18

- add trigger card for discovered devices
- add icon for discovery

### v1.0.3 - 07.10.18

- add generic device

### v1.0.4 - 20.10.18

- add verify process for detect/undetect events

### v1.0.5 - 07.10.24

- improve discovery of the devices
- change card description

### v1.0.6 - 07.10.24

- improve by connection and find the advertisement

### v1.0.7 - 07.10.24

- bump version

### v1.0.8 - 07.10.25

- improve sequence update beacons
- get peripheral for accurate range
- change timeout to 1 second
- improve logging to the app
- add retry strategy

### v1.0.9 - 07.10.25

- bump version

### v1.0.10 - 07.10.27

- introducing timeout and verification settings
- revert back to discovery strategy to improve speed
- add translations
- improve logging

### v1.0.11 - 07.10.27

- mismatch variable name bug
- also check on bigger that the amount if app restarts

### v1.0.12 - 07.10.30

- add default values in settings
- change comparator typo

### v1.0.13 - 07.11.01

- fixed change detect comparison mismatch
- add log handler to watch false positives
- fixed zero verification times

### v1.0.14 - 11.11.2018

- add homeyCommunityTopicId
- add version number app for logging
- add triggercards detect state changed

### v1.0.15 - 04.12.2018

- resolved issue of not triggering the device `change` cards

### v1.0.16 - 06.12.2018

- add BLE permission into manifest

### v1.0.17 - 10.12.2018

- removed BLE permission into manifest due to incompatibility with \< v2.0.0

### v1.2.0 - 12.12.2018

- moved registering cards to the app due to make them work in 2.0

### v1.2.1 - 11.01.2018

- update icon because of wrong viewport

### v1.2.2 - 01.03.2019

- update icon capability

### v1.2.3 - 07.03.2019

- update the discovery sequence for pairing

### v1.2.4 - 14.03.2019

- introduce condition card for beacon in/not in zone

### v1.2.5 - 18.03.2019

- bump version v1.2.4

### v1.2.6 - 27.03.2019

- fixed typo in the condition card

### v1.2.7 - 28.04.2019

- add warning if the beacon is outside range
- change discovery timeout to 10 seconds

### v1.2.8 - 23.05.2019

- removed warning because condition cards won’t trigger again

### v1.2.9 - 23.05.2019

- bump 1.2.8 due to app store bug

## Final note

The repository is available at: [GitHub - koktaildotcom/com.beacon: Integrate BLE beacons into Homey](https://github.com/koktaildotcom/com.koktail.beacon)

---

<div class="post-metadata">

**Author:** ![Koktail](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/koktail/32/51498_2.png) [@Koktail](https://community.homey.app/u/Koktail)\
**Post date:** [November 1, 2018, 5:54pm UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/2 "2018-11-01T17:54:58Z")

</div>

A tutorial can by found here:

> [@\[Tutorial\] Presence detection with bluetooth beacon](https://community.homey.app/t/tutorial-presence-detection-with-bluetooth-beacon/3536):
>
> Tutorial version: 0.2 Goal: Presence detection hardware: Tile Pro website: thetileapp (dot) com App: [Beacon](https://apps.athom.com/app/com.koktail.beacon) (credits Leendert De Kok ) App topic : [HERE](https://community.homey.app/t/beacon-using-ble-beacons-for-presence-detection/3550) It’s hard to find a good solutions for presence, after testing with wifi connections and z-wave/kaku remotes i tried it with bluetooth beacon on a keychain. The result is working perfectly. Install the beacon app (appstore). Buy a beacon (i use a Tile Pro (2 devices for 60 euro, deliverd in the netherlands within 24hours ;-). Add the…

---

<div class="post-metadata">

**Author:** ![Toon\_Vos](https://avatars.discourse-cdn.com/v4/letter/t/57b2e6/32.png) [@Toon\_Vos](https://community.homey.app/u/Toon_Vos)\
**Post date:** [November 2, 2018, 5:57am UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/3 "2018-11-02T05:57:41Z")

</div>

Would a iPhone work as beacon?

---

<div class="post-metadata">

**Author:** ![Jamie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jamie/32/5274_2.png) [@Jamie](https://community.homey.app/u/Jamie)\
**Post date:** [November 2, 2018, 6:49am UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/4 "2018-11-02T06:49:57Z")

</div>

A couple of us have attempted with iPhone6 - and it has not worked.

---

<div class="post-metadata">

**Author:** ![Rocodamelshekima](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/rocodamelshekima/32/8209_2.png) [@Rocodamelshekima](https://community.homey.app/u/Rocodamelshekima)\
**Post date:** [November 2, 2018, 7:08am UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/5 "2018-11-02T07:08:28Z")

</div>

Apple does not allow that.

---

<div class="post-metadata">

**Author:** ![Toon\_Vos](https://avatars.discourse-cdn.com/v4/letter/t/57b2e6/32.png) [@Toon\_Vos](https://community.homey.app/u/Toon_Vos)\
**Post date:** [November 2, 2018, 7:14am UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/6 "2018-11-02T07:14:55Z")

</div>

Too bad, this would improve the WAF

---

<div class="post-metadata">

**Author:** ![Koktail](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/koktail/32/51498_2.png) [@Koktail](https://community.homey.app/u/Koktail)\
**Post date:** [November 5, 2018, 4:08pm UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/7 "2018-11-05T16:08:55Z")

</div>

I’m curious, what BLE devices are you using, and what is the approximate range?

---

<div class="post-metadata">

**Author:** ![shadowz7](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/shadowz7/32/7945_2.png) [@shadowz7](https://community.homey.app/u/shadowz7)\
**Post date:** [November 9, 2018, 11:48pm UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/8 "2018-11-09T23:48:27Z")

</div>

a keeper from Gigaset does work, but minew’s C6, not why? In both are the same chips. And why only 8m. They have more power.

---

<div class="post-metadata">

**Author:** ![robertklep](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/robertklep/32/160628_2.png) [@robertklep](https://community.homey.app/u/robertklep)\
**Post date:** [November 10, 2018, 9:47am UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/9 "2018-11-10T09:47:57Z")

</div>

> [@Rocodamelshekima](#):
>
> Apple does not allow that.

“Any iOS device that supports sharing data using Bluetooth low energy can be turned into an iBeacon”

> **[Turning an iOS device into an iBeacon device | Apple Developer Documentation](https://developer.apple.com/documentation/corelocation/turning_an_ios_device_into_an_ibeacon_device)**
>
> Broadcast iBeacon signals from an iOS device.

Problem is that it’s only supported for apps that run in the foreground.

---

<div class="post-metadata">

**Author:** ![Koktail](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/koktail/32/51498_2.png) [@Koktail](https://community.homey.app/u/Koktail)\
**Post date:** [November 11, 2018, 1:08pm UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/10 "2018-11-11T13:08:34Z")

</div>

I’ve just released new alpha version:

### v1.0.14 - 11.11.01

- add homeyCommunityTopicId
- add version number app for logging
- add triggercards detect state changed

---

<div class="post-metadata">

**Author:** ![Koktail](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/koktail/32/51498_2.png) [@Koktail](https://community.homey.app/u/Koktail)\
**Post date:** [November 12, 2018, 10:41am UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/11 "2018-11-12T10:41:02Z")

</div>

Are there people that use the app with another beacon as described in the readme?  
Will you please share your experience of the range in the app’s topic? That way other people can make a good choice of using the correct beacons.

---

<div class="post-metadata">

**Author:** ![Michel\_Bredius](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/michel_bredius/32/9492_2.png) [@Michel\_Bredius](https://community.homey.app/u/Michel_Bredius)\
**Post date:** [November 12, 2018, 11:01am UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/12 "2018-11-12T11:01:34Z")

</div>

I use the Tile Mate, certainly reach 8 meters

---

<div class="post-metadata">

**Author:** ![Koktail](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/koktail/32/51498_2.png) [@Koktail](https://community.homey.app/u/Koktail)\
**Post date:** [November 12, 2018, 11:13am UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/13 "2018-11-12T11:13:56Z")

</div>

Thanks for sharing, i’ll add it to the readme

---

<div class="post-metadata">

**Author:** ![Adrian\_Rockall](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/adrian_rockall/32/13209_2.png) [@Adrian\_Rockall](https://community.homey.app/u/Adrian_Rockall)\
**Post date:** [November 13, 2018, 4:26pm UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/14 "2018-11-13T16:26:58Z")

</div>

I have added my Somfy One fobs. I’m not sure of the range but is OK to detect when someone is home. Best presence detection I have found so far. Very quick to detect when someone arrives but takes a few minutes to be sure someone has left as they only broadcast every 2 to 3 minutes.  
Maybe the Somfy One triggers them when a door opens and then randomly to see if still there.

---

<div class="post-metadata">

**Author:** ![Max\_SB](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/max_sb/32/300_2.png) [@Max\_SB](https://community.homey.app/u/Max_SB)\
**Post date:** [November 15, 2018, 9:02am UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/15 "2018-11-15T09:02:53Z")

</div>

does it work with Lapa?

> **[Lapa 2 Bluetooth Tracker - Find Keys, Wallet, Bag, Pets, and even your Smartphone (1-Pack, Black): Amazon.co.uk: Electronics](https://www.amazon.co.uk/Lapa-Bluetooth-Tracker-Wallet-Smartphone/dp/B01EIL2QSA/ref=sr_1_1?ie=UTF8&qid=1542272328&sr=8-1&keywords=lapa)**
>
> £22.92

I’ve tried it yesterday but couldn’t add a beacon “Cannot get devices:No devices found.”

Lapa 2 is connected to my mobile device and works…

---

<div class="post-metadata">

**Author:** ![Koktail](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/koktail/32/51498_2.png) [@Koktail](https://community.homey.app/u/Koktail)\
**Post date:** [November 15, 2018, 1:31pm UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/16 "2018-11-15T13:31:01Z")

</div>

That is designed as intended.

_Like the description in the app say:_

> For filtering out false positives there is a verification amount inside or outside the range available in the settings. This setting is the amount of times the beacon needs to be changed before it wil marked as such. The amount will be reset if the beacon is not in that current state.

The default are:  
`inside amount = 1`  
`outside amount = 5`

The difference of this is that if your beacon will trigger `out of range` (en checks the inside change amount), it will never be detected falsly because it will never by found.

---

<div class="post-metadata">

**Author:** ![Koktail](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/koktail/32/51498_2.png) [@Koktail](https://community.homey.app/u/Koktail)\
**Post date:** [November 15, 2018, 1:41pm UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/17 "2018-11-15T13:41:34Z")

</div>

You should disconnect your device from your phone because it isn’t public discoverable anymore that way.

---

<div class="post-metadata">

**Author:** ![Adrian\_Rockall](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/adrian_rockall/32/13209_2.png) [@Adrian\_Rockall](https://community.homey.app/u/Adrian_Rockall)\
**Post date:** [November 15, 2018, 4:00pm UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/18 "2018-11-15T16:00:05Z")

</div>

The purpose of my post was to let people know it works with the Somfy One fobs with those limitations caused by the fob. Your App is working perfectly and I used the settings to overcome those limitations. I hope it didn’t give the impression that I was unhappy with the App as I think you have done a great job.

---

<div class="post-metadata">

**Author:** ![Max\_SB](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/max_sb/32/300_2.png) [@Max\_SB](https://community.homey.app/u/Max_SB)\
**Post date:** [November 22, 2018, 11:18am UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/19 "2018-11-22T11:18:24Z")

</div>

Thank you, that helped!

---

<div class="post-metadata">

**Author:** ![Domotica-blog.nl](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/domotica-blog.nl/32/69291_2.png) [@Domotica-blog.nl](https://community.homey.app/u/Domotica-blog.nl)\
**Post date:** [November 26, 2018, 6:31pm UTC](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550/20 "2018-11-26T18:31:21Z")

</div>

I’ve never have that experience with the beacon app. Have you tried to remove and add the beacons again? Have you tried to restart the app again? Have you tried to reboot homey?

What settings do you use for:

```auto
Update settings
The delay between reading sensor values in seconds. (default 10 seconds)

Discovery timeout
The amount of seconds that is given to discover the beacons. (5 seconds)

VerificationAmountInside
The amount of verifications the app need to mark a beacon inside the range. (1 time)

VerificationAmountOutside
The amount of verifications the app need to mark a beacon outside the range. (5 times)

```

You can try to use a discovery timeout of 10 seconds, that way Homey has more time to discover the devices.

Note: We are spamming the tutorial topic, if there is a problem try to use the app’s topic: [Beacon - Using BLE beacons for presence detection](https://community.homey.app/t/beacon-using-ble-beacons-for-presence-detection/3550)

* * *

Thank you for the help.

I did a reset of the APP (and the Homey). Re-added the beacons. Re-installed the Beacon APP. But no luck.

I’m using the standard settings.

But they only give 1 status update (in range) and when a remove the batterij it still says in range. Offcourse i waited more then 10 sec \* 5 (checks).

Any idea how we can debug this?

[Next page](https://community.homey.app/t/app-pro-beacon-detect-your-presence-with-ble-beacons/3550.md?page=2)
