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

Site updated at 2017-09-26 07:14:23 UTC

Browse source
This commit is contained in:
Travis CI 2017-09-26 07:14:23 +00:00
parent 80847eb95a
commit b723b0750d
415 changed files with 2329 additions and 1581 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -77,7 +77,7 @@
<p class="note warning">
We have received <a href="https://github.com/home-assistant/home-assistant/issues/4442">numerous reports</a> that this integration will have a big impact on the performance of the server.
</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>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>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 platform requires pybluez to be installed. On Debian based installs, run</p>
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>sudo apt install bluetooth libbluetooth-dev pkg-config libboost-python-dev libboost-thread-dev libglib2.0-dev python-dev
@ -96,11 +96,11 @@ We have received <a href="https://github.com/home-assistant/home-assistant/issue
</div>
<p>Configuration variables:</p>
<ul>
<li><strong>device_id</strong> (<em>Optional</em>): The device ID for the bluetooth device to be used for tracking. Defaults to <code class="highlighter-rouge">hci0</code>.</li>
<li><strong>device_id</strong> (<em>Optional</em>): The device ID for the Bluetooth device to be used for tracking. Defaults to <code class="highlighter-rouge">hci0</code>.</li>
</ul>
<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>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>
<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
<span class="gp">$ </span>sudo setcap <span class="s1">'cap_net_raw,cap_net_admin+eip'</span> <span class="sb">`</span>readlink -f <span class="se">\`</span>which python3<span class="se">\`</span><span class="sb">`</span>
</code></pre>