feat: add holiday support for Velis Slp (Nuos) devices

ariston/ariston_api.py

@@ -85,14 +85,14 @@
         devices = self._get(f"{self.__api_url}{ARISTON_REMOTE}/{ARISTON_PLANTS}")
         if devices is not None:
             return list(devices)
         return list()
 
     def get_detailed_velis_devices(self) -> list[Any]:
         """Get detailed cloud devices"""
         devices = self._get(f"{self.__api_url}{ARISTON_VELIS}/{ARISTON_PLANTS}")
         if devices is not None:
             return list(devices)
         return list()
 
     def get_devices(self) -> list[Any]:
         """Get cloud devices"""
@@ -101,7 +101,7 @@
         )
         if devices is not None:
             return list(devices)
         return list()
 
     def get_features_for_device(self, gw_id: str) -> dict[str, Any]:
         """Get features for the device"""
@@ -110,7 +110,7 @@
         )
         if features is not None:
             return features
         return dict()
 
     def get_energy_account(self, gw_id: str) -> dict[str, Any]:
         """Get energy account for the device"""
@@ -119,7 +119,7 @@
         )
         if energy_account is not None:
             return energy_account
         return dict()
 
     def get_consumptions_sequences(self, gw_id: str, usages: str) -> list[Any]:
         """Get consumption sequences for the device"""
@@ -128,7 +128,7 @@
         )
         if consumptions_sequences is not None:
             return list(consumptions_sequences)
         return list()
 
     def get_consumptions_settings(self, gw_id: str) -> dict[str, Any]:
         """Get consumption settings"""
@@ -138,7 +138,7 @@
         )
         if consumptions_settings is not None:
             return consumptions_settings
         return dict()
 
     def set_consumptions_settings(
         self,
@@ -174,7 +174,7 @@
         )
         if properties is not None:
             return properties
         return dict()
 
     def get_bsb_plant_data(self, gw_id: str) -> dict[str, Any]:
         """Get BSB plant data."""
@@ -183,14 +183,14 @@
         )
         if data is not None:
             return data
         return dict()
 
     def get_velis_plant_data(self, plant_data: PlantData, gw_id: str) -> dict[str, Any]:
         """Get Velis properties"""
         data = self._get(f"{self.__api_url}{ARISTON_VELIS}/{plant_data.value}/{gw_id}")
         if data is not None:
             return data
         return dict()
 
     def get_velis_plant_settings(
         self, plant_data: PlantData, gw_id: str
@@ -201,7 +201,7 @@
         )
         if settings is not None:
             return settings
         return dict()
 
     def get_menu_items(self, gw_id: str) -> list[dict[str, Any]]:
         """Get menu items"""
@@ -210,7 +210,7 @@
         )
         if items is not None:
             return items
         return list()
 
     def set_property(
         self,
@@ -437,7 +437,7 @@
         )
         if thermostat_time_progs is not None:
             return thermostat_time_progs
         return dict()
 
     def set_holiday(
         self,
@@ -452,6 +452,23 @@
             },
         )
 
+    def set_velis_slp_holiday(
+        self,
+        gw_id: str,
+        holiday_end_date: Optional[str],
+    ) -> None:
+        """Set holiday on a Velis Slp (Nuos) device.
+
+        Pass an ISO-formatted end date string to schedule the holiday, or
+        ``None`` to clear it.
+        """
+        self._post(
+            f"{self.__api_url}{ARISTON_VELIS}/{PlantData.Slp.value}/{gw_id}/holiday",
+            {
+                "new": holiday_end_date,
+            },
+        )
+
     def get_bus_errors(self, gw_id: str) -> list[Any]:
         """Get bus errors"""
         bus_errors = self._get(
@@ -544,7 +561,7 @@
         )
         if detailed_devices is not None:
             return list(detailed_devices)
         return list()
 
     async def async_get_detailed_velis_devices(self) -> list[Any]:
         """Async get detailed cloud devices"""
@@ -553,7 +570,7 @@
         )
         if detailed_velis_devices is not None:
             return list(detailed_velis_devices)
         return list()
 
     async def async_get_devices(self) -> list[Any]:
         """Async get cloud devices"""
@@ -562,7 +579,7 @@
         )
         if devices is not None:
             return list(devices)
         return list()
 
     async def async_get_features_for_device(
         self, gw_id: str
@@ -579,7 +596,7 @@
         )
         if energy_account is not None:
             return energy_account
         return dict()
 
     async def async_get_consumptions_sequences(
         self, gw_id: str, usages: str
@@ -590,7 +607,7 @@
         )
         if consumptions_sequences is not None:
             return list(consumptions_sequences)
         return list()
 
     async def async_get_consumptions_settings(self, gw_id: str) -> dict[str, Any]:
         """Async get consumption settings"""
@@ -600,7 +617,7 @@
         )
         if consumptions_settings is not None:
             return consumptions_settings
         return dict()
 
     async def async_set_consumptions_settings(
         self,
@@ -628,7 +645,7 @@
         )
         if properties is not None:
             return properties
         return dict()
 
     async def async_get_bsb_plant_data(self, gw_id: str) -> dict[str, Any]:
         """Get BSB plant data."""
@@ -637,7 +654,7 @@
         )
         if data is not None:
             return data
         return dict()
 
     async def async_get_velis_plant_data(
         self, plant_data: PlantData, gw_id: str
@@ -648,7 +665,7 @@
         )
         if med_plant_data is not None:
             return med_plant_data
         return dict()
 
     async def async_get_velis_plant_settings(
         self, plant_data: PlantData, gw_id: str
@@ -659,7 +676,7 @@
         )
         if med_plant_settings is not None:
             return med_plant_settings
         return dict()
 
     async def async_get_menu_items(self, gw_id: str) -> list[dict[str, Any]]:
         """Async get menu items"""
@@ -668,7 +685,7 @@
         )
         if items is not None:
             return items
         return list()
 
     async def async_set_property(
         self,
@@ -914,6 +931,23 @@
             },
         )
 
+    async def async_set_velis_slp_holiday(
+        self,
+        gw_id: str,
+        holiday_end_date: Optional[str],
+    ) -> None:
+        """Async set holiday on a Velis Slp (Nuos) device.
+
+        Pass an ISO-formatted end date string to schedule the holiday, or
+        ``None`` to clear it.
+        """
+        await self._async_post(
+            f"{self.__api_url}{ARISTON_VELIS}/{PlantData.Slp.value}/{gw_id}/holiday",
+            {
+                "new": holiday_end_date,
+            },
+        )
+
     async def async_get_bus_errors(self, gw_id: str) -> list[Any]:
         """Async get bus errors"""
         bus_errors = await self._async_get(

ariston/const.py

@@ -427,6 +427,7 @@ class NuosSplitProperties(VelisDeviceProperties):
     OP_MODE: Final[str] = "opMode"
     BOOST_ON: Final[str] = "boostOn"
     HP_STATE: Final[str] = "hpState"
+    HOLIDAY_UNTIL: Final[str] = "holidayUntil"
 
 
 class EvoLydosDeviceProperties(VelisDeviceProperties):

ariston/nuos_split_device.py

@@ -2,6 +2,7 @@
 from __future__ import annotations
 
 import logging
+from datetime import date
 from typing import Optional
 
 from .velis_device import AristonVelisDevice
@@ -112,6 +113,26 @@ def water_heater_mode_value(self) -> Optional[int]:
         """Get water heater mode value"""
         return self.data.get(NuosSplitProperties.OP_MODE, None)
 
+    @property
+    def holiday_end_date(self) -> Optional[str]:
+        """Get the holiday end date.
+
+        Returns the ISO-formatted end date the cloud has on file
+        (e.g. ``"2026-08-15T00:00:00"``) when a holiday is scheduled, or
+        ``None`` when no holiday is active.
+        """
+        return self.data.get(NuosSplitProperties.HOLIDAY_UNTIL, None)
+
+    @property
+    def holiday_active(self) -> bool:
+        """Whether a holiday is currently scheduled.
+
+        The Slp payload does not expose a dedicated boolean: an active
+        holiday is signalled by `holidayUntil` being a non-null string,
+        and an inactive holiday by `holidayUntil` being ``null``.
+        """
+        return self.data.get(NuosSplitProperties.HOLIDAY_UNTIL) is not None
+
     def set_water_heater_boost(self, boost: bool):
         """Set water heater boost"""
         self.api.set_nous_boost(self.gw, boost)
@@ -257,3 +278,36 @@ async def async_set_heating_rate(self, heating_rate: float):
             self.plant_settings[SlpDeviceSettings.SLP_HEATING_RATE],
         )
         self.plant_settings[SlpDeviceSettings.SLP_HEATING_RATE] = heating_rate
+
+    @staticmethod
+    def _create_holiday_end_date(holiday_end: Optional[date]) -> Optional[str]:
+        """Format a holiday end date for the cloud payload.
+
+        Returns ``None`` when ``holiday_end`` is ``None``, which the cloud
+        interprets as "clear the holiday".
+        """
+        return (
+            None
+            if holiday_end is None
+            else holiday_end.strftime("%Y-%m-%dT00:00:00")
+        )
+
+    def set_holiday(self, holiday_end: Optional[date]) -> None:
+        """Set or clear the holiday on this Nuos device.
+
+        Pass a ``datetime.date`` to schedule the holiday end, or ``None`` to
+        clear an active holiday.
+        """
+        holiday_end_date = self._create_holiday_end_date(holiday_end)
+        self.api.set_velis_slp_holiday(self.gw, holiday_end_date)
+        self.data[NuosSplitProperties.HOLIDAY_UNTIL] = holiday_end_date
+
+    async def async_set_holiday(self, holiday_end: Optional[date]) -> None:
+        """Async set or clear the holiday on this Nuos device.
+
+        Pass a ``datetime.date`` to schedule the holiday end, or ``None`` to
+        clear an active holiday.
+        """
+        holiday_end_date = self._create_holiday_end_date(holiday_end)
+        await self.api.async_set_velis_slp_holiday(self.gw, holiday_end_date)
+        self.data[NuosSplitProperties.HOLIDAY_UNTIL] = holiday_end_date