aiohomematic 2025.10.7__tar.gz → 2025.10.8__tar.gz

{aiohomematic-2025.10.7 → aiohomematic-2025.10.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiohomematic
-Version: 2025.10.7
+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.7 → aiohomematic-2025.10.8}/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-2025.10.7 → aiohomematic-2025.10.8}/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-2025.10.7 → aiohomematic-2025.10.8}/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.7"
+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-2025.10.7 → aiohomematic-2025.10.8}/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-2025.10.7 → aiohomematic-2025.10.8}/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-2025.10.7 → aiohomematic-2025.10.8}/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-2025.10.7 → aiohomematic-2025.10.8}/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-2025.10.7 → aiohomematic-2025.10.8}/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.7 → aiohomematic-2025.10.8}/aiohomematic.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiohomematic
-Version: 2025.10.7
+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.7 → aiohomematic-2025.10.8}/tests/test_central.py

@@ -519,7 +519,7 @@ async def test_data_points_by_category(
     central, _, _ = central_client_factory
     ebp_sensor = central.get_data_points(category=DataPointCategory.SENSOR)
     assert ebp_sensor
-    assert len(ebp_sensor) == 16
+    assert len(ebp_sensor) == 18
 
     def _device_changed(self, *args: Any, **kwargs: Any) -> None:
         """Handle device state changes."""
@@ -527,7 +527,7 @@ async def test_data_points_by_category(
     ebp_sensor[0].register_data_point_updated_callback(cb=_device_changed, custom_id="some_id")
     ebp_sensor2 = central.get_data_points(category=DataPointCategory.SENSOR, registered=False)
     assert ebp_sensor2
-    assert len(ebp_sensor2) == 15
+    assert len(ebp_sensor2) == 17
 
 
 @pytest.mark.asyncio
@@ -595,13 +595,13 @@ async def test_add_device(
     """Test add_device."""
     central, _, _ = central_client_factory
     assert len(central._devices) == 1
-    assert len(central.get_data_points(exclude_no_create=False)) == 31
+    assert len(central.get_data_points(exclude_no_create=False)) == 33
     assert len(central.device_descriptions._raw_device_descriptions.get(const.INTERFACE_ID)) == 9
     assert len(central.paramset_descriptions._raw_paramset_descriptions.get(const.INTERFACE_ID)) == 9
     dev_desc = helper.load_device_description(central=central, filename="HmIP-BSM.json")
     await central.add_new_devices(interface_id=const.INTERFACE_ID, device_descriptions=dev_desc)
     assert len(central._devices) == 2
-    assert len(central.get_data_points(exclude_no_create=False)) == 62
+    assert len(central.get_data_points(exclude_no_create=False)) == 64
     assert len(central.device_descriptions._raw_device_descriptions.get(const.INTERFACE_ID)) == 20
     assert len(central.paramset_descriptions._raw_paramset_descriptions.get(const.INTERFACE_ID)) == 20
     await central.add_new_devices(interface_id="NOT_ANINTERFACE_ID", device_descriptions=dev_desc)
@@ -629,13 +629,13 @@ async def test_delete_device(
     """Test device delete_device."""
     central, _, _ = central_client_factory
     assert len(central._devices) == 2
-    assert len(central.get_data_points(exclude_no_create=False)) == 62
+    assert len(central.get_data_points(exclude_no_create=False)) == 64
     assert len(central.device_descriptions._raw_device_descriptions.get(const.INTERFACE_ID)) == 20
     assert len(central.paramset_descriptions._raw_paramset_descriptions.get(const.INTERFACE_ID)) == 20
 
     await central.delete_devices(interface_id=const.INTERFACE_ID, addresses=["VCU2128127"])
     assert len(central._devices) == 1
-    assert len(central.get_data_points(exclude_no_create=False)) == 31
+    assert len(central.get_data_points(exclude_no_create=False)) == 33
     assert len(central.device_descriptions._raw_device_descriptions.get(const.INTERFACE_ID)) == 9
     assert len(central.paramset_descriptions._raw_paramset_descriptions.get(const.INTERFACE_ID)) == 9
 
@@ -856,7 +856,7 @@ async def test_central_direct(factory: helper.Factory) -> None:
         assert central.available is False
         assert central.system_information.serial == "0815_4711"
         assert len(central._devices) == 2
-        assert len(central.get_data_points(exclude_no_create=False)) == 62
+        assert len(central.get_data_points(exclude_no_create=False)) == 64
     finally:
         await central.stop()
 

{aiohomematic-2025.10.7 → aiohomematic-2025.10.8}/tests/test_central_pydevccu.py

@@ -27,7 +27,7 @@ async def test_central_mini(central_unit_mini) -> None:
     assert central_unit_mini.get_client(interface_id=const.INTERFACE_ID).model == "PyDevCCU"
     assert central_unit_mini.primary_client.model == "PyDevCCU"
     assert len(central_unit_mini._devices) == 2
-    assert len(central_unit_mini.get_data_points(exclude_no_create=False)) == 68
+    assert len(central_unit_mini.get_data_points(exclude_no_create=False)) == 70
 
     usage_types: dict[DataPointUsage, int] = {}
     for dp in central_unit_mini.get_data_points(exclude_no_create=False):
@@ -39,7 +39,7 @@ async def test_central_mini(central_unit_mini) -> None:
 
     assert usage_types[DataPointUsage.NO_CREATE] == 45
     assert usage_types[DataPointUsage.CDP_PRIMARY] == 4
-    assert usage_types[DataPointUsage.DATA_POINT] == 14
+    assert usage_types[DataPointUsage.DATA_POINT] == 16
     assert usage_types[DataPointUsage.CDP_VISIBLE] == 5
 
 
@@ -193,12 +193,12 @@ async def test_central_full(central_unit_full) -> None:  # noqa: C901
     assert usage_types[DataPointUsage.CDP_PRIMARY] == 272
     assert usage_types[DataPointUsage.CDP_SECONDARY] == 162
     assert usage_types[DataPointUsage.CDP_VISIBLE] == 141
-    assert usage_types[DataPointUsage.DATA_POINT] == 3937
+    assert usage_types[DataPointUsage.DATA_POINT] == 4033
     assert usage_types[DataPointUsage.NO_CREATE] == 4291
 
     assert len(ce_channels) == 130
     assert len(data_point_types) == 6
-    assert len(parameters) == 232
+    assert len(parameters) == 234
 
     assert len(central_unit_full._devices) == 394
     virtual_remotes = ["VCU4264293", "VCU0000057", "VCU0000001"]