aiohomematic 2025.8.9__py3-none-any.whl → 2025.8.10__py3-none-any.whl

aiohomematic/support.py

@@ -1,14 +1,22 @@
-"""Helper functions used within aiohomematic."""
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+"""
+Helper functions used within aiohomematic.
+
+Public API of this module is defined by __all__.
+"""
 
 from __future__ import annotations
 
 import base64
 from collections import defaultdict
-from collections.abc import Callable, Collection, Set as AbstractSet
+from collections.abc import Callable, Collection, Mapping, Set as AbstractSet
 import contextlib
 from dataclasses import dataclass
 from datetime import datetime
+from functools import lru_cache
 import hashlib
+import inspect
 from ipaddress import IPv4Address
 import logging
 import os
@@ -256,8 +264,14 @@ def is_paramset_key(paramset_key: ParamsetKey | str) -> bool:
     return isinstance(paramset_key, ParamsetKey) or (isinstance(paramset_key, str) and paramset_key in ParamsetKey)
 
 
+@lru_cache(maxsize=4096)
 def get_split_channel_address(channel_address: str) -> tuple[str, int | None]:
-    """Return the device part of an address."""
+    """
+    Return the device part of an address.
+
+    Cached to avoid redundant parsing across layers when repeatedly handling
+    the same channel addresses.
+    """
     if ADDRESS_SEPARATOR in channel_address:
         device_address, channel_no = channel_address.split(ADDRESS_SEPARATOR)
         if channel_no in (None, "None"):
@@ -493,3 +507,146 @@ def supports_rx_mode(command_rx_mode: CommandRxMode, rx_modes: tuple[RxMode, ...
 def cleanup_text_from_html_tags(text: str) -> str:
     """Cleanup text from html tags."""
     return re.sub(HTMLTAG_PATTERN, "", text)
+
+
+# --- Structured error boundary logging helpers ---
+
+_BOUNDARY_MSG = "error_boundary"
+
+
+def _safe_context(context: Mapping[str, Any] | None) -> dict[str, Any]:
+    """Extract safe context from a mapping."""
+    ctx: dict[str, Any] = {}
+    if not context:
+        return ctx
+    # Avoid logging potentially sensitive values by redacting common keys
+    redact_keys = {"password", "passwd", "pwd", "token", "authorization", "auth"}
+    for k, v in context.items():
+        if k.lower() in redact_keys:
+            ctx[k] = "***"
+        else:
+            # Ensure value is serializable / printable
+            try:
+                str(v)
+                ctx[k] = v
+            except Exception:
+                ctx[k] = repr(v)
+    return ctx
+
+
+def build_log_context_from_obj(obj: Any | None) -> dict[str, Any]:
+    """
+    Extract structured context like device_id/channel/parameter from common objects.
+
+    Tries best-effort extraction without raising. Returns a dict suitable for logger.extra.
+    """
+    ctx: dict[str, Any] = {}
+    if obj is None:
+        return ctx
+    try:
+        # DataPoint-like: has channel and parameter
+        if hasattr(obj, "channel"):
+            ch = getattr(obj, "channel")
+            try:
+                # channel address/id
+                channel_address = ch.address if not callable(ch.address) else ch.address()
+                ctx["channel"] = channel_address
+            except Exception:
+                # Fallback to str
+                ctx["channel"] = str(ch)
+            try:
+                if (dev := ch.device if hasattr(ch, "device") else None) is not None:
+                    device_id = dev.id if not callable(dev.id) else dev.id()
+                    ctx["device_id"] = device_id
+            except Exception:
+                pass
+        # Parameter on DataPoint-like
+        if hasattr(obj, "parameter"):
+            with contextlib.suppress(Exception):
+                ctx["parameter"] = getattr(obj, "parameter")
+
+        # Also support objects exposing address directly
+        if "device_id" not in ctx and hasattr(obj, "device"):
+            dev = getattr(obj, "device")
+            try:
+                device_id = dev.id if not callable(dev.id) else dev.id()
+                ctx["device_id"] = device_id
+            except Exception:
+                pass
+        if "channel" not in ctx and hasattr(obj, "address"):
+            try:
+                addr = obj.address if not callable(obj.address) else obj.address()
+                ctx["channel"] = addr
+            except Exception:
+                pass
+    except Exception:
+        # Never allow context building to break the application
+        return {}
+    return ctx
+
+
+def log_boundary_error(
+    logger: logging.Logger,
+    *,
+    boundary: str,
+    action: str,
+    err: Exception,
+    level: int | None = None,
+    context: Mapping[str, Any] | None = None,
+) -> None:
+    """
+    Log a boundary error with the provided logger.
+
+    This function differentiates
+    between recoverable and non-recoverable domain errors to select an appropriate
+    logging level if not explicitly provided. Additionally, it enriches the log
+    record with extra context about the error and action boundaries.
+
+    :param logger: The logger instance used to log the error.
+    :type logger: logging.Logger
+    :param boundary: The name of the boundary at which the error occurred.
+    :type boundary: str
+    :param action: The action being performed when the error occurred.
+    :type action: str
+    :param err: The exception instance representing the error to log.
+    :type err: Exception
+    :param level: The optional logging level. Defaults to WARNING for recoverable
+        domain errors and ERROR for non-recoverable errors if not provided.
+    :type level: int | None
+    :param context: Optional mapping of additional information or context to
+        include in the log record.
+    :type context: Mapping[str, Any] | None
+    :return: None. This function logs the provided information but does not
+        return a value.
+    :rtype: None
+    """
+    extra = {
+        "boundary": boundary,
+        "action": action,
+        "err_type": err.__class__.__name__,
+        "err": extract_exc_args(exc=err),
+        **_safe_context(context),
+    }
+
+    # Choose level if not provided:
+    chosen_level = level
+    if chosen_level is None:
+        # Use WARNING for expected/recoverable domain errors, ERROR otherwise.
+        chosen_level = logging.WARNING if isinstance(err, BaseHomematicException) else logging.ERROR
+
+    if chosen_level >= logging.ERROR:
+        logger.exception(_BOUNDARY_MSG, extra=extra)
+    else:
+        logger.log(chosen_level, _BOUNDARY_MSG, extra=extra)
+
+
+# Define public API for this module
+__all__ = tuple(
+    sorted(
+        name
+        for name, obj in globals().items()
+        if not name.startswith("_")
+        and (inspect.isfunction(obj) or inspect.isclass(obj))
+        and getattr(obj, "__module__", __name__) == __name__
+    )
+)

aiohomematic/validator.py

@@ -1,10 +1,19 @@
-"""Validator functions used within aiohomematic."""
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2021-2025 Daniel Perna, SukramJ
+"""
+Validator functions used within aiohomematic.
+
+Public API of this module is defined by __all__.
+"""
 
 from __future__ import annotations
 
+import inspect
+
 import voluptuous as vol
 
-from aiohomematic.const import MAX_WAIT_FOR_CALLBACK
+from aiohomematic.const import BLOCKED_CATEGORIES, CATEGORIES, HUB_CATEGORIES, MAX_WAIT_FOR_CALLBACK, DataPointCategory
+from aiohomematic.model.custom import definition as hmed
 from aiohomematic.support import (
     check_password,
     is_channel_address,
@@ -63,3 +72,41 @@ def paramset_key(value: str) -> str:
 
 address = vol.All(vol.Coerce(str), vol.Any(device_address, channel_address))
 host = vol.All(vol.Coerce(str), vol.Any(hostname, ipv4_address))
+
+
+def validate_startup() -> None:
+    """
+    Validate enum and mapping exhaustiveness at startup.
+
+    - Ensure DataPointCategory coverage: all categories except UNDEFINED must be present
+      in either HUB_CATEGORIES or CATEGORIES. UNDEFINED must not appear in those lists.
+    """
+    categories_in_lists = set(BLOCKED_CATEGORIES) | set(CATEGORIES) | set(HUB_CATEGORIES)
+    all_categories = set(DataPointCategory)
+    if DataPointCategory.UNDEFINED in categories_in_lists:
+        raise vol.Invalid(
+            "DataPointCategory.UNDEFINED must not be present in BLOCKED_CATEGORIES/CATEGORIES/HUB_CATEGORIES"
+        )
+
+    if missing := all_categories - {DataPointCategory.UNDEFINED} - categories_in_lists:
+        missing_str = ", ".join(sorted(c.value for c in missing))
+        raise vol.Invalid(
+            f"BLOCKED_CATEGORIES/CATEGORIES/HUB_CATEGORIES are not exhaustive. Missing categories: {missing_str}"
+        )
+
+    # Validate custom definition mapping schema (Field <-> Parameter mappings)
+    # This ensures Field mappings are valid and consistent at startup.
+    if hmed.validate_custom_data_point_definition() is None:
+        raise vol.Invalid("Custom data point definition schema is invalid")
+
+
+# Define public API for this module
+__all__ = tuple(
+    sorted(
+        name
+        for name, obj in globals().items()
+        if not name.startswith("_")
+        and (inspect.isfunction(obj) or inspect.isclass(obj))
+        and getattr(obj, "__module__", __name__) == __name__
+    )
+)

aiohomematic-2025.8.10.dist-info/METADATA

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: aiohomematic
+Version: 2025.8.10
+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>
+License: MIT License
+Project-URL: Source Code, https://github.com/sukramj/aiohomematic
+Project-URL: Bug Reports, https://github.com/sukramj/aiohomematic/issues
+Project-URL: Docs: Dev, https://github.com/sukramj/aiohomematic
+Project-URL: Forum, https://github.com/sukramj/aiohomematic/discussions
+Keywords: home,automation,homematic
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Home Automation
+Requires-Python: >=3.13.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.10.0
+Requires-Dist: orjson>=3.10.0
+Requires-Dist: python-slugify>=8.0.0
+Requires-Dist: voluptuous>=0.14.0
+Dynamic: license-file
+
+# AIO Homematic (hahomematic)
+
+A lightweight Python 3 library that powers Home Assistant integrations for controlling and monitoring [HomeMatic](https://www.eq-3.com/products/homematic.html) and [HomematicIP](https://www.homematic-ip.com/en/start.html) devices. Some third‑party devices/gateways (e.g., Bosch, Intertechno) may be supported as well.
+
+This project is the modern successor to [pyhomematic](https://github.com/danielperna84/pyhomematic), focusing on automatic entity creation, fewer manual device definitions, and faster startups.
+
+## How it works
+
+Unlike pyhomematic, which required manual device mappings, aiohomematic automatically creates entities for each relevant parameter on every device channel (unless blacklisted). To achieve this it:
+
+- Fetches and caches device paramsets (VALUES) for fast successive startups.
+- Provides hooks for custom entity classes where complex behavior is needed (e.g., thermostats, lights, covers, climate, locks, sirens).
+- Includes helpers for robust operation, such as automatic reconnection after CCU restarts.
+
+## Key features
+
+- Automatic entity discovery from device/channel parameters.
+- Extensible via custom entity classes for complex devices.
+- Caching of paramsets to speed up restarts.
+- Designed to integrate with Home Assistant.
+
+## Quickstart for Home Assistant
+
+Use the Home Assistant custom integration "Homematic(IP) Local", which is powered by aiohomematic.
+
+1. Prerequisites
+   - Home Assistant 2024.6 or newer recommended.
+   - A CCU3, RaspberryMatic, or Homegear instance reachable from Home Assistant.
+   - For HomematicIP devices, ensure CCU firmware meets the minimum versions listed below.
+2. Install the integration
+   - Add the custom repository and install: https://github.com/sukramj/homematicip_local
+   - Follow the installation guide: https://github.com/sukramj/homematicip_local/wiki/Installation
+3. Configure via Home Assistant UI
+   - In Home Assistant: Settings → Devices & Services → Add Integration → search for "Homematic(IP) Local".
+   - Enter the CCU/Homegear host (IP or hostname). If you use HTTPS on the CCU, enable SSL and accept the certificate if self‑signed.
+   - Provide credentials if your CCU requires them.
+   - Choose which interfaces to enable (HM, HmIP, Virtual). Default ports are typically 2001 (HM), 2010 (HmIP), 9292 (Virtual).
+4. Network callbacks
+   - The integration needs to receive XML‑RPC callbacks from the CCU. Make sure Home Assistant is reachable from the CCU (no NAT/firewall blocking). The default callback port is 43439; you can adjust it in advanced options.
+5. Verify
+   - After setup, devices should appear under Devices & Services → Homematic(IP) Local. Discovery may take a few seconds after the first connection while paramsets are fetched and cached for faster restarts.
+
+If you need to use aiohomematic directly in Python, see the Public API and example below.
+
+## Requirements
+
+Due to a bug in earlier CCU2/CCU3 firmware, aiohomematic requires at least the following versions when used with HomematicIP devices:
+
+- CCU2: 2.53.27
+- CCU3: 3.53.26
+
+See details here: https://github.com/jens-maus/RaspberryMatic/issues/843. Other CCU‑like platforms using the buggy HmIPServer version are not supported.
+
+## Public API and imports
+
+- The public API of aiohomematic is explicitly defined via **all** in each module and subpackage.
+- Backwards‑compatible imports should target these modules:
+  - aiohomematic.central: CentralUnit, CentralConfig and related schemas
+  - aiohomematic.client: Client, InterfaceConfig, create_client, get_client
+  - aiohomematic.model: device/data point abstractions (see subpackages for details)
+  - aiohomematic.exceptions: library exception types intended for consumers
+  - aiohomematic.const: constants and enums (stable subset; see module **all**)
+- The top‑level package only exposes **version** to avoid import cycles and keep startup lean. Prefer importing from the specific submodules listed above.
+
+Example:
+
+    from aiohomematic.central import CentralConfig
+    from aiohomematic import client as hmcl
+
+    cfg = CentralConfig(
+        central_id="ccu-main",
+        host="ccu.local",
+        username="admin",
+        password="secret",
+        default_callback_port=43439,
+        interface_configs={hmcl.InterfaceConfig(interface=hmcl.Interface.HMIP, port=2010, enabled=True)},
+    )
+    central = cfg.create_central()
+
+## Useful links
+
+- Changelog: [see](changelog.md) for release history and latest changes.
+- Definition of calculated data points: [see](docs/calculated_data_points.md)
+- Homematic(IP) Local integration: https://github.com/sukramj/homematicip_local
+- Input select helper: [see](docs/input_select_helper.md) for an overview of how to use the input select helper.
+- Troubleshooting with Home Assistant: [see](docs/homeassistant_troubleshooting.md) for common issues and how to debug them.
+- Unignore mechanism: [see](docs/unignore.md) for how to unignore devices that are ignored by default.
+
+## Useful developer links
+
+- Architecture overview: [see](docs/architecture.md) for an overview of the architecture of the library.
+- Data flow: [see](docs/data_flow.md) for an overview of how data flows through the library.
+- Extending the model: [see](docs/extension_points.md) for adding custom device profiles and calculated data points.
+- Home Assistant lifecycle (discovery, updates, teardown): [see](docs/homeassistant_lifecycle.md) for details on how the integration works and how to debug issues.
+- RSSI fix: [see](docs/rssi_fix.md) for how RSSI values are fixed for Home Assistant.
+- Sequence diagrams: [see](docs/sequence_diagrams.md) for a sequence diagram of how the library works.

aiohomematic-2025.8.10.dist-info/RECORD

@@ -0,0 +1,78 @@
+aiohomematic/__init__.py,sha256=VPESkjzeVserFI2DDVAxD782cgYRlLK0sXJzLrr3e_k,2283
+aiohomematic/async_support.py,sha256=Xc55KkIV0h8rf936QKyU4OHSZsPEZ8TwuV8gVveeRh8,6106
+aiohomematic/const.py,sha256=EdtEgzd6a_XYytFHPLj0hHNxxTxLHuC5j5wcfQbJ2-o,25408
+aiohomematic/context.py,sha256=M7gkA7KFT0dp35gzGz2dzKVXu1PP0sAnepgLlmjyRS4,451
+aiohomematic/converter.py,sha256=QTOL8_B6SoCoqLuRSkjtOlfa7BVFSvOfnSBrDngiinA,3558
+aiohomematic/decorators.py,sha256=Iaq172N68w_RL-isiyJ3_suGM1kj1NaVbDWmlgOmTH8,9569
+aiohomematic/exceptions.py,sha256=o_H3Z0A2TQ0irNxUM9u8bmivq0L_mwPCB7nhxEawDxE,5018
+aiohomematic/hmcli.py,sha256=wHOLq4IJRSY9RJux_ZfDH1gQ1ZqD0k68ua5agyBkkE8,4933
+aiohomematic/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+aiohomematic/support.py,sha256=d70tjuajEQYGFsINJQA9-RkKuCRN8-2Sw33B0bPMym8,21495
+aiohomematic/validator.py,sha256=vChkYQ9dGKCQEigiBMnoeyPkCJDJlIm6DSgR1gmeHH0,3545
+aiohomematic/caches/__init__.py,sha256=_gI30tbsWgPRaHvP6cRxOQr6n9bYZzU-jp1WbHhWg-A,470
+aiohomematic/caches/dynamic.py,sha256=ZrAQqXlzhoCvzjZ9cTEtlWqygvkn5xTzOJ987WcrPBc,21539
+aiohomematic/caches/persistent.py,sha256=YBThIByt0mLQCgcZwBBmqanI8obAhHNcFULz_H-de8o,19932
+aiohomematic/caches/visibility.py,sha256=uZ1sSCfmEQURllPvSbJ3EzFVFE7TU8XcxMDSHRpNmMs,31481
+aiohomematic/central/__init__.py,sha256=vr4JVYbCO0bdgmVw8lHL7DrPjLlAnYtjXNcThuRH5dA,85733
+aiohomematic/central/decorators.py,sha256=Sl-cMDhreiAOKkIHiei-QbIOcvbWGVX-QwB5bLeohak,6904
+aiohomematic/central/xml_rpc_server.py,sha256=dM-gbAS1NpRy4wJKUZTsMI2LJfv_vjd4kvyv3pl86yw,10545
+aiohomematic/client/__init__.py,sha256=hGpdDb518VdMYMHxrBBj2PBpUBN2Ah8ID5vjokd9PAU,69832
+aiohomematic/client/_rpc_errors.py,sha256=vu76ZWMwJJEgB0cnXc10JzK8PaiRU7jYOvj1aC21CqE,2971
+aiohomematic/client/json_rpc.py,sha256=6eHRYM4xcXUS_Ny3tnjSxw7F0GpaRMUjkqwj1HGaT7w,48231
+aiohomematic/client/xml_rpc.py,sha256=OUWQkvYYbw9duFzNAB4CXavwwh-slBtitmMPGWShbNg,8504
+aiohomematic/model/__init__.py,sha256=l1YMXkx1ugdUf7ms8lD8ObVaOzKAhi-4O2TO5s0IMd0,5459
+aiohomematic/model/data_point.py,sha256=N446xJizb9jMtrX8TFW7NQ0wj8VbTxQREFsiVUnArKA,40738
+aiohomematic/model/decorators.py,sha256=JGhDzWx983zBCEKA9UoptjFmIHOGX-UfgozhqXAeZsM,7663
+aiohomematic/model/device.py,sha256=6PDtZPZ6S-3cjEmb20zrnAh6VYG9fMtAIi1OnuV9r5s,51991
+aiohomematic/model/event.py,sha256=vXtqb9OfpumOOmbgj9z6DG-QeVUEHMOvK1gnv0piKDY,7014
+aiohomematic/model/support.py,sha256=TnEpCB8EgJq_-4LoH-et1R0cPT6Lq4LTv7MxmRn5JQU,20767
+aiohomematic/model/update.py,sha256=DemrlE8TleJgaxBwj984NxzZGeLEKpC3xAo0Ew21HLU,5107
+aiohomematic/model/calculated/__init__.py,sha256=BHYLdWMMMjqvDI5T9cQ1sPOyk7t8_q-Ngfm4cFySvJ4,2810
+aiohomematic/model/calculated/climate.py,sha256=BUKXT5kd6mbEE7TAJpRs8-A1K4pVq2d2E5cSfjsOPJw,8515
+aiohomematic/model/calculated/data_point.py,sha256=hspOOnEp-WbXb4VMTcuXkgTWxjy0ug5E46zXZy6YReQ,11493
+aiohomematic/model/calculated/operating_voltage_level.py,sha256=sf5Fy0bSbvee9lvq95-iFC05rSGkHBOKIQkdjQBU_XY,14011
+aiohomematic/model/calculated/support.py,sha256=ODH3a2B1y8Mr9N_3sMt0pyUs1qQ1tDZsD2GthScntbg,6098
+aiohomematic/model/custom/__init__.py,sha256=KNvUy3hZvdr3aRZk9CDyMqJBqRorQedZfOP3M-zwjp8,6066
+aiohomematic/model/custom/climate.py,sha256=te8GoqqDU8wQAEDTf3Pyi8NFdm9MACCe8WyhBG74x28,54018
+aiohomematic/model/custom/const.py,sha256=Kh1pnab6nmwbaY43CfXQy3yrWpPwsrQdl1Ea2aZ6aw0,4961
+aiohomematic/model/custom/cover.py,sha256=dXYZGVzR-cFELbVP2az8tkM8h7jIrvzweUz4yWh7AM8,28552
+aiohomematic/model/custom/data_point.py,sha256=mz143_hLKaF9HzJRhqqqzsoJhouLF0L_9Jo_4oq_6Gc,14109
+aiohomematic/model/custom/definition.py,sha256=1GkUyEsmjJfAdrBCW1ZBmboYZOyb00MctUE_xn4Zyl8,35481
+aiohomematic/model/custom/light.py,sha256=0QC6x6eYuDypNMbk-Ey7CMfVs1B0vgFz2YzFzqQhbzw,44170
+aiohomematic/model/custom/lock.py,sha256=q-jsvMTly6s7kEWDT42rMEfEEJsd9lBIuwzpO2STFBk,11937
+aiohomematic/model/custom/siren.py,sha256=yfWdNj-vEUGLqXBejjURd98RzY8MQv99oXxy35Ul_6U,9726
+aiohomematic/model/custom/support.py,sha256=UvencsvCwgpm4iqRNRt5KRs560tyw1NhYP5ZaqmCT2k,1453
+aiohomematic/model/custom/switch.py,sha256=JSmWUWc_WB8XmZPPgcISB9r3TNNUeg-E4skX46z7vwA,6869
+aiohomematic/model/custom/valve.py,sha256=S5i2ZePa9Jt8JplIykzeJxpJrSBEN5w-3UEmGu0Q5G0,4226
+aiohomematic/model/generic/__init__.py,sha256=OI0-ijDRYS6OkDqVd9C9UOfde2rfcB7WZZ9CLTlX1S0,7613
+aiohomematic/model/generic/action.py,sha256=5SPWVliRqXlPgtb2bI6le0-V6JR5krzw8z_0FaOXu5U,994
+aiohomematic/model/generic/binary_sensor.py,sha256=TI_KNzObiprHFS6rUKb7cYr2EsQQElfNo8Sk7eBY9NQ,884
+aiohomematic/model/generic/button.py,sha256=9wStCwiE3NeGfKHum5IVpLlbq5jRdYOA1bGHSqReY8k,742
+aiohomematic/model/generic/data_point.py,sha256=a7AXyYd0o-AfMOaGIn1qu8Q73ipjjsLLQrxMFJRw5xQ,6019
+aiohomematic/model/generic/number.py,sha256=39paL6us6KMLD5L8GhR7BLl8bKtEiicAIfcd_3HyOw4,2666
+aiohomematic/model/generic/select.py,sha256=vCe5FpMe2iqePQMHFBxKmkIBY6Y99SnTyiatmeZC6dM,1532
+aiohomematic/model/generic/sensor.py,sha256=N2GeZjZQbRyc4s8lX11xvho_TOqIdT6Uqc7LguBF9Ho,2250
+aiohomematic/model/generic/switch.py,sha256=wr6vEBc0iTyCGaRSVdoO_9UY8lt3-NPTyAXEhuZbAqU,1836
+aiohomematic/model/generic/text.py,sha256=vTgQpX_COn1OxExZ5az9jPU410fGZIbq0PajPS8vXgs,851
+aiohomematic/model/hub/__init__.py,sha256=_UEEiNHfUVb0D0qTMcR2_YH1ZcYu1jzgLnUApPWfT2k,13493
+aiohomematic/model/hub/binary_sensor.py,sha256=0cF1SCJY1BRM1_Fx5oYPMaSZu9tDy1GnBMn_UqpqqPk,749
+aiohomematic/model/hub/button.py,sha256=N0QSN-SdnLY38JslCoUaqjI2pcdp0DJY2kxoODUKO0s,889
+aiohomematic/model/hub/data_point.py,sha256=3HscnhIbOQlipWZKliHZPvZulvtpTAF83qS0-4iCzVQ,10645
+aiohomematic/model/hub/number.py,sha256=mj4HVRGgUqoyAyluSzKwlE_0jconltBAx-2nJuL9bhY,1224
+aiohomematic/model/hub/select.py,sha256=s5_nmMCae35I7WtUK2Oo_577JzBt68BSpgv5cTussps,1658
+aiohomematic/model/hub/sensor.py,sha256=Uqqb1rqVmYCemJK4yIkarkllKWZJTpd-VNiyLOKXl3M,1189
+aiohomematic/model/hub/switch.py,sha256=1Dp_jG4qtnAs-itaZDKStmeD4PdiMtdZctDOoGWI-Qg,1391
+aiohomematic/model/hub/text.py,sha256=AQOQB2W0jt8t__FxahDAAEOGhshkAX1pImHIFt_Xwqg,987
+aiohomematic/rega_scripts/fetch_all_device_data.fn,sha256=7uxhHoelAOsH6yYr1n1M1XwIRgDmItiHnWIMhDYEimk,4373
+aiohomematic/rega_scripts/get_program_descriptions.fn,sha256=pGmj377MkqbZi6j-UBKQAsXTphwh1kDwDKqXij8zUBE,835
+aiohomematic/rega_scripts/get_serial.fn,sha256=t1oeo-sB_EuVeiY24PLcxFSkdQVgEWGXzpemJQZFybY,1079
+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.8.10.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=cvkO3tcxSJKy5ZLVdeqDbvSmeottxqZJNI4ccdxIVD4,12524
+aiohomematic-2025.8.10.dist-info/METADATA,sha256=Srm8S5cBMy77q-GowiujO6AupVIou9CwZ15HZOHODGU,6871
+aiohomematic-2025.8.10.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aiohomematic-2025.8.10.dist-info/top_level.txt,sha256=5TDRlUWQPThIUwQjOj--aUo4UA-ow4m0sNhnoCBi5n8,34
+aiohomematic-2025.8.10.dist-info/RECORD,,

{aiohomematic-2025.8.9.dist-info → aiohomematic-2025.8.10.dist-info}/licenses/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 Daniel Perna, SukramJ
+Copyright (c) 2021-2025 Daniel Perna, SukramJ
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

aiohomematic-2025.8.9.dist-info/METADATA

@@ -1,69 +0,0 @@
-Metadata-Version: 2.4
-Name: aiohomematic
-Version: 2025.8.9
-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>
-License: MIT License
-Project-URL: Source Code, https://github.com/sukramj/aiohomematic
-Project-URL: Bug Reports, https://github.com/sukramj/aiohomematic/issues
-Project-URL: Docs: Dev, https://github.com/sukramj/aiohomematic
-Project-URL: Forum, https://github.com/sukramj/aiohomematic/discussions
-Keywords: home,automation,homematic
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: End Users/Desktop
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Home Automation
-Requires-Python: >=3.13.0
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: aiohttp>=3.10.0
-Requires-Dist: orjson>=3.10.0
-Requires-Dist: python-slugify>=8.0.0
-Requires-Dist: voluptuous>=0.14.0
-Dynamic: license-file
-
-# AIO Homematic (hahomematic)
-
-A lightweight Python 3 library that powers Home Assistant integrations for controlling and monitoring [HomeMatic](https://www.eq-3.com/products/homematic.html) and [HomematicIP](https://www.homematic-ip.com/en/start.html) devices. Some third‑party devices/gateways (e.g., Bosch, Intertechno) may be supported as well.
-
-This project is the modern successor to [pyhomematic](https://github.com/danielperna84/pyhomematic), focusing on automatic entity creation, fewer manual device definitions, and faster startups.
-
-## How it works
-
-Unlike pyhomematic, which required manual device mappings, aiohomematic automatically creates entities for each relevant parameter on every device channel (unless blacklisted). To achieve this it:
-
-- Fetches and caches device paramsets (VALUES) for fast successive startups.
-- Provides hooks for custom entity classes where complex behavior is needed (e.g., thermostats, lights, covers, climate, locks, sirens).
-- Includes helpers for robust operation, such as automatic reconnection after CCU restarts.
-
-## Key features
-
-- Automatic entity discovery from device/channel parameters.
-- Extensible via custom entity classes for complex devices.
-- Caching of paramsets to speed up restarts.
-- Designed to integrate with Home Assistant.
-
-## Installation (with Home Assistant)
-
-Install via the custom component: [Homematic(IP) Local](https://github.com/sukramj/homematicip_local).
-
-Follow the installation guide: https://github.com/sukramj/homematicip_local/wiki/Installation
-
-## Requirements
-
-Due to a bug in earlier CCU2/CCU3 firmware, aiohomematic requires at least the following versions when used with HomematicIP devices:
-
-- CCU2: 2.53.27
-- CCU3: 3.53.26
-
-See details here: https://github.com/jens-maus/RaspberryMatic/issues/843. Other CCU‑like platforms using the buggy HmIPServer version are not supported.
-
-## Useful links
-
-- Examples: see example.py in this repository.
-- Changelog: see changelog.md.
-- Source code and documentation: this repository (docs/ directory may contain additional information).

aiohomematic-2025.8.9.dist-info/RECORD

@@ -1,77 +0,0 @@
-aiohomematic/__init__.py,sha256=VoLXfPmEFWVOFseEusar-BcfKhQ8pBthrA7M6_QkWg8,1741
-aiohomematic/async_support.py,sha256=8KzftPu9CHRpxxXU8ElExYYadN9P6rSkMvLK5Ci2Xlo,5476
-aiohomematic/const.py,sha256=Bb4WaY4ISZutoJ9P7JJbXJ7BHaXqdRepkNiW35ER-i8,24234
-aiohomematic/context.py,sha256=4CNoLd4PQ8MsLED_3D-Gcxo4h2UNlyQNd7QUE_0uvBA,253
-aiohomematic/converter.py,sha256=eZ3iQPCfYZwqxQgUy4q6aMne_Bay-27f1HQuMRdabZ4,2922
-aiohomematic/decorators.py,sha256=YD7zX9jBN-F-NdfKGNn0STqR6cndpoBCMuXaBvgvam4,7088
-aiohomematic/exceptions.py,sha256=uMmbR-rWmCnseqmOPSHZ826YZ10uJrxG1c0w7VCYPZ0,4579
-aiohomematic/hmcli.py,sha256=9oeXjCy50hkjMj7t1c9Cw0bz-LnXzjheKQBQDyGQQRk,4582
-aiohomematic/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-aiohomematic/support.py,sha256=MTRICfoUDT54plMObB4joogwAzdJCcGo-0QHkmlP40g,16170
-aiohomematic/validator.py,sha256=Xxcmf2MzjIvzsDAfJsPR-cSN8S06sub-V3TCn6ronAs,1765
-aiohomematic/caches/__init__.py,sha256=Uco9Y5fVmIPm_iRoLPWJnJNYfs9PY6VL-Jmj_3cT3yE,391
-aiohomematic/caches/dynamic.py,sha256=rvqsLhImFy6J5a_ZJc705-_tDKyboZQNXNE2BlOrTGY,21460
-aiohomematic/caches/persistent.py,sha256=ccdxTZztNRrDFTrlQTG6ad0g-NeJqgmZbyw5QhABa3s,19853
-aiohomematic/caches/visibility.py,sha256=SBTVN3qxxh7m-d06BKtpHDCH8CWWsxDr5LC5vB3-JLo,31402
-aiohomematic/central/__init__.py,sha256=LlTTbM0y8VNUAT5z-R2L1Jo6NVdlWynWXH1h7E2XUAA,84329
-aiohomematic/central/decorators.py,sha256=Lgc9SzvugZ45h_1anPjBNgzTjQ8BgDHnquE1PD48-XY,4899
-aiohomematic/central/xml_rpc_server.py,sha256=xwcb57ow7YEUS4By0HSBwzRSEY8kC9nZ-7hl4M-EWqI,9957
-aiohomematic/client/__init__.py,sha256=n2rNU3L1Xr453xsTCTM2mh5N1alp0yftAIienziB6ak,69753
-aiohomematic/client/json_rpc.py,sha256=HGgCXcp1uCfDkBdHlMNV8OD5O2PfWFRYNmiX5Pv1FO8,46463
-aiohomematic/client/xml_rpc.py,sha256=pUFdJZBtirNyNNyHbeMDOEh2mFkxQf_zrvjd56n1Lv4,8161
-aiohomematic/model/__init__.py,sha256=AbrppmY8X5rJkBV3c7Ggndk16Qvl-1S0uUWJqqxmXUE,5380
-aiohomematic/model/data_point.py,sha256=Vykptu14k7q3uD3yRdQXj7g18DN5iBC2pT-8m0lsDzY,40110
-aiohomematic/model/decorators.py,sha256=sIxYsoyIE9aqbbrAnuFSvebLhNZC_DaMlEOBe6T_fRA,6718
-aiohomematic/model/device.py,sha256=1F0yhv7_DL1VnJrODV-oRGkZ-zaX7b5KB6PtXKVwhp8,51912
-aiohomematic/model/event.py,sha256=4dVuW3IBXkXcYhJUBtV8ax8dq4krtomA0wxbvXPuNCc,6935
-aiohomematic/model/support.py,sha256=fXaGvD6ywaOmDihIAHjn-z3AuIn0Q3Wiq7EqcxUV6uc,19630
-aiohomematic/model/update.py,sha256=7fTkDwjX3J8R0sK3GhQku1poyJodRqxv_ZCihyZvHig,5028
-aiohomematic/model/calculated/__init__.py,sha256=vvBAPphiZPnc-ZTIRJ0M4VsDPdxVqQWCA56p8AhAKIM,2731
-aiohomematic/model/calculated/climate.py,sha256=yu3mFBAO6Cb_r68v197uXseOl9P1jz7Dz0tUaCY-6FE,8436
-aiohomematic/model/calculated/data_point.py,sha256=EVXclyuPqIWtyglk3NvCEB67nfW6P9CZumblSTSQe5M,11414
-aiohomematic/model/calculated/operating_voltage_level.py,sha256=F09jW2rFtjxrsR25xkN-uZxJAdw_dcDr8hv-xvTiBCs,13932
-aiohomematic/model/calculated/support.py,sha256=ht_KSFUT2Dze9wjw_o0Gp2-PGo4on0W0CZujhCWzwIk,6019
-aiohomematic/model/custom/__init__.py,sha256=6-jN7l6DPIUSCANw15SwNQFyL8aXxn8Me8m8fNHkWKc,5987
-aiohomematic/model/custom/climate.py,sha256=Sd3KofB1G085bKK1JKB7k4uaySD3W4SKbw-Fg9FH0PU,53930
-aiohomematic/model/custom/const.py,sha256=ifJgooQqo43qEqfPQTIcyY7IcUeFvM0-y4WvP-_HgXM,4882
-aiohomematic/model/custom/cover.py,sha256=aU8sSdKnGuiPBAO73GtmOMcYLoU7VmFldBxDf601dII,27474
-aiohomematic/model/custom/data_point.py,sha256=moms_MQiX4DYGDhDGVF-epIA_OiB9t4WvjPpWx1R7P4,14030
-aiohomematic/model/custom/definition.py,sha256=VQ8dROZSAVu-CarYc2jN_KrlvGI1kjhwUqD0ZR1qTUA,35402
-aiohomematic/model/custom/light.py,sha256=IGT98GlqRftNzZpFP8NR_aQG_EQHyr191O5xkcpVaz4,43843
-aiohomematic/model/custom/lock.py,sha256=6_xOeUFfVRJh_BjTY6RVLaCVmIozQo-uUMrbDqASt8g,11858
-aiohomematic/model/custom/siren.py,sha256=5WLiYfUE7vBNVDlV8Whjqh-7PVMiReW-CI5MDH25R0s,9573
-aiohomematic/model/custom/support.py,sha256=Rn6ikcSE2Hcqv34k2h02osXW45poS0hO3GX_wtTpMyE,1374
-aiohomematic/model/custom/switch.py,sha256=XIhlGvtkZaId4jNE1XtYpJfFuvFofzlAN6tUPHzLgTA,6790
-aiohomematic/model/custom/valve.py,sha256=u1mv5-hllX89GVN5Ir_svJcJOGdcS8JNYu0NAZsthTc,4147
-aiohomematic/model/generic/__init__.py,sha256=qYNbPuFlanpDsrw9GKbWAT48pcNaAYWKgERpkv91HzU,7534
-aiohomematic/model/generic/action.py,sha256=NMbMbNX6JSQH56M4CkkYstx1nb1nYuLXtFjZR2wg2UU,915
-aiohomematic/model/generic/binary_sensor.py,sha256=jHyvrkHyFuWdVOQiBWmD25HZqwk6tU6VKuWiZyrt2kU,805
-aiohomematic/model/generic/button.py,sha256=-6W7dEGq4bXvdEtQTtSA-54PurHD6in8umBaUiUtqNA,663
-aiohomematic/model/generic/data_point.py,sha256=QTzbjXSmOmDKrr7nFl1YrRk14gN07Iv7FbFp58Ih69I,5861
-aiohomematic/model/generic/number.py,sha256=6JIFPNED5WjghT1o0hM-OObhUXX42t-Cv7jAhNy52rw,2522
-aiohomematic/model/generic/select.py,sha256=-DUuavyD7-CicNZboA_kAV4kBN6w7mtoP_5Sn_6fNgA,1388
-aiohomematic/model/generic/sensor.py,sha256=dMjI0RSKIl6xI1VnTPFJe5HCUdfOKtfAXHLtX0Hwoiw,2171
-aiohomematic/model/generic/switch.py,sha256=bzJKvLmGN7yBoWSTZCjiXRnq2sBduKvRVGohBGrjKSE,1757
-aiohomematic/model/generic/text.py,sha256=ig-ilSa6CFlf65Sopg-E5jC9rK0Ma1vs2nzBxdprIpQ,772
-aiohomematic/model/hub/__init__.py,sha256=yTX2dLRMdVxyMMpbhDCf5ge6LisWWFUctWcusQsi3zE,13414
-aiohomematic/model/hub/binary_sensor.py,sha256=MG75YRZAkLOCs8ZVj2kr-EFgUte4v6dV_C3vdqZ-4jU,670
-aiohomematic/model/hub/button.py,sha256=3NWWQDjsQ4aIi3WGOVTWNi8Ry2shsvmqdgLNF6SvOGg,810
-aiohomematic/model/hub/data_point.py,sha256=64fU-X9jaDx3ZHpzY1KfrFLbigNXus2muPMA6j4KLCw,10566
-aiohomematic/model/hub/number.py,sha256=auwUxR2J5rF_ZKSKSDo4XSiZUcXJ0uYUiCJO94_vmQM,1145
-aiohomematic/model/hub/select.py,sha256=UTng9oNf7y-x-2wMnd7UL8rZ0goyH8GsfQhz8MJrw8o,1579
-aiohomematic/model/hub/sensor.py,sha256=q_QWbkt2rycHeJJ5hlBGJJg0-Rfum8vrLA8BoZZyGq4,1110
-aiohomematic/model/hub/switch.py,sha256=W5iGOgL4A8BWFw5_rEYcfxyRVCnXIYy5tYt5sbpShCg,1312
-aiohomematic/model/hub/text.py,sha256=LGgFQNHgXreCIzMe3j21KFiOjliLv5a0xJrnUb1_P9k,908
-aiohomematic/rega_scripts/fetch_all_device_data.fn,sha256=7uxhHoelAOsH6yYr1n1M1XwIRgDmItiHnWIMhDYEimk,4373
-aiohomematic/rega_scripts/get_program_descriptions.fn,sha256=pGmj377MkqbZi6j-UBKQAsXTphwh1kDwDKqXij8zUBE,835
-aiohomematic/rega_scripts/get_serial.fn,sha256=t1oeo-sB_EuVeiY24PLcxFSkdQVgEWGXzpemJQZFybY,1079
-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.8.9.dist-info/licenses/LICENSE,sha256=cKEF-xEwJKQt28HpA6ppSzyqUJ6QF9g5OLacWMCuz8s,1078
-aiohomematic_support/__init__.py,sha256=_0YtF4lTdC_k6-zrM2IefI0u0LMr_WA61gXAyeGLgbY,66
-aiohomematic_support/client_local.py,sha256=cvkO3tcxSJKy5ZLVdeqDbvSmeottxqZJNI4ccdxIVD4,12524
-aiohomematic-2025.8.9.dist-info/METADATA,sha256=OWbH-zT7kqxp3hOk74OZ-TcyV8m_hLqzpCuvajxlCwg,3249
-aiohomematic-2025.8.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-aiohomematic-2025.8.9.dist-info/top_level.txt,sha256=5TDRlUWQPThIUwQjOj--aUo4UA-ow4m0sNhnoCBi5n8,34
-aiohomematic-2025.8.9.dist-info/RECORD,,