cover.py

Go to the documentation of this file.

"""Representation of a cover."""
 
from __future__ import annotations
 
from typing import Any
 
from homeassistant.components.cover import (
    ATTR_POSITION,
    CoverEntity,
    CoverEntityFeature,
)
from homeassistant.config_entries import ConfigEntry
from homeassistant.core import HomeAssistant, callback
from homeassistant.helpers.dispatcher import async_dispatcher_connect
from homeassistant.helpers.entity_platform import AddEntitiesCallback
 
from .const import DOMAIN, ZWaveMePlatform
from .entity import ZWaveMeEntity
 
DEVICE_NAME = ZWaveMePlatform.COVER
 
 
async def async_setup_entry(
    hass: HomeAssistant,
    config_entry: ConfigEntry,
    async_add_entities: AddEntitiesCallback,
) -> None:
    """Set up the cover platform."""
 
    @callback
    def add_new_device(new_device):
        controller = hass.data[DOMAIN][config_entry.entry_id]
        cover = ZWaveMeCover(controller, new_device)
 
        async_add_entities(
            [
                cover,
            ]
        )
 
    config_entry.async_on_unload(
        async_dispatcher_connect(
            hass, f"ZWAVE_ME_NEW_{DEVICE_NAME.upper()}", add_new_device
        )
    )
 
 
class ZWaveMeCover(ZWaveMeEntity, CoverEntity):
    """Representation of a ZWaveMe Multilevel Cover."""
 
    _attr_supported_features = (
        CoverEntityFeature.OPEN
        | CoverEntityFeature.CLOSE
        | CoverEntityFeature.SET_POSITION
        | CoverEntityFeature.STOP
    )
 
    def close_cover(self, **kwargs: Any) -> None:
        """Close cover."""
        self.controllercontroller.zwave_api.send_command(self.devicedevice.id, "exact?level=0")
 
    def open_cover(self, **kwargs: Any) -> None:
        """Open cover."""
        self.controllercontroller.zwave_api.send_command(self.devicedevice.id, "exact?level=99")
 
    def set_cover_position(self, **kwargs: Any) -> None:
        """Update the current value."""
        value = kwargs[ATTR_POSITION]
        self.controllercontroller.zwave_api.send_command(
            self.devicedevice.id, f"exact?level={min(value, 99)!s}"
        )
 
    def stop_cover(self, **kwargs: Any) -> None:
        """Stop cover."""
        self.controllercontroller.zwave_api.send_command(self.devicedevice.id, "stop")
 
    @property
    def current_cover_position(self) -> int | None:
        """Return current position of cover.
 
        None is unknown, 0 is closed, 100 is fully open.
 
        Allow small calibration errors (some devices after a long time
        become not well calibrated).
        """
        if self.devicedevice.level > 95:
            return 100
 
        return self.devicedevice.level
 
    @property
    def is_closed(self) -> bool | None:
        """Return true if cover is closed.
 
        None is unknown.
 
        Allow small calibration errors (some devices after a long time
        become not well calibrated).
        """
        if self.devicedevice.level is None:
            return None
 
        return self.devicedevice.level < 5