You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: source/_components/device_tracker.bluetooth_le_tracker.markdown
+6-10Lines changed: 6 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -14,15 +14,15 @@ ha_release: 0.27
14
14
---
15
15
16
16
This tracker discovers new devices on boot and in regular intervals and tracks bluetooth low-energy devices periodically based on interval_seconds value. It is not required to pair the devices with each other!
17
+
17
18
Devices discovered are stored with 'BLE_' as the prefix for device mac addresses in `known_devices.yaml`.
18
19
19
-
<pclass='note'>
20
-
Requires PyBluez. If you are on Raspbian, run the following command to install the needed dependencies. `sudo apt install bluetooth libbluetooth-dev pkg-config libboost-python-dev libboost-thread-dev libglib2.0-dev python-dev`
21
-
</p>
20
+
This platform requires pybluez to be installed. On Debian based installs, run `sudo apt install bluetooth libbluetooth-dev pkg-config libboost-python-dev libboost-thread-dev libglib2.0-dev python-dev`
22
21
23
-
<pclass='note warning'>
24
-
Requires gattlib, which is not compatible with Windows. This tracker won't work on Windows!
25
-
</p>
22
+
Before you get started with this platform, please note that:
23
+
- This platform is incompatible with Windows
24
+
- This platform requires root privileges
25
+
- Don't use on a Raspberry Pi. It will become unusable slow when using this platform.
26
26
27
27
To use the Bluetooth tracker in your installation, add the following to your `configuration.yaml` file:
28
28
@@ -39,10 +39,6 @@ Configuration variables:
39
39
As some BT LE devices change their MAC address regularly, a new device is only discovered when it has been seen 5 times.
40
40
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.
41
41
42
-
<p class='note warning'>
43
-
BT LE tracking requires root privileges.
44
-
</p>
45
-
46
42
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).
0 commit comments