home-assistant.io/source/_components/climate.knx.markdown
2018-12-19 00:22:02 +01:00

4.7 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 Climate Instructions on how to integrate KNX thermostats with Home Assistant. 2016-06-24 12:00 true false true true knx.png Climate 0.25 Local Polling

The knx climate platform is used as in interface with KNX thermostats.

The knx component must be configured correctly, see KNX Component.

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_address: '5/1/4'
     operation_mode_address: '5/1/5'

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_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'

If you want to overwrite the supported operation modes use:

# 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_address: '5/1/4'
    operation_mode_frost_protection_address: '5/1/5'
    operation_mode_comfort_address: '5/1/7'
    override_supported_operation_modes:
      - "Night"
      - "Standby"
      - "Comfort"

{% configuration %} name: description: A name for this device used within Home Assistant. required: false default: KNX Climate type: string temperature_address: description: KNX group address for reading current room temperature from KNX bus. required: true type: string target_temperature_address: description: KNX group address for reading current target temperature from KNX bus. required: true type: string setpoint_shift_address: description: KNX address for setpoint_shift. required: false type: string setpoint_shift_state_address: description: Explicit KNX address for reading setpoint_shift. required: false type: string setpoint_shift_step: description: Defines for step size in Kelvin for each step of setpoint_shift. required: false default: 0.5 type: float setpoint_shift_min: description: Minimum value of setpoint shift. required: false default: -6 type: integer setpoint_shift_max: description: Maximum value of setpoint shift. required: false default: 6 type: integer operation_mode_address: description: KNX address for operation mode (Frost protection/night/comfort). required: false type: string operation_mode_state_address: description: Explicit KNX address for reading operation mode. required: false type: string controller_status_address: description: KNX address for HVAC controller status (in accordance with KNX AN 097/07 rev 3). required: false type: string controller_status_state_address: description: Explicit KNX address for reading HVAC controller status. required: false type: string operation_mode_frost_protection_address: description: KNX address for switching on/off frost/heat protection mode. required: false type: string operation_mode_night_address: description: KNX address for switching on/off night mode. required: false type: string operation_mode_comfort_address: description: KNX address for switching on/off comfort mode. required: false type: string override_supported_operation_modes: description: Defines the supported operation modes. required: false type: array on_off_address: description: KNX address for switching the device on/off. required: false type: string on_off_state_address: description: Explicit KNX address for reading the current on/off status. required: false type: string {% endconfiguration %}

operation_mode_frost_protection_address / operation_mode_night_address / operation_mode_comfort_address are not necessary if operation_mode_address is specified.

override_supported_operation_modes is an array that can contain any of the following values:

  • Auto
  • Comfort
  • Standby
  • Night
  • Frost Protection
  • Heat
  • Morning Warmup
  • Cool
  • Night Purge
  • Precool
  • Off
  • Test
  • Emergency Heat
  • Fan only
  • Ice
  • Dry
  • NoDem

Also check this page for more information.