"""Switch for Shelly.""" from __future__ import annotations from dataclasses import dataclass from typing import Any, cast from aioshelly.block_device import Block from aioshelly.const import MODEL_2, MODEL_25, MODEL_WALL_DISPLAY, RPC_GENERATIONS from homeassistant.components.switch import SwitchEntity, SwitchEntityDescription from homeassistant.const import STATE_ON, EntityCategory from homeassistant.core import HomeAssistant, State, callback from homeassistant.helpers.entity_platform import AddEntitiesCallback from homeassistant.helpers.entity_registry import RegistryEntry from homeassistant.helpers.restore_state import RestoreEntity from .const import CONF_SLEEP_PERIOD, MOTION_MODELS from .coordinator import ShellyBlockCoordinator, ShellyConfigEntry, ShellyRpcCoordinator from .entity import ( BlockEntityDescription, ShellyBlockEntity, ShellyRpcEntity, ShellySleepingBlockAttributeEntity, async_setup_entry_attribute_entities, ) from .utils import ( async_remove_shelly_entity, get_device_entry_gen, get_rpc_key_ids, is_block_channel_type_light, is_rpc_channel_type_light, is_rpc_thermostat_internal_actuator, is_rpc_thermostat_mode, ) @dataclass(frozen=True, kw_only=True) class BlockSwitchDescription(BlockEntityDescription, SwitchEntityDescription): """Class to describe a BLOCK switch.""" MOTION_SWITCH = BlockSwitchDescription( key="sensor|motionActive", name="Motion detection", entity_category=EntityCategory.CONFIG, ) async def async_setup_entry( hass: HomeAssistant, config_entry: ShellyConfigEntry, async_add_entities: AddEntitiesCallback, ) -> None: """Set up switches for device.""" if get_device_entry_gen(config_entry) in RPC_GENERATIONS: return async_setup_rpc_entry(hass, config_entry, async_add_entities) return async_setup_block_entry(hass, config_entry, async_add_entities) @callback def async_setup_block_entry( hass: HomeAssistant, config_entry: ShellyConfigEntry, async_add_entities: AddEntitiesCallback, ) -> None: """Set up entities for block device.""" coordinator = config_entry.runtime_data.block assert coordinator # Add Shelly Motion as a switch if coordinator.model in MOTION_MODELS: async_setup_entry_attribute_entities( hass, config_entry, async_add_entities, {("sensor", "motionActive"): MOTION_SWITCH}, BlockSleepingMotionSwitch, ) return if config_entry.data[CONF_SLEEP_PERIOD]: return # In roller mode the relay blocks exist but do not contain required info if ( coordinator.model in [MODEL_2, MODEL_25] and coordinator.device.settings["mode"] != "relay" ): return relay_blocks = [] assert coordinator.device.blocks for block in coordinator.device.blocks: if ( block.type != "relay" or block.channel is not None and is_block_channel_type_light( coordinator.device.settings, int(block.channel) ) ): continue relay_blocks.append(block) unique_id = f"{coordinator.mac}-{block.type}_{block.channel}" async_remove_shelly_entity(hass, "light", unique_id) if not relay_blocks: return async_add_entities(BlockRelaySwitch(coordinator, block) for block in relay_blocks) @callback def async_setup_rpc_entry( hass: HomeAssistant, config_entry: ShellyConfigEntry, async_add_entities: AddEntitiesCallback, ) -> None: """Set up entities for RPC device.""" coordinator = config_entry.runtime_data.rpc assert coordinator switch_key_ids = get_rpc_key_ids(coordinator.device.status, "switch") switch_ids = [] for id_ in switch_key_ids: if is_rpc_channel_type_light(coordinator.device.config, id_): continue if coordinator.model == MODEL_WALL_DISPLAY: # There are three configuration scenarios for WallDisplay: # - relay mode (no thermostat) # - thermostat mode using the internal relay as an actuator # - thermostat mode using an external (from another device) relay as # an actuator if not is_rpc_thermostat_mode(id_, coordinator.device.status): # The device is not in thermostat mode, we need to remove a climate # entity unique_id = f"{coordinator.mac}-thermostat:{id_}" async_remove_shelly_entity(hass, "climate", unique_id) elif is_rpc_thermostat_internal_actuator(coordinator.device.status): # The internal relay is an actuator, skip this ID so as not to create # a switch entity continue switch_ids.append(id_) unique_id = f"{coordinator.mac}-switch:{id_}" async_remove_shelly_entity(hass, "light", unique_id) if not switch_ids: return async_add_entities(RpcRelaySwitch(coordinator, id_) for id_ in switch_ids) class BlockSleepingMotionSwitch( ShellySleepingBlockAttributeEntity, RestoreEntity, SwitchEntity ): """Entity that controls Motion Sensor on Block based Shelly devices.""" entity_description: BlockSwitchDescription _attr_translation_key = "motion_switch" def __init__( self, coordinator: ShellyBlockCoordinator, block: Block | None, attribute: str, description: BlockSwitchDescription, entry: RegistryEntry | None = None, ) -> None: """Initialize the sleeping sensor.""" super().__init__(coordinator, block, attribute, description, entry) self.last_state: State | None = None @property def is_on(self) -> bool | None: """If motion is active.""" if self.block is not None: return bool(self.block.motionActive) if self.last_state is None: return None return self.last_state.state == STATE_ON async def async_turn_on(self, **kwargs: Any) -> None: """Activate switch.""" await self.coordinator.device.set_shelly_motion_detection(True) self.async_write_ha_state() async def async_turn_off(self, **kwargs: Any) -> None: """Deactivate switch.""" await self.coordinator.device.set_shelly_motion_detection(False) self.async_write_ha_state() async def async_added_to_hass(self) -> None: """Handle entity which will be added.""" await super().async_added_to_hass() if (last_state := await self.async_get_last_state()) is not None: self.last_state = last_state class BlockRelaySwitch(ShellyBlockEntity, SwitchEntity): """Entity that controls a relay on Block based Shelly devices.""" def __init__(self, coordinator: ShellyBlockCoordinator, block: Block) -> None: """Initialize relay switch.""" super().__init__(coordinator, block) self.control_result: dict[str, Any] | None = None @property def is_on(self) -> bool: """If switch is on.""" if self.control_result: return cast(bool, self.control_result["ison"]) return bool(self.block.output) async def async_turn_on(self, **kwargs: Any) -> None: """Turn on relay.""" self.control_result = await self.set_state(turn="on") self.async_write_ha_state() async def async_turn_off(self, **kwargs: Any) -> None: """Turn off relay.""" self.control_result = await self.set_state(turn="off") self.async_write_ha_state() @callback def _update_callback(self) -> None: """When device updates, clear control result that overrides state.""" self.control_result = None super()._update_callback() class RpcRelaySwitch(ShellyRpcEntity, SwitchEntity): """Entity that controls a relay on RPC based Shelly devices.""" def __init__(self, coordinator: ShellyRpcCoordinator, id_: int) -> None: """Initialize relay switch.""" super().__init__(coordinator, f"switch:{id_}") self._id = id_ @property def is_on(self) -> bool: """If switch is on.""" return bool(self.status["output"]) async def async_turn_on(self, **kwargs: Any) -> None: """Turn on relay.""" await self.call_rpc("Switch.Set", {"id": self._id, "on": True}) async def async_turn_off(self, **kwargs: Any) -> None: """Turn off relay.""" await self.call_rpc("Switch.Set", {"id": self._id, "on": False})