KNX Light
The knx
integration must be configured correctly to use this integration, see KNX Integration.
The knx light
integration is used as an interface to control knx actuators for lighting applications such as:
- switching actuators
- dimming actuators
- LED controllers
- DALI gateways
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 Variables
- address
(string)(Required)
KNX group address for switching the light on and off. DPT 1.001
- state_address
(string)(Optional)
KNX group address for retrieving the switch state of the light. DPT 1.001
- name
(string)(Optional)
A name for this device used within Home Assistant.
- brightness_address
(string)(Optional)
KNX group address for setting the brightness of the light in percent (absolute dimming). DPT 5.001
- brightness_state_address
(string)(Optional)
KNX group address for retrieving the brightness of the light in percent. DPT 5.001
- color_address
(string)(Optional)
KNX group address for setting the RGB color of the light. DPT 232.600
- color_state_address
(string)(Optional)
KNX group address for retrieving the RGB color of the light. DPT 232.600
- rgbw_address
(string)(Optional)
KNX group address for setting the RGBW color of the light. DPT 251.600
- rgbw_state_address
(string)(Optional)
KNX group address for retrieving the RGBW color of the light. DPT 251.600
- color_temperature_address
(string)(Optional)
KNX group address for setting the color temperature of the light. DPT 5.001 or 7.600 based on color_temperature_mode
- color_temperature_state_address
(string)(Optional)
KNX group address for retrieving the color temperature of the light. DPT 5.001 or 7.600 based on color_temperature_mode
- color_temperature_mode
-
(string)(Optional)
Color temperature group address data type.
absolute
color temperature in Kelvin. color_temperature_address -> DPT 7.600.relative
color temperature in percent cold white (0% warmest; 100% coldest). color_temperature_address -> DPT 5.001Default value:
absolute
- min_kelvin
-
(integer)(Optional)
Warmest possible color temperature in Kelvin. (Used in combination with color_temperature_address)
Default value:
2700
- max_kelvin
-
(integer)(Optional)
Coldest possible color temperature in Kelvin. (Used in combination with color_temperature_address)
Default value:
6000
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 switch object.
For switching/light actuators that are only controlled by a single group address and don’t have dedicated state communication objects you can set state_address
to the same value as address
.
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 example
light:
# dimmable light
- platform: knx
name: Bedroom-Light-1
address: '1/0/9'
state_address: '1/1/9'
brightness_address: '1/2/9'
brightness_state_address: '1/3/9'
#
# RGB light
- platform: knx
name: Bathroom-Light-1
address: '1/0/9'
state_address: '1/1/9'
brightness_address: '1/2/9'
brightness_state_address: '1/3/9'
color_address: '1/4/9'
color_state_address: '1/5/9'
#
# tunable white light
- platform: knx
name: Office-Light-1
address: '1/0/21'
state_address: '1/1/21'
brightness_address: '1/2/21'
brightness_state_address: '1/3/21'
color_temperature_address: '1/4/21'
color_temperature_state_address: '1/5/21'
color_temperature_mode: absolute
min_kelvin: 2550
max_kelvin: 6200
#
# actuator without dedicated state communication object
- platform: knx
name: Cellar-Light-1
address: '1/0/5'
state_address: '1/0/5'