mirror of
https://github.com/home-assistant/core.git
synced 2026-02-22 10:55:50 +00:00
109 lines
3.5 KiB
Python
109 lines
3.5 KiB
Python
"""Support for Roborock number."""
|
|
|
|
from collections.abc import Callable, Coroutine
|
|
from dataclasses import dataclass
|
|
import logging
|
|
from typing import Any
|
|
|
|
from roborock.devices.traits.v1 import PropertiesApi
|
|
from roborock.exceptions import RoborockException
|
|
|
|
from homeassistant.components.number import NumberEntity, NumberEntityDescription
|
|
from homeassistant.const import PERCENTAGE, EntityCategory
|
|
from homeassistant.core import HomeAssistant
|
|
from homeassistant.exceptions import HomeAssistantError
|
|
from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback
|
|
|
|
from .const import DOMAIN
|
|
from .coordinator import RoborockConfigEntry, RoborockDataUpdateCoordinator
|
|
from .entity import RoborockEntityV1
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
PARALLEL_UPDATES = 0
|
|
|
|
|
|
@dataclass(frozen=True, kw_only=True)
|
|
class RoborockNumberDescription(NumberEntityDescription):
|
|
"""Class to describe a Roborock number entity."""
|
|
|
|
trait: Callable[[PropertiesApi], Any | None]
|
|
"""Function to determine if number entity is supported by the device."""
|
|
|
|
get_value: Callable[[Any], float]
|
|
"""Function to get the value from the trait."""
|
|
|
|
set_value: Callable[[Any, float], Coroutine[Any, Any, None]]
|
|
"""Function to set the value on the trait."""
|
|
|
|
|
|
NUMBER_DESCRIPTIONS: list[RoborockNumberDescription] = [
|
|
RoborockNumberDescription(
|
|
key="volume",
|
|
translation_key="volume",
|
|
native_min_value=0,
|
|
native_max_value=100,
|
|
native_unit_of_measurement=PERCENTAGE,
|
|
entity_category=EntityCategory.CONFIG,
|
|
trait=lambda api: api.sound_volume,
|
|
get_value=lambda trait: float(trait.volume),
|
|
set_value=lambda trait, value: trait.set_volume(int(value)),
|
|
)
|
|
]
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
config_entry: RoborockConfigEntry,
|
|
async_add_entities: AddConfigEntryEntitiesCallback,
|
|
) -> None:
|
|
"""Set up Roborock number platform."""
|
|
async_add_entities(
|
|
[
|
|
RoborockNumberEntity(
|
|
f"{description.key}_{coordinator.duid_slug}",
|
|
coordinator=coordinator,
|
|
entity_description=description,
|
|
trait=trait,
|
|
)
|
|
for coordinator in config_entry.runtime_data.v1
|
|
for description in NUMBER_DESCRIPTIONS
|
|
if (trait := description.trait(coordinator.properties_api)) is not None
|
|
]
|
|
)
|
|
|
|
|
|
class RoborockNumberEntity(RoborockEntityV1, NumberEntity):
|
|
"""A class to let you set options on a Roborock vacuum where the potential options are fixed."""
|
|
|
|
entity_description: RoborockNumberDescription
|
|
|
|
def __init__(
|
|
self,
|
|
unique_id: str,
|
|
coordinator: RoborockDataUpdateCoordinator,
|
|
entity_description: RoborockNumberDescription,
|
|
trait: Any,
|
|
) -> None:
|
|
"""Create a number entity."""
|
|
self.entity_description = entity_description
|
|
super().__init__(
|
|
unique_id, coordinator.device_info, api=coordinator.properties_api.command
|
|
)
|
|
self._trait = trait
|
|
|
|
@property
|
|
def native_value(self) -> float | None:
|
|
"""Get native value."""
|
|
return self.entity_description.get_value(self._trait)
|
|
|
|
async def async_set_native_value(self, value: float) -> None:
|
|
"""Set number value."""
|
|
try:
|
|
await self.entity_description.set_value(self._trait, value)
|
|
except RoborockException as err:
|
|
raise HomeAssistantError(
|
|
translation_domain=DOMAIN,
|
|
translation_key="update_options_failed",
|
|
) from err
|