From 5485532693ed46fab2352a333246d50c0e5025aa Mon Sep 17 00:00:00 2001 From: "J. Nick Koston" Date: Sun, 21 Aug 2022 09:42:18 -1000 Subject: [PATCH] Update bluetooth le tracker docs to reflect the bluetooth integration must be functional for the integration to work (#23734) --- .../bluetooth_le_tracker.markdown | 29 +------------------ 1 file changed, 1 insertion(+), 28 deletions(-) diff --git a/source/_integrations/bluetooth_le_tracker.markdown b/source/_integrations/bluetooth_le_tracker.markdown index f49f6673209..8983980fff5 100644 --- a/source/_integrations/bluetooth_le_tracker.markdown +++ b/source/_integrations/bluetooth_le_tracker.markdown @@ -17,7 +17,7 @@ Devices discovered are stored with 'BLE_' as the prefix for device mac addresses ## Setup -This platform requires pybluez to be installed, which is already the case if you're using Home Assistant OS, Supervised or Container. For Home Assistant Core installs see below on the required steps. +This integration requires the [Bluetooth](/integrations/bluetooth) integration to be enabled and functional. ## Configuration @@ -58,30 +58,3 @@ Some BTLE devices (e.g., fitness trackers) are only visible to the devices that Enabling the battery tracking might slightly decrease the duration of the battery, but since this is only done at most once a day, this shouldn't be noticeable. Not all devices offer battery status information; if the information is not available, the integration will only try once at startup. For additional configuration variables check the [Device tracker page](/integrations/device_tracker/). - -{% details "Notes for Home Assistant Core Installations" %} - -On Debian based Home Assistant Core installations, run: - -```bash -sudo apt install bluetooth -``` - -Before you get started with this platform, please note that: - -- This platform is incompatible with Windows -- This platform requires access to the Bluetooth stack, see [Rootless Setup section](#rootless-setup) for further information - -### Rootless Setup on Core installs - -Normally 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 and hcitool the missing capabilities to access the Bluetooth stack. Quite like setting the setuid bit (see [Stack Exchange](https://unix.stackexchange.com/questions/96106/bluetooth-le-scan-as-non-root) for more information). - -```bash -sudo apt-get install libcap2-bin -sudo setcap 'cap_net_raw,cap_net_admin+eip' $(readlink -f $(which python3)) -sudo setcap 'cap_net_raw+ep' $(readlink -f $(which hcitool)) -``` - -A restart of Home Assistant is required. - -{% enddetails %}