home-assistant.io/source/_components/switch.knx.markdown
Franck Nijhof 1833c32a2c Cleans up front matter (#9835)
* Sets front matter defaults

* Removes default front matter from section templates/pages

* Removes default front matter from addon pages

* Removes default front matter from integration pages

* Removes default front matter from posts

* Removes default front matter from docs pages

* Removes default front matter from other pages

* Fixes blog category pages
2019-07-11 14:35:08 -07:00

1.4 KiB

title, description, logo, ha_category, ha_release, ha_iot_class
title description logo ha_category ha_release ha_iot_class
KNX Switch Instructions on how to integrate KNX switches with Home Assistant. knx.png
Switch
0.24 Local Polling

The knx switch integration is used as in interface to switching actuators.

The knx integration must be configured correctly, see KNX Component.

Configuration

To use your KNX switch in your installation, add the following to your configuration.yaml file:

switch:
  - platform: knx
    name: Kitchen.Coffee
    address: '1/1/6'

{% configuration %} address: description: KNX group address for switching the switch on/off. required: true type: string name: description: A name for this device used within Home Assistant. required: false default: KNX Switch type: string state_address: description: Separate KNX group address for retrieving the switch state. required: false type: string {% endconfiguration %}

Some KNX devices can change their state internally without any messages on the KNX bus, e.g., if you configure a timer on a channel. The optional state_address 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 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.