Add BL/WW circuit support with circuit-type sensor filtering (v0.13.0)

Merge community PR #2 (BL + WW circuits) with added circuit_types filter
to prevent sensors appearing on wrong circuit types. Bump version to 0.13.0.

New sensors: BL (temp, operating hours, energy), WW (temp top/bottom),
HK (flow temp, room temp target). Energy unit (MWh) pending verification.

Co-Authored-By: Babur <bduisenov@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: 3 people

CLAUDE.md

@@ -29,7 +29,7 @@ The integration lives in `custom_components/hoval_connect/`. User setup is email
 - `climate.py` — HK heating: target temp, HVAC modes (heat/auto/off)
 - `fan.py` — HV ventilation: speed slider 0–100%, on/off (standby ↔ temporary-change), debounced 1.5s
 - `select.py` — Program selection (week1/week2/ecoMode/standby/constant) with user-defined names
-- `sensor.py` — 9 per circuit + 6 plant-level sensors (events, weather)
+- `sensor.py` — Circuit-type-filtered sensors (HV/HK/BL/WW) + 6 plant-level sensors (events, weather)
 - `binary_sensor.py` — Plant online status + error/warning status
 - `diagnostics.py` — Diagnostic export with PII redaction
 - `const.py` — API URLs, OAuth client ID, token TTLs, polling interval, circuit types, duration enums
@@ -40,7 +40,8 @@ The integration lives in `custom_components/hoval_connect/`. User setup is email
 - Entities use `CoordinatorEntity` — no direct API calls, all data comes from the coordinator
 - Device hierarchy: one parent device per plant, one child device per plant+circuit (linked via `via_device`)
 - Circuit devices identified by `{plantId}_{circuitPath}`
-- Supports HV (ventilation) and HK (heating) circuit types (`SUPPORTED_CIRCUIT_TYPES` in `const.py`)
+- Supports HV (ventilation), HK (heating), BL (boiler), and WW (warm water) circuit types (`SUPPORTED_CIRCUIT_TYPES` in `const.py`)
+- Sensor descriptions use `circuit_types: frozenset[str] | None` to filter which sensors appear on which circuit types (`None` = all types)
 - Fan speed resolution uses smart fallback chain: live airVolume → targetAirVolume → program air volume → default 40% (API rejects value=0)
 - All entity platforms use `translation_key` for entity names (not hardcoded `_attr_name`)
 - Dynamic entity discovery: all platforms listen to `SIGNAL_NEW_CIRCUITS` dispatcher signal to add entities at runtime without restart
@@ -115,5 +116,6 @@ HK (heating), BL (boiler), WW (warm water), FRIWA (fresh water), HV (ventilation
 - Energy stats return empty for HV circuit (likely only relevant for HK/WW/SOL)
 - `business/plants/{id}/plant-structure` needs business role
 - Full OpenAPI 3.1 spec saved at `docs/openapi-v3.json` (also available live at `/v3/api-docs`, no auth required)
-- Non-supported circuit types (BL, WW, FRIWA, SOL, SOLB, PS) have endpoint support in the API but no HA entities yet
+- Non-supported circuit types (FRIWA, SOL, SOLB, PS) have endpoint support in the API but no HA entities yet
+- BL energy sensors (`heatAmount`, `totalEnergy`) use MWh — unit not verified against raw API values
 - HK climate entity: `set_temperature` sends value as integer — may need adjustment for different HK circuit models (some use tenths of degree)

README.md

@@ -37,10 +37,12 @@ Plants and circuits are discovered automatically from your account.
 - Shows user-defined program names from the Hoval app
 - Current program pre-selected
 
-**Sensor entities** (per circuit):
-- Outside temperature, exhaust temperature
-- Air volume, humidity (actual), humidity (target)
-- Operation mode, active week program, active day program, program air volume
+**Sensor entities** (per circuit, filtered by type):
+- **HV:** Outside temperature, exhaust temperature, air volume, humidity (actual/target), program air volume
+- **HK:** Outside temperature, flow temperature (actual/target), room temperature setpoint
+- **BL:** Heat generator temperature (actual/target), return temperature, operating hours, operating hours >50%, switching cycles, heat produced, electrical energy consumed
+- **WW:** Hot water setpoint, tank temperature top (SF1), tank temperature bottom (SF2)
+- **All:** Operation mode, active week program, active day program
 
 **Plant-level sensors:**
 - Weather condition and forecast temperature
@@ -69,7 +71,8 @@ Plants and circuits are discovered automatically from your account.
 
 ### Known Limitations
 
-- **HV and HK circuits only.** Boiler (BL), warm water (WW), solar (SOL), and other circuit types are not yet implemented.
+- **HV, HK, BL, and WW circuits only.** Solar (SOL), fresh water (FRIWA), and other circuit types are not yet implemented.
+- **BL energy sensors (MWh):** Heat produced and electrical energy consumed are displayed in MWh — unit not yet verified against all Hoval models, may need adjustment.
 - **No time program editing.** Time programs can be read but not modified through the integration.
 - **No energy/temperature history.** Historical statistics endpoints are documented but not yet integrated.
 - **No holiday mode control.**

custom_components/hoval_connect/manifest.json

@@ -9,5 +9,5 @@
   "iot_class": "cloud_polling",
   "issue_tracker": "https://github.com/trcyberoptic/hoval-connect-api/issues",
   "requirements": [],
-  "version": "0.12.3"
+  "version": "0.13.0"
 }