Home Assistant Unofficial Reference 2024.12.1
climate.py
Go to the documentation of this file.
1 """Initialization of ATAG One climate platform."""
2 
3 from __future__ import annotations
4 
5 from typing import Any
6 
8  PRESET_AWAY,
9  PRESET_BOOST,
10  ClimateEntity,
11  ClimateEntityFeature,
12  HVACAction,
13  HVACMode,
14 )
15 from homeassistant.const import ATTR_TEMPERATURE
16 from homeassistant.core import HomeAssistant
17 from homeassistant.helpers.entity_platform import AddEntitiesCallback
18 from homeassistant.util.enum import try_parse_enum
19 
20 from .coordinator import AtagConfigEntry, AtagDataUpdateCoordinator
21 from .entity import AtagEntity
22 
23 PRESET_MAP = {
24  "Manual": "manual",
25  "Auto": "automatic",
26  "Extend": "extend",
27  PRESET_AWAY: "vacation",
28  PRESET_BOOST: "fireplace",
29 }
30 PRESET_INVERTED = {v: k for k, v in PRESET_MAP.items()}
31 HVAC_MODES = [HVACMode.AUTO, HVACMode.HEAT]
32 
33 
35  hass: HomeAssistant, entry: AtagConfigEntry, async_add_entities: AddEntitiesCallback
36 ) -> None:
37  """Load a config entry."""
38  async_add_entities([AtagThermostat(entry.runtime_data, "climate")])
39 
40 
42  """Atag climate device."""
43 
44  _attr_hvac_modes = HVAC_MODES
45  _attr_preset_modes = list(PRESET_MAP.keys())
46  _attr_supported_features = (
47  ClimateEntityFeature.TARGET_TEMPERATURE | ClimateEntityFeature.PRESET_MODE
48  )
49  _enable_turn_on_off_backwards_compatibility = False
50 
51  def __init__(self, coordinator: AtagDataUpdateCoordinator, atag_id: str) -> None:
52  """Initialize an Atag climate device."""
53  super().__init__(coordinator, atag_id)
54  self._attr_temperature_unit_attr_temperature_unit = coordinator.atag.climate.temp_unit
55 
56  @property
57  def hvac_mode(self) -> HVACMode | None:
58  """Return hvac operation ie. heat, cool mode."""
59  return try_parse_enum(HVACMode, self.coordinator.atag.climate.hvac_mode)
60 
61  @property
62  def hvac_action(self) -> HVACAction | None:
63  """Return the current running hvac operation."""
64  is_active = self.coordinator.atag.climate.status
65  return HVACAction.HEATING if is_active else HVACAction.IDLE
66 
67  @property
68  def current_temperature(self) -> float | None:
69  """Return the current temperature."""
70  return self.coordinator.atag.climate.temperature
71 
72  @property
73  def target_temperature(self) -> float | None:
74  """Return the temperature we try to reach."""
75  return self.coordinator.atag.climate.target_temperature
76 
77  @property
78  def preset_mode(self) -> str | None:
79  """Return the current preset mode, e.g., auto, manual, fireplace, extend, etc."""
80  preset = self.coordinator.atag.climate.preset_mode
81  return PRESET_INVERTED.get(preset)
82 
83  async def async_set_temperature(self, **kwargs: Any) -> None:
84  """Set new target temperature."""
85  await self.coordinator.atag.climate.set_temp(kwargs.get(ATTR_TEMPERATURE))
86  self.async_write_ha_stateasync_write_ha_state()
87 
88  async def async_set_hvac_mode(self, hvac_mode: HVACMode) -> None:
89  """Set new target hvac mode."""
90  await self.coordinator.atag.climate.set_hvac_mode(hvac_mode)
91  self.async_write_ha_stateasync_write_ha_state()
92 
93  async def async_set_preset_mode(self, preset_mode: str) -> None:
94  """Set new preset mode."""
95  await self.coordinator.atag.climate.set_preset_mode(PRESET_MAP[preset_mode])
96  self.async_write_ha_stateasync_write_ha_state()
None async_set_temperature(self, **Any kwargs)
Definition: climate.py:83
None __init__(self, AtagDataUpdateCoordinator coordinator, str atag_id)
Definition: climate.py:51
None async_set_preset_mode(self, str preset_mode)
Definition: climate.py:93
None async_set_hvac_mode(self, HVACMode hvac_mode)
Definition: climate.py:88
None async_setup_entry(HomeAssistant hass, AtagConfigEntry entry, AddEntitiesCallback async_add_entities)
Definition: climate.py:36