Phase 2: Split energy counters (heating vs DHW)

[liudger]

Phase 2: Split Energy Counters (Heating / DHW)

Priority: 🟡 Medium
Scope: Library + HA integration
Depends on: Phase 0 (#1372)
Parent: #1371

Goal

Add separate energy counters for heating and DHW (domestic hot water), enabling users to track energy consumption per function. Currently only the total energy counter (param 3113) is exposed.

Background

BSB-LAN parameter 3113 provides total cumulative energy in 1 kWh steps — this is a hardware limitation of the meter. By exposing the split counters, users can at least see the breakdown between heating and DHW energy consumption.

New Parameters

Param ID	Name	Unit	Description
3124	energy_heating	kWh	Cumulative energy used for heating
3125	energy_dhw	kWh	Cumulative energy used for DHW

Tasks

Library (python-bsblan)

• Add params 3124 and 3125 to constants.py → BASE_SENSOR_PARAMS
• Add fields to Sensor model in models.py:

  energy_heating: EntityInfo[int] | None = None
  energy_dhw: EntityInfo[int] | None = None

• Verify UNIT_DEVICE_CLASS_MAP already maps kWh → energy ✅
• Verify UNIT_STATE_CLASS_MAP already maps kWh → total_increasing ✅
• Add tests and fixtures
• Run uv run prek run --all-files

HA Integration

• Update sensor.py — new energy sensor entities
• Ensure state_class=TOTAL_INCREASING for HA energy dashboard compatibility
• Test that these appear in the HA Energy dashboard
• Add tests

Acceptance Criteria

• energy_heating and energy_dhw available as separate HA sensor entities
• Both sensors compatible with HA Energy Dashboard
• state_class is total_increasing for proper long-term statistics
• Devices without these counters gracefully skip them (lazy validation)

Notes

• These counters likely have the same 1 kWh resolution as param 3113
• For finer resolution, users need the Tier 2 approach (compressor modulation × rated power) — tracked separately if param 3197 becomes available

[github-actions]

There hasn't been any activity on this issue recently, so we clean up some of the older and inactive issues.
Please make sure to update to the latest version and check if that solves the issue. Let us know if that works for you by leaving a comment 👍
This issue has now been marked as stale and will be closed if no further activity occurs. Thanks!