Merge pull request #3 from asev/master

Added Party mode service

Author: laszlojakab

README.md

@@ -20,6 +20,8 @@ Integration adds a fan entity, and the following sensors:
 
 - Extract air relative humidity
 
+- Party mode remaning time
+
 - Airflow rate (approximately value)
 - Fan speed percentage
 - Fan stage
@@ -41,4 +43,4 @@ Integration adds a fan entity, and the following sensors:
 - Warnings
 - Information
 
-
+Also it adds service `easycontrols.party_mode` to change fan speed for limited time.

custom_components/easycontrols/const.py

@@ -11,6 +11,9 @@
 VARIABLE_PREHEATER_STATUS = "v00024"
 VARIABLE_AFTERHEATER_STATUS = "v00201"
 VARIABLE_PARTY_MODE = "v00094"
+VARIABLE_PARTY_MODE_DURATION = "v00091"
+VARIABLE_PARTY_MODE_FAN_STAGE = "v00092"
+VARIABLE_PARTY_MODE_REMAINING_TIME = "v00093"
 VARIABLE_STANDBY_MODE = "v00099"
 VARIABLE_OPERATING_MODE = "v00101"
 VARIABLE_FAN_STAGE = "v00102"

custom_components/easycontrols/fan.py

@@ -21,6 +21,8 @@
     VARIABLE_HOLIDAY_MODE,
     VARIABLE_OPERATING_MODE,
     VARIABLE_PARTY_MODE,
+    VARIABLE_PARTY_MODE_FAN_STAGE,
+    VARIABLE_PARTY_MODE_DURATION,
     VARIABLE_PERCENTAGE_FAN_SPEED,
     VARIABLE_STANDBY_MODE
 )
@@ -114,6 +116,24 @@ async def async_turn_off(self, **kwargs):
         )  # operation mode = manual
         self._controller.set_variable(VARIABLE_FAN_STAGE, 0, "{:d}")
 
+    def start_party_mode(self, speed: str, duration: int):
+        if duration == 0:
+            # stop current party mode
+            self._controller.set_variable(
+                VARIABLE_PARTY_MODE, 0, "{:d}"
+            )
+            return
+
+        self._controller.set_variable(
+            VARIABLE_PARTY_MODE_FAN_STAGE, self.speed_list.index(speed) + 1, "{:d}"
+        )
+        self._controller.set_variable(
+            VARIABLE_PARTY_MODE_DURATION, duration, "{:d}"
+        )
+        self._controller.set_variable(
+            VARIABLE_PARTY_MODE, 1, "{:d}"
+        )
+
     async def async_update(self):
         self._percentage_fan_speed = float(
             self._controller.get_variable(
@@ -169,7 +189,15 @@ async def async_setup_entry(hass, entry, async_add_entities):
 
     name = entry.data[CONF_NAME]
     controller = hass.data[DOMAIN][CONTROLLER][entry.data[CONF_HOST]]
+    fan = EasyControlFanDevice(hass, controller, name)
+
+    async_add_entities([fan])
+
+    def handle_party_mode(call):
+        duration = call.data.get('duration', 60)
+        speed = call.data.get('speed', 'high')
+        fan.start_party_mode(speed, duration)
 
-    async_add_entities([EasyControlFanDevice(hass, controller, name)])
+    hass.services.async_register(DOMAIN, "party_mode", handle_party_mode)
 
     _LOGGER.info("Setting up Helios EasyControls fan device completed.")

custom_components/easycontrols/sensor.py

@@ -24,6 +24,7 @@
     VARIABLE_PERCENTAGE_PREHEATER,
     VARIABLE_PERCENTAGE_FAN_SPEED,
     VARIABLE_FAN_STAGE,
+    VARIABLE_PARTY_MODE_REMAINING_TIME,
     VARIABLE_PREHEATER_STATUS,
     VARIABLE_AFTERHEATER_STATUS
 )
@@ -385,6 +386,9 @@ async def async_setup_entry(hass, entry, async_add_entities):
         EasyControlSensor(
             controller, VARIABLE_HUMIDITY_EXTRACT_AIR, 8, int, f"{name} extract air relative humidity", name, "mdi:water-percent", "%"
         ),
+        EasyControlSensor(
+            controller, VARIABLE_PARTY_MODE_REMAINING_TIME, 8, int, f"{name} party mode remaining time", name, "mdi:clock", "min"
+        ),
         EasyControlSensor(
             controller, VARIABLE_OPERATION_HOURS_SUPPLY_AIR_FAN, 10, lambda x: round(float(
                 x) / 60.0, 2), f"{name} supply air fan operation hours", name, "mdi:history", "h"

custom_components/services.yaml

@@ -0,0 +1,12 @@
+party_mode:
+  description: Change fan speed for limited time
+  fields:
+    entity_id:
+      description: Name of the entity.
+      example: "fan.helios"
+    speed:
+      description: "Boost speed. Available: basic, rated, intensive, maximum"
+      example: intensive
+    duration:
+      description: Duration in minutes
+      example: 60