jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-22 16:56:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update device_tracker.bluetooth_le_tracker.markdown (#4318)

Browse Source 
* Update device_tracker.bluetooth_le_tracker.markdown

* Minor changes
This commit is contained in:
Ioan Loosley 2018-01-03 19:58:52 +00:00 committed by Fabian Affolter
parent 468d91b08b
commit 105f7a269f
1 changed files with 4 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
source/_components/device_tracker.bluetooth_le_tracker.markdown
View File

@ -30,7 +30,7 @@ $ sudo apt install bluetooth libbluetooth-dev pkg-config libboost-python-dev lib
Before you get started with this platform, please note that:
- This platform is incompatible with Windows
- This platform requires root privileges
- This platform requires access to the bluetooth stack, see [Rootless Setup section](#rootless-setup) for further infomation
To use the Bluetooth tracker in your installation, add the following to your `configuration.yaml` file:
@ -50,7 +50,9 @@ Configuration variables:
As some BT LE devices change their MAC address regularly, a new device is only discovered when it has been seen 5 times.
Some BTLE devices (e.g. fitness trackers) are only visible to the devices that they are paired with. In this case, the BTLE tracker won't see this device.
For running Home Assistant as non root user we can give python3 the missing capabilities to access the Bluetooth stack. Quite like setting the setuid bit (see [Stack Exchange](http://unix.stackexchange.com/questions/96106/bluetooth-le-scan-as-non-root) for more information).
## {% linkable_title Rootless Setup %}
Normaly accessing the Bluetooth stack is reserved for root, but running programs that are networked as root is a bad security wise. To allow non-root access to the Bluetooth stack we can give Python 3 the missing capabilities to access the Bluetooth stack. Quite like setting the setuid bit (see [Stack Exchange](http://unix.stackexchange.com/questions/96106/bluetooth-le-scan-as-non-root) for more information).
```bash
$ sudo apt-get install libcap2-bin