home-assistant.io/source/_integrations/switch.knx.markdown

1.5 KiB

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

The knx integration must be configured correctly to use this integration, see KNX Integration.

The knx switch platform is used as an interface to switching actuators.

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.