705 lines
22 KiB
Python
705 lines
22 KiB
Python
"""Provides functionality to interact with fans."""
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
from datetime import timedelta
|
|
import functools as ft
|
|
import logging
|
|
import math
|
|
from typing import final
|
|
|
|
import voluptuous as vol
|
|
|
|
from homeassistant.config_entries import ConfigEntry
|
|
from homeassistant.const import (
|
|
SERVICE_TOGGLE,
|
|
SERVICE_TURN_OFF,
|
|
SERVICE_TURN_ON,
|
|
STATE_ON,
|
|
)
|
|
from homeassistant.core import HomeAssistant
|
|
import homeassistant.helpers.config_validation as cv
|
|
from homeassistant.helpers.config_validation import ( # noqa: F401
|
|
PLATFORM_SCHEMA,
|
|
PLATFORM_SCHEMA_BASE,
|
|
)
|
|
from homeassistant.helpers.entity import ToggleEntity, ToggleEntityDescription
|
|
from homeassistant.helpers.entity_component import EntityComponent
|
|
from homeassistant.helpers.typing import ConfigType
|
|
from homeassistant.loader import bind_hass
|
|
from homeassistant.util.percentage import (
|
|
ordered_list_item_to_percentage,
|
|
percentage_to_ordered_list_item,
|
|
percentage_to_ranged_value,
|
|
ranged_value_to_percentage,
|
|
)
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
DOMAIN = "fan"
|
|
SCAN_INTERVAL = timedelta(seconds=30)
|
|
|
|
ENTITY_ID_FORMAT = DOMAIN + ".{}"
|
|
|
|
# Bitfield of features supported by the fan entity
|
|
SUPPORT_SET_SPEED = 1
|
|
SUPPORT_OSCILLATE = 2
|
|
SUPPORT_DIRECTION = 4
|
|
SUPPORT_PRESET_MODE = 8
|
|
|
|
SERVICE_SET_SPEED = "set_speed"
|
|
SERVICE_INCREASE_SPEED = "increase_speed"
|
|
SERVICE_DECREASE_SPEED = "decrease_speed"
|
|
SERVICE_OSCILLATE = "oscillate"
|
|
SERVICE_SET_DIRECTION = "set_direction"
|
|
SERVICE_SET_PERCENTAGE = "set_percentage"
|
|
SERVICE_SET_PRESET_MODE = "set_preset_mode"
|
|
|
|
SPEED_OFF = "off"
|
|
SPEED_LOW = "low"
|
|
SPEED_MEDIUM = "medium"
|
|
SPEED_HIGH = "high"
|
|
|
|
DIRECTION_FORWARD = "forward"
|
|
DIRECTION_REVERSE = "reverse"
|
|
|
|
ATTR_SPEED = "speed"
|
|
ATTR_PERCENTAGE = "percentage"
|
|
ATTR_PERCENTAGE_STEP = "percentage_step"
|
|
ATTR_SPEED_LIST = "speed_list"
|
|
ATTR_OSCILLATING = "oscillating"
|
|
ATTR_DIRECTION = "direction"
|
|
ATTR_PRESET_MODE = "preset_mode"
|
|
ATTR_PRESET_MODES = "preset_modes"
|
|
|
|
# Invalid speeds do not conform to the entity model, but have crept
|
|
# into core integrations at some point so we are temporarily
|
|
# accommodating them in the transition to percentages.
|
|
_NOT_SPEED_OFF = "off"
|
|
_NOT_SPEED_ON = "on"
|
|
_NOT_SPEED_AUTO = "auto"
|
|
_NOT_SPEED_SMART = "smart"
|
|
_NOT_SPEED_INTERVAL = "interval"
|
|
_NOT_SPEED_IDLE = "idle"
|
|
_NOT_SPEED_FAVORITE = "favorite"
|
|
_NOT_SPEED_SLEEP = "sleep"
|
|
_NOT_SPEED_SILENT = "silent"
|
|
|
|
_NOT_SPEEDS_FILTER = {
|
|
_NOT_SPEED_OFF,
|
|
_NOT_SPEED_ON,
|
|
_NOT_SPEED_AUTO,
|
|
_NOT_SPEED_SMART,
|
|
_NOT_SPEED_INTERVAL,
|
|
_NOT_SPEED_IDLE,
|
|
_NOT_SPEED_SILENT,
|
|
_NOT_SPEED_SLEEP,
|
|
_NOT_SPEED_FAVORITE,
|
|
}
|
|
|
|
_FAN_NATIVE = "_fan_native"
|
|
|
|
OFF_SPEED_VALUES = [SPEED_OFF, None]
|
|
|
|
LEGACY_SPEED_LIST = [SPEED_LOW, SPEED_MEDIUM, SPEED_HIGH]
|
|
|
|
|
|
class NoValidSpeedsError(ValueError):
|
|
"""Exception class when there are no valid speeds."""
|
|
|
|
|
|
class NotValidSpeedError(ValueError):
|
|
"""Exception class when the speed in not in the speed list."""
|
|
|
|
|
|
class NotValidPresetModeError(ValueError):
|
|
"""Exception class when the preset_mode in not in the preset_modes list."""
|
|
|
|
|
|
@bind_hass
|
|
def is_on(hass, entity_id: str) -> bool:
|
|
"""Return if the fans are on based on the statemachine."""
|
|
state = hass.states.get(entity_id)
|
|
if ATTR_SPEED in state.attributes:
|
|
return state.attributes[ATTR_SPEED] not in OFF_SPEED_VALUES
|
|
return state.state == STATE_ON
|
|
|
|
|
|
async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool:
|
|
"""Expose fan control via statemachine and services."""
|
|
component = hass.data[DOMAIN] = EntityComponent(
|
|
_LOGGER, DOMAIN, hass, SCAN_INTERVAL
|
|
)
|
|
|
|
await component.async_setup(config)
|
|
|
|
# After the transition to percentage and preset_modes concludes,
|
|
# switch this back to async_turn_on and remove async_turn_on_compat
|
|
component.async_register_entity_service(
|
|
SERVICE_TURN_ON,
|
|
{
|
|
vol.Optional(ATTR_SPEED): cv.string,
|
|
vol.Optional(ATTR_PERCENTAGE): vol.All(
|
|
vol.Coerce(int), vol.Range(min=0, max=100)
|
|
),
|
|
vol.Optional(ATTR_PRESET_MODE): cv.string,
|
|
},
|
|
"async_turn_on_compat",
|
|
)
|
|
component.async_register_entity_service(SERVICE_TURN_OFF, {}, "async_turn_off")
|
|
component.async_register_entity_service(SERVICE_TOGGLE, {}, "async_toggle")
|
|
# After the transition to percentage and preset_modes concludes,
|
|
# remove this service
|
|
component.async_register_entity_service(
|
|
SERVICE_SET_SPEED,
|
|
{vol.Required(ATTR_SPEED): cv.string},
|
|
"async_set_speed_deprecated",
|
|
[SUPPORT_SET_SPEED],
|
|
)
|
|
component.async_register_entity_service(
|
|
SERVICE_INCREASE_SPEED,
|
|
{
|
|
vol.Optional(ATTR_PERCENTAGE_STEP): vol.All(
|
|
vol.Coerce(int), vol.Range(min=0, max=100)
|
|
)
|
|
},
|
|
"async_increase_speed",
|
|
[SUPPORT_SET_SPEED],
|
|
)
|
|
component.async_register_entity_service(
|
|
SERVICE_DECREASE_SPEED,
|
|
{
|
|
vol.Optional(ATTR_PERCENTAGE_STEP): vol.All(
|
|
vol.Coerce(int), vol.Range(min=0, max=100)
|
|
)
|
|
},
|
|
"async_decrease_speed",
|
|
[SUPPORT_SET_SPEED],
|
|
)
|
|
component.async_register_entity_service(
|
|
SERVICE_OSCILLATE,
|
|
{vol.Required(ATTR_OSCILLATING): cv.boolean},
|
|
"async_oscillate",
|
|
[SUPPORT_OSCILLATE],
|
|
)
|
|
component.async_register_entity_service(
|
|
SERVICE_SET_DIRECTION,
|
|
{vol.Optional(ATTR_DIRECTION): cv.string},
|
|
"async_set_direction",
|
|
[SUPPORT_DIRECTION],
|
|
)
|
|
component.async_register_entity_service(
|
|
SERVICE_SET_PERCENTAGE,
|
|
{
|
|
vol.Required(ATTR_PERCENTAGE): vol.All(
|
|
vol.Coerce(int), vol.Range(min=0, max=100)
|
|
)
|
|
},
|
|
"async_set_percentage",
|
|
[SUPPORT_SET_SPEED],
|
|
)
|
|
component.async_register_entity_service(
|
|
SERVICE_SET_PRESET_MODE,
|
|
{vol.Required(ATTR_PRESET_MODE): cv.string},
|
|
"async_set_preset_mode",
|
|
[SUPPORT_SET_SPEED, SUPPORT_PRESET_MODE],
|
|
)
|
|
|
|
return True
|
|
|
|
|
|
async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
|
|
"""Set up a config entry."""
|
|
component: EntityComponent = hass.data[DOMAIN]
|
|
return await component.async_setup_entry(entry)
|
|
|
|
|
|
async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
|
|
"""Unload a config entry."""
|
|
component: EntityComponent = hass.data[DOMAIN]
|
|
return await component.async_unload_entry(entry)
|
|
|
|
|
|
def _fan_native(method):
|
|
"""Native fan method not overridden."""
|
|
setattr(method, _FAN_NATIVE, True)
|
|
return method
|
|
|
|
|
|
@dataclass
|
|
class FanEntityDescription(ToggleEntityDescription):
|
|
"""A class that describes fan entities."""
|
|
|
|
|
|
class FanEntity(ToggleEntity):
|
|
"""Base class for fan entities."""
|
|
|
|
entity_description: FanEntityDescription
|
|
|
|
@_fan_native
|
|
def set_speed(self, speed: str) -> None:
|
|
"""Set the speed of the fan."""
|
|
raise NotImplementedError()
|
|
|
|
async def async_set_speed_deprecated(self, speed: str):
|
|
"""Set the speed of the fan."""
|
|
_LOGGER.warning(
|
|
"The fan.set_speed service is deprecated, use fan.set_percentage or fan.set_preset_mode instead"
|
|
)
|
|
await self.async_set_speed(speed)
|
|
|
|
@_fan_native
|
|
async def async_set_speed(self, speed: str):
|
|
"""Set the speed of the fan."""
|
|
if speed == SPEED_OFF:
|
|
await self.async_turn_off()
|
|
return
|
|
|
|
if self.preset_modes and speed in self.preset_modes:
|
|
if not hasattr(self.async_set_preset_mode, _FAN_NATIVE):
|
|
await self.async_set_preset_mode(speed)
|
|
return
|
|
if not hasattr(self.set_preset_mode, _FAN_NATIVE):
|
|
await self.hass.async_add_executor_job(self.set_preset_mode, speed)
|
|
return
|
|
else:
|
|
if not hasattr(self.async_set_percentage, _FAN_NATIVE):
|
|
await self.async_set_percentage(self.speed_to_percentage(speed))
|
|
return
|
|
if not hasattr(self.set_percentage, _FAN_NATIVE):
|
|
await self.hass.async_add_executor_job(
|
|
self.set_percentage, self.speed_to_percentage(speed)
|
|
)
|
|
return
|
|
|
|
await self.hass.async_add_executor_job(self.set_speed, speed)
|
|
|
|
@_fan_native
|
|
def set_percentage(self, percentage: int) -> None:
|
|
"""Set the speed of the fan, as a percentage."""
|
|
raise NotImplementedError()
|
|
|
|
@_fan_native
|
|
async def async_set_percentage(self, percentage: int) -> None:
|
|
"""Set the speed of the fan, as a percentage."""
|
|
if percentage == 0:
|
|
await self.async_turn_off()
|
|
elif not hasattr(self.set_percentage, _FAN_NATIVE):
|
|
await self.hass.async_add_executor_job(self.set_percentage, percentage)
|
|
else:
|
|
await self.async_set_speed(self.percentage_to_speed(percentage))
|
|
|
|
async def async_increase_speed(self, percentage_step: int | None = None) -> None:
|
|
"""Increase the speed of the fan."""
|
|
await self._async_adjust_speed(1, percentage_step)
|
|
|
|
async def async_decrease_speed(self, percentage_step: int | None = None) -> None:
|
|
"""Decrease the speed of the fan."""
|
|
await self._async_adjust_speed(-1, percentage_step)
|
|
|
|
async def _async_adjust_speed(
|
|
self, modifier: int, percentage_step: int | None
|
|
) -> None:
|
|
"""Increase or decrease the speed of the fan."""
|
|
current_percentage = self.percentage or 0
|
|
|
|
if percentage_step is not None:
|
|
new_percentage = current_percentage + (percentage_step * modifier)
|
|
else:
|
|
speed_range = (1, self.speed_count)
|
|
speed_index = math.ceil(
|
|
percentage_to_ranged_value(speed_range, current_percentage)
|
|
)
|
|
new_percentage = ranged_value_to_percentage(
|
|
speed_range, speed_index + modifier
|
|
)
|
|
|
|
new_percentage = max(0, min(100, new_percentage))
|
|
|
|
await self.async_set_percentage(new_percentage)
|
|
|
|
@_fan_native
|
|
def set_preset_mode(self, preset_mode: str) -> None:
|
|
"""Set new preset mode."""
|
|
self._valid_preset_mode_or_raise(preset_mode)
|
|
self.set_speed(preset_mode)
|
|
|
|
@_fan_native
|
|
async def async_set_preset_mode(self, preset_mode: str) -> None:
|
|
"""Set new preset mode."""
|
|
if not hasattr(self.set_preset_mode, _FAN_NATIVE):
|
|
await self.hass.async_add_executor_job(self.set_preset_mode, preset_mode)
|
|
return
|
|
|
|
self._valid_preset_mode_or_raise(preset_mode)
|
|
await self.async_set_speed(preset_mode)
|
|
|
|
def _valid_preset_mode_or_raise(self, preset_mode):
|
|
"""Raise NotValidPresetModeError on invalid preset_mode."""
|
|
preset_modes = self.preset_modes
|
|
if preset_mode not in preset_modes:
|
|
raise NotValidPresetModeError(
|
|
f"The preset_mode {preset_mode} is not a valid preset_mode: {preset_modes}"
|
|
)
|
|
|
|
def set_direction(self, direction: str) -> None:
|
|
"""Set the direction of the fan."""
|
|
raise NotImplementedError()
|
|
|
|
async def async_set_direction(self, direction: str):
|
|
"""Set the direction of the fan."""
|
|
await self.hass.async_add_executor_job(self.set_direction, direction)
|
|
|
|
# pylint: disable=arguments-differ
|
|
def turn_on(
|
|
self,
|
|
speed: str | None = None,
|
|
percentage: int | None = None,
|
|
preset_mode: str | None = None,
|
|
**kwargs,
|
|
) -> None:
|
|
"""Turn on the fan."""
|
|
raise NotImplementedError()
|
|
|
|
async def async_turn_on_compat(
|
|
self,
|
|
speed: str | None = None,
|
|
percentage: int | None = None,
|
|
preset_mode: str | None = None,
|
|
**kwargs,
|
|
) -> None:
|
|
"""Turn on the fan.
|
|
|
|
This _compat version wraps async_turn_on with
|
|
backwards and forward compatibility.
|
|
|
|
After the transition to percentage and preset_modes concludes, it
|
|
should be removed.
|
|
"""
|
|
if preset_mode is not None:
|
|
self._valid_preset_mode_or_raise(preset_mode)
|
|
speed = preset_mode
|
|
percentage = None
|
|
elif speed is not None:
|
|
_LOGGER.warning(
|
|
"Calling fan.turn_on with the speed argument is deprecated, use percentage or preset_mode instead"
|
|
)
|
|
if self.preset_modes and speed in self.preset_modes:
|
|
preset_mode = speed
|
|
percentage = None
|
|
else:
|
|
percentage = self.speed_to_percentage(speed)
|
|
elif percentage is not None:
|
|
speed = self.percentage_to_speed(percentage)
|
|
|
|
await self.async_turn_on(
|
|
speed=speed,
|
|
percentage=percentage,
|
|
preset_mode=preset_mode,
|
|
**kwargs,
|
|
)
|
|
|
|
# pylint: disable=arguments-differ
|
|
async def async_turn_on(
|
|
self,
|
|
speed: str | None = None,
|
|
percentage: int | None = None,
|
|
preset_mode: str | None = None,
|
|
**kwargs,
|
|
) -> None:
|
|
"""Turn on the fan."""
|
|
if speed == SPEED_OFF:
|
|
await self.async_turn_off()
|
|
else:
|
|
await self.hass.async_add_executor_job(
|
|
ft.partial(
|
|
self.turn_on,
|
|
speed=speed,
|
|
percentage=percentage,
|
|
preset_mode=preset_mode,
|
|
**kwargs,
|
|
)
|
|
)
|
|
|
|
def oscillate(self, oscillating: bool) -> None:
|
|
"""Oscillate the fan."""
|
|
raise NotImplementedError()
|
|
|
|
async def async_oscillate(self, oscillating: bool):
|
|
"""Oscillate the fan."""
|
|
await self.hass.async_add_executor_job(self.oscillate, oscillating)
|
|
|
|
@property
|
|
def is_on(self):
|
|
"""Return true if the entity is on."""
|
|
return self.speed not in [SPEED_OFF, None]
|
|
|
|
@property
|
|
def _implemented_percentage(self) -> bool:
|
|
"""Return true if percentage has been implemented."""
|
|
return not hasattr(self.set_percentage, _FAN_NATIVE) or not hasattr(
|
|
self.async_set_percentage, _FAN_NATIVE
|
|
)
|
|
|
|
@property
|
|
def _implemented_preset_mode(self) -> bool:
|
|
"""Return true if preset_mode has been implemented."""
|
|
return not hasattr(self.set_preset_mode, _FAN_NATIVE) or not hasattr(
|
|
self.async_set_preset_mode, _FAN_NATIVE
|
|
)
|
|
|
|
@property
|
|
def _implemented_speed(self) -> bool:
|
|
"""Return true if speed has been implemented."""
|
|
return not hasattr(self.set_speed, _FAN_NATIVE) or not hasattr(
|
|
self.async_set_speed, _FAN_NATIVE
|
|
)
|
|
|
|
@property
|
|
def speed(self) -> str | None:
|
|
"""Return the current speed."""
|
|
if self._implemented_preset_mode:
|
|
preset_mode = self.preset_mode
|
|
if preset_mode:
|
|
return preset_mode
|
|
if self._implemented_percentage:
|
|
percentage = self.percentage
|
|
if percentage is None:
|
|
return None
|
|
return self.percentage_to_speed(percentage)
|
|
return None
|
|
|
|
@property
|
|
def percentage(self) -> int | None:
|
|
"""Return the current speed as a percentage."""
|
|
if (
|
|
not self._implemented_preset_mode
|
|
and self.preset_modes
|
|
and self.speed in self.preset_modes
|
|
):
|
|
return None
|
|
if self.speed is not None and not self._implemented_percentage:
|
|
return self.speed_to_percentage(self.speed)
|
|
return 0
|
|
|
|
@property
|
|
def speed_count(self) -> int:
|
|
"""Return the number of speeds the fan supports."""
|
|
speed_list = speed_list_without_preset_modes(self.speed_list)
|
|
if speed_list:
|
|
return len(speed_list)
|
|
return 100
|
|
|
|
@property
|
|
def percentage_step(self) -> float:
|
|
"""Return the step size for percentage."""
|
|
return 100 / self.speed_count
|
|
|
|
@property
|
|
def speed_list(self) -> list:
|
|
"""Get the list of available speeds."""
|
|
speeds = []
|
|
if self._implemented_percentage:
|
|
speeds += [SPEED_OFF, *LEGACY_SPEED_LIST]
|
|
if self._implemented_preset_mode and self.preset_modes:
|
|
speeds += self.preset_modes
|
|
return speeds
|
|
|
|
@property
|
|
def current_direction(self) -> str | None:
|
|
"""Return the current direction of the fan."""
|
|
return None
|
|
|
|
@property
|
|
def oscillating(self):
|
|
"""Return whether or not the fan is currently oscillating."""
|
|
return None
|
|
|
|
@property
|
|
def capability_attributes(self):
|
|
"""Return capability attributes."""
|
|
attrs = {}
|
|
if self.supported_features & SUPPORT_SET_SPEED:
|
|
attrs[ATTR_SPEED_LIST] = self.speed_list
|
|
|
|
if (
|
|
self.supported_features & SUPPORT_SET_SPEED
|
|
or self.supported_features & SUPPORT_PRESET_MODE
|
|
):
|
|
attrs[ATTR_PRESET_MODES] = self.preset_modes
|
|
|
|
return attrs
|
|
|
|
@property
|
|
def _speed_list_without_preset_modes(self) -> list:
|
|
"""Return the speed list without preset modes.
|
|
|
|
This property provides forward and backwards
|
|
compatibility for conversion to percentage speeds.
|
|
"""
|
|
if not self._implemented_speed:
|
|
return LEGACY_SPEED_LIST
|
|
return speed_list_without_preset_modes(self.speed_list)
|
|
|
|
def speed_to_percentage(self, speed: str) -> int:
|
|
"""
|
|
Map a speed to a percentage.
|
|
|
|
Officially this should only have to deal with the 4 pre-defined speeds:
|
|
|
|
return {
|
|
SPEED_OFF: 0,
|
|
SPEED_LOW: 33,
|
|
SPEED_MEDIUM: 66,
|
|
SPEED_HIGH: 100,
|
|
}[speed]
|
|
|
|
Unfortunately lots of fans make up their own speeds. So the default
|
|
mapping is more dynamic.
|
|
"""
|
|
if speed in OFF_SPEED_VALUES:
|
|
return 0
|
|
|
|
speed_list = self._speed_list_without_preset_modes
|
|
|
|
if speed_list and speed not in speed_list:
|
|
raise NotValidSpeedError(f"The speed {speed} is not a valid speed.")
|
|
|
|
try:
|
|
return ordered_list_item_to_percentage(speed_list, speed)
|
|
except ValueError as ex:
|
|
raise NoValidSpeedsError(
|
|
f"The speed_list {speed_list} does not contain any valid speeds."
|
|
) from ex
|
|
|
|
def percentage_to_speed(self, percentage: int) -> str:
|
|
"""
|
|
Map a percentage onto self.speed_list.
|
|
|
|
Officially, this should only have to deal with 4 pre-defined speeds.
|
|
|
|
if value == 0:
|
|
return SPEED_OFF
|
|
elif value <= 33:
|
|
return SPEED_LOW
|
|
elif value <= 66:
|
|
return SPEED_MEDIUM
|
|
else:
|
|
return SPEED_HIGH
|
|
|
|
Unfortunately there is currently a high degree of non-conformancy.
|
|
Until fans have been corrected a more complicated and dynamic
|
|
mapping is used.
|
|
"""
|
|
if percentage == 0:
|
|
return SPEED_OFF
|
|
|
|
speed_list = self._speed_list_without_preset_modes
|
|
|
|
try:
|
|
return percentage_to_ordered_list_item(speed_list, percentage)
|
|
except ValueError as ex:
|
|
raise NoValidSpeedsError(
|
|
f"The speed_list {speed_list} does not contain any valid speeds."
|
|
) from ex
|
|
|
|
@final
|
|
@property
|
|
def state_attributes(self) -> dict:
|
|
"""Return optional state attributes."""
|
|
data: dict[str, float | str | None] = {}
|
|
supported_features = self.supported_features
|
|
|
|
if supported_features & SUPPORT_DIRECTION:
|
|
data[ATTR_DIRECTION] = self.current_direction
|
|
|
|
if supported_features & SUPPORT_OSCILLATE:
|
|
data[ATTR_OSCILLATING] = self.oscillating
|
|
|
|
if supported_features & SUPPORT_SET_SPEED:
|
|
data[ATTR_SPEED] = self.speed
|
|
data[ATTR_PERCENTAGE] = self.percentage
|
|
data[ATTR_PERCENTAGE_STEP] = self.percentage_step
|
|
|
|
if (
|
|
supported_features & SUPPORT_PRESET_MODE
|
|
or supported_features & SUPPORT_SET_SPEED
|
|
):
|
|
data[ATTR_PRESET_MODE] = self.preset_mode
|
|
|
|
return data
|
|
|
|
@property
|
|
def supported_features(self) -> int:
|
|
"""Flag supported features."""
|
|
return 0
|
|
|
|
@property
|
|
def preset_mode(self) -> str | None:
|
|
"""Return the current preset mode, e.g., auto, smart, interval, favorite.
|
|
|
|
Requires SUPPORT_SET_SPEED.
|
|
"""
|
|
speed = self.speed
|
|
if self.preset_modes and speed in self.preset_modes:
|
|
return speed
|
|
return None
|
|
|
|
@property
|
|
def preset_modes(self) -> list[str] | None:
|
|
"""Return a list of available preset modes.
|
|
|
|
Requires SUPPORT_SET_SPEED.
|
|
"""
|
|
return preset_modes_from_speed_list(self.speed_list)
|
|
|
|
|
|
def speed_list_without_preset_modes(speed_list: list):
|
|
"""Filter out non-speeds from the speed list.
|
|
|
|
The goal is to get the speeds in a list from lowest to
|
|
highest by removing speeds that are not valid or out of order
|
|
so we can map them to percentages.
|
|
|
|
Examples:
|
|
input: ["off", "low", "low-medium", "medium", "medium-high", "high", "auto"]
|
|
output: ["low", "low-medium", "medium", "medium-high", "high"]
|
|
|
|
input: ["off", "auto", "low", "medium", "high"]
|
|
output: ["low", "medium", "high"]
|
|
|
|
input: ["off", "1", "2", "3", "4", "5", "6", "7", "smart"]
|
|
output: ["1", "2", "3", "4", "5", "6", "7"]
|
|
|
|
input: ["Auto", "Silent", "Favorite", "Idle", "Medium", "High", "Strong"]
|
|
output: ["Medium", "High", "Strong"]
|
|
"""
|
|
|
|
return [speed for speed in speed_list if speed.lower() not in _NOT_SPEEDS_FILTER]
|
|
|
|
|
|
def preset_modes_from_speed_list(speed_list: list):
|
|
"""Filter out non-preset modes from the speed list.
|
|
|
|
The goal is to return only preset modes.
|
|
|
|
Examples:
|
|
input: ["off", "low", "low-medium", "medium", "medium-high", "high", "auto"]
|
|
output: ["auto"]
|
|
|
|
input: ["off", "auto", "low", "medium", "high"]
|
|
output: ["auto"]
|
|
|
|
input: ["off", "1", "2", "3", "4", "5", "6", "7", "smart"]
|
|
output: ["smart"]
|
|
|
|
input: ["Auto", "Silent", "Favorite", "Idle", "Medium", "High", "Strong"]
|
|
output: ["Auto", "Silent", "Favorite", "Idle"]
|
|
"""
|
|
|
|
return [
|
|
speed
|
|
for speed in speed_list
|
|
if speed.lower() in _NOT_SPEEDS_FILTER and speed.lower() != SPEED_OFF
|
|
]
|