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

Site updated at 2017-09-09 08:11:28 UTC

Browse source
This commit is contained in:
Travis CI 2017-09-09 08:11:28 +00:00
parent 884f293365
commit f9e31a30cd
827 changed files with 13304 additions and 2121 deletions
Download patch file Download diff file Expand all files Collapse all files

39
components/light.knx/index.html
View file

@ -75,20 +75,29 @@
</header>
<hr class="divider">
<p>The <code class="highlighter-rouge">knx</code> light component is used as in interface to switching/light actuators.</p>
<p>To use your KNX light 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">light</span><span class="pi">:</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 light 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">light</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">KNX light</span>
<span class="s">address</span><span class="pi">:</span> <span class="s">0/0/1</span>
<span class="s">name</span><span class="pi">:</span> <span class="s">Kitchen-Light-1</span>
<span class="s">address</span><span class="pi">:</span> <span class="s1">'</span><span class="s">1/0/9'</span>
<span class="s">brightness_address</span><span class="pi">:</span> <span class="s1">'</span><span class="s">1/0/11'</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">Kitchen-Light-2</span>
<span class="s">address</span><span class="pi">:</span> <span class="s1">'</span><span class="s">1/0/12'</span>
<span class="s">brightness_address</span><span class="pi">:</span> <span class="s1">'</span><span class="s">1/0/14'</span>
</code></pre>
</div>
<ul>
<li><strong>name</strong> (<em>Optional</em>): A name for this devices used within Home assistant</li>
<li><strong>address</strong> (<em>Required</em>): The KNX group address that is used to turn on/off this actuator channel</li>
<li><strong>state_address</strong> (<em>Optional</em>): Some KNX devices can change their state internally without any messages on the KXN bus, e.g. if you configure a timer on a channel. The optional <code class="highlighter-rouge">state_address</code> can be used to inform Home Assistant about these state changes. If a KNX message is seen on the bus addressed to the given state address, this will overwrite the state of the switch object.
For switching/light actuators that are only controlled by a single group address and can’t change their state internally, you don’t have to configure the state address.</li>
<li><strong>name</strong> (<em>Optional</em>): A name for this device used within Home Assistant.</li>
<li><strong>address</strong>: KNX group address for switching the light on and off</li>
<li><strong>brightness_address</strong>: (Optional) KNX group address for dimming light.</li>
<li><strong>state_address</strong>: (<em>Optional</em>) separate KNX group address for retrieving the switch state of the light.</li>
<li><strong>brightness_state_address</strong>: (<em>Optional</em>) separate KNX group address for retrieving the dimmed state of the light.</li>
</ul>
<p>Some KNX devices can change their state internally without any messages on the KXN bus, e.g., if you configure a timer on a channel. The optional <code class="highlighter-rouge">state_address</code> can be used to inform Home Assistant about these state changes. If a KNX message is seen on the bus addressed to the given state address, this will overwrite the state of the switch object.
For switching/light actuators that are only controlled by a single group address and can’t change their state internally, you don’t have to configure the state address.</p>
</article>
</div>
<aside id="sidebar" class="grid__item one-third lap-one-whole palm-one-whole">
@ -117,18 +126,21 @@ For switching/light actuators that are only controlled by a single group address
<li><a href='/components/binary_sensor.knx/'>
KNX Binary Sensor
</a></li>
<li><a href='/components/climate.knx/'>
KNX Climate
</a></li>
<li><a href='/components/cover.knx/'>
KNX Cover
</a></li>
<li><a href='/components/notify.knx/'>
KNX Notify
</a></li>
<li><a href='/components/sensor.knx/'>
KNX Sensor
</a></li>
<li><a href='/components/switch.knx/'>
KNX Switch
</a></li>
<li><a href='/components/climate.knx/'>
KNX Thermostat
</a></li>
</ul>
</div>
<div class='section'>
@ -266,6 +278,9 @@ For switching/light actuators that are only controlled by a single group address
<li>
<a href='/components/light.xiaomi/'>Xiaomi Light</a>
</li>
<li>
<a href='/components/light.xiaomi_philipslight/'>Xiaomi Philips Light</a>
</li>
<li>
<a href='/components/light.yeelightsunflower/'>Yeelight Sunflower Bulb</a>
</li>