Site updated at 2017-09-09 08:11:28 UTC
This commit is contained in:
Travis CI
parent
884f293365
commit
f9e31a30cd
827 changed files with 13304 additions and 2121 deletions
|
|
@ -6,13 +6,13 @@
|
|||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
|
||||
<title>KNX Thermostat - Home Assistant</title>
|
||||
<title>KNX Climate - Home Assistant</title>
|
||||
<meta name="author" content="Home Assistant">
|
||||
<meta name="description" content="Instructions on how to integrate KXN thermostats with Home Assistant.">
|
||||
<meta name="viewport" content="width=device-width">
|
||||
<link rel="canonical" href="https://home-assistant.io/components/climate.knx/">
|
||||
<meta property="fb:app_id" content="338291289691179">
|
||||
<meta property="og:title" content="KNX Thermostat">
|
||||
<meta property="og:title" content="KNX Climate">
|
||||
<meta property="og:site_name" content="Home Assistant">
|
||||
<meta property="og:url" content="https://home-assistant.io/components/climate.knx/">
|
||||
<meta property="og:type" content="article">
|
||||
|
|
@ -20,7 +20,7 @@
|
|||
<meta property="og:image" content="https://home-assistant.io/images/default-social.png">
|
||||
<meta name="twitter:card" content="summary_large_image">
|
||||
<meta name="twitter:site" content="@home_assistant">
|
||||
<meta name="twitter:title" content="KNX Thermostat">
|
||||
<meta name="twitter:title" content="KNX Climate">
|
||||
<meta name="twitter:description" content="Instructions on how to integrate KXN thermostats with Home Assistant.">
|
||||
<meta name="twitter:image" content="https://home-assistant.io/images/default-social.png">
|
||||
<link href="/stylesheets/screen.css" media="screen, projection" rel="stylesheet">
|
||||
|
|
@ -70,28 +70,52 @@
|
|||
<article class="page">
|
||||
<header>
|
||||
<h1 class="title indent">
|
||||
KNX Thermostat
|
||||
KNX Climate
|
||||
</h1>
|
||||
</header>
|
||||
<hr class="divider">
|
||||
<p>The <code class="highlighter-rouge">knx</code> climate platform is used as in interface with KNX thermostats.</p>
|
||||
<p>KNX thermostats use at least 2 group addresses: one for the current temperature and one for the target temperature (named set-point in KNX terms).</p>
|
||||
<p>To use your KNX thermostats 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">climate</span><span class="pi">:</span>
|
||||
<span class="pi">-</span> <span class="s">platform</span><span class="pi">:</span> <span class="s">knx</span>
|
||||
<span class="s">address</span> <span class="pi">:</span> <span class="s">KNX_ADDRESS</span>
|
||||
<span class="s">temperature_address</span><span class="pi">:</span> <span class="s">0/1/1</span>
|
||||
<span class="s">setpoint_address</span><span class="pi">:</span> <span class="s">0/1/0</span>
|
||||
<p>The <code class="highlighter-rouge">knx</code> component must be configured correctly, see <a href="/components/knx">KNX Component</a>.</p>
|
||||
<p>To use your KNX thermostats in your installation, add the following lines to your <code class="highlighter-rouge">configuration.yaml</code> file:</p>
|
||||
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="s">climate</span><span class="pi">:</span>
|
||||
<span class="pi">-</span> <span class="s">platform</span><span class="pi">:</span> <span class="s">knx</span>
|
||||
<span class="s">name</span><span class="pi">:</span> <span class="s">HASS-Kitchen.Temperature</span>
|
||||
<span class="s">temperature_address</span><span class="pi">:</span> <span class="s1">'</span><span class="s">6/2/1'</span>
|
||||
<span class="s">setpoint_address</span><span class="pi">:</span> <span class="s1">'</span><span class="s">5/1/2'</span>
|
||||
<span class="s">target_temperature_address</span><span class="pi">:</span> <span class="s1">'</span><span class="s">5/1/1'</span>
|
||||
<span class="s">operation_mode_address</span><span class="pi">:</span> <span class="s1">'</span><span class="s">5/1/3'</span>
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>Alternatively, if your device has dedicated binary group addresses for frost/night/comfort mode:</p>
|
||||
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="s">climate</span><span class="pi">:</span>
|
||||
<span class="pi">-</span> <span class="s">platform</span><span class="pi">:</span> <span class="s">knx</span>
|
||||
<span class="s">name</span><span class="pi">:</span> <span class="s">HASS-Kitchen.Temperature</span>
|
||||
<span class="s">temperature_address</span><span class="pi">:</span> <span class="s1">'</span><span class="s">6/2/1'</span>
|
||||
<span class="s">setpoint_address</span><span class="pi">:</span> <span class="s1">'</span><span class="s">5/1/2'</span>
|
||||
<span class="s">target_temperature_address</span><span class="pi">:</span> <span class="s1">'</span><span class="s">5/1/1'</span>
|
||||
<span class="s">operation_mode_frost_protection_address</span><span class="pi">:</span> <span class="s1">'</span><span class="s">5/1/3'</span>
|
||||
<span class="s">operation_mode_night_address</span><span class="pi">:</span> <span class="s1">'</span><span class="s">5/1/4'</span>
|
||||
<span class="s">operation_mode_comfort_address</span><span class="pi">:</span> <span class="s1">'</span><span class="s">5/1/5'</span>
|
||||
</code></pre>
|
||||
</div>
|
||||
<ul>
|
||||
<li><strong>address</strong> (<em>Required</em>): The KNX group address that is used to turn on/off this actuator channel.</li>
|
||||
<li><strong>temperature_address</strong> (<em>Required</em>): The group address that is used to communicate the current temperature. Data format must be datapoint type 9.001 DPT_Value_Temp (2-Octet float value), check <a href="http://www.knx.org/fileadmin/template/documents/downloads_support_menu/KNX_tutor_seminar_page/Advanced_documentation/05_Interworking_E1209.pdf">details</a>.</li>
|
||||
<li><strong>setpoint_address</strong> (<em>Required</em>): The group address that is used to set/read the target temperature. Data format must be datapoint type 9.001 DPT_Value_Temp (2-Octet float value). Make sure, you set the read-flag for the thermostat to allow Home Assistant to read the target temperature.</li>
|
||||
<li><strong>name</strong> (<em>Optional</em>): A name for this devices used within Home Assistant.</li>
|
||||
<li><strong>name</strong> (<em>Optional</em>): A name for this device used within Home Assistant.</li>
|
||||
<li><strong>temperature_address</strong>: KNX group address for reading current room temperature from KNX bus.</li>
|
||||
<li><strong>target_temperature_address</strong>: KNX group address for reading current target temperature from KNX bus.</li>
|
||||
<li>
|
||||
<p><strong>setpoint_address</strong>: KNX group address for basis setpoint</p>
|
||||
</li>
|
||||
<li><strong>operation_mode_address</strong> (<em>Optional</em>) KNX address for operation mode (Frost protection/night/comfort).</li>
|
||||
<li><strong>operation_mode_state_address</strong> (<em>Optional</em>) Explicit KNX address for reading operation mode</li>
|
||||
<li><strong>controller_status_address</strong> (<em>Optional</em>) KNX address for HVAC controller status (in accordance with KNX AN 097/07 rev 3)</li>
|
||||
<li>
|
||||
<p><strong>controller_status_state_address</strong> (<em>Optional</em>) Explicit KNX address for reading HVAC controller status</p>
|
||||
</li>
|
||||
<li><strong>operation_mode_frost_protection_address</strong> (<em>Optional</em>) KNX address for switching on/off frost/heat protection mode.</li>
|
||||
<li><strong>operation_mode_night_address</strong> (<em>Optional</em>) KNX address for switching on/off night nmode.</li>
|
||||
<li><strong>operation_mode_comfort_address</strong> (<em>Optional</em>) KNX address for switching on/off comfort mode.</li>
|
||||
</ul>
|
||||
<p>With the current version of the module, no advanced KNX thermostat functionalities (e.g. HVAC mode) are supported.</p>
|
||||
<p><code class="highlighter-rouge">operation_mode_frost_protection_address</code> / <code class="highlighter-rouge">operation_mode_night_address</code> / <code class="highlighter-rouge">operation_mode_comfort_address</code> are not necessary if <code class="highlighter-rouge">operation_mode_address</code> was specified.</p>
|
||||
</article>
|
||||
</div>
|
||||
<aside id="sidebar" class="grid__item one-third lap-one-whole palm-one-whole">
|
||||
|
|
@ -126,6 +150,9 @@
|
|||
<li><a href='/components/light.knx/'>
|
||||
KNX Light
|
||||
</a></li>
|
||||
<li><a href='/components/notify.knx/'>
|
||||
KNX Notify
|
||||
</a></li>
|
||||
<li><a href='/components/sensor.knx/'>
|
||||
KNX Sensor
|
||||
</a></li>
|
||||
|
|
@ -159,7 +186,7 @@
|
|||
<a href='/components/climate.honeywell/'>Honeywell Thermostat</a>
|
||||
</li>
|
||||
<li>
|
||||
KNX Thermostat
|
||||
KNX Climate
|
||||
</li>
|
||||
<li>
|
||||
<a href='/components/climate.mysensors/'>MySensors HVAC</a>
|
||||
|
|
@ -185,6 +212,9 @@
|
|||
<li>
|
||||
<a href='/components/climate.tado/'>Tado Thermostat</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href='/components/climate.tesla/'>Tesla HVAC</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href='/components/climate.vera/'>Vera Thermostat</a>
|
||||
</li>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue