Phase 1: Extended diagnostic sensors (flow temps, compressor stats)

[liudger]

Phase 1: Extended Diagnostic Sensors

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

Goal

Add the most commonly monitored diagnostic parameters as sensor entities, covering flow temperatures, compressor statistics, and heat pump status. These are the parameters that power users (like Matt's Grafana dashboards) monitor regularly.

New Parameters

Flow & Return Temperatures (fast poll)

Param ID	Name	Unit	Description
8410	flow_temperature_hc1	°C	HC1 flow temperature
8412	return_temperature	°C	Return temperature
8744	flow_temperature_hc2	°C	HC2 flow temperature (multi-circuit)

Compressor & Runtime Stats (slow poll)

Param ID	Name	Unit	Description
8450	compressor_starts	count	Number of compressor starts
8451	compressor_running_time	hours	Total compressor runtime
8336	compressor_speed	%	Current compressor modulation

Heat Pump Status (fast poll)

Param ID	Name	Unit	Description
8006	heat_pump_status	enum	Current heat pump status/mode

Additional Outside Temp Variants (slow poll)

Param ID	Name	Unit	Description
8701	outside_temperature_min	°C	Minimum outside temp (24h)
8702	outside_temperature_max	°C	Maximum outside temp (24h)
8703	outside_temperature_damped	°C	Damped (averaged) outside temp

Tasks

Library (python-bsblan)

• Add parameter IDs to constants.py → BASE_SENSOR_PARAMS (or create EXTENDED_SENSOR_PARAMS)
• Consider splitting sensors into groups (like hot water essential/config/schedule pattern)
  • SENSOR_TEMPERATURE_PARAMS — temperatures (fast poll)
  • SENSOR_DIAGNOSTIC_PARAMS — compressor stats, status (slow poll)
• Add fields to Sensor model in models.py
• Implement lazy loading for new sensor groups
• Add unit/device class mappings if needed (most units already mapped)
• Add tests and fixtures
• Run uv run prek run --all-files

HA Integration

• Update sensor.py — create sensor entities for new parameters
• Set appropriate device_class, state_class, native_unit_of_measurement
• Add compressor_starts as SensorStateClass.TOTAL_INCREASING
• Add compressor_running_time as SensorStateClass.TOTAL_INCREASING
• Update coordinator polling to include new sensor groups
• Add tests

Acceptance Criteria

• All listed parameters available as HA sensor entities
• Correct device classes and state classes for each sensor
• Flow temperatures update on fast poll interval
• Diagnostic stats update on slow poll interval
• Parameters that don't exist on a specific device are gracefully skipped (lazy validation)

[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!