{"record":{"id":"4b24cf686e5178d5","repo":"home-assistant/core","slug":"this-device-does-not-support-setting-brightness","errorCode":null,"errorMessage":"This device does not support setting brightness","messagePattern":"This device does not support setting brightness","errorType":"exception","errorClass":"HomeAssistantError","httpStatus":null,"severity":"warning","filePath":"homeassistant/components/bond/light.py","lineNumber":84,"sourceCode":"        for device in hub.devices\n        if DeviceType.is_light(device.type)\n    ]\n\n    async_add_entities(\n        fan_lights + fan_up_lights + fan_down_lights + fireplaces + fp_lights + lights,\n    )\n\n\nclass BondBaseLight(BondEntity, LightEntity):\n    \"\"\"Representation of a Bond light.\"\"\"\n\n    _attr_color_mode = ColorMode.ONOFF\n    _attr_supported_color_modes = {ColorMode.ONOFF}\n\n    async def async_set_brightness_belief(self, brightness: int) -> None:\n        \"\"\"Set the belief state of the light.\"\"\"\n        if not self._device.supports_set_brightness():\n            raise HomeAssistantError(\"This device does not support setting brightness\")\n        if brightness == 0:\n            await self.async_set_power_belief(False)\n            return\n        try:\n            await self._bond.action(\n                self._device_id,\n                Action.set_brightness_belief(round((brightness * 100) / 255)),\n            )\n        except ClientResponseError as ex:\n            raise HomeAssistantError(\n                \"The bond API returned an error calling set_brightness_belief for\"\n                f\" {self.entity_id}.  Code: {ex.status}  Message: {ex.message}\"\n            ) from ex\n\n    async def async_set_power_belief(self, power_state: bool) -> None:\n        \"\"\"Set the belief state of the light.\"\"\"\n        try:\n            await self._bond.action(","sourceCodeStart":66,"sourceCodeEnd":102,"githubUrl":"https://github.com/home-assistant/core/blob/58a3fdb3ea0538617f0a07efcfba6294de64fd59/homeassistant/components/bond/light.py#L66-L102","documentation":"Raised by BondBaseLight.async_set_brightness_belief when a brightness command arrives for a Bond light whose device profile lacks the set_brightness capability (self._device.supports_set_brightness() is False). It is a capability guard, not an API failure: the command is rejected locally before any HTTP call.","triggerScenarios":"A light entity built from a Bond device with only on/off actions receiving set_brightness_belief(brightness > 0) — e.g. an automation or scene storing a brightness for an on/off relay/light, or a restore-state replay.","commonSituations":"Script or scene sets brightness_pct on a plain on/off light; Google Home/Alexy sync sending brightness for a dumb light; restored state from when the device previously supported brightness.","solutions":["Remove brightness attributes from automations/scripts/scenes targeting this entity, or target an entity that supports brightness.","Check the device's Bond properties (actions include 'set_brightness') in the Bond app to confirm the capability.","If the physical device does support dimming, re-add it in the Bond app so its profile carries set_brightness, then reload the integration."],"exampleFix":"// before\nawait entity.async_set_brightness_belief(128)\n// after\nif entity._device.supports_set_brightness():\n    await entity.async_set_brightness_belief(128)\nelse:\n    await entity.async_turn_on()","handlingStrategy":"type-guard","validationCode":null,"typeGuard":"def supports_brightness(entity) -> bool:\n    \"\"\"True when the Bond light accepts brightness commands.\"\"\"\n    device = getattr(entity, \"_device\", None)\n    return bool(device and device.supports_set_brightness())","tryCatchPattern":"try:\n    await light.async_set_brightness_belief(value)\nexcept HomeAssistantError as err:\n    if \"does not support setting brightness\" in str(err):\n        await light.async_turn_on()  # graceful fallback to on/off","preventionTips":["Scenes/automations: only set brightness on lights whose supported_features include brightness.","Voice-assistant mappings: mark on/off-only lights as non-dimmable."],"tags":["bond","light","capability","home-assistant"],"backgroundTag":null,"analyzedSha":"58a3fdb3ea0538617f0a07efcfba6294de64fd59","analyzedAt":"2026-08-14T20:54:38.818Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}