python-bsblan 3.1.4__tar.gz → 3.1.5__tar.gz

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/.github/LICENSE.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright (c) 2023-2024 Willem-Jan L. van Rootselaar
+Copyright (c) 2023-2026 Willem-Jan L. van Rootselaar
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/.github/renovate.json

@@ -4,6 +4,7 @@
   "rebaseWhen": "behind-base-branch",
   "dependencyDashboard": true,
   "labels": ["dependencies", "no-stale"],
+  "platformAutomerge": true,
   "lockFileMaintenance": {
     "enabled": true,
     "automerge": true
@@ -11,16 +12,17 @@
   "commitMessagePrefix": "⬆️",
   "packageRules": [
     {
-      "matchManagers": ["poetry"],
+      "matchManagers": ["uv"],
       "addLabels": ["python"]
     },
     {
-      "matchManagers": ["poetry"],
+      "matchManagers": ["uv"],
       "matchDepTypes": ["dev"],
       "rangeStrategy": "pin"
     },
     {
-      "matchManagers": ["poetry"],
+      "description": "Automerge minor/patch Python updates (after CI passes)",
+      "matchManagers": ["uv"],
       "matchUpdateTypes": ["minor", "patch"],
       "automerge": true
     },
@@ -40,9 +42,16 @@
       "rangeStrategy": "pin"
     },
     {
+      "description": "Automerge minor/patch GitHub Actions updates (after CI passes)",
       "matchManagers": ["github-actions"],
       "matchUpdateTypes": ["minor", "patch"],
       "automerge": true
+    },
+    {
+      "description": "Don't automerge major GitHub Actions updates",
+      "matchManagers": ["github-actions"],
+      "matchUpdateTypes": ["major"],
+      "automerge": false
     }
   ]
 }

python_bsblan-3.1.5/.github/workflows/auto-approve-renovate.yml

@@ -0,0 +1,24 @@
+---
+name: Auto-approve Renovate PRs
+
+# yamllint disable-line rule:truthy
+on:
+  pull_request_target:
+    types:
+      - opened
+      - synchronize
+      - reopened
+
+permissions:
+  pull-requests: write
+
+jobs:
+  auto-approve:
+    runs-on: ubuntu-latest
+    if: >-
+      github.actor == 'renovate[bot]' &&
+      github.actor_id == '29139614' &&
+      github.event.pull_request.head.repo.full_name == github.repository
+    steps:
+      # yamllint disable-line rule:line-length
+      - uses: hmarr/auto-approve-action@f0939ea97e9205ef24d872e76833fa908a770363 # v4.0.0

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/.github/workflows/codeql.yaml

@@ -19,6 +19,6 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Initialize CodeQL
-        uses: github/codeql-action/init@v3.31.6
+        uses: github/codeql-action/init@v3.31.9
       - name: 🚀 Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v3.31.6
+        uses: github/codeql-action/analyze@v3.31.9

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/.github/workflows/linting.yaml

@@ -4,7 +4,9 @@ name: Linting
 # yamllint disable-line rule:truthy
 on:
   push:
+    branches: [main]
   pull_request:
+    branches: [main]
   workflow_dispatch:
 
 env:
@@ -18,7 +20,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -38,7 +40,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -60,7 +62,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -104,7 +106,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -124,7 +126,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -144,7 +146,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/.github/workflows/lock.yaml

@@ -12,7 +12,7 @@ jobs:
     name: 🔒 Lock closed issues and PRs
     runs-on: ubuntu-latest
     steps:
-      - uses: dessant/lock-threads@v5.0.1
+      - uses: dessant/lock-threads@v6.0.0
         with:
           github-token: ${{ github.token }}
           issue-inactive-days: "30"

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/.github/workflows/release.yaml

@@ -24,7 +24,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/.github/workflows/tests.yaml

@@ -4,7 +4,9 @@ name: Testing
 # yamllint disable-line rule:truthy
 on:
   push:
+    branches: [main]
   pull_request:
+    branches: [main]
   workflow_dispatch:
 
 env:
@@ -21,7 +23,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ matrix.python }}
@@ -34,7 +36,7 @@ jobs:
       - name: 🚀 Run pytest
         run: uv run pytest --cov=bsblan tests
       - name: ⬆️ Upload coverage artifact
-        uses: actions/upload-artifact@v5.0.0
+        uses: actions/upload-artifact@v6.0.0
         with:
           name: coverage-${{ matrix.python }}
           include-hidden-files: true
@@ -49,9 +51,9 @@ jobs:
         with:
           fetch-depth: 0
       - name: ⬇️ Download coverage data
-        uses: actions/download-artifact@v6.0.0
+        uses: actions/download-artifact@v7.0.0
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -66,7 +68,7 @@ jobs:
           uv run coverage combine coverage*/.coverage*
           uv run coverage xml -i
       - name: 🚀 Upload coverage report
-        uses: codecov/codecov-action@v5.5.1
+        uses: codecov/codecov-action@v5.5.2
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
       - name: SonarCloud Scan

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/.github/workflows/typing.yaml

@@ -4,21 +4,25 @@ name: Typing
 # yamllint disable-line rule:truthy
 on:
   push:
+    branches: [main]
   pull_request:
+    branches: [main]
   workflow_dispatch:
 
 env:
   DEFAULT_PYTHON: "3.13"
 
 jobs:
-  mypy:
-    name: mypy
+  ty:
+    name: ty
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
     steps:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -28,5 +32,5 @@ jobs:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install dependencies
         run: uv sync --dev
-      - name: 🚀 Run mypy
-        run: uv run mypy examples src tests
+      - name: 🚀 Run ty
+        run: uv run ty check examples src tests

python_bsblan-3.1.5/.nvmrc

@@ -0,0 +1 @@
+24.12.0

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/.pre-commit-config.yaml

@@ -83,11 +83,11 @@ repos:
         types: [text]
         entry: uv run end-of-file-fixer
         stages: [pre-commit, pre-push, manual]
-      - id: mypy
-        name: 🆎 Static type checking using mypy
+      - id: ty
+        name: 🆎 Static type checking using ty
         language: system
         types: [python]
-        entry: uv run mypy
+        entry: uv run ty check
         require_serial: true
       - id: no-commit-to-branch
         name: 🛑 Don't commit to main branch

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-bsblan
-Version: 3.1.4
+Version: 3.1.5
 Summary: Asynchronous Python client for BSBLAN API
 Project-URL: Homepage, https://github.com/liudger/python-bsblan
 Project-URL: Repository, https://github.com/liudger/python-bsblan
@@ -48,7 +48,7 @@ Asynchronous Python client for BSBLan.
 
 ## About
 
-This package allows you to control and monitor an BSBLan device
+This package allows you to control and monitor a BSBLan device
 programmatically. It is mainly created to allow third-party programs to automate
 the behavior of [BSBLan][bsblanmodule].
 
@@ -121,9 +121,9 @@ async def main() -> None:
         print("\nSetting temperature to 18°C")
         await bsblan.thermostat(target_temperature="18")
 
-        # Set HVAC mode
+        # Set HVAC mode (using raw integer: 0=off, 1=auto, 2=eco, 3=heat)
         print("Setting HVAC mode to heat")
-        await bsblan.thermostat(hvac_mode="heat")
+        await bsblan.thermostat(hvac_mode=3)
 
         # Get and print sensor information
         sensor: Sensor = await bsblan.sensor()
@@ -211,7 +211,7 @@ check [the contributor's page][contributors].
 
 MIT License
 
-Copyright (c) 2023-2025 WJ van Rootselaar
+Copyright (c) 2023-2026 WJ van Rootselaar
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -243,9 +243,7 @@ SOFTWARE.
 [keepchangelog]: http://keepachangelog.com/en/1.0.0/
 [license-shield]: https://img.shields.io/badge/license-MIT-blue.svg
 [liudger]: https://github.com/liudger
-[maintenance-shield]: https://img.shields.io/maintenance/yes/2025.svg
-[poetry]: https://python-poetry.org
-[poetry-install]: https://python-poetry.org/docs/#installation
+[maintenance-shield]: https://img.shields.io/maintenance/yes/2026.svg
 [uv]: https://docs.astral.sh/uv/
 [uv-install]: https://docs.astral.sh/uv/getting-started/installation/
 [pre-commit]: https://pre-commit.com/

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/README.md

@@ -16,7 +16,7 @@ Asynchronous Python client for BSBLan.
 
 ## About
 
-This package allows you to control and monitor an BSBLan device
+This package allows you to control and monitor a BSBLan device
 programmatically. It is mainly created to allow third-party programs to automate
 the behavior of [BSBLan][bsblanmodule].
 
@@ -89,9 +89,9 @@ async def main() -> None:
         print("\nSetting temperature to 18°C")
         await bsblan.thermostat(target_temperature="18")
 
-        # Set HVAC mode
+        # Set HVAC mode (using raw integer: 0=off, 1=auto, 2=eco, 3=heat)
         print("Setting HVAC mode to heat")
-        await bsblan.thermostat(hvac_mode="heat")
+        await bsblan.thermostat(hvac_mode=3)
 
         # Get and print sensor information
         sensor: Sensor = await bsblan.sensor()
@@ -179,7 +179,7 @@ check [the contributor's page][contributors].
 
 MIT License
 
-Copyright (c) 2023-2025 WJ van Rootselaar
+Copyright (c) 2023-2026 WJ van Rootselaar
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -211,9 +211,7 @@ SOFTWARE.
 [keepchangelog]: http://keepachangelog.com/en/1.0.0/
 [license-shield]: https://img.shields.io/badge/license-MIT-blue.svg
 [liudger]: https://github.com/liudger
-[maintenance-shield]: https://img.shields.io/maintenance/yes/2025.svg
-[poetry]: https://python-poetry.org
-[poetry-install]: https://python-poetry.org/docs/#installation
+[maintenance-shield]: https://img.shields.io/maintenance/yes/2026.svg
 [uv]: https://docs.astral.sh/uv/
 [uv-install]: https://docs.astral.sh/uv/getting-started/installation/
 [pre-commit]: https://pre-commit.com/

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/examples/control.py

@@ -18,6 +18,13 @@ from typing import Any
 
 from bsblan import (
     BSBLAN,
+    BSBLAN_HVAC_ACTION_COOLING,
+    BSBLAN_HVAC_ACTION_DEFROSTING,
+    BSBLAN_HVAC_ACTION_DRYING,
+    BSBLAN_HVAC_ACTION_FAN,
+    BSBLAN_HVAC_ACTION_HEATING,
+    BSBLAN_HVAC_ACTION_OFF,
+    BSBLAN_HVAC_ACTION_PREHEATING,
     BSBLANConfig,
     Device,
     DeviceTime,
@@ -66,6 +73,44 @@ def print_attributes(title: str, attributes: dict[str, str]) -> None:
         print(f"{label}: {value}")
 
 
+def get_hvac_action_name(status_code: int) -> str:
+    """Map BSB-LAN parameter 8000 status code to a human-readable HVAC action.
+
+    BSB-LAN parameter 8000 ("Status heating circuit 1") returns vendor-specific
+    status codes. This function maps those codes to simplified HVAC action states
+    compatible with Home Assistant and other automation systems.
+
+    Args:
+        status_code: The raw status code from parameter 8000 (hvac_action.value).
+
+    Returns:
+        str: Human-readable HVAC action name. Returns "idle" for unmapped codes.
+
+    Example:
+        >>> state = await bsblan.state()
+        >>> if state.hvac_action is not None:
+        ...     action = get_hvac_action_name(state.hvac_action.value)
+        ...     print(f"Current HVAC action: {action}")
+
+    """
+    # Map status code sets to action names
+    action_mappings: list[tuple[set[int], str]] = [
+        (BSBLAN_HVAC_ACTION_HEATING, "heating"),
+        (BSBLAN_HVAC_ACTION_COOLING, "cooling"),
+        (BSBLAN_HVAC_ACTION_PREHEATING, "preheating"),
+        (BSBLAN_HVAC_ACTION_DEFROSTING, "defrosting"),
+        (BSBLAN_HVAC_ACTION_DRYING, "drying"),
+        (BSBLAN_HVAC_ACTION_FAN, "fan"),
+        (BSBLAN_HVAC_ACTION_OFF, "off"),
+    ]
+
+    for action_set, action_name in action_mappings:
+        if status_code in action_set:
+            return action_name
+
+    return "idle"
+
+
 async def print_state(state: State) -> None:
     """Print the current state of the BSBLan device.
 
@@ -73,8 +118,22 @@ async def print_state(state: State) -> None:
         state (State): The current state of the BSBLan device.
 
     """
+    # Get the HVAC action - both the raw value and mapped action name
+    hvac_action_desc = await get_attribute(state.hvac_action, "desc", "Unknown Action")
+    hvac_action_value = await get_attribute(state.hvac_action, "value", "N/A")
+
+    # Map the raw status code to a simplified action name
+    hvac_action_mapped = "N/A"
+    if hvac_action_value != "N/A":
+        try:
+            hvac_action_mapped = get_hvac_action_name(int(hvac_action_value))
+        except (ValueError, TypeError):
+            hvac_action_mapped = "unknown"
+
     attributes = {
-        "HVAC Action": await get_attribute(state.hvac_action, "desc", "Unknown Action"),
+        "HVAC Action (raw value)": str(hvac_action_value),
+        "HVAC Action (device desc)": hvac_action_desc,
+        "HVAC Action (mapped)": hvac_action_mapped,
         "HVAC Mode": await get_attribute(state.hvac_mode, "desc", "Unknown Mode"),
         "Current Temperature": await get_attribute(
             state.current_temperature, "value", "N/A"

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-bsblan"
-version = "3.1.4"
+version = "3.1.5"
 description = "Asynchronous Python client for BSBLAN API"
 authors = [
     {name = "Willem-Jan van Rootselaar", email = "liudgervr@gmail.com"}
@@ -178,27 +178,27 @@ build-backend = "hatchling.build"
 dev = [
     "aresponses==3.0.0",
     "bandit==1.9.2",
-    "black==25.11.0",
+    "black==25.12.0",
     "blacken-docs==1.20.0",
     "codespell==2.4.1",
     "covdefaults==2.3.0",
-    "coverage==7.12.0",
+    "coverage==7.13.1",
     "darglint==1.8.1",
     "flake8==7.3.0",
-    "flake8-simplify==0.22.0",
+    "flake8-simplify==0.30.0",
     # hatch is required to support type hinting and proper packaging of the py.typed file.
     "hatch>=1.14.1",
-    "isort==6.1.0",
-    "mypy==1.19.0",
-    "pre-commit==4.5.0",
+    "isort==7.0.0",
+    "ty==0.0.8",
+    "pre-commit==4.5.1",
     "pre-commit-hooks==6.0.0",
-    "pylint==3.3.9",
+    "pylint==4.0.4",
     "pytest>=8.3.5",
     "pytest-asyncio==1.3.0",
     "pytest-cov==7.0.0",
     "pytest-xdist>=3.8.0",
     "pyupgrade==3.21.2",
-    "ruff==0.14.8",
+    "ruff==0.14.10",
     "safety==3.7.0",
     "vulture==2.14",
     "yamllint==1.37.1",

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/src/bsblan/__init__.py

@@ -1,6 +1,15 @@
 """Asynchronous Python client for BSBLAN."""
 
 from .bsblan import BSBLAN, BSBLANConfig
+from .constants import (
+    BSBLAN_HVAC_ACTION_COOLING,
+    BSBLAN_HVAC_ACTION_DEFROSTING,
+    BSBLAN_HVAC_ACTION_DRYING,
+    BSBLAN_HVAC_ACTION_FAN,
+    BSBLAN_HVAC_ACTION_HEATING,
+    BSBLAN_HVAC_ACTION_OFF,
+    BSBLAN_HVAC_ACTION_PREHEATING,
+)
 from .exceptions import BSBLANAuthError, BSBLANConnectionError, BSBLANError
 from .models import (
     DaySchedule,
@@ -22,6 +31,13 @@ from .models import (
 
 __all__ = [
     "BSBLAN",
+    "BSBLAN_HVAC_ACTION_COOLING",
+    "BSBLAN_HVAC_ACTION_DEFROSTING",
+    "BSBLAN_HVAC_ACTION_DRYING",
+    "BSBLAN_HVAC_ACTION_FAN",
+    "BSBLAN_HVAC_ACTION_HEATING",
+    "BSBLAN_HVAC_ACTION_OFF",
+    "BSBLAN_HVAC_ACTION_PREHEATING",
     "BSBLANAuthError",
     "BSBLANConfig",
     "BSBLANConnectionError",

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/src/bsblan/constants.py

@@ -131,6 +131,101 @@ API_VERSIONS: Final[dict[str, APIConfig]] = {
 # Valid HVAC mode values for validation
 VALID_HVAC_MODES: Final[set[int]] = {0, 1, 2, 3}
 
+# Parameter 8000 ("Status heating circuit 1") yields many vendor specific status
+# codes. These sets capture the most common codes we need for Home Assistant's
+# simplified HVAC action states. Any unmapped code will fall back to IDLE.
+# Status code definitions from BSB-LAN ENUM8000 (LANG_DE_LEGACY.h / LANG_EN.h)
+BSBLAN_HVAC_ACTION_HEATING: Final[set[int]] = {
+    0x04,  # Manual control active
+    0x11,  # Overrun active
+    0x16,  # Frost protection plant active
+    0x17,  # Frost protection active
+    0x18,  # (Reserved heating state)
+    0x38,  # Overheat protection active
+    0x65,  # Room frost protection active
+    0x67,  # Limited, boiler protection
+    0x68,  # Limited, DHW priority
+    0x69,  # Limited, buffer
+    0x6A,  # Heating operation limited
+    0x72,  # Heating operation comfort
+    0x73,  # Switch-off optimization
+    0x74,  # Heating operation reduced
+    0x75,  # Flow frost protection active
+    0x77,  # Day eco active
+    0x78,  # Setback to reduced
+    0x79,  # Setback to frost protection
+    0x89,  # (Reserved heating state)
+}
+
+BSBLAN_HVAC_ACTION_PREHEATING: Final[set[int]] = {
+    0x6F,  # Switch-on optimization + quick heat-up
+    0x70,  # Switch-on optimization
+    0x71,  # Quick heat-up
+}
+
+BSBLAN_HVAC_ACTION_DRYING: Final[set[int]] = {
+    0x66,  # Screed function active (floor drying)
+}
+
+BSBLAN_HVAC_ACTION_FAN: Final[set[int]] = {
+    0x6B,  # Forced consumption buffer
+    0x6C,  # Forced consumption DHW
+    0x6D,  # Forced consumption generator
+    0x6E,  # Forced consumption
+}
+
+BSBLAN_HVAC_ACTION_COOLING: Final[set[int]] = {
+    0x7F,  # Active cooling mode
+    0x80,  # Passive cooling mode
+    0x81,  # Cooling down evaporator
+    0x84,  # (Cooling related)
+    0x85,  # Dew point monitor active
+    0x86,  # Cooling limit outdoor temp active
+    0x88,  # Cooling mode
+    0x90,  # Cooling operation limited
+    0x91,  # Cooling limit outside temp max active
+    0x94,  # (Reserved cooling state)
+    0x95,  # (Reserved cooling state)
+    0x96,  # Cooling operation comfort
+    0xB1,  # Limit flow min dew point
+    0xB2,  # Limit flow min outdoor temp
+    0xB3,  # Flow limit reached
+    0x8E,  # Recooling via DHW/HC
+    0xC4,  # Limit source temp min cooling
+    0xCF,  # Compressor runtime min active, cooling
+    0xD0,  # Compressor 1 and 2 on, cooling
+    0xD1,  # Compressor 1 on, cooling
+    0xD2,  # Compressor 2 on, cooling
+    0x11D,  # Protection mode cooling
+}
+
+BSBLAN_HVAC_ACTION_OFF: Final[set[int]] = {
+    0x02,  # Fault/error state
+    0x19,  # (Off/standby state)
+    0x76,  # Off
+    0x8C,  # (Off/standby state)
+    0x8A,  # Cooling mode off
+    0x92,  # Cooling operation locked
+    0xA1,  # Heating operation generator off
+    0xA2,  # Heating operation off
+    0xCC,  # Locked, heating mode
+    0xCD,  # Locked, generator
+    0xCE,  # Locked, buffer
+}
+
+BSBLAN_HVAC_ACTION_DEFROSTING: Final[set[int]] = {
+    0x7D,  # Defrost active
+    0x7E,  # Drip-off
+    0x82,  # Pre-heating for defrost
+    0x83,  # (Defrost related)
+    0xCA,  # Frost protection cooling active
+    0xC0,  # Forced defrost compressor
+    0xC1,  # Forced defrost fan
+    0xC2,  # Defrost with compressor
+    0xC3,  # Defrost with fan
+    0x101,  # (Defrost related)
+}
+
 # Error Messages
 NO_STATE_ERROR_MSG: Final[str] = "No state provided."
 NO_SCHEDULE_ERROR_MSG: Final[str] = "No schedule provided."

{python_bsblan-3.1.4 → python_bsblan-3.1.5}/src/bsblan/utility.py

@@ -5,10 +5,7 @@ from __future__ import annotations
 import logging
 import re
 from dataclasses import dataclass, field
-from typing import TYPE_CHECKING, Any
-
-if TYPE_CHECKING:
-    from constants import APIConfig
+from typing import Any
 
 logger = logging.getLogger(__name__)
 
@@ -76,7 +73,8 @@ def validate_time_format(
 class APIValidator:
     """Validates and maintains BSB-LAN API configuration."""
 
-    api_config: APIConfig
+    # Flexible type for API data (accepts `APIConfig`, plain dicts, or None)
+    api_config: Any  # intentionally permissive to support tests and dynamic data
     validated_sections: set[str] = field(default_factory=set)
 
     def validate_section(self, section: str, request_data: dict[str, Any]) -> None:
@@ -89,7 +87,7 @@ class APIValidator:
 
         """
         # Check if the section exists in the APIConfig object
-        if section not in self.api_config:
+        if not self.api_config or section not in self.api_config:
             logger.warning("Unknown section '%s' in API configuration", section)
             return
 
@@ -141,7 +139,7 @@ class APIValidator:
 
     def get_section_params(self, section: str) -> Any:
         """Get the parameter mapping for a section."""
-        return self.api_config.get(section, {}).copy()
+        return (self.api_config or {}).get(section, {}).copy()
 
     def is_section_validated(self, section: str) -> bool:
         """Check if a section has been validated."""