Add ClimateEntityFeature.TURN_OFF feature & implementation

README.md

@@ -86,6 +86,8 @@ Use the standard `climate` service calls to control or automate each unit. Avail
 - `climate.set_fan_mode`
 - `climate.set_hvac_mode`
 - `climate.set_swing_mode`
+- `climate.turn_on`
+- `climate.turn_off`
 
 Specific support and behavior can vary, depending on the capabilities of your indoor unit.
 

custom_components/kumo/climate.py

@@ -128,8 +128,6 @@ class KumoThermostat(CoordinatedKumoEntity, ClimateEntity):
         "runstate",
     ]
 
-    _enable_turn_on_off_backwards_compatibility = False # can be removed once 2024.12 is no longer supported
-
     def __init__(self, coordinator: KumoDataUpdateCoordinator):
         """Initialize the thermostat."""
 
@@ -155,7 +153,10 @@ def __init__(self, coordinator: KumoDataUpdateCoordinator):
         self._swing_modes = self._pykumo.get_vane_directions()
         self._hvac_modes = [HVACMode.OFF, HVACMode.COOL]
         self._supported_features = (
-            ClimateEntityFeature.TARGET_TEMPERATURE | ClimateEntityFeature.FAN_MODE
+            ClimateEntityFeature.TARGET_TEMPERATURE |
+            ClimateEntityFeature.FAN_MODE |
+            ClimateEntityFeature.TURN_OFF |
+            ClimateEntityFeature.TURN_ON
         )
         if self._pykumo.has_dry_mode():
             self._hvac_modes.append(HVACMode.DRY)
@@ -495,7 +496,7 @@ def set_temperature(self, **kwargs):
                 "Kumo %s set %s temp response: %s", self._name, "cool", str(response)
             )
 
-    def set_hvac_mode(self, hvac_mode):
+    def set_hvac_mode(self, hvac_mode, caller="set_hvac_mode"):
         """Set new target operation mode."""
         try:
             mode = HA_STATE_TO_KUMO[hvac_mode]
@@ -508,7 +509,7 @@ def set_hvac_mode(self, hvac_mode):
 
         response = self._pykumo.set_mode(mode)
         _LOGGER.debug(
-            "Kumo %s set mode %s response: %s", self._name, hvac_mode, response
+            "Kumo %s set mode %s (via `%s`) response: %s", self._name, hvac_mode, caller, response
         )
 
     def set_swing_mode(self, swing_mode):
@@ -528,3 +529,14 @@ def set_fan_mode(self, fan_mode):
 
         response = self._pykumo.set_fan_speed(fan_mode)
         _LOGGER.debug("Kumo %s set fan speed response: %s", self._name, response)
+
+    def turn_on(self) -> None:
+        """Turn the climate on. This implements https://www.home-assistant.io/integrations/climate/#action-climateturn_on.
+
+        For now, turn it on to HVACMode.COOL which always exists in self._hvac_modes.
+        In the future, make the default "on" mode configurable."""
+        self.set_hvac_mode(HVACMode.COOL, caller="turn_on")
+
+    def turn_off(self):
+        """Turn the climate off. This implements https://www.home-assistant.io/integrations/climate/#action-climateturn_off."""
+        self.set_hvac_mode(HVACMode.OFF, caller="turn_off")