From 9643a663d661fb00617bd925e1cb95fa971f18ea Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sat, 11 Mar 2017 00:46:08 -0800 Subject: [PATCH] Update device_tracker.bluetooth_le_tracker.markdown --- .../device_tracker.bluetooth_le_tracker.markdown | 16 ++++++---------- 1 file changed, 6 insertions(+), 10 deletions(-) diff --git a/source/_components/device_tracker.bluetooth_le_tracker.markdown b/source/_components/device_tracker.bluetooth_le_tracker.markdown index cb5f53f4047..dc407b3dd2d 100644 --- a/source/_components/device_tracker.bluetooth_le_tracker.markdown +++ b/source/_components/device_tracker.bluetooth_le_tracker.markdown @@ -14,15 +14,15 @@ ha_release: 0.27 --- 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! + Devices discovered are stored with 'BLE_' as the prefix for device mac addresses in `known_devices.yaml`. -

-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` -

+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` -

-Requires gattlib, which is not compatible with Windows. This tracker won't work on Windows! -

+Before you get started with this platform, please note that: + - This platform is incompatible with Windows + - This platform requires root privileges + - Don't use on a Raspberry Pi. It will become unusable slow when using this platform. To use the Bluetooth tracker in your installation, add the following to your `configuration.yaml` file: @@ -39,10 +39,6 @@ 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. -

-BT LE tracking requires root privileges. -

- 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). ```bash