Files
devmel_hass_airsend/custom_components/airsend/cover.py
T
Daniel Moindrot b079939ccb Add invert option for covers with reversed open/close logic
- Add invert: true option in airsend.yaml for covers where
  open/close logic is reversed (e.g. shade sails, projector screens)
- UP/DOWN commands are swapped when invert is enabled
- Position value is mirrored (100 - position) for covers with position
- is_closed state logic is inverted accordingly
- inverted: true shown in entity attributes when active
2026-06-12 08:20:30 +02:00

154 lines
5.6 KiB
Python

"""AirSend covers."""
from typing import Any
from .device import Device, TransferResult
from homeassistant.components.cover import CoverEntity
from homeassistant.config_entries import ConfigEntry
from homeassistant.core import HomeAssistant
from homeassistant.helpers.entity import DeviceInfo
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.restore_state import RestoreEntity
from homeassistant.const import CONF_INTERNAL_URL
from . import DOMAIN
async def async_setup_entry(
hass: HomeAssistant,
entry: ConfigEntry,
async_add_entities: AddEntitiesCallback,
) -> None:
"""Set up AirSend covers from a config entry."""
internal_url = entry.data.get(CONF_INTERNAL_URL, "")
devices_config = entry.data.get("devices", {})
entities = []
for name, options in devices_config.items():
device = Device(name, options, internal_url)
if device.is_cover:
entities.append(AirSendCover(hass, device))
async_add_entities(entities)
class AirSendCover(RestoreEntity, CoverEntity):
"""Representation of an AirSend Cover."""
def __init__(self, hass: HomeAssistant, device: Device) -> None:
self._hass = hass
self._device = device
self._unique_id = DOMAIN + "_" + str(device.unique_channel_name) + "_cover"
self._closed = None
self._available = True
if device.is_cover_with_position:
self._attr_current_cover_position = 50
@property
def unique_id(self):
return self._unique_id
@property
def available(self):
return self._available
@property
def should_poll(self):
return False
@property
def name(self):
return self._device.name
@property
def extra_state_attributes(self):
attrs = self._device.extra_state_attributes or {}
if self._device.is_inverted:
attrs = {**attrs, "inverted": True}
return attrs or None
@property
def assumed_state(self):
return True
@property
def device_info(self) -> DeviceInfo:
return self._device.device_info
@property
def is_closed(self):
if self._device.is_async and self._hass:
component = self._hass.states.get(self.entity_id)
if component is not None:
is_open_state = component.state not in ('open', 'on', 'up')
# Invert the closed logic if needed
self._closed = not is_open_state if self._device.is_inverted else is_open_state
return self._closed
async def async_added_to_hass(self):
"""Restore last known state when added to hass."""
await super().async_added_to_hass()
last_state = await self.async_get_last_state()
if last_state and last_state.state not in ('unavailable', 'unknown'):
if self._device.is_cover_with_position:
if last_state.attributes.get('current_position') is not None:
self._attr_current_cover_position = last_state.attributes['current_position']
if last_state.state == 'closed':
self._attr_current_cover_position = 0
elif last_state.state == 'open':
self._attr_current_cover_position = 100
if last_state.state == 'closed':
self._closed = True
elif last_state.state == 'open':
self._closed = False
self.async_write_ha_state()
async def _send(self, note: dict) -> bool:
"""Send a command and update availability accordingly."""
result = await self._device.async_transfer(note, self.entity_id)
available = result != TransferResult.NETWORK_ERROR
if self._available != available:
self._available = available
self.async_write_ha_state()
return result in (TransferResult.SUCCESS, TransferResult.SENT)
def _up_note(self) -> dict:
"""Return UP note, inverted if needed."""
value = "DOWN" if self._device.is_inverted else "UP"
return {"method": 1, "type": 0, "value": value}
def _down_note(self) -> dict:
"""Return DOWN note, inverted if needed."""
value = "UP" if self._device.is_inverted else "DOWN"
return {"method": 1, "type": 0, "value": value}
async def async_open_cover(self, **kwargs: Any) -> None:
if await self._send(self._up_note()):
self._closed = False
if self._device.is_cover_with_position:
self._attr_current_cover_position = 100
self.async_write_ha_state()
async def async_close_cover(self, **kwargs: Any) -> None:
if await self._send(self._down_note()):
self._closed = True
if self._device.is_cover_with_position:
self._attr_current_cover_position = 0
self.async_write_ha_state()
async def async_stop_cover(self, **kwargs: Any) -> None:
note = {"method": 1, "type": 0, "value": "STOP"}
if await self._send(note):
self._closed = False
if self._device.is_cover_with_position:
self._attr_current_cover_position = 50
self.async_write_ha_state()
async def async_set_cover_position(self, **kwargs: Any) -> None:
position = int(kwargs["position"])
# Invert position value if needed
actual_position = (100 - position) if self._device.is_inverted else position
note = {"method": 1, "type": 9, "value": actual_position}
if await self._send(note):
self._attr_current_cover_position = position
self._closed = position == 0
self.async_write_ha_state()