371 lines
14 KiB
Python
371 lines
14 KiB
Python
"""Hunter Douglas Powerview cover."""
|
|
|
|
from typing import Any, Final
|
|
|
|
from bleak.exc import BleakError
|
|
|
|
from homeassistant.components.bluetooth.passive_update_coordinator import (
|
|
PassiveBluetoothCoordinatorEntity,
|
|
)
|
|
from homeassistant.components.cover import (
|
|
ATTR_CURRENT_POSITION,
|
|
ATTR_CURRENT_TILT_POSITION,
|
|
ATTR_POSITION,
|
|
ATTR_TILT_POSITION,
|
|
CoverDeviceClass,
|
|
CoverEntity,
|
|
CoverEntityFeature,
|
|
)
|
|
from homeassistant.core import HomeAssistant
|
|
from homeassistant.helpers.device_registry import format_mac
|
|
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
|
|
|
from . import ConfigEntryType, async_setup_shade_platform
|
|
from .api import CLOSED_POSITION, OPEN_POSITION
|
|
from .const import DOMAIN, LOGGER
|
|
from .coordinator import PVCoordinator
|
|
|
|
|
|
def _add_entities(
|
|
coordinator: PVCoordinator, async_add_entities: AddEntitiesCallback
|
|
) -> None:
|
|
"""Create cover entities for a single shade coordinator."""
|
|
caps = coordinator.shade_capabilities
|
|
|
|
if caps.tilt_only:
|
|
entities: list[PowerViewCover] = [PowerViewCoverTiltOnly(coordinator)]
|
|
elif caps.has_tilt:
|
|
entities = [PowerViewCoverTilt(coordinator)]
|
|
elif caps.is_top_down:
|
|
entities = [PowerViewCoverTopDown(coordinator)]
|
|
else:
|
|
entities = [PowerViewCover(coordinator)]
|
|
|
|
async_add_entities(entities)
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
config_entry: ConfigEntryType,
|
|
async_add_entities: AddEntitiesCallback,
|
|
) -> None:
|
|
"""Set up the cover platform."""
|
|
async_setup_shade_platform(hass, config_entry, async_add_entities, _add_entities)
|
|
|
|
|
|
class PowerViewCover(PassiveBluetoothCoordinatorEntity[PVCoordinator], CoverEntity): # type: ignore[reportIncompatibleVariableOverride]
|
|
"""Representation of a PowerView shade with Up/Down functionality only."""
|
|
|
|
_attr_has_entity_name = True
|
|
_attr_device_class = CoverDeviceClass.SHADE
|
|
_attr_supported_features = (
|
|
CoverEntityFeature.OPEN
|
|
| CoverEntityFeature.CLOSE
|
|
| CoverEntityFeature.SET_POSITION
|
|
| CoverEntityFeature.STOP
|
|
)
|
|
|
|
def __init__(
|
|
self,
|
|
coordinator: PVCoordinator,
|
|
) -> None:
|
|
"""Initialize the shade."""
|
|
LOGGER.debug("%s: init() PowerViewCover", coordinator.name)
|
|
self._attr_name = None
|
|
self._coord: PVCoordinator = coordinator
|
|
self._attr_device_info = self._coord.device_info
|
|
self._target_position: int | None = round(
|
|
self._coord.data.get(ATTR_CURRENT_POSITION, OPEN_POSITION)
|
|
)
|
|
self._attr_unique_id = (
|
|
f"{DOMAIN}_{format_mac(self._coord.address)}_{CoverDeviceClass.SHADE}"
|
|
)
|
|
super().__init__(coordinator)
|
|
|
|
@property
|
|
def is_opening(self) -> bool | None: # type: ignore[reportIncompatibleVariableOverride]
|
|
"""Return if the cover is opening or not."""
|
|
return bool(self._coord.data.get("is_opening")) or (
|
|
isinstance(self._target_position, int)
|
|
and isinstance(self.current_cover_position, int)
|
|
and self._target_position > self.current_cover_position
|
|
and self._coord.api.is_connected
|
|
)
|
|
|
|
@property
|
|
def is_closing(self) -> bool | None: # type: ignore[reportIncompatibleVariableOverride]
|
|
"""Return if the cover is closing or not."""
|
|
return bool(self._coord.data.get("is_closing")) or (
|
|
isinstance(self._target_position, int)
|
|
and isinstance(self.current_cover_position, int)
|
|
and self._target_position < self.current_cover_position
|
|
and self._coord.api.is_connected
|
|
)
|
|
|
|
@property
|
|
def is_closed(self) -> bool: # type: ignore[reportIncompatibleVariableOverride]
|
|
"""Return if the cover is closed."""
|
|
return self.current_cover_position == CLOSED_POSITION
|
|
|
|
@property
|
|
def supported_features(self) -> CoverEntityFeature: # type: ignore[reportIncompatibleVariableOverride]
|
|
"""Flag supported features, disable control if encryption is needed."""
|
|
if self._coord.data.get("home_id") and not self._coord.api.has_key:
|
|
return CoverEntityFeature(0)
|
|
|
|
return super().supported_features
|
|
|
|
@property
|
|
def current_cover_position(self) -> int | None: # type: ignore[reportIncompatibleVariableOverride]
|
|
"""Return current position of cover.
|
|
|
|
None is unknown, 0 is closed, 100 is fully open.
|
|
"""
|
|
pos: Final = self._coord.data.get(ATTR_CURRENT_POSITION)
|
|
return round(pos) if pos is not None else None
|
|
|
|
async def async_set_cover_position(self, **kwargs: Any) -> None:
|
|
"""Move the cover to a specific position."""
|
|
target_position: Final = kwargs.get(ATTR_POSITION)
|
|
if target_position is not None:
|
|
LOGGER.debug("set cover to position %f", target_position)
|
|
if self.current_cover_position == round(target_position) and not (
|
|
self.is_closing or self.is_opening
|
|
):
|
|
return
|
|
self._target_position = round(target_position)
|
|
try:
|
|
await self._coord.api.set_position(
|
|
round(target_position),
|
|
velocity=self._coord.velocity,
|
|
)
|
|
self.async_write_ha_state()
|
|
except BleakError as err:
|
|
LOGGER.error(
|
|
"Failed to move cover '%s' to %f%%: %s",
|
|
self.name,
|
|
target_position,
|
|
err,
|
|
)
|
|
|
|
def _reset_target_position(self) -> None:
|
|
self._target_position = None
|
|
|
|
async def async_open_cover(self, **kwargs: Any) -> None:
|
|
"""Open the cover."""
|
|
LOGGER.debug("open cover")
|
|
if self.current_cover_position == OPEN_POSITION:
|
|
return
|
|
try:
|
|
self._target_position = OPEN_POSITION
|
|
await self._coord.api.open(velocity=self._coord.velocity)
|
|
self.async_write_ha_state()
|
|
except BleakError as err:
|
|
LOGGER.error("Failed to open cover '%s': %s", self.name, err)
|
|
self._reset_target_position()
|
|
|
|
async def async_close_cover(self, **kwargs: Any) -> None:
|
|
"""Close the cover tilt."""
|
|
LOGGER.debug("close cover")
|
|
if self.current_cover_position == CLOSED_POSITION:
|
|
return
|
|
try:
|
|
self._target_position = CLOSED_POSITION
|
|
await self._coord.api.close(velocity=self._coord.velocity)
|
|
self.async_write_ha_state()
|
|
except BleakError as err:
|
|
LOGGER.error("Failed to close cover '%s': %s", self.name, err)
|
|
self._reset_target_position()
|
|
|
|
async def async_stop_cover(self, **kwargs: Any) -> None:
|
|
"""Stop the cover."""
|
|
LOGGER.debug("stop cover")
|
|
try:
|
|
await self._coord.api.stop()
|
|
self._reset_target_position()
|
|
self.async_write_ha_state()
|
|
except BleakError as err:
|
|
LOGGER.error("Failed to stop cover '%s': %s", self.name, err)
|
|
|
|
|
|
class PowerViewCoverTilt(PowerViewCover):
|
|
"""Representation of a PowerView shade with additional tilt functionality."""
|
|
|
|
_attr_supported_features = (
|
|
CoverEntityFeature.OPEN
|
|
| CoverEntityFeature.CLOSE
|
|
| CoverEntityFeature.STOP
|
|
| CoverEntityFeature.SET_POSITION
|
|
| CoverEntityFeature.OPEN_TILT
|
|
| CoverEntityFeature.CLOSE_TILT
|
|
| CoverEntityFeature.STOP_TILT
|
|
| CoverEntityFeature.SET_TILT_POSITION
|
|
)
|
|
|
|
def __init__(
|
|
self,
|
|
coordinator: PVCoordinator,
|
|
) -> None:
|
|
"""Initialize the shade with tilt."""
|
|
LOGGER.debug("%s: init() PowerViewCoverTilt", coordinator.name)
|
|
super().__init__(coordinator)
|
|
|
|
@property
|
|
def current_cover_tilt_position(self) -> int | None: # type: ignore[reportIncompatibleVariableOverride]
|
|
"""Return current tilt of cover.
|
|
|
|
None is unknown
|
|
"""
|
|
pos: Final = self._coord.data.get(ATTR_CURRENT_TILT_POSITION)
|
|
return round(pos) if pos is not None else None
|
|
|
|
async def async_set_cover_tilt_position(self, **kwargs: Any) -> None:
|
|
"""Move the tilt to a specific position."""
|
|
|
|
if isinstance(target_position := kwargs.get(ATTR_TILT_POSITION), int):
|
|
LOGGER.debug("set cover tilt to position %i", target_position)
|
|
if (
|
|
self.current_cover_tilt_position == round(target_position)
|
|
or self.current_cover_position is None
|
|
):
|
|
return
|
|
|
|
try:
|
|
await self._coord.api.set_position(
|
|
self.current_cover_position,
|
|
tilt=target_position,
|
|
velocity=self._coord.velocity,
|
|
)
|
|
self.async_write_ha_state()
|
|
except BleakError as err:
|
|
LOGGER.error(
|
|
"Failed to tilt cover '%s' to %f%%: %s",
|
|
self.name,
|
|
target_position,
|
|
err,
|
|
)
|
|
|
|
async def async_stop_cover_tilt(self, **kwargs: Any) -> None:
|
|
"""Stop the cover."""
|
|
await self.async_stop_cover(**kwargs)
|
|
|
|
async def async_open_cover_tilt(self, **kwargs: Any) -> None:
|
|
"""Open the cover tilt."""
|
|
LOGGER.debug("open cover tilt")
|
|
_kwargs = {**kwargs, ATTR_TILT_POSITION: OPEN_POSITION}
|
|
await self.async_set_cover_tilt_position(**_kwargs)
|
|
|
|
async def async_close_cover_tilt(self, **kwargs: Any) -> None:
|
|
"""Close the cover tilt."""
|
|
LOGGER.debug("close cover tilt")
|
|
_kwargs = {**kwargs, ATTR_TILT_POSITION: CLOSED_POSITION}
|
|
await self.async_set_cover_tilt_position(**_kwargs)
|
|
|
|
|
|
class PowerViewCoverTopDown(PowerViewCover):
|
|
"""Representation of a top-down PowerView shade.
|
|
|
|
The device position axis is inverted: device 0 = open (fabric retracted),
|
|
device 100 = closed (fabric fully extended). We translate at the boundary
|
|
so HA's standard 0=closed / 100=open convention is preserved.
|
|
"""
|
|
|
|
@property
|
|
def current_cover_position(self) -> int | None: # type: ignore[reportIncompatibleVariableOverride]
|
|
"""Return current position, inverting the device axis."""
|
|
pos: Final = self._coord.data.get(ATTR_CURRENT_POSITION)
|
|
return OPEN_POSITION - round(pos) if pos is not None else None
|
|
|
|
async def async_set_cover_position(self, **kwargs: Any) -> None:
|
|
"""Move the cover to a specific position, inverting for the device."""
|
|
target_position: Final = kwargs.get(ATTR_POSITION)
|
|
if target_position is not None:
|
|
inverted = OPEN_POSITION - round(target_position)
|
|
LOGGER.debug("set top-down cover to position %f (device %i)", target_position, inverted)
|
|
if self.current_cover_position == round(target_position) and not (
|
|
self.is_closing or self.is_opening
|
|
):
|
|
return
|
|
self._target_position = round(target_position)
|
|
try:
|
|
await self._coord.api.set_position(
|
|
inverted,
|
|
velocity=self._coord.velocity,
|
|
)
|
|
self.async_write_ha_state()
|
|
except BleakError as err:
|
|
LOGGER.error(
|
|
"Failed to move cover '%s' to %f%%: %s",
|
|
self.name,
|
|
target_position,
|
|
err,
|
|
)
|
|
|
|
async def async_open_cover(self, **kwargs: Any) -> None:
|
|
"""Open the cover (send device position 0)."""
|
|
LOGGER.debug("open top-down cover")
|
|
if self.current_cover_position == OPEN_POSITION:
|
|
return
|
|
try:
|
|
self._target_position = OPEN_POSITION
|
|
await self._coord.api.set_position(CLOSED_POSITION, velocity=self._coord.velocity)
|
|
self.async_write_ha_state()
|
|
except BleakError as err:
|
|
LOGGER.error("Failed to open cover '%s': %s", self.name, err)
|
|
self._reset_target_position()
|
|
|
|
async def async_close_cover(self, **kwargs: Any) -> None:
|
|
"""Close the cover (send device position 100)."""
|
|
LOGGER.debug("close top-down cover")
|
|
if self.current_cover_position == CLOSED_POSITION:
|
|
return
|
|
try:
|
|
self._target_position = CLOSED_POSITION
|
|
await self._coord.api.set_position(OPEN_POSITION, velocity=self._coord.velocity)
|
|
self.async_write_ha_state()
|
|
except BleakError as err:
|
|
LOGGER.error("Failed to close cover '%s': %s", self.name, err)
|
|
self._reset_target_position()
|
|
|
|
|
|
class PowerViewCoverTiltOnly(PowerViewCoverTilt):
|
|
"""Representation of a PowerView shade with additional tilt functionality."""
|
|
|
|
OPENCLOSED_THRESHOLD = 5
|
|
|
|
_attr_device_class = CoverDeviceClass.BLIND
|
|
_attr_supported_features = (
|
|
CoverEntityFeature.OPEN_TILT
|
|
| CoverEntityFeature.CLOSE_TILT
|
|
| CoverEntityFeature.STOP_TILT
|
|
| CoverEntityFeature.SET_TILT_POSITION
|
|
)
|
|
|
|
def __init__(
|
|
self,
|
|
coordinator: PVCoordinator,
|
|
) -> None:
|
|
"""Initialize the shade with tilt only."""
|
|
LOGGER.debug("%s: init() PowerViewCoverTiltOnly", coordinator.name)
|
|
super().__init__(coordinator)
|
|
|
|
@property
|
|
def is_opening(self) -> bool | None: # type: ignore[reportIncompatibleVariableOverride]
|
|
"""Return if the cover is opening or not."""
|
|
return False
|
|
|
|
@property
|
|
def is_closing(self) -> bool | None: # type: ignore[reportIncompatibleVariableOverride]
|
|
"""Return if the cover is closing or not."""
|
|
return False
|
|
|
|
@property
|
|
def is_closed(self) -> bool: # type: ignore[reportIncompatibleVariableOverride]
|
|
"""Return if the cover is closed."""
|
|
return isinstance(self.current_cover_tilt_position, int) and (
|
|
self.current_cover_tilt_position
|
|
>= OPEN_POSITION - PowerViewCoverTiltOnly.OPENCLOSED_THRESHOLD
|
|
or self.current_cover_tilt_position
|
|
<= CLOSED_POSITION + PowerViewCoverTiltOnly.OPENCLOSED_THRESHOLD
|
|
)
|