6577daf37f
* Update KNX component configuration variable Update style of KNX component (all the 7 files) documentation to follow new configuration variables description. Related to #6385. * Update binary_sensor.knx.markdown * 🚑 Syntax fix * 🚑 Tweak after source check * 🚑 Tweak after suggestion
2.1 KiB
layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, ha_iot_class
| layout | title | description | date | sidebar | comments | sharing | footer | logo | ha_category | ha_release | ha_iot_class |
|---|---|---|---|---|---|---|---|---|---|---|---|
| page | KNX Light | Instructions on how to integrate KNX lights with Home Assistant. | 2016-06-24 12:00 | true | false | true | true | knx.png | Light | 0.44 | Local Polling |
The knx light component is used as in interface to switching/light actuators.
The knx component must be configured correctly, see KNX Component.
{% linkable_title Configuration %}
To use your KNX light in your installation, add the following lines to your configuration.yaml file:
# Example configuration.yaml entry
light:
- platform: knx
address: '1/0/9'
{% configuration %} address: description: KNX group address for switching the light on and off. required: true type: string name: description: A name for this device used within Home Assistant. required: false type: string brightness_address: description: KNX group address for dimming light. required: false type: string state_address: description: separate KNX group address for retrieving the switch state of the light. required: false type: string brightness_state_address: description: separate KNX group address for retrieving the dimmed state of the light. required: false type: string color_address: description: separate KNX group address for setting the color of the light. required: false type: string color_state_address: description: separate KNX group address for retrieving the color of the light. 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/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.