aiohomematic 2025.9.7__py3-none-any.whl → 2025.10.0__py3-none-any.whl

aiohomematic/caches/visibility.py

@@ -171,6 +171,8 @@ _IGNORED_PARAMETERS: Final[frozenset[TParameterName]] = frozenset(
         "CLEAR_ERROR",
         "CLEAR_WINDOW_OPEN_SYMBOL",
         "CLOCK",
+        "CMD_RETL",  # CuXD
+        "CMD_RETS",  # CuXD
         "CONTROL_DIFFERENTIAL_TEMPERATURE",
         "DATE_TIME_UNKNOWN",
         "DECISION_VALUE",

aiohomematic/central/__init__.py

@@ -44,12 +44,10 @@ Example (simplified):
 
     cfg = CentralConfig(
         central_id="ccu-main",
-        default_callback_port=43439,
         host="ccu.local",
         interface_configs=iface_cfgs,
         name="MyCCU",
         password="secret",
-        storage_folder=".storage",
         username="admin",
     )
 
@@ -102,6 +100,7 @@ from aiohomematic.const import (
     DEFAULT_MAX_READ_WORKERS,
     DEFAULT_PERIODIC_REFRESH_INTERVAL,
     DEFAULT_PROGRAM_MARKERS,
+    DEFAULT_STORAGE_FOLDER,
     DEFAULT_SYS_SCAN_INTERVAL,
     DEFAULT_SYSVAR_MARKERS,
     DEFAULT_TLS,
@@ -1828,16 +1827,15 @@ class CentralConfig:
     def __init__(
         self,
         central_id: str,
-        default_callback_port: int,
         host: str,
         interface_configs: AbstractSet[hmcl.InterfaceConfig],
         name: str,
         password: str,
-        storage_folder: str,
         username: str,
         client_session: ClientSession | None = None,
         callback_host: str | None = None,
         callback_port: int | None = None,
+        default_callback_port: int = PORT_ANY,
         enable_device_firmware_check: bool = DEFAULT_ENABLE_DEVICE_FIRMWARE_CHECK,
         enable_program_scan: bool = DEFAULT_ENABLE_PROGRAM_SCAN,
         enable_sysvar_scan: bool = DEFAULT_ENABLE_SYSVAR_SCAN,
@@ -1851,6 +1849,7 @@ class CentralConfig:
         periodic_refresh_interval: int = DEFAULT_PERIODIC_REFRESH_INTERVAL,
         program_markers: tuple[DescriptionMarker | str, ...] = DEFAULT_PROGRAM_MARKERS,
         start_direct: bool = False,
+        storage_folder: str = DEFAULT_STORAGE_FOLDER,
         sys_scan_interval: int = DEFAULT_SYS_SCAN_INTERVAL,
         sysvar_markers: tuple[DescriptionMarker | str, ...] = DEFAULT_SYSVAR_MARKERS,
         tls: bool = DEFAULT_TLS,

aiohomematic/client/xml_rpc.py

@@ -203,7 +203,7 @@ class XmlRpcProxy(xmlrpc.client.ServerProxy):
             if not self._connection_state.has_issue(issuer=self, iid=self._interface_id):
                 if perr.errmsg == "Unauthorized":
                     raise AuthFailure(perr) from perr
-                raise NoConnectionException(perr.errmsg) from perr
+                raise NoConnectionException(f"No connection to {self.log_context} ({perr.errmsg})") from perr
         except Exception as exc:
             raise ClientException(exc) from exc
 

aiohomematic/const.py

@@ -19,7 +19,7 @@ import sys
 from types import MappingProxyType
 from typing import Any, Final, NamedTuple, Required, TypeAlias, TypedDict
 
-VERSION: Final = "2025.9.7"
+VERSION: Final = "2025.10.0"
 
 # Detect test speedup mode via environment
 _TEST_SPEEDUP: Final = (
@@ -27,6 +27,7 @@ _TEST_SPEEDUP: Final = (
 )
 
 # default
+DEFAULT_STORAGE_FOLDER: Final = "aiohomematic_storage"
 DEFAULT_CUSTOM_ID: Final = "custom_id"
 DEFAULT_ENABLE_DEVICE_FIRMWARE_CHECK: Final = False
 DEFAULT_ENABLE_PROGRAM_SCAN: Final = True

aiohomematic/model/custom/climate.py

@@ -4,6 +4,7 @@
 
 from __future__ import annotations
 
+from abc import abstractmethod
 from collections.abc import Mapping
 from datetime import datetime, timedelta
 from enum import IntEnum, StrEnum
@@ -26,7 +27,16 @@ from aiohomematic.model.custom.const import DeviceProfile, Field
 from aiohomematic.model.custom.data_point import CustomDataPoint
 from aiohomematic.model.custom.support import CustomConfig
 from aiohomematic.model.data_point import CallParameterCollector, bind_collector
-from aiohomematic.model.generic import DpAction, DpBinarySensor, DpFloat, DpInteger, DpSelect, DpSensor, DpSwitch
+from aiohomematic.model.generic import (
+    DpAction,
+    DpBinarySensor,
+    DpFloat,
+    DpInteger,
+    DpSelect,
+    DpSensor,
+    DpSwitch,
+    GenericDataPoint,
+)
 from aiohomematic.property_decorators import config_property, state_property
 
 _LOGGER: Final = logging.getLogger(__name__)
@@ -174,6 +184,7 @@ class BaseCustomDpClimate(CustomDataPoint):
         "_dp_temperature",
         "_dp_temperature_maximum",
         "_dp_temperature_minimum",
+        "_old_manu_setpoint",
         "_supports_schedule",
     )
     _category = DataPointCategory.CLIMATE
@@ -199,6 +210,7 @@ class BaseCustomDpClimate(CustomDataPoint):
             custom_config=custom_config,
         )
         self._supports_schedule = False
+        self._old_manu_setpoint: float | None = None
 
     def _init_data_point_fields(self) -> None:
         """Init the data_point fields."""
@@ -219,6 +231,13 @@ class BaseCustomDpClimate(CustomDataPoint):
         self._dp_temperature_minimum: DpFloat = self._get_data_point(
             field=Field.TEMPERATURE_MINIMUM, data_point_type=DpFloat
         )
+        self._unregister_callbacks.append(
+            self._dp_setpoint.register_data_point_updated_callback(cb=self._manu_temp_changed, custom_id="manu_temp")
+        )
+
+    @abstractmethod
+    def _manu_temp_changed(self, data_point: GenericDataPoint) -> None:
+        """Handle device state changes."""
 
     @state_property
     def current_humidity(self) -> int | None:
@@ -311,11 +330,21 @@ class BaseCustomDpClimate(CustomDataPoint):
         return _TEMP_CELSIUS
 
     @property
-    def _min_or_target_temperature(self) -> float:
-        """Return the min or target temperature."""
-        if (temperature := self.target_temperature or self.min_temp) < self.min_temp:
-            return self.min_temp
-        return temperature
+    def _temperature_for_heat_mode(self) -> float:
+        """
+        Return a safe temperature to use when setting mode to HEAT.
+
+        If the current target temperature is None or represents the special OFF value,
+        fall back to the device's minimum valid temperature. Otherwise, return the
+        current target temperature clipped to the valid [min, max] range.
+        """
+        temp = self._old_manu_setpoint or self.target_temperature
+        # Treat None or OFF sentinel as invalid/unsafe to restore.
+        if temp is None or temp <= _OFF_TEMPERATURE or temp < self.min_temp:
+            return self.min_temp if self.min_temp > _OFF_TEMPERATURE else _OFF_TEMPERATURE + 0.5
+        if temp > self.max_temp:
+            return self.max_temp
+        return temp
 
     @property
     def schedule_profile_nos(self) -> int:
@@ -329,10 +358,7 @@ class BaseCustomDpClimate(CustomDataPoint):
         collector: CallParameterCollector | None = None,
         do_validate: bool = True,
     ) -> None:
-        """Set new target temperature."""
-        if not self.is_state_change(temperature=temperature):
-            return
-
+        """Set new target temperature. The temperature must be set in all cases, even if the values are identical."""
         if do_validate and self.mode == ClimateMode.HEAT and self.min_max_value_not_relevant_for_manu_mode:
             do_validate = False
 
@@ -694,6 +720,9 @@ class CustomDpSimpleRfThermostat(BaseCustomDpClimate):
 
     __slots__ = ()
 
+    def _manu_temp_changed(self, data_point: GenericDataPoint) -> None:
+        """Handle device state changes."""
+
 
 class CustomDpRfThermostat(BaseCustomDpClimate):
     """Classic Homematic thermostat like HM-CC-RT-DN."""
@@ -753,6 +782,28 @@ class CustomDpRfThermostat(BaseCustomDpClimate):
             field=Field.WEEK_PROGRAM_POINTER, data_point_type=DpSelect
         )
 
+        self._unregister_callbacks.append(
+            self._dp_control_mode.register_data_point_updated_callback(
+                cb=self._manu_temp_changed, custom_id="manu_temp"
+            )
+        )
+
+    def _manu_temp_changed(self, data_point: GenericDataPoint) -> None:
+        """Handle device state changes."""
+        if (
+            data_point == self._dp_control_mode
+            and self.mode == ClimateMode.HEAT
+            and self._dp_setpoint.refreshed_recently
+        ):
+            self._old_manu_setpoint = self.target_temperature
+
+        if (
+            data_point == self._dp_setpoint
+            and self.mode == ClimateMode.HEAT
+            and self._dp_control_mode.refreshed_recently
+        ):
+            self._old_manu_setpoint = self.target_temperature
+
     @state_property
     def activity(self) -> ClimateActivity | None:
         """Return the current activity."""
@@ -817,7 +868,7 @@ class CustomDpRfThermostat(BaseCustomDpClimate):
         if mode == ClimateMode.AUTO:
             await self._dp_auto_mode.send_value(value=True, collector=collector)
         elif mode == ClimateMode.HEAT:
-            await self._dp_manu_mode.send_value(value=self._min_or_target_temperature, collector=collector)
+            await self._dp_manu_mode.send_value(value=self._temperature_for_heat_mode, collector=collector)
         elif mode == ClimateMode.OFF:
             await self._dp_manu_mode.send_value(value=self.target_temperature, collector=collector)
             # Disable validation here to allow setting a value,
@@ -975,6 +1026,28 @@ class CustomDpIpThermostat(BaseCustomDpClimate):
             field=Field.TEMPERATURE_OFFSET, data_point_type=DpFloat
         )
 
+        self._unregister_callbacks.append(
+            self._dp_set_point_mode.register_data_point_updated_callback(
+                cb=self._manu_temp_changed, custom_id="manu_temp"
+            )
+        )
+
+    def _manu_temp_changed(self, data_point: GenericDataPoint) -> None:
+        """Handle device state changes."""
+        if (
+            data_point == self._dp_set_point_mode
+            and self.mode == ClimateMode.HEAT
+            and self._dp_setpoint.refreshed_recently
+        ):
+            self._old_manu_setpoint = self.target_temperature
+
+        if (
+            data_point == self._dp_setpoint
+            and self.mode == ClimateMode.HEAT
+            and self._dp_set_point_mode.refreshed_recently
+        ):
+            self._old_manu_setpoint = self.target_temperature
+
     @property
     def _is_heating_mode(self) -> bool:
         """Return the heating_mode of the device."""
@@ -1074,7 +1147,7 @@ class CustomDpIpThermostat(BaseCustomDpClimate):
             await self._dp_control_mode.send_value(value=_ModeHmIP.AUTO, collector=collector)
         elif mode in (ClimateMode.HEAT, ClimateMode.COOL):
             await self._dp_control_mode.send_value(value=_ModeHmIP.MANU, collector=collector)
-            await self.set_temperature(temperature=self._min_or_target_temperature, collector=collector)
+            await self.set_temperature(temperature=self._temperature_for_heat_mode, collector=collector)
         elif mode == ClimateMode.OFF:
             await self._dp_control_mode.send_value(value=_ModeHmIP.MANU, collector=collector)
             await self.set_temperature(temperature=_OFF_TEMPERATURE, collector=collector, do_validate=False)

aiohomematic/model/data_point.py

@@ -757,7 +757,7 @@ class BaseParameterDataPoint[
 
     @property
     def service(self) -> bool:
-        """Return the if data_point is visible in the backend."""
+        """Return the if data_point is relevant for service messages in the backend."""
         return self._service
 
     @property

aiohomematic/model/generic/data_point.py

@@ -107,10 +107,12 @@ class GenericDataPoint[ParameterT: GenericParameterType, InputParameterT: Generi
             return set()
 
         converted_value = self._convert_value(value=prepared_value)
+        # if collector is set, then add value to collector
         if collector:
             collector.add_data_point(self, value=converted_value, collector_order=collector_order)
             return set()
 
+        # if collector is not set, then send value directly
         if self._validate_state_change and not self.is_state_change(value=converted_value):
             return set()
 

{aiohomematic-2025.9.7.dist-info → aiohomematic-2025.10.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiohomematic
-Version: 2025.9.7
+Version: 2025.10.0
 Summary: Homematic interface for Home Assistant running on Python 3.
 Home-page: https://github.com/sukramj/aiohomematic
 Author-email: SukramJ <sukramj@icloud.com>, Daniel Perna <danielperna84@gmail.com>

{aiohomematic-2025.9.7.dist-info → aiohomematic-2025.10.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 aiohomematic/__init__.py,sha256=ngULK_anZQwwUUCVcberBdVjguYfboiuG9VoueKy9fA,2283
 aiohomematic/async_support.py,sha256=Xc55KkIV0h8rf936QKyU4OHSZsPEZ8TwuV8gVveeRh8,6106
-aiohomematic/const.py,sha256=I8C5OggQPiF0jRnYezPvNp-wN2pRpOxkCMtX95MJ13Y,25411
+aiohomematic/const.py,sha256=iRFyrsWQX3Vb6glqBD9eMegu67CnGBDh_h2OvPmTg2o,25467
 aiohomematic/context.py,sha256=M7gkA7KFT0dp35gzGz2dzKVXu1PP0sAnepgLlmjyRS4,451
 aiohomematic/converter.py,sha256=QTOL8_B6SoCoqLuRSkjtOlfa7BVFSvOfnSBrDngiinA,3558
 aiohomematic/decorators.py,sha256=oHEFSJoJVd-h9RYb6NLTJ60erkpRHPYv7EEipKn1a9Q,10636
@@ -13,16 +13,16 @@ aiohomematic/validator.py,sha256=vChkYQ9dGKCQEigiBMnoeyPkCJDJlIm6DSgR1gmeHH0,354
 aiohomematic/caches/__init__.py,sha256=_gI30tbsWgPRaHvP6cRxOQr6n9bYZzU-jp1WbHhWg-A,470
 aiohomematic/caches/dynamic.py,sha256=ANZUbkueQBeKC8Jwd44LH6qdt6qBCPWgzB5J0aHGUJw,21334
 aiohomematic/caches/persistent.py,sha256=od1hqoXopGw53gSVvd3rmT_40KuutSY43MUPKj1HAvU,19932
-aiohomematic/caches/visibility.py,sha256=xCks7f-bTZjwlxvwBU31wh23U0GOnz76Hy1kVqweW7g,31481
-aiohomematic/central/__init__.py,sha256=3UdYf-nvnRgdeQH92v8vGwIk_J_DXT8JPDG14PskXKw,86167
+aiohomematic/caches/visibility.py,sha256=-PWXc7sJxVhJzzU8WZkiokaL_ANE7EZ2-IO8TIZHGw8,31537
+aiohomematic/central/__init__.py,sha256=7l23fW4zUGBRxVMmGXtsz5r4wKPrI0aPaDRpvi9geQA,86159
 aiohomematic/central/decorators.py,sha256=Sl-cMDhreiAOKkIHiei-QbIOcvbWGVX-QwB5bLeohak,6904
 aiohomematic/central/xml_rpc_server.py,sha256=pOqOuTp1Yy5Wlqs5E-L9f_UNW8j9HSE5XMAPCdXJchI,10407
 aiohomematic/client/__init__.py,sha256=YuVD_FNh2Q_9SiDtGTM0T--ycT3hzCgkZM_W9AOOuTg,70106
 aiohomematic/client/_rpc_errors.py,sha256=ZPFZJ4t0tE4RVAae4L7hE9earutMwB5BFfB2NArLp9E,2975
 aiohomematic/client/json_rpc.py,sha256=s9EOWlVed-xerRFXOQToPGAW-0p_BuOuwjvL4TZD2Ok,49393
-aiohomematic/client/xml_rpc.py,sha256=-JQpIt3_6ehpn6uhDqPWW7e2X8-D9EVS3X6-CJpxN4E,9475
+aiohomematic/client/xml_rpc.py,sha256=T39zi8GatsV2d-w_SqRLgPraJWtGdZQZxAZbGM_sN9o,9518
 aiohomematic/model/__init__.py,sha256=cqL5v5HNxlzrgLziAPf8sGU72fDneiaLTioIGcLfhTU,5442
-aiohomematic/model/data_point.py,sha256=8k60CalDaixvpxfhPpNkHgQyEHuIqRRqamFeMcYB2TE,40894
+aiohomematic/model/data_point.py,sha256=K_UsSJKTltllVe2tpUTyF_FggUX2t16OeW2Y_wQMm20,40916
 aiohomematic/model/device.py,sha256=f6KVYynK6ug2HLF6mbavl20qRlZOwXhgKaYN0GJdzAE,52703
 aiohomematic/model/event.py,sha256=omesSQ18e1tCIjjTIYTmeqwtItzjTYR3fy90-oZi4ic,6837
 aiohomematic/model/support.py,sha256=4VQsOlkJuPhq0hLHKt5LB43YgbITjnyJMwucUYGghzM,19616
@@ -33,7 +33,7 @@ aiohomematic/model/calculated/data_point.py,sha256=4b0uGuI_HYb4MkykrtSHpw7XVzrj_
 aiohomematic/model/calculated/operating_voltage_level.py,sha256=urlCkHjisCJ-DO6tUE0evfp45tPwsYcb81_2uoHYxS0,13521
 aiohomematic/model/calculated/support.py,sha256=K-oUSSH6k6_J7zZ9cwxt6qIfArWd-SBWo93LuZUs1_s,6674
 aiohomematic/model/custom/__init__.py,sha256=1sWRrAjHnHSakdrrlNW4_SZ2rg5g2WjGdI4X2PUg_h0,6064
-aiohomematic/model/custom/climate.py,sha256=V6DD6hZjjS65MaXJcRZUD92Gg93IhIBmp-Yjghlo5Yw,53986
+aiohomematic/model/custom/climate.py,sha256=N0w4mne_UUZopaKM7yiJHGlHrY292slk6_gsh2RZ5Ng,56688
 aiohomematic/model/custom/const.py,sha256=Kh1pnab6nmwbaY43CfXQy3yrWpPwsrQdl1Ea2aZ6aw0,4961
 aiohomematic/model/custom/cover.py,sha256=8coWxSyFgsDKoTQIvu0czfiVufobtkHgQdlp4ocAqu8,28555
 aiohomematic/model/custom/data_point.py,sha256=d7B8gfyDDZf8HW3f0ofeHYF32GE8kgnQ0DZYSUbLHxY,14112
@@ -48,7 +48,7 @@ aiohomematic/model/generic/__init__.py,sha256=goR2uBBGizm-A5Vvd7ii9Ai3OihBl3hIzt
 aiohomematic/model/generic/action.py,sha256=5SPWVliRqXlPgtb2bI6le0-V6JR5krzw8z_0FaOXu5U,994
 aiohomematic/model/generic/binary_sensor.py,sha256=U5GvfRYbhwe0jRmaedD4LVZ_24SyyPbVr74HEfZXoxE,887
 aiohomematic/model/generic/button.py,sha256=6jZ49woI9gYJEx__PjguDNbc5vdE1P-YcLMZZFkYRCg,740
-aiohomematic/model/generic/data_point.py,sha256=2rxtoHxU3-hsY9ufisqX7XvQIO2og7q_TTJ4I1z-uho,5932
+aiohomematic/model/generic/data_point.py,sha256=XDaWqTfwrTNtnpt2qWtHKuyQOecZeKCvo5WDS0D1ocM,6051
 aiohomematic/model/generic/number.py,sha256=wHNIIVr41IOoROPOnBXuMRsANG6doguIEWXYnQHJbBk,2669
 aiohomematic/model/generic/select.py,sha256=kxN5BR85Yli7kQF2DYkGiLnTgcY9LBJWI7MMwWpH1mo,1535
 aiohomematic/model/generic/sensor.py,sha256=dWff7yBJfJSjoD4rcYdmH5HhaRCUEKfPFfOu4T1LrPo,2253
@@ -69,10 +69,10 @@ aiohomematic/rega_scripts/get_serial.fn,sha256=t1oeo-sB_EuVeiY24PLcxFSkdQVgEWGXz
 aiohomematic/rega_scripts/get_system_variable_descriptions.fn,sha256=UKXvC0_5lSApdQ2atJc0E5Stj5Zt3lqh0EcliokYu2c,849
 aiohomematic/rega_scripts/set_program_state.fn,sha256=0bnv7lUj8FMjDZBz325tDVP61m04cHjVj4kIOnUUgpY,279
 aiohomematic/rega_scripts/set_system_variable.fn,sha256=sTmr7vkPTPnPkor5cnLKlDvfsYRbGO1iq2z_2pMXq5E,383
-aiohomematic-2025.9.7.dist-info/licenses/LICENSE,sha256=q-B0xpREuZuvKsmk3_iyVZqvZ-vJcWmzMZpeAd0RqtQ,1083
+aiohomematic-2025.10.0.dist-info/licenses/LICENSE,sha256=q-B0xpREuZuvKsmk3_iyVZqvZ-vJcWmzMZpeAd0RqtQ,1083
 aiohomematic_support/__init__.py,sha256=_0YtF4lTdC_k6-zrM2IefI0u0LMr_WA61gXAyeGLgbY,66
 aiohomematic_support/client_local.py,sha256=kWzrIeyrvSQx1qVX9_L1bgaFr9aPRDm3E3p82eqkFvo,12538
-aiohomematic-2025.9.7.dist-info/METADATA,sha256=Qo81mWVD5xRydrMdqyheEmeEGd7pf_cU4yocXBHNJ2A,7602
-aiohomematic-2025.9.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-aiohomematic-2025.9.7.dist-info/top_level.txt,sha256=5TDRlUWQPThIUwQjOj--aUo4UA-ow4m0sNhnoCBi5n8,34
-aiohomematic-2025.9.7.dist-info/RECORD,,
+aiohomematic-2025.10.0.dist-info/METADATA,sha256=gwYr_waUP6P_Gpi82v-1EBAVkDTqVm-ah8xQG7HlzG8,7603
+aiohomematic-2025.10.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aiohomematic-2025.10.0.dist-info/top_level.txt,sha256=5TDRlUWQPThIUwQjOj--aUo4UA-ow4m0sNhnoCBi5n8,34
+aiohomematic-2025.10.0.dist-info/RECORD,,