52 lines
1.7 KiB
Python
52 lines
1.7 KiB
Python
"""This component provides HA Siren support for Ring Chimes."""
|
|
import logging
|
|
from typing import Any
|
|
|
|
from ring_doorbell.const import CHIME_TEST_SOUND_KINDS, KIND_DING
|
|
|
|
from homeassistant.components.siren import ATTR_TONE, SirenEntity, SirenEntityFeature
|
|
from homeassistant.config_entries import ConfigEntry
|
|
from homeassistant.core import HomeAssistant
|
|
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
|
|
|
from . import DOMAIN
|
|
from .entity import RingEntityMixin
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
config_entry: ConfigEntry,
|
|
async_add_entities: AddEntitiesCallback,
|
|
) -> None:
|
|
"""Create the sirens for the Ring devices."""
|
|
devices = hass.data[DOMAIN][config_entry.entry_id]["devices"]
|
|
sirens = []
|
|
|
|
for device in devices["chimes"]:
|
|
sirens.append(RingChimeSiren(config_entry, device))
|
|
|
|
async_add_entities(sirens)
|
|
|
|
|
|
class RingChimeSiren(RingEntityMixin, SirenEntity):
|
|
"""Creates a siren to play the test chimes of a Chime device."""
|
|
|
|
def __init__(self, config_entry: ConfigEntry, device) -> None:
|
|
"""Initialize a Ring Chime siren."""
|
|
super().__init__(config_entry.entry_id, device)
|
|
# Entity class attributes
|
|
self._attr_name = f"{self._device.name} Siren"
|
|
self._attr_unique_id = f"{self._device.id}-siren"
|
|
self._attr_available_tones = CHIME_TEST_SOUND_KINDS
|
|
self._attr_supported_features = (
|
|
SirenEntityFeature.TURN_ON | SirenEntityFeature.TONES
|
|
)
|
|
|
|
def turn_on(self, **kwargs: Any) -> None:
|
|
"""Play the test sound on a Ring Chime device."""
|
|
tone = kwargs.get(ATTR_TONE) or KIND_DING
|
|
|
|
self._device.test_sound(kind=tone)
|