aiohomematic 2025.10.6__py3-none-any.whl → 2025.10.8__py3-none-any.whl

aiohomematic/central/__init__.py

@@ -1068,7 +1068,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
             )
             return
         client = self._clients[interface_id]
-        if (device_descriptions := await client.get_all_device_description(device_address=address)) is None:
+        if (device_descriptions := await client.get_all_device_descriptions(device_address=address)) is None:
             _LOGGER.warning(
                 "ADD_NEW_DEVICES_MANUALLY failed: No device description found for address %s on interface_id %s",
                 address,

aiohomematic/central/rpc_server.py

@@ -12,7 +12,7 @@ from __future__ import annotations
 import contextlib
 import logging
 import threading
-from typing import Any, Final
+from typing import Any, Final, cast
 from xmlrpc.server import SimpleXMLRPCRequestHandler, SimpleXMLRPCServer
 
 from aiohomematic import central as hmcu
@@ -175,7 +175,7 @@ class RpcServer(threading.Thread):
     """RPC server thread to handle messages from the backend."""
 
     _initialized: bool = False
-    _instances: Final[dict[tuple[str, int], XmlRpcServer]] = {}
+    _instances: Final[dict[tuple[str, int], RpcServer]] = {}
 
     def __init__(
         self,
@@ -190,9 +190,10 @@ class RpcServer(threading.Thread):
         self._listen_ip_addr: Final = ip_addr
         self._listen_port: Final[int] = find_free_port() if port == PORT_ANY else port
         self._address: Final[tuple[str, int]] = (ip_addr, self._listen_port)
-        threading.Thread.__init__(self, name=f"RpcServer {ip_addr}:{self._listen_port}")
         self._centrals: Final[dict[str, hmcu.CentralUnit]] = {}
         self._simple_rpc_server: SimpleXMLRPCServer
+        self._instances[self._address] = self
+        threading.Thread.__init__(self, name=f"RpcServer {ip_addr}:{self._listen_port}")
 
     def run(self) -> None:
         """Run the RPC-Server thread."""
@@ -266,8 +267,9 @@ class XmlRpcServer(RpcServer):
     ) -> None:
         """Init XmlRPC server."""
 
+        if self._initialized:
+            return
         super().__init__(ip_addr=ip_addr, port=port)
-        self._instances[self._address] = self
         self._simple_rpc_server = HomematicXMLRPCServer(
             addr=self._address,
             requestHandler=RequestHandler,
@@ -283,7 +285,7 @@ class XmlRpcServer(RpcServer):
         if (rpc := cls._instances.get((ip_addr, port))) is None:
             _LOGGER.debug("Creating XmlRpc server")
             return super().__new__(cls)
-        return rpc
+        return cast(XmlRpcServer, rpc)
 
 
 def create_xml_rpc_server(*, ip_addr: str = IP_ANY_V4, port: int = PORT_ANY) -> XmlRpcServer:

aiohomematic/client/__init__.py

@@ -507,7 +507,7 @@ class Client(ABC, LogContextMixin):
         return None
 
     @inspector(re_raise=False)
-    async def get_all_device_description(self, *, device_address: str) -> tuple[DeviceDescription, ...] | None:
+    async def get_all_device_descriptions(self, *, device_address: str) -> tuple[DeviceDescription, ...] | None:
         """Get all device descriptions from the backend."""
         all_device_description: list[DeviceDescription] = []
         if main_dd := await self.get_device_description(device_address=device_address):

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.10.6"
+VERSION: Final = "2025.10.8"
 
 # Detect test speedup mode via environment
 _TEST_SPEEDUP: Final = (
@@ -179,6 +179,8 @@ class CalulatedParameter(StrEnum):
 
     APPARENT_TEMPERATURE = "APPARENT_TEMPERATURE"
     DEW_POINT = "DEW_POINT"
+    DEW_POINT_SPREAD = "DEW_POINT_SPREAD"
+    ENTHALPY = "ENTHALPY"
     FROST_POINT = "FROST_POINT"
     OPERATING_VOLTAGE_LEVEL = "OPERATING_VOLTAGE_LEVEL"
     VAPOR_CONCENTRATION = "VAPOR_CONCENTRATION"

aiohomematic/model/calculated/__init__.py

@@ -24,7 +24,7 @@ Factory:
   normal read-only data points.
 
 Modules/classes:
-- ApparentTemperature, DewPoint, FrostPoint, VaporConcentration: Climate-related
+- ApparentTemperature, DewPoint, DewPointSpread, Enthalphy, FrostPoint, VaporConcentration: Climate-related
   sensors implemented in climate.py using well-known formulas (see
   aiohomematic.model.calculated.support for details and references).
 - OperatingVoltageLevel: Interprets battery/voltage values and exposes a human
@@ -41,7 +41,14 @@ from typing import Final
 
 from aiohomematic.decorators import inspector
 from aiohomematic.model import device as hmd
-from aiohomematic.model.calculated.climate import ApparentTemperature, DewPoint, FrostPoint, VaporConcentration
+from aiohomematic.model.calculated.climate import (
+    ApparentTemperature,
+    DewPoint,
+    DewPointSpread,
+    Enthalpy,
+    FrostPoint,
+    VaporConcentration,
+)
 from aiohomematic.model.calculated.data_point import CalculatedDataPoint
 from aiohomematic.model.calculated.operating_voltage_level import OperatingVoltageLevel
 
@@ -49,13 +56,23 @@ __all__ = [
     "ApparentTemperature",
     "CalculatedDataPoint",
     "DewPoint",
+    "DewPointSpread",
+    "Enthalpy",
     "FrostPoint",
     "OperatingVoltageLevel",
     "VaporConcentration",
     "create_calculated_data_points",
 ]
 
-_CALCULATED_DATA_POINTS: Final = (ApparentTemperature, DewPoint, FrostPoint, OperatingVoltageLevel, VaporConcentration)
+_CALCULATED_DATA_POINTS: Final = (
+    ApparentTemperature,
+    DewPoint,
+    DewPointSpread,
+    Enthalpy,
+    FrostPoint,
+    OperatingVoltageLevel,
+    VaporConcentration,
+)
 _LOGGER: Final = logging.getLogger(__name__)
 
 

aiohomematic/model/calculated/climate.py

@@ -13,6 +13,8 @@ from aiohomematic.model.calculated.data_point import CalculatedDataPoint
 from aiohomematic.model.calculated.support import (
     calculate_apparent_temperature,
     calculate_dew_point,
+    calculate_dew_point_spread,
+    calculate_enthalpy,
     calculate_frost_point,
     calculate_vapor_concentration,
 )
@@ -141,6 +143,62 @@ class DewPoint(BaseClimateSensor):
         return None
 
 
+class DewPointSpread(BaseClimateSensor):
+    """Implementation of a calculated sensor for dew point spread."""
+
+    __slots__ = ()
+
+    _calculated_parameter = CalulatedParameter.DEW_POINT_SPREAD
+
+    def __init__(self, *, channel: hmd.Channel) -> None:
+        """Initialize the data point."""
+        super().__init__(channel=channel)
+        self._unit = "K"
+
+    @staticmethod
+    def is_relevant_for_model(*, channel: hmd.Channel) -> bool:
+        """Return if this calculated data point is relevant for the model."""
+        return _is_relevant_for_model_temperature_and_humidity(channel=channel)
+
+    @state_property
+    def value(self) -> float | None:
+        """Return the value."""
+        if self._dp_temperature.value is not None and self._dp_humidity.value is not None:
+            return calculate_dew_point_spread(
+                temperature=self._dp_temperature.value,
+                humidity=self._dp_humidity.value,
+            )
+        return None
+
+
+class Enthalpy(BaseClimateSensor):
+    """Implementation of a calculated sensor for enthalpy."""
+
+    __slots__ = ()
+
+    _calculated_parameter = CalulatedParameter.ENTHALPY
+
+    def __init__(self, *, channel: hmd.Channel) -> None:
+        """Initialize the data point."""
+        super().__init__(channel=channel)
+        self._unit = "kJ/kg"
+
+    @staticmethod
+    def is_relevant_for_model(*, channel: hmd.Channel) -> bool:
+        """Return if this calculated data point is relevant for the model."""
+        return _is_relevant_for_model_temperature_and_humidity(channel=channel)
+
+    @state_property
+    def value(self) -> float | None:
+        """Return the value."""
+        if self._dp_temperature.value is not None and self._dp_humidity.value is not None:
+            return calculate_enthalpy(
+                temperature=self._dp_temperature.value,
+                humidity=self._dp_humidity.value,
+            )
+        return None
+
+
 class FrostPoint(BaseClimateSensor):
     """Implementation of a calculated sensor for frost point."""
 

aiohomematic/model/calculated/support.py

@@ -16,9 +16,47 @@ from typing import Final
 
 from aiohomematic.support import extract_exc_args
 
+_DEFAULT_PRESSURE_HPA: Final = 1013.25
 _LOGGER: Final = logging.getLogger(__name__)
 
 
+def calculate_dew_point_spread(*, temperature: float, humidity: int) -> float | None:
+    """
+    Calculate the dew point spread.
+
+    Dew point spread = Difference between current air temperature and dew point.
+    Specifies the safety margin against condensation(K).
+    """
+    if dew_point := calculate_dew_point(temperature=temperature, humidity=humidity):
+        return round(temperature - dew_point, 2)
+    return None
+
+
+def calculate_enthalpy(
+    *, temperature: float, humidity: int, pressure_hPa: float = _DEFAULT_PRESSURE_HPA
+) -> float | None:
+    """
+    Calculate the enthalpy based on temperature and humidity.
+
+    Calculates the specific enthalpy of humid air in kJ/kg (relative to dry air).
+    temperature: Air temperature in °C
+    humidity: Relative humidity in %
+    pressure_hPa: Air pressure (default: 1013.25 hPa)
+
+    """
+
+    # Saturation vapor pressure according to Magnus in hPa
+    e_s = 6.112 * math.exp((17.62 * temperature) / (243.12 + temperature))
+    e = humidity / 100.0 * e_s  # aktueller Dampfdruck in hPa
+
+    # Mixing ratio (g water / kg dry air)
+    r = 622 * e / (pressure_hPa - e)
+
+    # Specific enthalpy (kJ/kg dry air)
+    h = 1.006 * temperature + r * (2501 + 1.86 * temperature) / 1000  # in kJ/kg
+    return round(h, 2)
+
+
 def _calculate_heat_index(*, temperature: float, humidity: int) -> float:
     """
     Calculate the Heat Index (feels like temperature) based on the NOAA equation.
@@ -158,10 +196,10 @@ def calculate_dew_point(*, temperature: float, humidity: int) -> float | None:
 def calculate_frost_point(*, temperature: float, humidity: int) -> float | None:
     """Calculate the frost point."""
     try:
-        if (dewpoint := calculate_dew_point(temperature=temperature, humidity=humidity)) is None:
+        if (dew_point := calculate_dew_point(temperature=temperature, humidity=humidity)) is None:
             return None
         t = temperature + 273.15
-        td = dewpoint + 273.15
+        td = dew_point + 273.15
 
         return round((td + (2671.02 / ((2954.61 / t) + 2.193665 * math.log(t) - 13.3448)) - t) - 273.15, 1)
     except ValueError as verr:

aiohomematic/model/device.py

@@ -1338,10 +1338,7 @@ class _DefinitionExporter:
         def perform_save() -> DataOperationResult:
             if not check_or_create_directory(directory=file_dir):
                 return DataOperationResult.NO_SAVE  # pragma: no cover
-            with open(
-                file=os.path.join(file_dir, filename),
-                mode="wb",
-            ) as fptr:
+            with open(file=os.path.join(file_dir, filename), mode="wb") as fptr:
                 fptr.write(orjson.dumps(data, option=orjson.OPT_INDENT_2 | orjson.OPT_NON_STR_KEYS))
             return DataOperationResult.SAVE_SUCCESS
 

aiohomematic/support.py

@@ -43,6 +43,7 @@ from aiohomematic.const import (
     NO_CACHE_ENTRY,
     PRIMARY_CLIENT_CANDIDATE_INTERFACES,
     TIMEOUT,
+    UTF_8,
     CommandRxMode,
     DeviceDescription,
     ParamsetKey,
@@ -526,9 +527,9 @@ def hash_sha256(*, value: Any) -> str:
         data = orjson.dumps(value, option=orjson.OPT_SORT_KEYS | orjson.OPT_NON_STR_KEYS)
     except Exception:
         # Fallback: convert to a hashable representation and use repr()
-        data = repr(_make_value_hashable(value=value)).encode()
+        data = repr(_make_value_hashable(value=value)).encode(encoding=UTF_8)
     hasher.update(data)
-    return base64.b64encode(hasher.digest()).decode()
+    return base64.b64encode(hasher.digest()).decode(encoding=UTF_8)
 
 
 def _make_value_hashable(*, value: Any) -> Any:
@@ -632,9 +633,7 @@ def log_boundary_error(
         log_message += f" {message}"
 
     if log_context:
-        log_message += (
-            f" ctx={orjson.dumps(_safe_log_context(context=log_context), option=orjson.OPT_SORT_KEYS).decode()}"
-        )
+        log_message += f" ctx={orjson.dumps(_safe_log_context(context=log_context), option=orjson.OPT_SORT_KEYS).decode(encoding=UTF_8)}"
 
     # Choose level if not provided:
     if (chosen_level := level) is None:

{aiohomematic-2025.10.6.dist-info → aiohomematic-2025.10.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiohomematic
-Version: 2025.10.6
+Version: 2025.10.8
 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.10.6.dist-info → aiohomematic-2025.10.8.dist-info}/RECORD

@@ -1,6 +1,6 @@
 aiohomematic/__init__.py,sha256=ngULK_anZQwwUUCVcberBdVjguYfboiuG9VoueKy9fA,2283
 aiohomematic/async_support.py,sha256=BeNKaDrFsRA5-_uAFzmyyKPqlImfSs58C22Nqd5dZAg,7887
-aiohomematic/const.py,sha256=7siFMot4SYI6EAdWTG-GTgsHsdYpue_0EA-29kyBEbk,26643
+aiohomematic/const.py,sha256=cUITpwnRyO-gGI7iJH2pFO3vV1fb0tbFZ2-kQjby0L0,26711
 aiohomematic/context.py,sha256=M7gkA7KFT0dp35gzGz2dzKVXu1PP0sAnepgLlmjyRS4,451
 aiohomematic/converter.py,sha256=gaNHe-WEiBStZMuuRz9iGn3Mo_CGz1bjgLtlYBJJAko,3624
 aiohomematic/decorators.py,sha256=M4n_VSyqmsUgQQQv_-3JWQxYPbS6KEkhCS8OzAfaVKo,11060
@@ -8,30 +8,30 @@ aiohomematic/exceptions.py,sha256=8Uu3rADawhYlAz6y4J52aJ-wKok8Z7YbUYUwWeGMKhs,50
 aiohomematic/hmcli.py,sha256=qNstNDX6q8t3mJFCGlXlmRVobGabntrPtFi3kchf1Eg,4933
 aiohomematic/property_decorators.py,sha256=56lHGATgRtaFkIK_IXcR2tBW9mIVITcCwH5KOw575GA,17162
 aiohomematic/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-aiohomematic/support.py,sha256=7FTIDvRZvGFMfN3i_zBnHtJQd-vDqTMTq2i1G5GmW3Y,22834
+aiohomematic/support.py,sha256=TSzKKSVY6_fj_3hGvdmIIqSHzXQSmYVXV4A2WdBTPqQ,22863
 aiohomematic/validator.py,sha256=HUikmo-SFksehFBAdZmBv4ajy0XkjgvXvcCfbexnzZo,3563
 aiohomematic/caches/__init__.py,sha256=_gI30tbsWgPRaHvP6cRxOQr6n9bYZzU-jp1WbHhWg-A,470
 aiohomematic/caches/dynamic.py,sha256=0hOu-WoYUc9_3fofMeg_OjlYS-quD4uTyDI6zd5W4Do,22553
 aiohomematic/caches/persistent.py,sha256=xUMjvu5Vthz9W0LLllSbcqTADZvVV025b4VnPzrPnis,20604
 aiohomematic/caches/visibility.py,sha256=8lTO-jfAUzd90atUOK8rKMrzRa__m083RAoEovg0Q0o,31676
-aiohomematic/central/__init__.py,sha256=_ft-2HXfn0pF_LTrNyV_mZ7cHkHuRgeprBJZx5MlK0I,92659
+aiohomematic/central/__init__.py,sha256=z6_VqPDaVnnHFdqNmdeMMqzolxIF-Ef-K_sB9dOikD0,92660
 aiohomematic/central/decorators.py,sha256=NUMSsQ_Or6gno4LzagrNMXeBtmbBbYyoIlMI0TFp1_E,6908
-aiohomematic/central/rpc_server.py,sha256=V1H8RNs8ofDOXe_L0yK_GXA7N-39sp3NcywPWzHcJnQ,10899
-aiohomematic/client/__init__.py,sha256=w7ns0JZNroKNy9Yw1YM1ssxhPwXUoVNpPo5RLAbgK7E,73857
+aiohomematic/central/rpc_server.py,sha256=wf2KG-cj_wIdgfRHY3GIFFzOenJbz8MfUGLdF1drd3k,10971
+aiohomematic/client/__init__.py,sha256=2oqhX9JjWrQ3Bxz4JR1Y53DjpNDlNQ9sEIa6z8Mm-88,73858
 aiohomematic/client/_rpc_errors.py,sha256=-NPtGvkQPJ4V2clDxv1tKy09M9JZm61pUCeki9DDh6s,2984
 aiohomematic/client/json_rpc.py,sha256=7p8j6uhS0y2LuJVtobQqwtpOA_AsC5HqEdGB0T8ZSu4,50177
 aiohomematic/client/rpc_proxy.py,sha256=v0YyhfQ_qylQpqGvGtylJtG3_tIk9PN6tWMHkki4D48,10705
 aiohomematic/model/__init__.py,sha256=KO7gas_eEzm67tODKqWTs0617CSGeKKjOWOlDbhRo_Q,5458
 aiohomematic/model/data_point.py,sha256=Ml8AOQ1RcRezTYWiGBlIXwcTLolQMX5Cyb-O7GtNDm4,41586
-aiohomematic/model/device.py,sha256=15z5G2X3jSJaj-yz7jX_tnirzipRIGBJPymObY3Dmjk,52942
+aiohomematic/model/device.py,sha256=NZ5J5Snu03gMVlGlFYW7meGLT0XV4Fvz-SlqfPXkWOA,52895
 aiohomematic/model/event.py,sha256=82H8M_QNMCCC29mP3R16alJyKWS3Hb3aqY_aFMSqCvo,6874
 aiohomematic/model/support.py,sha256=l5E9Oon20nkGWOSEmbYtqQbpbh6-H4rIk8xtEtk5Fcg,19657
 aiohomematic/model/update.py,sha256=5F39xNz9B2GKJ8TvJHPMC-Wu97HfkiiMawjnHEYMnoA,5156
-aiohomematic/model/calculated/__init__.py,sha256=UGLePgKDH8JpLqjhPBgvBzjggI34omcaCPsc6tcM8Xs,2811
-aiohomematic/model/calculated/climate.py,sha256=GXBsC5tnrC_BvnFBkJ9KUqE7uVcGD1KTU_6-OleF5H4,8545
+aiohomematic/model/calculated/__init__.py,sha256=_n-qWnG4FDs-arTEfWbsXfLK4LGic4pM8kFQgCqtPMI,2988
+aiohomematic/model/calculated/climate.py,sha256=tDYbO7BajBgc8MpId2jGnrHJNQbxWDTGZoEQnb9WRL8,10521
 aiohomematic/model/calculated/data_point.py,sha256=oTN8y3B9weh7CX3ZFiDyZFgvX77iUwge-acg49pd1sI,11609
 aiohomematic/model/calculated/operating_voltage_level.py,sha256=ZrOPdNoWQ5QLr4yzMRsoPG3UuJKRkBUHfchIrpKZU4o,13527
-aiohomematic/model/calculated/support.py,sha256=vOxTvWe8SBCwJpLzcVA8ibtfw4eP8yTUZj4Jt9hWt9k,6695
+aiohomematic/model/calculated/support.py,sha256=v7Wz0efL2XmjRY48IKFX1P2HbbPQUVVU9iXwdaao0D4,8011
 aiohomematic/model/custom/__init__.py,sha256=UzczqjsUqWvS9ZaqKeb6elbjb2y5W3cgFPB0YQUHaeM,6095
 aiohomematic/model/custom/climate.py,sha256=zSLQUY_tU7tDlbM-vW15BGuyWRjcR_DyqOwSg1_Vmfw,57217
 aiohomematic/model/custom/const.py,sha256=Kh1pnab6nmwbaY43CfXQy3yrWpPwsrQdl1Ea2aZ6aw0,4961
@@ -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.10.6.dist-info/licenses/LICENSE,sha256=q-B0xpREuZuvKsmk3_iyVZqvZ-vJcWmzMZpeAd0RqtQ,1083
+aiohomematic-2025.10.8.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=nFeYkoX_EXXIwbrpL_5peYQG-934D0ASN6kflYp0_4I,12819
-aiohomematic-2025.10.6.dist-info/METADATA,sha256=IjdBD7NWGknN0DlQcM0K4gZeFEYAkC-iCnUOkRPu1tU,7603
-aiohomematic-2025.10.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-aiohomematic-2025.10.6.dist-info/top_level.txt,sha256=5TDRlUWQPThIUwQjOj--aUo4UA-ow4m0sNhnoCBi5n8,34
-aiohomematic-2025.10.6.dist-info/RECORD,,
+aiohomematic-2025.10.8.dist-info/METADATA,sha256=NidjXklk-E_9ym54IQr5kTTx5lCDVNhUx5Ep3bIfwyc,7603
+aiohomematic-2025.10.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aiohomematic-2025.10.8.dist-info/top_level.txt,sha256=5TDRlUWQPThIUwQjOj--aUo4UA-ow4m0sNhnoCBi5n8,34
+aiohomematic-2025.10.8.dist-info/RECORD,,