{"record":{"id":"06b80654d7b15b2c","repo":"home-assistant/core","slug":"setup-outdated-firmware","errorCode":"setup_outdated_firmware","errorMessage":"Your BSB-LAN device is running firmware {firmware_version}, which is no longer supported. Please update your BSB-LAN board firmware to a newer version to keep using this integration.","messagePattern":"Your BSB-LAN device is running firmware (.+?), which is no longer supported\\. Please update your BSB-LAN board firmware to a newer version to keep using this integration\\.","errorType":"exception","errorClass":"ConfigEntryError","httpStatus":null,"severity":"error","filePath":"homeassistant/components/bsblan/__init__.py","lineNumber":217,"sourceCode":"            translation_key=\"setup_connection_error\",\n            translation_placeholders={\"host\": entry.data[CONF_HOST]},\n        ) from err\n    except BSBLANAuthError as err:\n        raise ConfigEntryAuthFailed(\n            translation_domain=DOMAIN,\n            translation_key=\"setup_auth_error\",\n        ) from err\n    except TimeoutError as err:\n        raise ConfigEntryNotReady(\n            translation_domain=DOMAIN,\n            translation_key=\"setup_connection_error\",\n            translation_placeholders={\"host\": entry.data[CONF_HOST]},\n        ) from err\n    except BSBLANVersionError as err:\n        # The device does not report a supported JSON-API version, so the\n        # integration cannot operate. Surface a clear, actionable error.\n        firmware_version = bsblan.device_info.version if bsblan.device_info else None\n        raise ConfigEntryError(\n            translation_domain=DOMAIN,\n            translation_key=\"setup_outdated_firmware\",\n            translation_placeholders={\n                \"firmware_version\": firmware_version or \"unknown\"\n            },\n        ) from err\n    except BSBLANError as err:\n        raise ConfigEntryError(\n            translation_domain=DOMAIN,\n            translation_key=\"setup_general_error\",\n        ) from err\n\n    # Devices below JSON-API v2 operate with a reduced single-circuit feature\n    # set. Surface (or clear) the repair issue recommending a firmware upgrade.\n    _async_manage_outdated_firmware_issue(\n        hass, entry, device.version, bsblan.json_api_version\n    )\n","sourceCodeStart":199,"sourceCodeEnd":235,"githubUrl":"https://github.com/home-assistant/core/blob/58a3fdb3ea0538617f0a07efcfba6294de64fd59/homeassistant/components/bsblan/__init__.py#L199-L235","documentation":"Raised during bsblan setup when the device reports a JSON-API version python-bsblan does not support (BSBLANVersionError), mapped to ConfigEntryError with translation key `setup_outdated_firmware` and the device's firmware version (or 'unknown' if unavailable). Unlike NotReady errors, this is a hard failure: the integration cannot operate until the BSB-LAN firmware is updated. A repair issue is also created recommending the upgrade.","triggerScenarios":"Loading a bsblan entry against a board running firmware so old that its JSON API version is below what the python-bsblan library supports (or a brand-new API version the library has not learned yet). `bsblan.device_info.version` is used for the placeholder when already fetched.","commonSituations":"Users who installed BSB-LAN years ago and never updated the sketch; a newly flashed device with an old saved config; or conversely a brand-new firmware ahead of the pinned python-bsblan release.","solutions":["Update the BSB-LAN firmware on the device (see bsblan.friedrich-programme.de docs) to a version with a supported JSON API.","Reload the integration after the firmware update; if a repair issue exists, it clears automatically.","If firmware is already newest and the error persists, the HA bsblan integration/python-bsblan may lag behind — update Home Assistant to get a newer library."],"exampleFix":null,"handlingStrategy":"validation","validationCode":"# confirm the device's JSON API version before adding the entry\nimport bsblan\nclient = bsblan.BSBLan(host, user, pass_)\nprint(await client.api_version())","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Check the BSB-LAN release notes for supported JSON API versions before updating HA or firmware.","Update BSB-LAN firmware promptly when the integration's minimum supported version changes.","Read the repair issue HA raises — it names the exact firmware version needed."],"tags":["home-assistant","bsblan","firmware","version","setup"],"backgroundTag":null,"analyzedSha":"58a3fdb3ea0538617f0a07efcfba6294de64fd59","analyzedAt":"2026-08-14T20:54:38.818Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}