{"record":{"id":"fc9926ae7f0dce52","repo":"home-assistant/core","slug":"update-error-fc9926","errorCode":"update_error","errorMessage":"An error occurred while retrieving data from the {device} printer: {error}","messagePattern":"An error occurred while retrieving data from the (.+?) printer: (.+?)","errorType":"exception","errorClass":"UpdateFailed","httpStatus":null,"severity":"error","filePath":"homeassistant/components/brother/coordinator.py","lineNumber":47,"sourceCode":"        self.brother = brother\n        self.device_name = config_entry.title\n\n        super().__init__(\n            hass,\n            _LOGGER,\n            config_entry=config_entry,\n            name=DOMAIN,\n            update_interval=UPDATE_INTERVAL,\n        )\n\n    @override\n    async def _async_update_data(self) -> BrotherSensors:\n        \"\"\"Update data via library.\"\"\"\n        try:\n            async with timeout(20):\n                data = await self.brother.async_update()\n        except (ConnectionError, SnmpError, UnsupportedModelError) as error:\n            raise UpdateFailed(\n                translation_domain=DOMAIN,\n                translation_key=\"update_error\",\n                translation_placeholders={\n                    \"device\": self.device_name,\n                    \"error\": repr(error),\n                },\n            ) from error\n        return data\n","sourceCodeStart":29,"sourceCodeEnd":56,"githubUrl":"https://github.com/home-assistant/core/blob/58a3fdb3ea0538617f0a07efcfba6294de64fd59/homeassistant/components/brother/coordinator.py#L29-L56","documentation":"UpdateFailed with translation_key 'update_error' from the Brother coordinator when brother.async_update() raises ConnectionError, SnmpError, or UnsupportedModelError within a 20-second timeout. Entities go unavailable and the coordinator retries on its interval.","triggerScenarios":"Printer entered sleep mode and stopped answering SNMP; network drop mid-poll; printer model firmware reporting OIDs the library cannot map (UnsupportedModelError); SNMP service hung so the 20s timeout fires as TimeoutError is not caught here — it surfaces as asyncio timeout cancel.","commonSituations":"Deep-sleep printers failing intermittent polls; switches blocking UDP 161 intermittently; firmware updates changing SNMP MIB layout triggering UnsupportedModelError.","solutions":["Check printer is awake and SNMP still responds: snmpwalk -v2c -c <community> <host>","Disable deep-sleep on the printer or accept transient UpdateFailed entries — the coordinator retries","If UnsupportedModelError, update the brother Python library (integration update) for new model support","Verify no firewall intermittently drops UDP 161"],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":"# Consuming platforms should read coordinator data, not catch UpdateFailed;\n# HA renders unavailable entities during failed refreshes automatically.\nif not coordinator.last_update_success:\n    # skip actions that need fresh printer data","preventionTips":["Keep the printer SNMP-reachable (disable deep sleep if drops are frequent)","Update the integration so new models map correctly (UnsupportedModelError)","Expect transient UpdateFailed entries during printer sleep; the coordinator retries"],"tags":["brother","coordinator","snmp","update-failed","home-assistant"],"backgroundTag":null,"analyzedSha":"58a3fdb3ea0538617f0a07efcfba6294de64fd59","analyzedAt":"2026-08-14T20:54:38.818Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}