Handle empty BSB-LAN heating circuits

[liudger]

Breaking change

Proposed change

The previous python lib bump did solve the issue but would not trigger a reconfigure.
This update is a fix that checks if climate entity has an empty list and do a minor version bump.
As this is a bug fix I would like to have this in the next sub release. Thanks!

(generated)

Details

This pull request improves the robustness of the BSBLan integration by ensuring that heating circuit discovery always falls back to a safe default when no circuits are found, and by updating the configuration flow and migration logic to handle empty or missing circuit lists. It also bumps the config entry minor version to 3 and adds comprehensive test coverage for these scenarios.

Core logic and configuration improvements:

• Introduced a new constant DEFAULT_HEATING_CIRCUITS (set to (1,)) to consistently represent the default heating circuit, and updated all relevant logic to use this constant instead of hardcoded lists. [1] [2] [3]
• Updated the config flow and migration logic to fall back to DEFAULT_HEATING_CIRCUITS whenever circuit discovery returns an empty list or fails, ensuring every setup has at least one circuit. [1] [2] [3] [4] [5]
• Added a migration step (minor version 1.3) to repair entries that have an empty circuit list, defaulting them to [1] and updating the minor version. [1] [2]

Testing improvements:

• Added new tests to verify that the integration correctly falls back to the default circuit when circuit discovery returns an empty list, both during initial setup, reconfiguration, and migration. [1] [2] [3] [4]
• Updated existing tests and fixtures to reflect the new minor version and default circuit handling. [1] [2] [3]

These changes ensure that the BSBLan integration is more resilient to device quirks and configuration edge cases, and that users will always have at least one heating circuit configured.

Type of change

• Dependency upgrade
• Bugfix (non-breaking change which fixes an issue)
• New integration (thank you!)
• New feature (which adds functionality to an existing integration)
• Deprecation (breaking change to happen in the future)
• Breaking change (fix/feature causing existing functionality to break)
• Code quality improvements to existing code or addition of tests

Additional information

• This PR fixes or closes issue: fixes bsblan climate entity permanently unavailable after upgrade to 2026.5.0 #170056
• This PR is related to issue:
• Link to documentation pull request:
• Link to developer documentation pull request:
• Link to frontend pull request:

Checklist

• I understand the code I am submitting and can explain how it works.
• The code change is tested and works locally.
• Local tests pass. Your PR cannot be merged unless tests pass
• There is no commented out code in this PR.
• I have followed the development checklist
• I have followed the perfect PR recommendations
• The code has been formatted using Ruff (ruff format homeassistant tests)
• Tests have been added to verify that the new code works.
• Any generated code has been carefully reviewed for correctness and compliance with project standards.

If user exposed functionality or configuration variables are added/changed:

• Documentation added/updated for www.home-assistant.io

If the code communicates with devices, web services, or third-party tools:

• The manifest file has all fields filled out correctly.
  Updated and included derived files by running: python3 -m script.hassfest.
• New or updated dependencies have been added to requirements_all.txt.
  Updated by running python3 -m script.gen_requirements_all.
• For the updated dependencies a diff between library versions and ideally a link to the changelog/release notes is added to the PR description.

To help with the load of incoming pull requests:

• I have reviewed two other open pull requests in this repository.

[Copilot]

Pull request overview

This pull request improves robustness of the bsblan integration when heating circuit discovery returns an empty list, ensuring setup/migration/reconfigure always fall back to a safe default circuit and that affected config entries are migrated forward.

Changes:

• Introduce DEFAULT_HEATING_CIRCUITS and use it consistently across config flow, setup, and migration.
• Bump the config entry minor version to 1.3 and add a migration step to repair entries that stored an empty heating_circuits list.
• Add/adjust tests covering empty discovery results in config flows and during config entry migration.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
homeassistant/components/bsblan/const.py	Adds a single source of truth for the default heating circuits.
homeassistant/components/bsblan/config_flow.py	Bumps minor version and ensures empty discovery results fall back to the default circuits.
homeassistant/components/bsblan/__init__.py	Ensures runtime setup and migrations recover from missing/empty circuits and bumps migration minor version to 3.
tests/components/bsblan/conftest.py	Updates test config entries to the new minor version.
tests/components/bsblan/test_config_flow.py	Adds coverage for empty circuit discovery during initial setup and reconfigure.
tests/components/bsblan/test_init.py	Adds coverage for migration behavior when discovery returns empty and when stored circuits are empty.

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated no new comments.