jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-27 03:07:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update Knx switch component configuration variable (#6896)

Browse Source
This commit is contained in:
Klaas Schoute 2018-10-17 23:21:07 +02:00 committed by Fabian Affolter
parent 416c365722
commit a691756093
1 changed files with 15 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
source/_components/switch.knx.markdown
View File

@ -29,11 +29,21 @@ switch:
address: '1/1/6' address: '1/1/6'
``` ```
Configuration variables: {% configuration %}
address:
* **address** (*Required*): KNX group address for switching the switch on/off. description: KNX group address for switching the switch on/off.
* **name** (*Optional*): A name for this device used within Home Assistant. required: true
* **state_address** (*Optional*): separate KNX group address for retrieving the switch state. 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. 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. 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.