"""Support for TPLink number entities.""" from __future__ import annotations from dataclasses import dataclass import logging from typing import Final, cast from kasa import Device, Feature from homeassistant.components.number import ( DOMAIN as NUMBER_DOMAIN, NumberEntity, NumberEntityDescription, NumberMode, ) from homeassistant.core import HomeAssistant, callback from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback from . import TPLinkConfigEntry from .entity import ( CoordinatedTPLinkFeatureEntity, TPLinkDataUpdateCoordinator, TPLinkFeatureEntityDescription, async_refresh_after, ) _LOGGER = logging.getLogger(__name__) @dataclass(frozen=True, kw_only=True) class TPLinkNumberEntityDescription( NumberEntityDescription, TPLinkFeatureEntityDescription ): """Base class for a TPLink feature based number entity description.""" # Coordinator is used to centralize the data updates # For actions the integration handles locking of concurrent device request PARALLEL_UPDATES = 0 NUMBER_DESCRIPTIONS: Final = ( TPLinkNumberEntityDescription( key="smooth_transition_on", mode=NumberMode.BOX, ), TPLinkNumberEntityDescription( key="smooth_transition_off", mode=NumberMode.BOX, ), TPLinkNumberEntityDescription( key="auto_off_minutes", mode=NumberMode.BOX, ), TPLinkNumberEntityDescription( key="temperature_offset", mode=NumberMode.BOX, ), TPLinkNumberEntityDescription( key="pan_step", mode=NumberMode.BOX, ), TPLinkNumberEntityDescription( key="tilt_step", mode=NumberMode.BOX, ), TPLinkNumberEntityDescription( key="power_protection_threshold", mode=NumberMode.SLIDER, ), TPLinkNumberEntityDescription( key="clean_count", mode=NumberMode.SLIDER, ), ) NUMBER_DESCRIPTIONS_MAP = {desc.key: desc for desc in NUMBER_DESCRIPTIONS} async def async_setup_entry( hass: HomeAssistant, config_entry: TPLinkConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback, ) -> None: """Set up number entities.""" data = config_entry.runtime_data parent_coordinator = data.parent_coordinator device = parent_coordinator.device known_child_device_ids: set[str] = set() first_check = True def _check_device() -> None: entities = CoordinatedTPLinkFeatureEntity.entities_for_device_and_its_children( hass=hass, device=device, coordinator=parent_coordinator, feature_type=Feature.Type.Number, entity_class=TPLinkNumberEntity, descriptions=NUMBER_DESCRIPTIONS_MAP, platform_domain=NUMBER_DOMAIN, known_child_device_ids=known_child_device_ids, first_check=first_check, ) async_add_entities(entities) _check_device() first_check = False config_entry.async_on_unload(parent_coordinator.async_add_listener(_check_device)) class TPLinkNumberEntity(CoordinatedTPLinkFeatureEntity, NumberEntity): """Representation of a feature-based TPLink number entity.""" entity_description: TPLinkNumberEntityDescription def __init__( self, device: Device, coordinator: TPLinkDataUpdateCoordinator, *, feature: Feature, description: TPLinkFeatureEntityDescription, parent: Device | None = None, ) -> None: """Initialize the number entity.""" super().__init__( device, coordinator, feature=feature, description=description, parent=parent ) self._attr_native_min_value = self._feature.minimum_value self._attr_native_max_value = self._feature.maximum_value @async_refresh_after async def async_set_native_value(self, value: float) -> None: """Set feature value.""" await self._feature.set_value(int(value)) @callback def _async_update_attrs(self) -> bool: """Update the entity's attributes.""" self._attr_native_value = cast(float | None, self._feature.value) return True