python-bsblan 6.1.10__tar.gz → 6.2.0__tar.gz

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/.github/workflows/codeql.yaml

@@ -27,6 +27,6 @@ jobs:
         with:
           persist-credentials: false
       - name: 🏗 Initialize CodeQL
-        uses: github/codeql-action/init@24c54180a607b1449ed407dd24f251e4e9147c8d # v4.38.3
+        uses: github/codeql-action/init@9b3254085494b55a0f7c4c2b3d2d52cc712ce370 # v4.39.1
       - name: 🚀 Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@24c54180a607b1449ed407dd24f251e4e9147c8d # v4.38.3
+        uses: github/codeql-action/analyze@9b3254085494b55a0f7c4c2b3d2d52cc712ce370 # v4.39.1

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/.github/workflows/release.yaml

@@ -54,7 +54,7 @@ jobs:
         with:
           subject-path: ./dist/*
       - name: 🚀 Publish to PyPi
-        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3
         with:
           verbose: true
           print-hash: true

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/.github/workflows/scorecard.yml

@@ -40,7 +40,7 @@ jobs:
 
       - name: "Run analysis"
         # yamllint disable-line rule:line-length
-        uses: ossf/scorecard-action@2d1146689b8cda280b9bc96326124645441f03bc # v2.4.4
+        uses: ossf/scorecard-action@fa7117db83c52d787ae5a89f350999701505d78e # v2.5.0
         with:
           results_file: results.sarif
           results_format: sarif
@@ -66,6 +66,6 @@ jobs:
       # Upload the results to GitHub's code scanning dashboard (optional).
       - name: "Upload to code-scanning"
         # yamllint disable-line rule:line-length
-        uses: github/codeql-action/upload-sarif@24c54180a607b1449ed407dd24f251e4e9147c8d # v4.38.3
+        uses: github/codeql-action/upload-sarif@9b3254085494b55a0f7c4c2b3d2d52cc712ce370 # v4.39.1
         with:
           sarif_file: results.sarif

python_bsblan-6.2.0/.nvmrc

@@ -0,0 +1 @@
+24.22.1

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: python-bsblan
-Version: 6.1.10
+Version: 6.2.0
 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

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/docs/getting-started.md

@@ -95,6 +95,26 @@ example, on PPS devices). The upper heating bound is the comfort maximum (`716`
 for circuit 1 and `1016` for circuit 2) when the device exposes those
 parameters.
 
+## Reduced setpoint and temporary override
+
+The reduced room setpoint (`712` for circuit 1, `1012` for circuit 2) can be
+written with `temp_reduced_setpoint`. It uses the same bounds as
+`target_temperature`.
+
+To switch a circuit to comfort or reduced only until the next time program
+switch point, write `temporary_mode` (`10110` for circuit 1, `10111` for circuit
+2): `0` (no override), `1` (reduced), or `2` (comfort). The override only has an
+effect in automatic mode and cannot be read back.
+
+```python
+async with BSBLAN(config) as client:
+    await client.thermostat(temp_reduced_setpoint="18.0")
+    await client.thermostat(temporary_mode=2)
+```
+
+Setting `temp_reduced_setpoint` and `temporary_mode` is not supported on PPS
+devices.
+
 ## Cooling setpoint support
 
 Some BSB/LPB controllers expose a cooling comfort setpoint for each heating
@@ -147,6 +167,24 @@ async with BSBLAN(config) as client:
 
 Setting `cooling_operating_mode` is not supported on PPS devices.
 
+## Active setpoints
+
+In automatic mode the controller switches between the comfort setpoint
+(`710`/`1010`) and the reduced setpoint (`712`/`1012`) following the time
+program, and room units can shift it temporarily. `target_temperature` always
+holds the comfort setpoint. The setpoint the controller currently applies is
+exposed as `current_setpoint` (`8741` for circuit 1, `8771` for circuit 2).
+
+Hot water works the same way: `nominal_setpoint` (`1610`) applies during the
+release periods (`1620`) and `reduced_setpoint` (`1612`) outside them. The
+setpoint currently applied is exposed as `dhw_current_setpoint` (`8831`).
+
+```python
+async with BSBLAN(config) as client:
+    state = await client.state(include=["target_temperature", "current_setpoint"])
+    hw_state = await client.hot_water_state(include=["dhw_current_setpoint"])
+```
+
 ## PPS bus support
 
 PPS bus devices are detected from the device metadata returned by BSB-LAN. The

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/examples/control.py

@@ -409,11 +409,9 @@ async def main() -> None:
         # Example: Set device time
         if bsblan.supports_time_sync:
             print("\nSetting device time to current system time")
-            # Get current local system time and format it for BSB-LAN.
-            current_time = datetime.now().replace(microsecond=0)  # noqa: DTZ005
-            formatted_time = current_time.strftime("%d.%m.%Y %H:%M:%S")
-            print(f"Current system time: {formatted_time}")
-            await bsblan.set_time(formatted_time)
+            current_time = datetime.now()  # noqa: DTZ005
+            print(f"Current system time: {current_time:%d.%m.%Y %H:%M:%S}")
+            await bsblan.set_time(current_time)
         else:
             print("\nSkipping device time sync for this bus type")
 

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/examples/fake_bsblan_server.py

@@ -128,6 +128,7 @@ def build_parameter_db(
     # ---- Sensor params ----
     db["8700"] = _param("Outside temp sensor local", "6.1", unit="°C", readonly=1)
     db["8740"] = _param("Room temp 1 actual value", "21.3", unit="°C", readonly=1)
+    db["8741"] = _param("Room setpoint 1", "21.0", unit="°C", readonly=1)
     db["3113"] = _param("Total energy", "7968", unit="kWh", readonly=1)
 
     # ---- Time param (0) ----
@@ -161,6 +162,7 @@ def build_parameter_db(
         db["1663"] = _param("DHW circulation setpoint", "40.0", unit="°C")
         db["1680"] = _param("DHW changeover", "0", desc="---", data_type=1)
         db["8830"] = _param("DHW actual top temp", "48.2", unit="°C", readonly=1)
+        db["8831"] = _param("DHW current setpoint", "50.0", unit="°C", readonly=1)
         db["8820"] = _param(
             "DHW pump state", "255", desc="Off", data_type=1, readonly=1
         )
@@ -219,9 +221,10 @@ def build_parameter_db(
             data_type=1,
             readonly=1,
         )
-        db["8741"] = _param(
+        db["8770"] = _param(
             "Room temp 2 actual value", "19.8", unit="°C", readonly=1
         )
+        db["8771"] = _param("Room setpoint 2", "19.0", unit="°C", readonly=1)
         db["8750"] = _param(
             "HC2 Room1 thermostat mode",
             "1",
@@ -250,7 +253,7 @@ def build_parameter_db(
             data_type=1,
             readonly=1,
         )
-        db["8742"] = _param(
+        db["8800"] = _param(
             "Room temp 3 actual value", "17.5", unit="°C", readonly=1
         )
         db["8751"] = _param(
@@ -340,6 +343,7 @@ class FakeBSBLAN:
                     "1680",
                     "8820",
                     "8830",
+                    "8831",
                 }
             )
 

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/package-lock.json

@@ -12,13 +12,13 @@
         "url-parse": "1.5.10"
       },
       "devDependencies": {
-        "prettier": "3.9.9"
+        "prettier": "3.9.10"
       }
     },
     "node_modules/prettier": {
-      "version": "3.9.9",
-      "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.9.9.tgz",
-      "integrity": "sha512-Z/CJHIkdujO/OtN7nXUii0Rf3VT5SRuhjBA82Xvu2XhBUgX3nhP67T0LHceBdQLex7OOFGTox+Q5Yg8Jk2Qivg==",
+      "version": "3.9.10",
+      "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.9.10.tgz",
+      "integrity": "sha512-skGHTH1Yb9QvaTC4hWnRTzEYtCpApF0UMBPz+t/0ZPzP8ihefo/btKd+QA7pUE0fEwA1SbS/NmhyEcstdXOIdA==",
       "dev": true,
       "license": "MIT",
       "bin": {

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/package.json

@@ -9,7 +9,7 @@
   "author": "WJL van Rootselaar <liudgervr@gmail.com>",
   "license": "MIT",
   "devDependencies": {
-    "prettier": "3.9.9"
+    "prettier": "3.9.10"
   },
   "dependencies": {
     "url-parse": "1.5.10"

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-bsblan"
-version = "6.1.10"
+version = "6.2.0"
 description = "Asynchronous Python client for BSBLAN API"
 authors = [
     {name = "Willem-Jan van Rootselaar", email = "liudgervr@gmail.com"}
@@ -186,7 +186,7 @@ build-backend = "hatchling.build"
 dev = [
     "aresponses==3.0.0",
     "bandit==1.9.4",
-    "black==26.10.0",
+    "black==26.10.1",
     "blacken-docs==1.20.0",
     "codespell==2.4.3",
     "covdefaults==2.3.0",
@@ -197,16 +197,16 @@ dev = [
     # hatch is required to support type hinting and proper packaging of the py.typed file.
     "hatch>=1.14.1",
     "isort==8.0.1",
-    "ty==0.0.86",
+    "ty==0.0.90",
     "prek>=0.3.3",
     "pre-commit-hooks==6.0.0",
-    "pylint==4.1.2",
+    "pylint==4.1.3",
     "pytest>=8.3.5",
     "pytest-asyncio==1.4.0",
     "pytest-cov==7.1.0",
     "pytest-xdist>=3.8.0",
     "pyupgrade==3.22.0",
-    "ruff==0.16.10",
+    "ruff==0.17.1",
     "safety==3.8.1",
     "vulture==2.16",
     "yamllint==1.38.0",

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/src/bsblan/_thermostat.py

@@ -35,7 +35,7 @@ class ThermostatWriter:
         self._temperature = temperature
         self._set_payload = set_payload
 
-    async def prepare_state(  # pylint: disable=too-many-arguments
+    async def prepare_state(  # noqa: PLR0913  # pylint: disable=too-many-arguments
         self,
         target_temperature: str | None,
         hvac_mode: int | None,
@@ -43,6 +43,8 @@ class ThermostatWriter:
         target_temperature_high: str | float | None = None,
         *,
         cooling_operating_mode: int | None = None,
+        temp_reduced_setpoint: str | float | None = None,
+        temporary_mode: int | None = None,
     ) -> dict[str, Any]:
         """Prepare the thermostat state for setting.
 
@@ -53,6 +55,9 @@ class ThermostatWriter:
             target_temperature_high: The cooling comfort setpoint to set.
             cooling_operating_mode: The cooling circuit operating mode to set
                 as raw integer.
+            temp_reduced_setpoint: The reduced (eco) room setpoint to set.
+            temporary_mode: The temporary operating mode override to set as
+                raw integer.
 
         Returns:
             dict[str, Any]: The prepared state for the thermostat.
@@ -69,10 +74,7 @@ class ThermostatWriter:
                 self._set_payload(param_ids["target_temperature"], target_temperature),
             )
         if target_temperature_high is not None:
-            param_id = param_ids.get("target_temperature_high")
-            if param_id is None:
-                parameter_name = "target_temperature_high"
-                raise BSBLANInvalidParameterError(parameter_name)
+            param_id = self._param_id(param_ids, "target_temperature_high")
             await self._temperature.validate_target_temperature_high(
                 target_temperature_high,
                 circuit,
@@ -89,16 +91,35 @@ class ThermostatWriter:
                 self._set_payload(param_ids["hvac_mode"], hvac_value),
             )
         if cooling_operating_mode is not None:
-            param_id = param_ids.get("cooling_operating_mode")
-            if param_id is None:
-                parameter_name = "cooling_operating_mode"
-                raise BSBLANInvalidParameterError(parameter_name)
+            param_id = self._param_id(param_ids, "cooling_operating_mode")
             self.validate_cooling_operating_mode(cooling_operating_mode)
             state.update(
                 self._set_payload(param_id, str(cooling_operating_mode)),
             )
+        if temp_reduced_setpoint is not None:
+            param_id = self._param_id(param_ids, "temp_reduced_setpoint")
+            await self._temperature.validate_target_temperature(
+                str(temp_reduced_setpoint),
+                circuit,
+            )
+            state.update(
+                self._set_payload(param_id, str(temp_reduced_setpoint)),
+            )
+        if temporary_mode is not None:
+            param_id = self._param_id(param_ids, "temporary_mode")
+            self.validate_temporary_mode(temporary_mode)
+            state.update(
+                self._set_payload(param_id, str(temporary_mode)),
+            )
         return state
 
+    @staticmethod
+    def _param_id(param_ids: dict[str, str], parameter_name: str) -> str:
+        """Return the parameter ID for a write, or raise if unsupported."""
+        if (param_id := param_ids.get(parameter_name)) is None:
+            raise BSBLANInvalidParameterError(parameter_name)
+        return param_id
+
     def thermostat_params(self, circuit: int) -> dict[str, str]:
         """Return thermostat write parameters for the active bus type."""
         if self._uses_pps_bus():
@@ -135,3 +156,17 @@ class ThermostatWriter:
         """
         if cooling_operating_mode not in Validation.COOLING_OPERATING_MODES:
             raise BSBLANInvalidParameterError(str(cooling_operating_mode))
+
+    def validate_temporary_mode(self, temporary_mode: int) -> None:
+        """Validate the temporary operating mode override.
+
+        Args:
+            temporary_mode (int): The mode to validate. Valid values are
+                0=No override, 1=Reduced, 2=Comfort.
+
+        Raises:
+            BSBLANInvalidParameterError: If the mode is invalid.
+
+        """
+        if temporary_mode not in Validation.TEMPORARY_MODES:
+            raise BSBLANInvalidParameterError(str(temporary_mode))

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/src/bsblan/_validation.py

@@ -233,7 +233,7 @@ class SectionValidator:
 
         This enables more granular lazy loading for hot water - instead of
         validating all 29 hot water parameters at once, we only validate
-        the specific group needed (essential: 5, config: 16, schedule: 8).
+        the specific group needed (essential: 6, config: 16, schedule: 8).
 
         Uses a per-group lock to prevent concurrent validation of the same
         group, which could cause duplicate network requests.

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/src/bsblan/bsblan.py

@@ -51,9 +51,10 @@ from .models import (
     State,
     StaticState,
 )
-from .utility import is_param_value_active, validate_time_format
+from .utility import is_param_value_active
 
 if TYPE_CHECKING:
+    from datetime import datetime
     from typing import Self
 
     from aiohttp.client import ClientSession
@@ -171,7 +172,20 @@ class BSBLAN:
         if self.session is None:
             self.session = aiohttp.ClientSession()
             self._close_session = True
-        await self.initialize()
+        try:
+            await self.initialize()
+        except BaseException:
+            if self._close_session and self.session:
+                session = self.session
+                self.session = None
+                self._close_session = False
+                try:
+                    await session.close()
+                except Exception:
+                    logger.exception(
+                        "Failed to close session after initialization failure"
+                    )
+            raise
         return self
 
     async def __aexit__(self, *args: object) -> None:
@@ -332,7 +346,7 @@ class BSBLAN:
 
         This enables more granular lazy loading for hot water - instead of
         validating all 29 hot water parameters at once, we only validate
-        the specific group needed (essential: 5, config: 16, schedule: 8).
+        the specific group needed (essential: 6, config: 16, schedule: 8).
 
         Uses a per-group lock to prevent concurrent validation of the same
         group, which could cause duplicate network requests.
@@ -720,7 +734,7 @@ class BSBLAN:
             include: Optional list of parameter names to fetch. If None,
                 fetches all state parameters. Valid names include:
                 hvac_mode, target_temperature, hvac_action,
-                hvac_mode_changeover, current_temperature,
+                hvac_mode_changeover, current_temperature, current_setpoint,
                 room1_temp_setpoint_boost.
             circuit: The heating circuit number (1 or 2). Defaults to 1.
                 Circuit 2 uses separate parameter IDs but returns the
@@ -782,15 +796,17 @@ class BSBLAN:
         Args:
             include: Optional list of parameter names to fetch. If None,
                 fetches all static parameters. Valid names include:
-                min_temp, max_temp.
+                temp_reduced_setpoint, heating_protective_setpoint,
+                comfort_setpoint_max, cooling_comfort_setpoint_min,
+                cooling_reduced_setpoint, and min_temp, max_temp on PPS.
             circuit: The heating circuit number (1 or 2). Defaults to 1.
 
         Returns:
             StaticState: The static information from the BSBLAN device.
 
         Example:
-            # Fetch only min_temp
-            static = await client.static_values(include=["min_temp"])
+            # Fetch only the reduced setpoint
+            static = await client.static_values(include=["temp_reduced_setpoint"])
 
             # Fetch static values for heating circuit 2
             static_hc2 = await client.static_values(circuit=2)
@@ -847,26 +863,33 @@ class BSBLAN:
         time_data = {"time": data["0"]}
         return DeviceTime.model_validate(time_data)
 
-    async def set_time(self, time_value: str) -> None:
+    async def set_time(self, value: datetime) -> None:
         """Set the time on the BSB-LAN device.
 
         Args:
-            time_value (str): The time value to set in format "DD.MM.YYYY HH:MM:SS"
-                (e.g., "13.08.2025 10:25:55").
+            value (datetime): The local time of the heating system. Its date and
+                time are written as they are, without timezone conversion.
 
         Raises:
-            BSBLANInvalidParameterError: If the time format is invalid.
+            BSBLANInvalidParameterError: If the year is out of range.
+            BSBLANError: If the device does not accept the new time.
 
         """
         await self._ensure_device_metadata()
         self._validate_time_sync_supported()
-        self._validate_time_format(time_value)
+        if not Validation.MIN_YEAR <= value.year <= Validation.MAX_YEAR:
+            msg = f"Invalid year: {value.year}"
+            raise BSBLANInvalidParameterError(msg)
+        # BSB-LAN 4.1 rejects a space between the date and the time
         response = await self._request(
-            base_path="/JS", data=self._set_payload("0", time_value)
+            base_path="/JS",
+            data=self._set_payload("0", value.strftime("%d.%m.%Y_%H:%M:%S")),
         )
         logger.debug("Response for setting time: %s", response)
+        if response.get("0", {}).get("status") != 1:
+            raise BSBLANError(ErrorMsg.TIME_SYNC_FAILED)
 
-    async def thermostat(  # pylint: disable=too-many-arguments
+    async def thermostat(  # noqa: PLR0913  # pylint: disable=too-many-arguments
         self,
         target_temperature: str | None = None,
         hvac_mode: int | None = None,
@@ -874,6 +897,8 @@ class BSBLAN:
         target_temperature_high: str | float | None = None,
         *,
         cooling_operating_mode: int | None = None,
+        temp_reduced_setpoint: str | float | None = None,
+        temporary_mode: int | None = None,
     ) -> None:
         """Change the state of the thermostat through BSB-Lan.
 
@@ -888,6 +913,12 @@ class BSBLAN:
             cooling_operating_mode: The cooling circuit operating mode to set
                 as raw integer value: 0=Protection, 1=Automatic, 2=Reduced,
                 3=Comfort. Not supported on PPS devices.
+            temp_reduced_setpoint: The reduced (eco) room setpoint to set.
+                Not supported on PPS devices.
+            temporary_mode: Temporary operating mode override, active until
+                the next time program switch point. Raw integer value:
+                0=No override, 1=Reduced, 2=Comfort. Only has an effect in
+                automatic mode. Not supported on PPS devices.
 
         Example:
             # Set HC1 temperature
@@ -899,6 +930,12 @@ class BSBLAN:
             # Set HC1 cooling operating mode
             await client.thermostat(cooling_operating_mode=1)
 
+            # Set HC1 reduced setpoint
+            await client.thermostat(temp_reduced_setpoint="18.0")
+
+            # Switch HC1 to comfort until the next time program switch point
+            await client.thermostat(temporary_mode=2)
+
             # Set HC2 mode
             await client.thermostat(hvac_mode=1, circuit=2)
 
@@ -906,13 +943,14 @@ class BSBLAN:
         self._validate_circuit(circuit)
         if self._uses_pps_bus:
             self._validate_bus_write_supported()
-        await self._initialize_temperature_range(circuit)
 
         self._validate_single_parameter(
             target_temperature,
             hvac_mode,
             target_temperature_high,
             cooling_operating_mode,
+            temp_reduced_setpoint,
+            temporary_mode,
             error_msg=ErrorMsg.MULTI_PARAMETER,
         )
 
@@ -922,6 +960,8 @@ class BSBLAN:
             circuit,
             target_temperature_high,
             cooling_operating_mode=cooling_operating_mode,
+            temp_reduced_setpoint=temp_reduced_setpoint,
+            temporary_mode=temporary_mode,
         )
         await self._set_device_state(state)
 
@@ -960,21 +1000,6 @@ class BSBLAN:
             circuit,
         )
 
-    def _validate_time_format(self, time_value: str) -> None:
-        """Validate the time format.
-
-        Args:
-            time_value (str): The time value to validate.
-
-        Raises:
-            BSBLANInvalidParameterError: If the time format is invalid.
-
-        """
-        try:
-            validate_time_format(time_value, Validation.MIN_YEAR, Validation.MAX_YEAR)
-        except ValueError as err:
-            raise BSBLANInvalidParameterError(str(err)) from err
-
     def _set_payload(
         self, parameter: str, value: str, type_: str = "1"
     ) -> dict[str, Any]:
@@ -1010,14 +1035,15 @@ class BSBLAN:
         that are typically checked frequently for monitoring purposes.
         This reduces API calls and improves performance for regular polling.
 
-        Uses granular lazy loading - only validates the 5 essential params,
+        Uses granular lazy loading - only validates the 6 essential params,
         not all 29 hot water parameters.
 
         Args:
             include: Optional list of parameter names to fetch. If None,
                 fetches all essential hot water parameters. Valid names include:
                 operating_mode, nominal_setpoint, release,
-                dhw_actual_value_top_temperature, state_dhw_pump.
+                dhw_actual_value_top_temperature, dhw_current_setpoint,
+                state_dhw_pump.
 
         Returns:
             HotWaterState: Essential hot water state information.

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/src/bsblan/constants.py

@@ -45,6 +45,7 @@ BASE_HEATING_PARAMS: Final[dict[str, str]] = {
     # -------
     "8000": "hvac_action",
     "8740": "current_temperature",
+    "8741": "current_setpoint",
     "770": "room1_temp_setpoint_boost",
 }
 
@@ -90,6 +91,7 @@ BASE_HOT_WATER_PARAMS: Final[dict[str, str]] = {
     "1680": "operating_mode_changeover",
     # -------
     "8830": "dhw_actual_value_top_temperature",
+    "8831": "dhw_current_setpoint",
     "8820": "state_dhw_pump",
     # -------
     "561": "dhw_time_program_monday",
@@ -113,6 +115,7 @@ BASE_HEATING_CIRCUIT2_PARAMS: Final[dict[str, str]] = {
     # -------
     "8001": "hvac_action",
     "8770": "current_temperature",
+    "8771": "current_setpoint",
     "1070": "room1_temp_setpoint_boost",
 }
 
@@ -181,12 +184,16 @@ class CircuitConfig:
             "target_temperature_high": "902",
             "hvac_mode": "700",
             "cooling_operating_mode": "901",
+            "temp_reduced_setpoint": "712",
+            "temporary_mode": "10110",
         },
         2: {
             "target_temperature": "1010",
             "target_temperature_high": "1202",
             "hvac_mode": "1000",
             "cooling_operating_mode": "1201",
+            "temp_reduced_setpoint": "1012",
+            "temporary_mode": "10111",
         },
     }
     PROBE_PARAMS: Final[dict[int, str]] = {
@@ -252,6 +259,9 @@ class Validation:
     # 901/1201 cooling circuit operating mode (ENUM, verified on device):
     # 0=Protection, 1=Automatic, 2=Reduced, 3=Comfort
     COOLING_OPERATING_MODES: Final[set[int]] = {0, 1, 2, 3}
+    # 10110/10111 temporary operating mode (write-only, verified on device):
+    # 0=No override, 1=Reduced, 2=Comfort, until the next time program switch
+    TEMPORARY_MODES: Final[set[int]] = {0, 1, 2}
     PPS_HVAC_MODES: Final[set[int]] = {0, 1, 3}
     PPS_HVAC_MODE_TO_BSBLAN: Final[dict[int, str]] = {
         0: "2",  # off
@@ -415,19 +425,20 @@ _STATUS_TO_CATEGORY: dict[HeatingCircuitStatus, HVACActionCategory] = {
     # Off states
     HeatingCircuitStatus.FAULT_ERROR: HVACActionCategory.OFF,
     HeatingCircuitStatus.STANDBY_1: HVACActionCategory.OFF,
-    HeatingCircuitStatus.OFF: HVACActionCategory.OFF,
     HeatingCircuitStatus.STANDBY_2: HVACActionCategory.OFF,
     HeatingCircuitStatus.COOLING_OFF: HVACActionCategory.OFF,
-    HeatingCircuitStatus.COOLING_LOCKED: HVACActionCategory.OFF,
     HeatingCircuitStatus.HEATING_GENERATOR_OFF: HVACActionCategory.OFF,
     HeatingCircuitStatus.HEATING_OFF: HVACActionCategory.OFF,
-    HeatingCircuitStatus.LOCKED_HEATING_MODE: HVACActionCategory.OFF,
-    HeatingCircuitStatus.LOCKED_GENERATOR: HVACActionCategory.OFF,
-    HeatingCircuitStatus.LOCKED_BUFFER: HVACActionCategory.OFF,
-    HeatingCircuitStatus.DAY_ECO: HVACActionCategory.OFF,
-    HeatingCircuitStatus.SETBACK_REDUCED: HVACActionCategory.OFF,
-    HeatingCircuitStatus.SETBACK_FROST_PROTECTION: HVACActionCategory.OFF,
-    HeatingCircuitStatus.ROOM_TEMPERATURE_LIMIT: HVACActionCategory.OFF,
+    # Idle states: the circuit runs but currently needs no heat
+    HeatingCircuitStatus.OFF: HVACActionCategory.IDLE,  # summer operation
+    HeatingCircuitStatus.COOLING_LOCKED: HVACActionCategory.IDLE,
+    HeatingCircuitStatus.LOCKED_HEATING_MODE: HVACActionCategory.IDLE,
+    HeatingCircuitStatus.LOCKED_GENERATOR: HVACActionCategory.IDLE,
+    HeatingCircuitStatus.LOCKED_BUFFER: HVACActionCategory.IDLE,
+    HeatingCircuitStatus.DAY_ECO: HVACActionCategory.IDLE,
+    HeatingCircuitStatus.SETBACK_REDUCED: HVACActionCategory.IDLE,
+    HeatingCircuitStatus.SETBACK_FROST_PROTECTION: HVACActionCategory.IDLE,
+    HeatingCircuitStatus.ROOM_TEMPERATURE_LIMIT: HVACActionCategory.IDLE,
     # Heating states
     HeatingCircuitStatus.MANUAL_CONTROL: HVACActionCategory.HEATING,
     HeatingCircuitStatus.OVERRUN: HVACActionCategory.HEATING,
@@ -550,6 +561,7 @@ class ErrorMsg:
     )
     NO_HEATING_SCHEDULE_PARAMS = "No heating schedule parameters available"
     TIME_SYNC_NOT_SUPPORTED = "Time synchronization is not supported by this device"
+    TIME_SYNC_FAILED = "The device did not accept the new time"
     BUS_WRITE_NOT_SUPPORTED = "Writing parameters is not supported by this device"
 
 
@@ -642,6 +654,7 @@ class HotWaterParams:
             "nominal_setpoint",
             "release",
             "dhw_actual_value_top_temperature",
+            "dhw_current_setpoint",
             "state_dhw_pump",
         }
     }

{python_bsblan-6.1.10 → python_bsblan-6.2.0}/src/bsblan/models.py

@@ -481,6 +481,8 @@ class State(BaseModel):
     # (0=Protection, 1=Automatic, 2=Reduced, 3=Comfort)
     cooling_operating_mode: EntityInfo[int] | None = None
     current_temperature: EntityInfo[float] | None = None
+    # 8741/8771: room setpoint currently applied by the controller
+    current_setpoint: EntityInfo[float] | None = None
     room1_temp_setpoint_boost: EntityInfo[float] | None = None
 
 
@@ -525,6 +527,7 @@ class HotWaterState(BaseModel):
     nominal_setpoint: EntityInfo[float] | None = None
     release: EntityInfo[int] | None = None
     dhw_actual_value_top_temperature: EntityInfo[float] | None = None
+    dhw_current_setpoint: EntityInfo[float] | None = None
     state_dhw_pump: EntityInfo[int] | None = None