home-assistant/core · error · HomeAssistantError

failed_to_set_htsp

failed_to_set_htsp

Error message

Failed to set heating setpoint

What it means

HomeAssistantError with translation_key 'failed_to_set_htsp' (heating setpoint), raised when ATTR_TARGET_TEMP_LOW is provided but set_heating_setpoint() returns falsy. Mirror of the cooling-setpoint failure: the gateway did not acknowledge the heating setpoint write.

Source

Thrown at homeassistant/components/bryant_evolution/climate.py:233

            )
        self._attr_hvac_mode = hvac_mode
        self._async_write_ha_state()

    @override
    async def async_set_temperature(self, **kwargs: Any) -> None:
        """Set new target temperature."""
        if value := kwargs.get(ATTR_TARGET_TEMP_HIGH):
            temp = int(value)
            if not await self._client.set_cooling_setpoint(temp):
                raise HomeAssistantError(
                    translation_domain=DOMAIN, translation_key="failed_to_set_clsp"
                )
            self._attr_target_temperature_high = temp

        if value := kwargs.get(ATTR_TARGET_TEMP_LOW):
            temp = int(value)
            if not await self._client.set_heating_setpoint(temp):
                raise HomeAssistantError(
                    translation_domain=DOMAIN, translation_key="failed_to_set_htsp"
                )
            self._attr_target_temperature_low = temp

        if value := kwargs.get(ATTR_TEMPERATURE):
            temp = int(value)
            fn = (
                self._client.set_heating_setpoint
                if self.hvac_mode == HVACMode.HEAT
                else self._client.set_cooling_setpoint
            )
            if not await fn(temp):
                raise HomeAssistantError(
                    translation_domain=DOMAIN, translation_key="failed_to_set_temp"
                )
            self._attr_target_temperature = temp

        # If we get here, we must have changed something unless HA allowed an

View on GitHub (pinned to 58a3fdb3ea)

Solutions

  1. Confirm the gateway is reachable and the thermostat responds locally
  2. Reload the integration to refresh the client session and retry
  3. Validate the setpoint is within the system's configured min/max
  4. Add a retry to automations that change setpoints unattended
Defensive patterns

Strategy: try-catch

Validate before calling

MIN_HTSP, MAX_HTSP = 40, 68  # degrees, per your system configuration
if MIN_HTSP <= temp <= MAX_HTSP:
    await climate.async_set_temperature(target_temp_low=temp)

Try / catch

try:
    await climate.async_set_temperature(target_temp_low=65)
except HomeAssistantError as err:
    if 'failed_to_set_htsp' in str(err):
        # heating setpoint write not acknowledged; retry after gateway recovers

Prevention

When it happens

Trigger: Setting target_temp_low while the gateway is unreachable or the session is stale; heating setpoint outside the system's accepted range; system refusing writes during a lockout state.

Common situations: Scheduled heating setpoint changes failing during outages; heat/cool auto mode configuration where the low setpoint write races a gateway reboot.

Related errors

AI-assisted analysis of home-assistant/core@58a3fdb3ea (2026-08-14). Data as JSON: /api/errors/c22690515b6d2948. Report an issue: GitHub.