From e51d9a54740ece11b24b9257eaeba48aba072326 Mon Sep 17 00:00:00 2001 From: Matthias Alphart Date: Tue, 24 Sep 2024 22:36:56 +0200 Subject: [PATCH] KNX UI configuration of light and switch (#34905) Co-authored-by: Franck Nijhof --- source/_integrations/knx.markdown | 30 ++++++++++++++++-------------- 1 file changed, 16 insertions(+), 14 deletions(-) diff --git a/source/_integrations/knx.markdown b/source/_integrations/knx.markdown index f1304a491f4..7bcde1c5c0b 100644 --- a/source/_integrations/knx.markdown +++ b/source/_integrations/knx.markdown @@ -1241,15 +1241,10 @@ The KNX light integration is used as an interface to control KNX actuators for l - LED controllers - DALI gateways -To use your KNX light in your installation, add the following lines to your top level [KNX Integration](/integrations/knx) configuration key in `configuration.yaml`: +Light entities can be created from the frontend in the KNX panel or via YAML. -```yaml -# Example configuration.yaml entry -knx: - light: - - name: "Kitchen" - address: "1/0/9" -``` + +{% details "Configuration of KNX light entities via YAML" %} {% configuration %} address: @@ -1382,11 +1377,9 @@ entity_category: Many KNX devices can change their state internally without a message to the switch address on the KNX bus, e.g., if you configure a scene or 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` (in most cases from the light actuator), it will overwrite the state of the object. -For switching/light actuators that are only controlled by a single group address and don't have dedicated state group objects you can set `state_address` to the same value as `address`. +For switching/light actuators that are only controlled by a single group address and don't have dedicated state group objects you can set `state_address` to the same value as `address` if it is readable from the bus. -*Note on tunable white:* Home Assistant uses Mireds as the unit for color temperature, whereas KNX typically uses Kelvin. The Kelvin/Mireds relationship is reciprocal, not linear, therefore the color temperature pickers (sliders) in Home Assistant may not align with ones of KNX visualizations. This is the expected behavior. - -### Extended configuration examples +### YAML configuration examples ```yaml knx: @@ -1472,6 +1465,8 @@ knx: state_address: "1/0/5" ``` +{% enddetails %} + ## Notify The KNX notify platform allows you to send notifications to [KNX](https://www.knx.org/) devices as DPT16 strings. @@ -1988,6 +1983,14 @@ knx: The KNX switch platform is used as an interface to switching actuators. +Switch entities can be created from the frontend in the KNX panel or via YAML. + +Switch entities without a `state_address` will restore their last known state after Home Assistant was restarted. +Switches that have a `state_address` configured request their current state from the KNX bus. + + +{% details "Configuration of KNX switch entities via YAML" %} + ```yaml knx: switch: @@ -2032,8 +2035,7 @@ device_class: The optional `state_address` can be used to inform Home Assistant about state changes not triggered by a telegram to the `address` e.g., if you configure a timer on a channel. If a KNX message is seen on the bus addressed to the given state address, this will overwrite the state of the switch object. -Switch entities without a `state_address` will restore their last known state after Home Assistant was restarted. -Switches that have a `state_address` configured request their current state from the KNX bus. +{% enddetails %} ## Text