mirror of https://github.com/home-assistant/core
96 lines
3.1 KiB
Python
96 lines
3.1 KiB
Python
"""Component providing HA switch support for Ring Door Bell/Chimes."""
|
|
|
|
from datetime import timedelta
|
|
from enum import StrEnum, auto
|
|
import logging
|
|
from typing import Any
|
|
|
|
from ring_doorbell import RingStickUpCam
|
|
|
|
from homeassistant.components.light import ColorMode, LightEntity
|
|
from homeassistant.core import HomeAssistant, callback
|
|
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
|
import homeassistant.util.dt as dt_util
|
|
|
|
from . import RingConfigEntry
|
|
from .coordinator import RingDataCoordinator
|
|
from .entity import RingEntity, exception_wrap
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
|
|
# It takes a few seconds for the API to correctly return an update indicating
|
|
# that the changes have been made. Once we request a change (i.e. a light
|
|
# being turned on) we simply wait for this time delta before we allow
|
|
# updates to take place.
|
|
|
|
SKIP_UPDATES_DELAY = timedelta(seconds=5)
|
|
|
|
|
|
class OnOffState(StrEnum):
|
|
"""Enum for allowed on off states."""
|
|
|
|
ON = auto()
|
|
OFF = auto()
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
entry: RingConfigEntry,
|
|
async_add_entities: AddEntitiesCallback,
|
|
) -> None:
|
|
"""Create the lights for the Ring devices."""
|
|
ring_data = entry.runtime_data
|
|
devices_coordinator = ring_data.devices_coordinator
|
|
|
|
async_add_entities(
|
|
RingLight(device, devices_coordinator)
|
|
for device in ring_data.devices.stickup_cams
|
|
if device.has_capability("light")
|
|
)
|
|
|
|
|
|
class RingLight(RingEntity[RingStickUpCam], LightEntity):
|
|
"""Creates a switch to turn the ring cameras light on and off."""
|
|
|
|
_attr_color_mode = ColorMode.ONOFF
|
|
_attr_supported_color_modes = {ColorMode.ONOFF}
|
|
_attr_translation_key = "light"
|
|
|
|
def __init__(
|
|
self, device: RingStickUpCam, coordinator: RingDataCoordinator
|
|
) -> None:
|
|
"""Initialize the light."""
|
|
super().__init__(device, coordinator)
|
|
self._attr_unique_id = str(device.id)
|
|
self._attr_is_on = device.lights == OnOffState.ON
|
|
self._no_updates_until = dt_util.utcnow()
|
|
|
|
@callback
|
|
def _handle_coordinator_update(self) -> None:
|
|
"""Call update method."""
|
|
if self._no_updates_until > dt_util.utcnow():
|
|
return
|
|
device = self._get_coordinator_data().get_stickup_cam(
|
|
self._device.device_api_id
|
|
)
|
|
self._attr_is_on = device.lights == OnOffState.ON
|
|
super()._handle_coordinator_update()
|
|
|
|
@exception_wrap
|
|
async def _async_set_light(self, new_state: OnOffState) -> None:
|
|
"""Update light state, and causes Home Assistant to correctly update."""
|
|
await self._device.async_set_lights(new_state)
|
|
|
|
self._attr_is_on = new_state == OnOffState.ON
|
|
self._no_updates_until = dt_util.utcnow() + SKIP_UPDATES_DELAY
|
|
self.async_write_ha_state()
|
|
|
|
async def async_turn_on(self, **kwargs: Any) -> None:
|
|
"""Turn the light on for 30 seconds."""
|
|
await self._async_set_light(OnOffState.ON)
|
|
|
|
async def async_turn_off(self, **kwargs: Any) -> None:
|
|
"""Turn the light off."""
|
|
await self._async_set_light(OnOffState.OFF)
|