Climate 1.0

[pvizeli]

Breaking Change:

• All operation are now defined by the core
• Abstract operation mode and current action for devices they support this (only for viewing on UI)
• Hold modes called now presets
• Away mode move into hold modes because it is what it is and manufactory use it like that
• Remove on/off in flavor of hvac state

Platforms:

Most platform will support now a lot more features. But Somethings was also cleaned out:

• OEM - Remove fake away
• Hive - Hot water is not a climate device @KJonline @Rendili (use the new component for hot water) / boost use now preset instead hack into auxiliary
• Radiotherm - remove fake away
• Nuheat - service renamed from climate.nuheat_resume_program to nuheat.resume_program
• generic-thermostat - rename initial_operation_mode to initial_hvac_mode

Description:

Looks like a small change but they are massive. I look over all climate API and also external Interfaces like Voice Assistant, and that is the result they should be able to cover our cases.

Most of the problem was that a lot of stuff was mixed because of history for that component. Like Away mode, they were initially added and later as the hold modes come too, they were never strict merged back. Some integration was added hacks to offload it from hold mode.

That is the result of hours and hours research of what we have and what exists and how the device manufacture implement things.

I don't think our old climate was bad because no platform supports so many different devices and I learned a lot from that code. The problem was only, that no one had the overview to make a clean setup.

Implement the subset of over 100 comments from home-assistant/architecture#22

This pull request includes an updated UI to work with the new schema.

AWAY

Some HA hardware interfaces (components) use a fake away. That is something that is not part of an interface schema. Logic abstraction or components level 2 allowed to fake logic but not on level 1 (hardware interfaces).

Upgrade guide

The main thing that is new is presets Things like eco mode, away mode, hold mode, manual mode, etc are now all presets and set via set_preset_mode function.

• New set_preset_mode/async_set_preset_mode replaces the following (including their async variants):
  • turn_away_mode_on
  • turn_away_mode_off
  • set_hold_mode
  • turn_on
  • turn_off
• supported_features:
  • SUPPORT_TARGET_TEMPERATURE_LOW + SUPPORT_TARGET_TEMPERATURE_HIGH -> SUPPORT_TARGET_TEMPERATURE_RANGE
  • Removed SUPPORT_TARGET_HUMIDITY_HIGH, SUPPORT_TARGET_HUMIDITY_LOW
  • Removed SUPPORT_OPERATION_MODE
  • Removed SUPPORT_HOLD_MODE
  • Removed SUPPORT_SWING_MODE
  • Removed SUPPORT_AWAY_MODE
  • Removed SUPPORT_ON_OFF (implement HVAC_MODE_HEAT + HVAC_MODE_OFF instead)
• is_on removed (implement HVAC_MODE_HEAT + HVAC_MODE_OFF instead)
• STATE_IDLE -> HVAC_STATE_OFF
• State machine attribute ATTR_OPERATION_MODE is now the state of the entity
• Properties that are the same:
  • name
  • precision_unit
  • temperature_unit
  • current_humidity
  • target_humidity
  • current_temperature
  • target_temperature
  • target_temperature_step
  • target_temperature_high
  • target_temperature_low
  • min_temp
  • max_temp
  • min_humidity
  • max_humidity
• current_operation -> hvac_mode(limited to one of HVAC_MODES const)
• operation_list -> hvac_modes (subset of HVAC_MODES const)
• hvac_action new. The current action of the device (heating, etc. See CURRENT_HVAC_* consts)
• preset_mode new The current preset mode (home, away, temp) (one of preset_modes)
• preset_modes new The available preset modes (prefer one of PRESET_* const, custom values allowed)
• is_aux_heat_on -> is_aux_heat
• current_fan_mode -> fan_mode (one of fan_modes)
• fan_list -> fan_modes (prefer using FAN_* constants from climate/const.py, custom values allowed)
• current_swing_mode -> swing_mode (one of swing_modes)
• swing_list -> swing_modes (prefer SWING_ constants, custom values allowed)
• set_operation_mode -> set_hvac_mode

Migration

• homematic
• demo
• xs1
• hive
• mill
• lcn
• oem
• toon
• deconz
• tesla
• vera
• zwave
• velbus
• wink
• dyson
• tefiac
• tado
• mqtt
• venstar
• zhong_hong
• tuya
• spider
• radiotherm
• sensibo
• smartthings
• melissa
• fibaro
• mysensors
• nest
• ecobee
• elkm1
• flexit
• coolmaster
• daikin
• honeywell Migrate honeywell to new climate schema #24257
• proliphix
• ephember
• incomfort
• homekit
• homekit_controller
• geniushub Migrate geniushub to new climate schema #24191
• touchline
• stiebel_eltron
• opentherm_gw
• nuheat
• netatmo
• modbus
• maxcube
• knx
• homematicip_cloud
• heatmiser
• generic_thermostat
• fritzbox
• evohome Migrate evohome, cache access tokens #24491
• esphome
• eq3btsmart
• ambiclimate ambiclimate to climate 1.0 #24911

Integration

• Alexa
• Google Assistant

[Jc2k]

@zxdavb cheers!

Have submitted #25009 to fix that.

[balloob]

🎉 🎉 🎉 🎉 🎉

We did it! We made a lots of changes and things might have been broken. If you find a bug in one of the integrations or have a PR with improvements, please tag PRs with [climate] so it is easy to spot for us. Feel free to tag me and I prioritize reviewing.

[Rendili]

Hi @balloob,

Khole and I are working on fixes to the Hive climate code, which we think we have completed now and re-adding Hive hotwater support as water_heater after it was removed from climate.

We are still ironing out some bugs in the water_heater, but if not complete before Climate 1.0 goes live we will lose hotwater / water_heater support for Hive (assuming no one else is working on this)

How do you recommend we proceed? We were aiming for one PR with the new file for water_heater and the fixed file for climate.
and do we now make the PR for DEV rather than Climate branch?

[elupus]

The ecobee failure is due to dict in 3.5 not preserving order on keys.
https://github.com/home-assistant/home-assistant/blob/ab832cda710f9bf14111b438005ed27aca7cad0d/homeassistant/components/ecobee/climate.py#L427

[balloob]

@Rendili PRs against dev branch. We are cutting the 96 beta this Wednesday but will include a water heater PR in 96 if it comes in during the beta period.

@elupus good catch, I'll open a PR with a fix.

[balloob]

@elupus #25019