KNX Climate


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

The knx climate platform is used as an interface to KNX thermostats and room controllers.

To use your KNX thermostats in your installation, add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
climate:
   - platform: knx
     name: HASS-Kitchen.Temperature
     temperature_address: '5/1/1'
     setpoint_shift_address: '5/1/2'
     setpoint_shift_state_address: '5/1/3'
     target_temperature_state_address: '5/1/4'
     operation_mode_address: '5/1/5'
     operation_mode_state_address: '5/1/6'

Alternatively, if your device has dedicated binary group addresses for frost/night/comfort mode:

# Example configuration.yaml entry
climate:
  - platform: knx
    name: HASS-Kitchen.Temperature
    temperature_address: '5/1/1'
    setpoint_shift_address: '5/1/2'
    setpoint_shift_state_address: '5/1/3'
    target_temperature_state_address: '5/1/4'
    operation_mode_frost_protection_address: '5/1/5'
    operation_mode_night_address: '5/1/6'
    operation_mode_comfort_address: '5/1/7'
    operation_mode_state_address: '5/1/8'

If your device doesn’t support setpoint_shift calculations (i.e. if you don’t provide a setpoint_shift_address value) please set the min_temp and max_temp attributes of the climate device to avoid issues with exceeding valid temperature values in the frontend. Please do also make sure to add the target_temperature_address to the config in this case.:

# Example configuration.yaml entry
climate:
  - platform: knx
    name: HASS-Kitchen.Temperature
    temperature_address: '5/1/2'
    target_temperature_address: '5/1/4'
    target_temperature_state_address: '5/1/1'
    operation_mode_frost_protection_address: '5/1/5'
    operation_mode_night_address: '5/1/6'
    operation_mode_comfort_address: '5/1/7'
    operation_mode_state_address: '5/1/8'
    min_temp: 7.0
    max_temp: 32.0

operation_mode_frost_protection_address / operation_mode_night_address / operation_mode_comfort_address are not necessary if operation_mode_address is specified. If the actor doesn’t support explicit state communication objects the *_state_address can be configured with the same group address as the writeable *_address. The Read-Flag for the *_state_address communication object has to be set in ETS to support initial reading eg. when starting home-assistant.

The following values are valid for the hvac_mode attribute:

  • Off (maps internally to HVAC_MODE_OFF within Home Assistant)
  • Auto (maps internally to HVAC_MODE_AUTO within Home Assistant)
  • Heat (maps internally to HVAC_MDOE_HEAT within Home Assistant)
  • Cool (maps internally to HVAC_MDOE_COOL within Home Assistant)
  • Fan only (maps internally to HVAC_MODE_FAN_ONLY within Home Assistant)
  • Dry (maps internally to HVAC_MODE_DRY within Home Assistant)

The following presets are valid for the preset_mode attribute:

  • Comfort (maps internally to PRESET_COMFORT within Home Assistant)
  • Standby (maps internally to PRESET_AWAY within Home Assistant)
  • Night (maps internally to PRESET_SLEEP within Home Assistant)
  • Frost Protection (maps internally to PRESET_ECO within Home Assistant)

Configuration Variables

name

(string)(Optional)

A name for this device used within Home Assistant.

Default value:

KNX Climate

temperature_address

(string)(Required)

KNX group address for reading current room temperature from KNX bus. DPT 9.001

target_temperature_address

(string)(Optional)

KNX group address for setting target temperature. DPT 9.001

target_temperature_state_address

(string)(Required)

KNX group address for reading current target temperature from KNX bus. DPT 9.001

setpoint_shift_address

(string)(Optional)

KNX address for setpoint_shift. DPT 6.010

setpoint_shift_state_address

(string)(Optional)

KNX address for reading setpoint_shift. DPT 6.010

setpoint_shift_step

(float)(Optional)

Defines the step size in Kelvin for each step of setpoint_shift.

Default value:

0.5

setpoint_shift_min

(float)(Optional)

Minimum value of setpoint shift.

Default value:

-6

setpoint_shift_max

(float)(Optional)

Maximum value of setpoint shift.

Default value:

6

operation_mode_address

(string)(Optional)

KNX address for setting operation mode (Frost protection/night/comfort). DPT 20.102

operation_mode_state_address

(string)(Optional)

KNX address for reading operation mode. DPT 20.102

controller_status_address

(string)(Optional)

KNX address for HVAC controller status (in accordance with KNX AN 097/07 rev 3).

controller_status_state_address

(string)(Optional)

KNX address for reading HVAC controller status.

controller_mode_address

(string)(Optional)

KNX address for setting HVAC controller modes. DPT 20.105

controller_mode_state_address

(string)(Optional)

KNX address for reading HVAC Control Mode. DPT 20.105

operation_mode_frost_protection_address

(string)(Optional)

KNX address for switching on/off frost/heat protection mode.

operation_mode_night_address

(string)(Optional)

KNX address for switching on/off night mode.

operation_mode_comfort_address

(string)(Optional)

KNX address for switching on/off comfort mode.

operation_modes

(list)(Optional)

Overrides the supported operation modes.

on_off_address

(string)(Optional)

KNX address for switching the climate device on/off.

on_off_state_address

(string)(Optional)

KNX address for gathering the current state (on/off) of the climate device.

min_temp

(float)(Optional)

Override the minimum temperature.

max_temp

(float)(Optional)

Override the maximum temperature.