mirror of
https://github.com/home-assistant/core
synced 2024-07-30 21:18:57 +02:00
134 lines
4.0 KiB
Python
134 lines
4.0 KiB
Python
"""Light support for switch entities."""
|
|
from __future__ import annotations
|
|
|
|
from typing import Any, cast
|
|
|
|
import voluptuous as vol
|
|
|
|
from homeassistant.components import switch
|
|
from homeassistant.components.light import PLATFORM_SCHEMA, LightEntity
|
|
from homeassistant.const import (
|
|
ATTR_ENTITY_ID,
|
|
CONF_ENTITY_ID,
|
|
CONF_NAME,
|
|
STATE_ON,
|
|
STATE_UNAVAILABLE,
|
|
)
|
|
from homeassistant.core import HomeAssistant, State, callback
|
|
import homeassistant.helpers.config_validation as cv
|
|
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
|
from homeassistant.helpers.event import async_track_state_change_event
|
|
from homeassistant.helpers.typing import ConfigType, DiscoveryInfoType
|
|
|
|
# mypy: allow-untyped-calls, allow-untyped-defs, no-check-untyped-defs
|
|
|
|
DEFAULT_NAME = "Light Switch"
|
|
|
|
PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend(
|
|
{
|
|
vol.Optional(CONF_NAME, default=DEFAULT_NAME): cv.string,
|
|
vol.Required(CONF_ENTITY_ID): cv.entity_domain(switch.DOMAIN),
|
|
}
|
|
)
|
|
|
|
|
|
async def async_setup_platform(
|
|
hass: HomeAssistant,
|
|
config: ConfigType,
|
|
async_add_entities: AddEntitiesCallback,
|
|
discovery_info: DiscoveryInfoType | None = None,
|
|
) -> None:
|
|
"""Initialize Light Switch platform."""
|
|
|
|
registry = await hass.helpers.entity_registry.async_get_registry()
|
|
wrapped_switch = registry.async_get(config[CONF_ENTITY_ID])
|
|
unique_id = wrapped_switch.unique_id if wrapped_switch else None
|
|
|
|
async_add_entities(
|
|
[
|
|
LightSwitch(
|
|
cast(str, config.get(CONF_NAME)),
|
|
config[CONF_ENTITY_ID],
|
|
unique_id,
|
|
)
|
|
]
|
|
)
|
|
|
|
|
|
class LightSwitch(LightEntity):
|
|
"""Represents a Switch as a Light."""
|
|
|
|
def __init__(self, name: str, switch_entity_id: str, unique_id: str) -> None:
|
|
"""Initialize Light Switch."""
|
|
self._name = name
|
|
self._switch_entity_id = switch_entity_id
|
|
self._unique_id = unique_id
|
|
self._switch_state: State | None = None
|
|
|
|
@property
|
|
def name(self) -> str:
|
|
"""Return the name of the entity."""
|
|
return self._name
|
|
|
|
@property
|
|
def is_on(self) -> bool:
|
|
"""Return true if light switch is on."""
|
|
assert self._switch_state is not None
|
|
return self._switch_state.state == STATE_ON
|
|
|
|
@property
|
|
def available(self) -> bool:
|
|
"""Return true if light switch is on."""
|
|
return (
|
|
self._switch_state is not None
|
|
and self._switch_state.state != STATE_UNAVAILABLE
|
|
)
|
|
|
|
@property
|
|
def should_poll(self) -> bool:
|
|
"""No polling needed for a light switch."""
|
|
return False
|
|
|
|
@property
|
|
def unique_id(self):
|
|
"""Return the unique id of the light switch."""
|
|
return self._unique_id
|
|
|
|
async def async_turn_on(self, **kwargs):
|
|
"""Forward the turn_on command to the switch in this light switch."""
|
|
data = {ATTR_ENTITY_ID: self._switch_entity_id}
|
|
await self.hass.services.async_call(
|
|
switch.DOMAIN,
|
|
switch.SERVICE_TURN_ON,
|
|
data,
|
|
blocking=True,
|
|
context=self._context,
|
|
)
|
|
|
|
async def async_turn_off(self, **kwargs):
|
|
"""Forward the turn_off command to the switch in this light switch."""
|
|
data = {ATTR_ENTITY_ID: self._switch_entity_id}
|
|
await self.hass.services.async_call(
|
|
switch.DOMAIN,
|
|
switch.SERVICE_TURN_OFF,
|
|
data,
|
|
blocking=True,
|
|
context=self._context,
|
|
)
|
|
|
|
async def async_added_to_hass(self) -> None:
|
|
"""Register callbacks."""
|
|
self._switch_state = self.hass.states.get(self._switch_entity_id)
|
|
|
|
@callback
|
|
def async_state_changed_listener(*_: Any) -> None:
|
|
"""Handle child updates."""
|
|
self._switch_state = self.hass.states.get(self._switch_entity_id)
|
|
self.async_write_ha_state()
|
|
|
|
self.async_on_remove(
|
|
async_track_state_change_event(
|
|
self.hass, [self._switch_entity_id], async_state_changed_listener
|
|
)
|
|
)
|