core/homeassistant/components/indevolt/number.py

"""Number platform for Indevolt integration."""

from dataclasses import dataclass
from typing import Final

from indevolt_api import IndevoltConfig

from homeassistant.components.number import (
    NumberDeviceClass,
    NumberEntity,
    NumberEntityDescription,
    NumberMode,
)
from homeassistant.const import PERCENTAGE, UnitOfPower
from homeassistant.core import HomeAssistant
from homeassistant.exceptions import HomeAssistantError
from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback

from . import IndevoltConfigEntry
from .const import DOMAIN
from .coordinator import IndevoltCoordinator
from .entity import IndevoltEntity

PARALLEL_UPDATES = 0


@dataclass(frozen=True, kw_only=True)
class IndevoltNumberEntityDescription(NumberEntityDescription):
    """Custom entity description class for Indevolt number entities."""

    read_key: str
    write_key: str
    generation: tuple[int, ...] = (1, 2)


NUMBERS: Final = (
    IndevoltNumberEntityDescription(
        key="discharge_limit",
        generation=(2,),
        translation_key="discharge_limit",
        read_key=IndevoltConfig.READ_DISCHARGE_LIMIT,
        write_key=IndevoltConfig.WRITE_DISCHARGE_LIMIT,
        native_min_value=0,
        native_max_value=100,
        native_step=1,
        native_unit_of_measurement=PERCENTAGE,
    ),
    IndevoltNumberEntityDescription(
        key="max_ac_output_power",
        generation=(2,),
        translation_key="max_ac_output_power",
        read_key=IndevoltConfig.READ_MAX_AC_OUTPUT_POWER,
        write_key=IndevoltConfig.WRITE_MAX_AC_OUTPUT_POWER,
        native_min_value=0,
        native_max_value=2400,
        native_step=100,
        native_unit_of_measurement=UnitOfPower.WATT,
        device_class=NumberDeviceClass.POWER,
    ),
    IndevoltNumberEntityDescription(
        key="inverter_input_limit",
        generation=(2,),
        translation_key="inverter_input_limit",
        read_key=IndevoltConfig.READ_INVERTER_INPUT_LIMIT,
        write_key=IndevoltConfig.WRITE_INVERTER_INPUT_LIMIT,
        native_min_value=100,
        native_max_value=2400,
        native_step=100,
        native_unit_of_measurement=UnitOfPower.WATT,
        device_class=NumberDeviceClass.POWER,
    ),
    IndevoltNumberEntityDescription(
        key="feedin_power_limit",
        generation=(2,),
        translation_key="feedin_power_limit",
        read_key=IndevoltConfig.READ_FEEDIN_POWER_LIMIT,
        write_key=IndevoltConfig.WRITE_FEEDIN_POWER_LIMIT,
        native_min_value=0,
        native_max_value=2400,
        native_step=100,
        native_unit_of_measurement=UnitOfPower.WATT,
        device_class=NumberDeviceClass.POWER,
    ),
)


async def async_setup_entry(
    hass: HomeAssistant,
    entry: IndevoltConfigEntry,
    async_add_entities: AddConfigEntryEntitiesCallback,
) -> None:
    """Set up the number platform for Indevolt."""
    coordinator = entry.runtime_data
    device_gen = coordinator.generation

    # Number initialization
    async_add_entities(
        IndevoltNumberEntity(coordinator, description)
        for description in NUMBERS
        if device_gen in description.generation
    )


class IndevoltNumberEntity(IndevoltEntity, NumberEntity):
    """Represents a number entity for Indevolt devices."""

    entity_description: IndevoltNumberEntityDescription
    _attr_mode = NumberMode.BOX

    def __init__(
        self,
        coordinator: IndevoltCoordinator,
        description: IndevoltNumberEntityDescription,
    ) -> None:
        """Initialize the Indevolt number entity."""
        super().__init__(coordinator)

        self.entity_description = description
        self._attr_unique_id = f"{self.serial_number}_{description.key}"

    @property
    def native_value(self) -> int | None:
        """Return the current value of the entity."""
        raw_value = self.coordinator.data.get(self.entity_description.read_key)
        if raw_value is None:
            return None

        return int(raw_value)

    async def async_set_native_value(self, value: float) -> None:
        """Set a new value for the entity."""

        int_value = int(value)
        success = await self.coordinator.async_push_data(
            self.entity_description.write_key, int_value
        )

        if success:
            await self.coordinator.async_request_refresh()

        else:
            raise HomeAssistantError(
                translation_domain=DOMAIN,
                translation_key="write_error",
                translation_placeholders={"name": str(self.name)},
            )