mirror of https://github.com/home-assistant/core
93 lines
2.7 KiB
Python
93 lines
2.7 KiB
Python
"""Support for TPLink button entities."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
from typing import Final
|
|
|
|
from kasa import Feature
|
|
|
|
from homeassistant.components.button import (
|
|
DOMAIN as BUTTON_DOMAIN,
|
|
ButtonDeviceClass,
|
|
ButtonEntity,
|
|
ButtonEntityDescription,
|
|
)
|
|
from homeassistant.components.siren import DOMAIN as SIREN_DOMAIN
|
|
from homeassistant.core import HomeAssistant
|
|
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
|
|
|
from . import TPLinkConfigEntry
|
|
from .deprecate import DeprecatedInfo, async_cleanup_deprecated
|
|
from .entity import CoordinatedTPLinkFeatureEntity, TPLinkFeatureEntityDescription
|
|
|
|
|
|
@dataclass(frozen=True, kw_only=True)
|
|
class TPLinkButtonEntityDescription(
|
|
ButtonEntityDescription, TPLinkFeatureEntityDescription
|
|
):
|
|
"""Base class for a TPLink feature based button entity description."""
|
|
|
|
|
|
BUTTON_DESCRIPTIONS: Final = [
|
|
TPLinkButtonEntityDescription(
|
|
key="test_alarm",
|
|
deprecated_info=DeprecatedInfo(
|
|
platform=BUTTON_DOMAIN,
|
|
new_platform=SIREN_DOMAIN,
|
|
breaks_in_ha_version="2025.4.0",
|
|
),
|
|
),
|
|
TPLinkButtonEntityDescription(
|
|
key="stop_alarm",
|
|
deprecated_info=DeprecatedInfo(
|
|
platform=BUTTON_DOMAIN,
|
|
new_platform=SIREN_DOMAIN,
|
|
breaks_in_ha_version="2025.4.0",
|
|
),
|
|
),
|
|
TPLinkButtonEntityDescription(
|
|
key="reboot",
|
|
device_class=ButtonDeviceClass.RESTART,
|
|
),
|
|
]
|
|
|
|
BUTTON_DESCRIPTIONS_MAP = {desc.key: desc for desc in BUTTON_DESCRIPTIONS}
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
config_entry: TPLinkConfigEntry,
|
|
async_add_entities: AddEntitiesCallback,
|
|
) -> None:
|
|
"""Set up buttons."""
|
|
data = config_entry.runtime_data
|
|
parent_coordinator = data.parent_coordinator
|
|
children_coordinators = data.children_coordinators
|
|
device = parent_coordinator.device
|
|
|
|
entities = CoordinatedTPLinkFeatureEntity.entities_for_device_and_its_children(
|
|
hass=hass,
|
|
device=device,
|
|
coordinator=parent_coordinator,
|
|
feature_type=Feature.Type.Action,
|
|
entity_class=TPLinkButtonEntity,
|
|
descriptions=BUTTON_DESCRIPTIONS_MAP,
|
|
child_coordinators=children_coordinators,
|
|
)
|
|
async_cleanup_deprecated(hass, BUTTON_DOMAIN, config_entry.entry_id, entities)
|
|
async_add_entities(entities)
|
|
|
|
|
|
class TPLinkButtonEntity(CoordinatedTPLinkFeatureEntity, ButtonEntity):
|
|
"""Representation of a TPLink button entity."""
|
|
|
|
entity_description: TPLinkButtonEntityDescription
|
|
|
|
async def async_press(self) -> None:
|
|
"""Execute action."""
|
|
await self._feature.set_value(True)
|
|
|
|
def _async_update_attrs(self) -> None:
|
|
"""No need to update anything."""
|