Site updated at 2017-01-18 07:44:14 UTC

This commit is contained in:
Travis CI 2017-01-18 07:44:14 +00:00
parent c29b2b503b
commit 1f32fd6d79
27 changed files with 83 additions and 76 deletions

View file

@ -92,43 +92,27 @@
<p>The <code class="highlighter-rouge">eq3btsmart</code> climate platform allows you to integrate EQ3 Bluetooth Smart Thermostats.</p>
<p>The only functionality is to set the temperature, there doesnt seem to be any way to query the temperature sensor or battery level (<a href="https://forum.fhem.de/index.php/topic,39308.15.html">read more</a>).</p>
<p>The current functionality allows setting the temperature as well as controlling the supported modes with help of <a href="https://github.com/rytilahti/python-eq3bt">python-eq3bt</a> library.
As the device doesnt contain a temperature sensor (<a href="https://forum.fhem.de/index.php/topic,39308.15.html">read more</a>),
we report target temperature also as current one.</p>
<p>Setup is a bit more cumbersome than for most other thermostats. It has to be paired first:</p>
<h3>Testing the connectivity</h3>
<p>Before configuring Home Assistant you should check that connectivity with the thermostat is working, which can can be done with the eq3cli tool:</p>
<div class="language-bash highlighter-rouge"><pre class="highlight"><code>bluetoothctl
scan on
&lt;Wait <span class="k">for </span>the thermostat to be found, which looks like this: <span class="o">[</span>NEW] Device 00:11:22:33:44:55 CC-RT-BLE&gt;
scan off
&lt;Set the thermostat to pairing mode.&gt;
pair &lt;MAC&gt;
trust &lt;MAC&gt;
disconnect &lt;MAC&gt;
<span class="nb">exit</span>
<div class="language-bash highlighter-rouge"><pre class="highlight"><code>eq3cli --mac 00:11:22:33:44:55
<span class="o">[</span>00:1A:22:XX:XX:XX] Target 17.0 <span class="o">(</span>mode: auto dst, away: no<span class="o">)</span>
Locked: False
Batter low: False
Window open: False
Boost: False
Current target temp: 21.0
Current mode: auto dst
Valve: 0
</code></pre>
</div>
<p>Then check with gatttool if the connection works as expected:</p>
<div class="language-bash highlighter-rouge"><pre class="highlight"><code>gatttool -b 00:11:22:33:44:55 -I
<span class="gp">[00:11:22:33:44:55][LE]&gt; </span>connect
Attempting to connect to 00:11:22:33:44:55
Connection successful
<span class="gp">[00:11:22:33:44:55][LE]&gt; </span>char-write-req 0x0411 03
Characteristic value was written successfully
Notification handle <span class="o">=</span> 0x0421 value: 02 01 09 14 04 2d
<span class="gp">[00:11:22:33:44:55][LE]&gt; </span>disconnect
<span class="gp">[00:11:22:33:44:55][LE]&gt; </span><span class="nb">exit</span>
</code></pre>
</div>
<p>Important: For gatttool or homeassistant to work, the thermostat needs to be disconnected from bluetoothd, so I found it best to modify the hass-daemon startscript by adding:</p>
<div class="language-bash highlighter-rouge"><pre class="highlight"><code>/usr/bin/bt-device -d CC-RT-BLE
</code></pre>
</div>
<p>to the start function of /etc/init.d/hass-daemon.</p>
<h3>Configuration</h3>
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example configuration.yaml entry</span>
<span class="s">climate</span><span class="pi">:</span>

View file

@ -90,7 +90,7 @@
<hr class="divider">
<p>The <code class="highlighter-rouge">swisscom</code> platform offers presence detection by looking at connected devices to an <a href="https://www.swisscom.ch/en/residential/help/device/internet-router.html">Internet-Box</a> router from <a href="https://www.swisscom.ch">Swisscom</a>, which is the main Internet provider in Switzerland.</p>
<p>The <code class="highlighter-rouge">swisscom</code> platform offers presence detection by looking at connected devices to an <a href="https://www.swisscom.ch/en/residential/help/device/internet-router.html">Internet-Box</a> router from <a href="https://www.swisscom.ch">Swisscom</a> which is an Internet provider in Switzerland.</p>
<p class="note">
There are three models of Internet-Box (light, standard and plus). The platform has only been tested on the Internet-Box plus but the others should work as well because they have the same web interface.
@ -100,11 +100,16 @@ There are three models of Internet-Box (light, standard and plus). The platform
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example configuration.yaml entry</span>
<span class="s">device_tracker</span><span class="pi">:</span>
<span class="s">platform</span><span class="pi">:</span> <span class="s">swisscom</span>
<span class="s">host</span><span class="pi">:</span> <span class="s2">"</span><span class="s">192.168.1.1"</span> <span class="c1"># only required if not 192.168.1.1</span>
<span class="pi">-</span> <span class="s">platform</span><span class="pi">:</span> <span class="s">swisscom</span>
</code></pre>
</div>
<p>Configuration variables:</p>
<ul>
<li><strong>host</strong> (<em>Optional</em>): The IP address of your router. Set it if you are not using <code class="highlighter-rouge">192.168.1.1</code>.</li>
</ul>
<p>See the <a href="/components/device_tracker/">device tracker component page</a> for instructions how to configure the people to be tracked.</p>

View file

@ -90,18 +90,24 @@
<hr class="divider">
<p>The <code class="highlighter-rouge">upc_connect</code> platform offers presence detection by looking at connected devices to an <a href="https://www.upc.ch/de/internet/connectbox/">ConnectBox</a> router from <a href="http://www.libertyglobal.com/">Liberty Global</a>, which is a Internet provider in Switzerland, Austria.</p>
<p>The <code class="highlighter-rouge">upc_connect</code> platform offers presence detection by looking at connected devices to a <a href="https://www.upc.ch/de/internet/connectbox/">Connect Box</a> from <a href="http://www.libertyglobal.com/">Liberty Global</a> (also known as UPC Cablecom in Switzerland) which is a Internet provider in Switzerland and Austria.</p>
<p>To use an Internet-Box router in your installation, add the following to your <code class="highlighter-rouge">configuration.yaml</code> file:</p>
<p>To use a Connect Box in your installation, add the following to your <code class="highlighter-rouge">configuration.yaml</code> file:</p>
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example configuration.yaml entry</span>
<span class="s">device_tracker</span><span class="pi">:</span>
<span class="s">platform</span><span class="pi">:</span> <span class="s">upc_connect</span>
<span class="s">password</span><span class="pi">:</span> <span class="s1">'</span><span class="s">123456'</span>
<span class="s">host</span><span class="pi">:</span> <span class="s2">"</span><span class="s">192.168.0.1"</span> <span class="c1"># only required if not 192.168.0.1</span>
<span class="pi">-</span> <span class="s">platform</span><span class="pi">:</span> <span class="s">upc_connect</span>
<span class="s">password</span><span class="pi">:</span> <span class="s">YOUR_PASSWORD</span>
</code></pre>
</div>
<p>Configuration variables:</p>
<ul>
<li><strong>password</strong> (<em>Required</em>): The password for your Connect Box.</li>
<li><strong>host</strong> (<em>Optional</em>): The IP address of your router. Set it if you are not using <code class="highlighter-rouge">192.168.0.1</code>.</li>
</ul>
<p>See the <a href="/components/device_tracker/">device tracker component page</a> for instructions how to configure the people to be tracked.</p>

View file

@ -123,6 +123,14 @@
</code></pre>
</div>
<h5><a class="title-link" name="additional-configuration-on-macos" href="#additional-configuration-on-macos"></a> Additional configuration on macOS</h5>
<p>On macOS phython-vlc wont find the VLC plugin directory unless you add this to the users <code class="highlighter-rouge">.bash_profile</code> that is running Home Assistant:</p>
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="nb">export </span><span class="nv">VLC_PLUGIN_PATH</span><span class="o">=</span><span class="nv">$VLC_PLUGIN_PATH</span>:/Applications/VLC.app/Contents/MacOS/plugins
</code></pre>
</div>
</article>