Feature Roadmap: python-bsblan & Home Assistant Integration

[liudger]

Feature Roadmap: python-bsblan & Home Assistant BSB-LAN Integration

This is the tracking issue for the feature roadmap covering both the python-bsblan library and the Home Assistant BSB-LAN integration.

The roadmap is based on gap analysis between current library capabilities and real-world user needs (community feedback, blog posts, forum discussions).

Phases Overview

Phase	Title	Priority	Scope
0	Ship multi-circuit support to HA	🔴 Critical	HA integration
1	Extended diagnostic sensors	🟠 High	Library + HA
2	Split energy counters (heating/DHW)	🟡 Medium	Library + HA
3	Heating circuit time programs	🟡 Medium	Library + HA
4	Smart grid / energy tariff support	🔵 Low	Library + HA
5	Number & select entities in HA	🟡 Medium	HA integration

Guiding Principles

• Lazy loading: New parameters are validated on-demand, not at startup
• Granular groups: Split large parameter sets into meaningful groups (like hot water essential/config/schedule)
• Backwards compatible: New features don't break existing installations
• 100% patch coverage: All new code must be fully tested

Dependencies

• Phase 0 is the current add-dual-heating-support branch — must land first
• Phases 1-3 can be worked in parallel after Phase 0
• Phase 4 depends on Phase 2 (energy counters foundation)
• Phase 5 depends on Phases 1-3 (needs the entities to exist first)

References

• Matt's BSB-LAN monitoring blog
• BSB-LAN firmware
• HA BSB-LAN integration