jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Site updated at 2017-03-11 08:50:22 UTC

Browse source
This commit is contained in:
Travis CI 2017-03-11 08:50:22 +00:00
parent 66ee9c15dc
commit a199a844bd
24 changed files with 47 additions and 49 deletions
Download patch file Download diff file Expand all files Collapse all files

22
components/device_tracker.bluetooth_le_tracker/index.html
View file

@ -90,16 +90,18 @@
<hr class="divider">
<p>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 <code class="highlighter-rouge">known_devices.yaml</code>.</p>
<p>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!</p>
<p class="note">
Requires PyBluez. If you are on Raspbian, run the following command to install the needed dependencies. <code class="highlighter-rouge">sudo apt install bluetooth libbluetooth-dev pkg-config libboost-python-dev libboost-thread-dev libglib2.0-dev python-dev</code>
</p>
<p>Devices discovered are stored with ‘BLE_’ as the prefix for device mac addresses in <code class="highlighter-rouge">known_devices.yaml</code>.</p>
<p class="note warning">
Requires gattlib, which is not compatible with Windows. This tracker won’t work on Windows!
</p>
<p>This platform requires pybluez to be installed. On Debian based installs, run <code class="highlighter-rouge">sudo apt install bluetooth libbluetooth-dev pkg-config libboost-python-dev libboost-thread-dev libglib2.0-dev python-dev</code></p>
<p>Before you get started with this platform, please note that:</p>
<ul>
<li>This platform is incompatible with Windows</li>
<li>This platform requires root privileges</li>
<li>Don’t use on a Raspberry Pi. It will become unusable slow when using this platform.</li>
</ul>
<p>To use the Bluetooth tracker in your installation, add the following to your <code class="highlighter-rouge">configuration.yaml</code> file:</p>
@ -118,10 +120,6 @@ Requires gattlib, which is not compatible with Windows. This tracker won’t wor
<p>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.</p>
<p class="note warning">
BT LE tracking requires root privileges.
</p>
<p>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 <a href="http://unix.stackexchange.com/questions/96106/bluetooth-le-scan-as-non-root">Stack Exchange</a> for more information).</p>
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>sudo apt-get install libcap2-bin