""" This platform allows several cover to be grouped into one cover. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/cover.group/ """ import logging import voluptuous as vol from homeassistant.core import callback from homeassistant.components.cover import ( DOMAIN, PLATFORM_SCHEMA, CoverDevice, ATTR_POSITION, ATTR_CURRENT_POSITION, ATTR_TILT_POSITION, ATTR_CURRENT_TILT_POSITION, SUPPORT_OPEN, SUPPORT_CLOSE, SUPPORT_STOP, SUPPORT_SET_POSITION, SUPPORT_OPEN_TILT, SUPPORT_CLOSE_TILT, SUPPORT_STOP_TILT, SUPPORT_SET_TILT_POSITION, SERVICE_OPEN_COVER, SERVICE_CLOSE_COVER, SERVICE_SET_COVER_POSITION, SERVICE_STOP_COVER, SERVICE_OPEN_COVER_TILT, SERVICE_CLOSE_COVER_TILT, SERVICE_STOP_COVER_TILT, SERVICE_SET_COVER_TILT_POSITION) from homeassistant.const import ( ATTR_ASSUMED_STATE, ATTR_ENTITY_ID, ATTR_SUPPORTED_FEATURES, CONF_ENTITIES, CONF_NAME, STATE_CLOSED) import homeassistant.helpers.config_validation as cv from homeassistant.helpers.event import async_track_state_change _LOGGER = logging.getLogger(__name__) KEY_OPEN_CLOSE = 'open_close' KEY_STOP = 'stop' KEY_POSITION = 'position' DEFAULT_NAME = 'Cover Group' PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Optional(CONF_NAME, default=DEFAULT_NAME): cv.string, vol.Required(CONF_ENTITIES): cv.entities_domain(DOMAIN), }) async def async_setup_platform(hass, config, async_add_entities, discovery_info=None): """Set up the Group Cover platform.""" async_add_entities( [CoverGroup(config[CONF_NAME], config[CONF_ENTITIES])]) class CoverGroup(CoverDevice): """Representation of a CoverGroup.""" def __init__(self, name, entities): """Initialize a CoverGroup entity.""" self._name = name self._is_closed = False self._cover_position = 100 self._tilt_position = None self._supported_features = 0 self._assumed_state = True self._entities = entities self._covers = {KEY_OPEN_CLOSE: set(), KEY_STOP: set(), KEY_POSITION: set()} self._tilts = {KEY_OPEN_CLOSE: set(), KEY_STOP: set(), KEY_POSITION: set()} @callback def update_supported_features(self, entity_id, old_state, new_state, update_state=True): """Update dictionaries with supported features.""" if not new_state: for values in self._covers.values(): values.discard(entity_id) for values in self._tilts.values(): values.discard(entity_id) if update_state: self.async_schedule_update_ha_state(True) return features = new_state.attributes.get(ATTR_SUPPORTED_FEATURES, 0) if features & (SUPPORT_OPEN | SUPPORT_CLOSE): self._covers[KEY_OPEN_CLOSE].add(entity_id) else: self._covers[KEY_OPEN_CLOSE].discard(entity_id) if features & (SUPPORT_STOP): self._covers[KEY_STOP].add(entity_id) else: self._covers[KEY_STOP].discard(entity_id) if features & (SUPPORT_SET_POSITION): self._covers[KEY_POSITION].add(entity_id) else: self._covers[KEY_POSITION].discard(entity_id) if features & (SUPPORT_OPEN_TILT | SUPPORT_CLOSE_TILT): self._tilts[KEY_OPEN_CLOSE].add(entity_id) else: self._tilts[KEY_OPEN_CLOSE].discard(entity_id) if features & (SUPPORT_STOP_TILT): self._tilts[KEY_STOP].add(entity_id) else: self._tilts[KEY_STOP].discard(entity_id) if features & (SUPPORT_SET_TILT_POSITION): self._tilts[KEY_POSITION].add(entity_id) else: self._tilts[KEY_POSITION].discard(entity_id) if update_state: self.async_schedule_update_ha_state(True) async def async_added_to_hass(self): """Register listeners.""" for entity_id in self._entities: new_state = self.hass.states.get(entity_id) self.update_supported_features(entity_id, None, new_state, update_state=False) async_track_state_change(self.hass, self._entities, self.update_supported_features) await self.async_update() @property def name(self): """Return the name of the cover.""" return self._name @property def assumed_state(self): """Enable buttons even if at end position.""" return self._assumed_state @property def should_poll(self): """Disable polling for cover group.""" return False @property def supported_features(self): """Flag supported features for the cover.""" return self._supported_features @property def is_closed(self): """Return if all covers in group are closed.""" return self._is_closed @property def current_cover_position(self): """Return current position for all covers.""" return self._cover_position @property def current_cover_tilt_position(self): """Return current tilt position for all covers.""" return self._tilt_position async def async_open_cover(self, **kwargs): """Move the covers up.""" data = {ATTR_ENTITY_ID: self._covers[KEY_OPEN_CLOSE]} await self.hass.services.async_call( DOMAIN, SERVICE_OPEN_COVER, data, blocking=True) async def async_close_cover(self, **kwargs): """Move the covers down.""" data = {ATTR_ENTITY_ID: self._covers[KEY_OPEN_CLOSE]} await self.hass.services.async_call( DOMAIN, SERVICE_CLOSE_COVER, data, blocking=True) async def async_stop_cover(self, **kwargs): """Fire the stop action.""" data = {ATTR_ENTITY_ID: self._covers[KEY_STOP]} await self.hass.services.async_call( DOMAIN, SERVICE_STOP_COVER, data, blocking=True) async def async_set_cover_position(self, **kwargs): """Set covers position.""" data = {ATTR_ENTITY_ID: self._covers[KEY_POSITION], ATTR_POSITION: kwargs[ATTR_POSITION]} await self.hass.services.async_call( DOMAIN, SERVICE_SET_COVER_POSITION, data, blocking=True) async def async_open_cover_tilt(self, **kwargs): """Tilt covers open.""" data = {ATTR_ENTITY_ID: self._tilts[KEY_OPEN_CLOSE]} await self.hass.services.async_call( DOMAIN, SERVICE_OPEN_COVER_TILT, data, blocking=True) async def async_close_cover_tilt(self, **kwargs): """Tilt covers closed.""" data = {ATTR_ENTITY_ID: self._tilts[KEY_OPEN_CLOSE]} await self.hass.services.async_call( DOMAIN, SERVICE_CLOSE_COVER_TILT, data, blocking=True) async def async_stop_cover_tilt(self, **kwargs): """Stop cover tilt.""" data = {ATTR_ENTITY_ID: self._tilts[KEY_STOP]} await self.hass.services.async_call( DOMAIN, SERVICE_STOP_COVER_TILT, data, blocking=True) async def async_set_cover_tilt_position(self, **kwargs): """Set tilt position.""" data = {ATTR_ENTITY_ID: self._tilts[KEY_POSITION], ATTR_TILT_POSITION: kwargs[ATTR_TILT_POSITION]} await self.hass.services.async_call( DOMAIN, SERVICE_SET_COVER_TILT_POSITION, data, blocking=True) async def async_update(self): """Update state and attributes.""" self._assumed_state = False self._is_closed = True for entity_id in self._entities: state = self.hass.states.get(entity_id) if not state: continue if state.state != STATE_CLOSED: self._is_closed = False break self._cover_position = None if self._covers[KEY_POSITION]: position = -1 self._cover_position = 0 if self.is_closed else 100 for entity_id in self._covers[KEY_POSITION]: state = self.hass.states.get(entity_id) pos = state.attributes.get(ATTR_CURRENT_POSITION) if position == -1: position = pos elif position != pos: self._assumed_state = True break else: if position != -1: self._cover_position = position self._tilt_position = None if self._tilts[KEY_POSITION]: position = -1 self._tilt_position = 100 for entity_id in self._tilts[KEY_POSITION]: state = self.hass.states.get(entity_id) pos = state.attributes.get(ATTR_CURRENT_TILT_POSITION) if position == -1: position = pos elif position != pos: self._assumed_state = True break else: if position != -1: self._tilt_position = position supported_features = 0 supported_features |= SUPPORT_OPEN | SUPPORT_CLOSE \ if self._covers[KEY_OPEN_CLOSE] else 0 supported_features |= SUPPORT_STOP \ if self._covers[KEY_STOP] else 0 supported_features |= SUPPORT_SET_POSITION \ if self._covers[KEY_POSITION] else 0 supported_features |= SUPPORT_OPEN_TILT | SUPPORT_CLOSE_TILT \ if self._tilts[KEY_OPEN_CLOSE] else 0 supported_features |= SUPPORT_STOP_TILT \ if self._tilts[KEY_STOP] else 0 supported_features |= SUPPORT_SET_TILT_POSITION \ if self._tilts[KEY_POSITION] else 0 self._supported_features = supported_features if not self._assumed_state: for entity_id in self._entities: state = self.hass.states.get(entity_id) if state and state.attributes.get(ATTR_ASSUMED_STATE): self._assumed_state = True break