Duoxilian c68df1bc66 Update climate.markdown (#1898)
Add documentation for hold_mode.
2017-01-29 09:24:10 +01:00

5.8 KiB

layout, title, description, date, sidebar, comments, sharing, footer
layout title description date sidebar comments sharing footer
page Climate Instructions how to setup climate control devices within Home Assistant. 2016-08-26 19:00 true false true true

The climate component is built for the controlling and monitoring of HVAC (heating, ventilating, and air conditioning) and thermostat devices.

To enable this component, pick one of the platforms, and add it to your configuration.yaml:

# Example configuration.yaml entry
climate:
  platform: demo

{% linkable_title Services %}

{% linkable_title Climate control services %}

Available services: climate.set_aux_heat, climate.set_away_mode, climate.set_temperature, climate.set_humidity, climate.set_fan_mode, climate.set_operation_mode, climate.set_swing_mode

Not all climate services may be available for your platform. Be sure to check the available services Home Assistant has enabled by checking service developer tool icon **Services**.

{% linkable_title Service climate.set_aux_heat %}

Turn auxiliary heater on/off for climate device

Service data attribute Optional Description
entity_id yes String or list of strings that point at entity_id's of climate devices to control. Else targets all.
aux_heat no New value of auxiliary heater.

{% linkable_title Automation example %}

automation:
  trigger:
    platform: time
    after: "07:15:00"
  action:
    - service: climate.set_aux_heat
      data:
        entity_id: climate.kitchen
        aux_heat: true

{% linkable_title Service climate.set_away_mode %}

This service has been deprecated. Use climate.set_hold_mode instead.

{% linkable_title Service climate.set_hold_mode %}

Set hold mode for climate device

Service data attribute Optional Description
entity_id yes String or list of strings that point at entity_id's of climate devices to control. Else targets all.
hold_mode no New value of hold mode.

{% linkable_title Automation example %}

automation:
  trigger:
    platform: time
    after: "07:15:00"
  action:
    - service: climate.set_hold_mode
      data:
        entity_id: climate.kitchen
        hold_mode: 'away'

{% linkable_title Service climate.set_temperature %}

Set target temperature of climate device

Service data attribute Optional Description
entity_id yes String or list of strings that point at entity_id's of climate devices to control. Else targets all.
temperature no New target temperature for hvac
target_temp_high yes New target high temperature for hvac
target_temp_low yes New target low temperature for hvac
operation_mode yes Operation mode to set temperature to. This defaults to current_operation mode if not set, or set incorrectly.

{% linkable_title Automation example %}

automation:
  trigger:
    platform: time
    after: "07:15:00"
  action:
    - service: climate.set_temperature
      data:
        entity_id: climate.kitchen
        temperature: 24
        operation_mode: Heat

{% linkable_title Service climate.set_humidity %}

Set target humidity of climate device

Service data attribute Optional Description
entity_id yes String or list of strings that point at entity_id's of climate devices to control. Else targets all.
humidity no New target humidity for climate device

{% linkable_title Automation example %}

automation:
  trigger:
    platform: time
    after: "07:15:00"
  action:
    - service: climate.set_humidity
      data:
        entity_id: climate.kitchen
        humidity: 60

{% linkable_title Service climate.set_fan_mode %}

Set fan operation for climate device

Service data attribute Optional Description
entity_id yes String or list of strings that point at entity_id's of climate devices to control. Else targets all.
fan_mode no New value of fan mode

{% linkable_title Automation example %}

automation:
  trigger:
    platform: time
    after: "07:15:00"
  action:
    - service: climate.set_fan_mode
      data:
        entity_id: climate.kitchen
        fan_mode: 'On Low'

{% linkable_title Service climate.set_operation_mode %}

Set operation mode for climate device

Service data attribute Optional Description
entity_id yes String or list of strings that point at entity_id's of climate devices to control. Else targets all.
operation_mode no New value of operation mode

{% linkable_title Automation example %}

automation:
  trigger:
    platform: time
    after: "07:15:00"
  action:
    - service: climate.set_operation_mode
      data:
        entity_id: climate.kitchen
        operation_mode: Heat

{% linkable_title Service climate.set_swing_mode %}

Set operation mode for climate device

Service data attribute Optional Description
entity_id yes String or list of strings that point at entity_id's of climate devices to control. Else targets all.
swing_mode no New value of swing mode

{% linkable_title Automation example %}

automation:
  trigger:
    platform: time
    after: "07:15:00"
  action:
    - service: climate.set_swing_mode
      data:
        entity_id: climate.kitchen
        swing_mode: 1