"""Support for KNX/IP numeric values.""" from __future__ import annotations from typing import cast from xknx import XKNX from xknx.devices import NumericValue from homeassistant import config_entries from homeassistant.components.number import NumberEntity from homeassistant.const import ( CONF_ENTITY_CATEGORY, CONF_MODE, CONF_NAME, CONF_TYPE, STATE_UNAVAILABLE, STATE_UNKNOWN, Platform, ) from homeassistant.core import HomeAssistant from homeassistant.helpers.entity_platform import AddEntitiesCallback from homeassistant.helpers.restore_state import RestoreEntity from homeassistant.helpers.typing import ConfigType from .const import ( CONF_RESPOND_TO_READ, CONF_STATE_ADDRESS, DATA_KNX_CONFIG, DOMAIN, KNX_ADDRESS, ) from .knx_entity import KnxEntity from .schema import NumberSchema async def async_setup_entry( hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddEntitiesCallback, ) -> None: """Set up number(s) for KNX platform.""" xknx: XKNX = hass.data[DOMAIN].xknx config: list[ConfigType] = hass.data[DATA_KNX_CONFIG][Platform.NUMBER] async_add_entities(KNXNumber(xknx, entity_config) for entity_config in config) def _create_numeric_value(xknx: XKNX, config: ConfigType) -> NumericValue: """Return a KNX NumericValue to be used within XKNX.""" return NumericValue( xknx, name=config[CONF_NAME], group_address=config[KNX_ADDRESS], group_address_state=config.get(CONF_STATE_ADDRESS), respond_to_read=config[CONF_RESPOND_TO_READ], value_type=config[CONF_TYPE], ) class KNXNumber(KnxEntity, NumberEntity, RestoreEntity): """Representation of a KNX number.""" _device: NumericValue def __init__(self, xknx: XKNX, config: ConfigType) -> None: """Initialize a KNX number.""" super().__init__(_create_numeric_value(xknx, config)) self._attr_max_value = config.get( NumberSchema.CONF_MAX, self._device.sensor_value.dpt_class.value_max, ) self._attr_min_value = config.get( NumberSchema.CONF_MIN, self._device.sensor_value.dpt_class.value_min, ) self._attr_mode = config[CONF_MODE] self._attr_step = config.get( NumberSchema.CONF_STEP, self._device.sensor_value.dpt_class.resolution, ) self._attr_entity_category = config.get(CONF_ENTITY_CATEGORY) self._attr_unique_id = str(self._device.sensor_value.group_address) self._attr_unit_of_measurement = self._device.unit_of_measurement() self._device.sensor_value.value = max(0, self._attr_min_value) async def async_added_to_hass(self) -> None: """Restore last state.""" await super().async_added_to_hass() if not self._device.sensor_value.readable and ( last_state := await self.async_get_last_state() ): if last_state.state not in (STATE_UNKNOWN, STATE_UNAVAILABLE): self._device.sensor_value.value = float(last_state.state) @property def value(self) -> float: """Return the entity value to represent the entity state.""" # self._device.sensor_value.value is set in __init__ so it is never None return cast(float, self._device.resolve_state()) async def async_set_value(self, value: float) -> None: """Set new value.""" await self._device.set(value)