mirror of
https://github.com/home-assistant/core.git
synced 2025-04-23 16:57:53 +00:00
Move rflink base entity to separate module (#126206)
This commit is contained in:
parent
4f53ffcd9c
commit
1ff69825e4
@ -6,36 +6,30 @@ import asyncio
|
||||
from collections import defaultdict
|
||||
import logging
|
||||
|
||||
from rflink.protocol import ProtocolBase, create_rflink_connection
|
||||
from rflink.protocol import create_rflink_connection
|
||||
from serial import SerialException
|
||||
import voluptuous as vol
|
||||
|
||||
from homeassistant.const import (
|
||||
ATTR_ENTITY_ID,
|
||||
ATTR_STATE,
|
||||
CONF_COMMAND,
|
||||
CONF_DEVICE_ID,
|
||||
CONF_HOST,
|
||||
CONF_PORT,
|
||||
EVENT_HOMEASSISTANT_STOP,
|
||||
STATE_ON,
|
||||
)
|
||||
from homeassistant.core import CoreState, HassJob, HomeAssistant, ServiceCall, callback
|
||||
from homeassistant.exceptions import HomeAssistantError
|
||||
import homeassistant.helpers.config_validation as cv
|
||||
from homeassistant.helpers.dispatcher import (
|
||||
async_dispatcher_connect,
|
||||
async_dispatcher_send,
|
||||
)
|
||||
from homeassistant.helpers.entity import Entity
|
||||
from homeassistant.helpers.event import async_call_later
|
||||
from homeassistant.helpers.restore_state import RestoreEntity
|
||||
from homeassistant.helpers.typing import ConfigType
|
||||
|
||||
from .const import (
|
||||
DATA_DEVICE_REGISTER,
|
||||
DATA_ENTITY_GROUP_LOOKUP,
|
||||
DATA_ENTITY_LOOKUP,
|
||||
DEFAULT_SIGNAL_REPETITIONS,
|
||||
EVENT_KEY_COMMAND,
|
||||
EVENT_KEY_ID,
|
||||
EVENT_KEY_SENSOR,
|
||||
@ -43,7 +37,8 @@ from .const import (
|
||||
SIGNAL_HANDLE_EVENT,
|
||||
TMP_ENTITY,
|
||||
)
|
||||
from .utils import brightness_to_rflink, identify_event_type
|
||||
from .entity import RflinkCommand
|
||||
from .utils import identify_event_type
|
||||
|
||||
_LOGGER = logging.getLogger(__name__)
|
||||
|
||||
@ -52,13 +47,10 @@ CONF_RECONNECT_INTERVAL = "reconnect_interval"
|
||||
CONF_WAIT_FOR_ACK = "wait_for_ack"
|
||||
CONF_KEEPALIVE_IDLE = "tcp_keepalive_idle_timer"
|
||||
|
||||
DATA_ENTITY_GROUP_LOOKUP = "rflink_entity_group_only_lookup"
|
||||
DEFAULT_RECONNECT_INTERVAL = 10
|
||||
DEFAULT_TCP_KEEPALIVE_IDLE_TIMER = 3600
|
||||
CONNECTION_TIMEOUT = 10
|
||||
|
||||
EVENT_BUTTON_PRESSED = "button_pressed"
|
||||
|
||||
RFLINK_GROUP_COMMANDS = ["allon", "alloff"]
|
||||
|
||||
DOMAIN = "rflink"
|
||||
@ -286,298 +278,3 @@ async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool:
|
||||
hass.async_create_task(connect(), eager_start=False)
|
||||
async_dispatcher_connect(hass, SIGNAL_EVENT, event_callback)
|
||||
return True
|
||||
|
||||
|
||||
class RflinkDevice(Entity):
|
||||
"""Representation of a Rflink device.
|
||||
|
||||
Contains the common logic for Rflink entities.
|
||||
"""
|
||||
|
||||
_state: bool | None = None
|
||||
_available = True
|
||||
_attr_should_poll = False
|
||||
|
||||
def __init__(
|
||||
self,
|
||||
device_id,
|
||||
initial_event=None,
|
||||
name=None,
|
||||
aliases=None,
|
||||
group=True,
|
||||
group_aliases=None,
|
||||
nogroup_aliases=None,
|
||||
fire_event=False,
|
||||
signal_repetitions=DEFAULT_SIGNAL_REPETITIONS,
|
||||
):
|
||||
"""Initialize the device."""
|
||||
# Rflink specific attributes for every component type
|
||||
self._initial_event = initial_event
|
||||
self._device_id = device_id
|
||||
self._attr_unique_id = device_id
|
||||
if name:
|
||||
self._name = name
|
||||
else:
|
||||
self._name = device_id
|
||||
|
||||
self._aliases = aliases
|
||||
self._group = group
|
||||
self._group_aliases = group_aliases
|
||||
self._nogroup_aliases = nogroup_aliases
|
||||
self._should_fire_event = fire_event
|
||||
self._signal_repetitions = signal_repetitions
|
||||
|
||||
@callback
|
||||
def handle_event_callback(self, event):
|
||||
"""Handle incoming event for device type."""
|
||||
# Call platform specific event handler
|
||||
self._handle_event(event)
|
||||
|
||||
# Propagate changes through ha
|
||||
self.async_write_ha_state()
|
||||
|
||||
# Put command onto bus for user to subscribe to
|
||||
if self._should_fire_event and identify_event_type(event) == EVENT_KEY_COMMAND:
|
||||
self.hass.bus.async_fire(
|
||||
EVENT_BUTTON_PRESSED,
|
||||
{ATTR_ENTITY_ID: self.entity_id, ATTR_STATE: event[EVENT_KEY_COMMAND]},
|
||||
)
|
||||
_LOGGER.debug(
|
||||
"Fired bus event for %s: %s", self.entity_id, event[EVENT_KEY_COMMAND]
|
||||
)
|
||||
|
||||
def _handle_event(self, event):
|
||||
"""Platform specific event handler."""
|
||||
raise NotImplementedError
|
||||
|
||||
@property
|
||||
def name(self):
|
||||
"""Return a name for the device."""
|
||||
return self._name
|
||||
|
||||
@property
|
||||
def is_on(self):
|
||||
"""Return true if device is on."""
|
||||
if self.assumed_state:
|
||||
return False
|
||||
return self._state
|
||||
|
||||
@property
|
||||
def assumed_state(self):
|
||||
"""Assume device state until first device event sets state."""
|
||||
return self._state is None
|
||||
|
||||
@property
|
||||
def available(self):
|
||||
"""Return True if entity is available."""
|
||||
return self._available
|
||||
|
||||
@callback
|
||||
def _availability_callback(self, availability):
|
||||
"""Update availability state."""
|
||||
self._available = availability
|
||||
self.async_write_ha_state()
|
||||
|
||||
async def async_added_to_hass(self):
|
||||
"""Register update callback."""
|
||||
await super().async_added_to_hass()
|
||||
# Remove temporary bogus entity_id if added
|
||||
tmp_entity = TMP_ENTITY.format(self._device_id)
|
||||
if (
|
||||
tmp_entity
|
||||
in self.hass.data[DATA_ENTITY_LOOKUP][EVENT_KEY_COMMAND][self._device_id]
|
||||
):
|
||||
self.hass.data[DATA_ENTITY_LOOKUP][EVENT_KEY_COMMAND][
|
||||
self._device_id
|
||||
].remove(tmp_entity)
|
||||
|
||||
# Register id and aliases
|
||||
self.hass.data[DATA_ENTITY_LOOKUP][EVENT_KEY_COMMAND][self._device_id].append(
|
||||
self.entity_id
|
||||
)
|
||||
if self._group:
|
||||
self.hass.data[DATA_ENTITY_GROUP_LOOKUP][EVENT_KEY_COMMAND][
|
||||
self._device_id
|
||||
].append(self.entity_id)
|
||||
# aliases respond to both normal and group commands (allon/alloff)
|
||||
if self._aliases:
|
||||
for _id in self._aliases:
|
||||
self.hass.data[DATA_ENTITY_LOOKUP][EVENT_KEY_COMMAND][_id].append(
|
||||
self.entity_id
|
||||
)
|
||||
self.hass.data[DATA_ENTITY_GROUP_LOOKUP][EVENT_KEY_COMMAND][_id].append(
|
||||
self.entity_id
|
||||
)
|
||||
# group_aliases only respond to group commands (allon/alloff)
|
||||
if self._group_aliases:
|
||||
for _id in self._group_aliases:
|
||||
self.hass.data[DATA_ENTITY_GROUP_LOOKUP][EVENT_KEY_COMMAND][_id].append(
|
||||
self.entity_id
|
||||
)
|
||||
# nogroup_aliases only respond to normal commands
|
||||
if self._nogroup_aliases:
|
||||
for _id in self._nogroup_aliases:
|
||||
self.hass.data[DATA_ENTITY_LOOKUP][EVENT_KEY_COMMAND][_id].append(
|
||||
self.entity_id
|
||||
)
|
||||
self.async_on_remove(
|
||||
async_dispatcher_connect(
|
||||
self.hass, SIGNAL_AVAILABILITY, self._availability_callback
|
||||
)
|
||||
)
|
||||
self.async_on_remove(
|
||||
async_dispatcher_connect(
|
||||
self.hass,
|
||||
SIGNAL_HANDLE_EVENT.format(self.entity_id),
|
||||
self.handle_event_callback,
|
||||
)
|
||||
)
|
||||
|
||||
# Process the initial event now that the entity is created
|
||||
if self._initial_event:
|
||||
self.handle_event_callback(self._initial_event)
|
||||
|
||||
|
||||
class RflinkCommand(RflinkDevice):
|
||||
"""Singleton class to make Rflink command interface available to entities.
|
||||
|
||||
This class is to be inherited by every Entity class that is actionable
|
||||
(switches/lights). It exposes the Rflink command interface for these
|
||||
entities.
|
||||
|
||||
The Rflink interface is managed as a class level and set during setup (and
|
||||
reset on reconnect).
|
||||
"""
|
||||
|
||||
# Keep repetition tasks to cancel if state is changed before repetitions
|
||||
# are sent
|
||||
_repetition_task: asyncio.Task[None] | None = None
|
||||
|
||||
_protocol: ProtocolBase | None = None
|
||||
|
||||
_wait_ack: bool | None = None
|
||||
|
||||
@classmethod
|
||||
def set_rflink_protocol(
|
||||
cls, protocol: ProtocolBase | None, wait_ack: bool | None = None
|
||||
) -> None:
|
||||
"""Set the Rflink asyncio protocol as a class variable."""
|
||||
cls._protocol = protocol
|
||||
if wait_ack is not None:
|
||||
cls._wait_ack = wait_ack
|
||||
|
||||
@classmethod
|
||||
def is_connected(cls):
|
||||
"""Return connection status."""
|
||||
return bool(cls._protocol)
|
||||
|
||||
@classmethod
|
||||
async def send_command(cls, device_id, action):
|
||||
"""Send device command to Rflink and wait for acknowledgement."""
|
||||
return await cls._protocol.send_command_ack(device_id, action)
|
||||
|
||||
async def _async_handle_command(self, command, *args):
|
||||
"""Do bookkeeping for command, send it to rflink and update state."""
|
||||
self.cancel_queued_send_commands()
|
||||
|
||||
if command == "turn_on":
|
||||
cmd = "on"
|
||||
self._state = True
|
||||
|
||||
elif command == "turn_off":
|
||||
cmd = "off"
|
||||
self._state = False
|
||||
|
||||
elif command == "dim":
|
||||
# convert brightness to rflink dim level
|
||||
cmd = str(brightness_to_rflink(args[0]))
|
||||
self._state = True
|
||||
|
||||
elif command == "toggle":
|
||||
cmd = "on"
|
||||
# if the state is unknown or false, it gets set as true
|
||||
# if the state is true, it gets set as false
|
||||
self._state = self._state in [None, False]
|
||||
|
||||
# Cover options for RFlink
|
||||
elif command == "close_cover":
|
||||
cmd = "DOWN"
|
||||
self._state = False
|
||||
|
||||
elif command == "open_cover":
|
||||
cmd = "UP"
|
||||
self._state = True
|
||||
|
||||
elif command == "stop_cover":
|
||||
cmd = "STOP"
|
||||
self._state = True
|
||||
|
||||
# Send initial command and queue repetitions.
|
||||
# This allows the entity state to be updated quickly and not having to
|
||||
# wait for all repetitions to be sent
|
||||
await self._async_send_command(cmd, self._signal_repetitions)
|
||||
|
||||
# Update state of entity
|
||||
self.async_write_ha_state()
|
||||
|
||||
def cancel_queued_send_commands(self):
|
||||
"""Cancel queued signal repetition commands.
|
||||
|
||||
For example when user changed state while repetitions are still
|
||||
queued for broadcast. Or when an incoming Rflink command (remote
|
||||
switch) changes the state.
|
||||
"""
|
||||
# cancel any outstanding tasks from the previous state change
|
||||
if self._repetition_task:
|
||||
self._repetition_task.cancel()
|
||||
|
||||
async def _async_send_command(self, cmd, repetitions):
|
||||
"""Send a command for device to Rflink gateway."""
|
||||
_LOGGER.debug("Sending command: %s to Rflink device: %s", cmd, self._device_id)
|
||||
|
||||
if not self.is_connected():
|
||||
raise HomeAssistantError("Cannot send command, not connected!")
|
||||
|
||||
if self._wait_ack:
|
||||
# Puts command on outgoing buffer then waits for Rflink to confirm
|
||||
# the command has been sent out.
|
||||
await self._protocol.send_command_ack(self._device_id, cmd)
|
||||
else:
|
||||
# Puts command on outgoing buffer and returns straight away.
|
||||
# Rflink protocol/transport handles asynchronous writing of buffer
|
||||
# to serial/tcp device. Does not wait for command send
|
||||
# confirmation.
|
||||
self._protocol.send_command(self._device_id, cmd)
|
||||
|
||||
if repetitions > 1:
|
||||
self._repetition_task = self.hass.async_create_task(
|
||||
self._async_send_command(cmd, repetitions - 1), eager_start=False
|
||||
)
|
||||
|
||||
|
||||
class SwitchableRflinkDevice(RflinkCommand, RestoreEntity):
|
||||
"""Rflink entity which can switch on/off (eg: light, switch)."""
|
||||
|
||||
async def async_added_to_hass(self):
|
||||
"""Restore RFLink device state (ON/OFF)."""
|
||||
await super().async_added_to_hass()
|
||||
if (old_state := await self.async_get_last_state()) is not None:
|
||||
self._state = old_state.state == STATE_ON
|
||||
|
||||
def _handle_event(self, event):
|
||||
"""Adjust state if Rflink picks up a remote command for this device."""
|
||||
self.cancel_queued_send_commands()
|
||||
|
||||
command = event["command"]
|
||||
if command in ["on", "allon"]:
|
||||
self._state = True
|
||||
elif command in ["off", "alloff"]:
|
||||
self._state = False
|
||||
|
||||
async def async_turn_on(self, **kwargs):
|
||||
"""Turn the device on."""
|
||||
await self._async_handle_command("turn_on")
|
||||
|
||||
async def async_turn_off(self, **kwargs):
|
||||
"""Turn the device off."""
|
||||
await self._async_handle_command("turn_off")
|
||||
|
@ -26,8 +26,8 @@ import homeassistant.helpers.event as evt
|
||||
from homeassistant.helpers.restore_state import RestoreEntity
|
||||
from homeassistant.helpers.typing import ConfigType, DiscoveryInfoType
|
||||
|
||||
from . import RflinkDevice
|
||||
from .const import CONF_ALIASES
|
||||
from .entity import RflinkDevice
|
||||
|
||||
CONF_OFF_DELAY = "off_delay"
|
||||
DEFAULT_FORCE_UPDATE = False
|
||||
|
@ -16,6 +16,7 @@ CONF_FIRE_EVENT = "fire_event"
|
||||
CONF_SIGNAL_REPETITIONS = "signal_repetitions"
|
||||
|
||||
DATA_DEVICE_REGISTER = "rflink_device_register"
|
||||
DATA_ENTITY_GROUP_LOOKUP = "rflink_entity_group_only_lookup"
|
||||
DATA_ENTITY_LOOKUP = "rflink_entity_lookup"
|
||||
DEFAULT_SIGNAL_REPETITIONS = 1
|
||||
|
||||
|
@ -18,7 +18,6 @@ from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
||||
from homeassistant.helpers.restore_state import RestoreEntity
|
||||
from homeassistant.helpers.typing import ConfigType, DiscoveryInfoType
|
||||
|
||||
from . import RflinkCommand
|
||||
from .const import (
|
||||
CONF_ALIASES,
|
||||
CONF_DEVICE_DEFAULTS,
|
||||
@ -29,6 +28,7 @@ from .const import (
|
||||
CONF_SIGNAL_REPETITIONS,
|
||||
DEVICE_DEFAULTS_SCHEMA,
|
||||
)
|
||||
from .entity import RflinkCommand
|
||||
|
||||
_LOGGER = logging.getLogger(__name__)
|
||||
|
||||
|
325
homeassistant/components/rflink/entity.py
Normal file
325
homeassistant/components/rflink/entity.py
Normal file
@ -0,0 +1,325 @@
|
||||
"""Support for Rflink devices."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import asyncio
|
||||
import logging
|
||||
|
||||
from rflink.protocol import ProtocolBase
|
||||
|
||||
from homeassistant.const import ATTR_ENTITY_ID, ATTR_STATE, STATE_ON
|
||||
from homeassistant.core import callback
|
||||
from homeassistant.exceptions import HomeAssistantError
|
||||
from homeassistant.helpers.dispatcher import async_dispatcher_connect
|
||||
from homeassistant.helpers.entity import Entity
|
||||
from homeassistant.helpers.restore_state import RestoreEntity
|
||||
|
||||
from .const import (
|
||||
DATA_ENTITY_GROUP_LOOKUP,
|
||||
DATA_ENTITY_LOOKUP,
|
||||
DEFAULT_SIGNAL_REPETITIONS,
|
||||
EVENT_KEY_COMMAND,
|
||||
SIGNAL_AVAILABILITY,
|
||||
SIGNAL_HANDLE_EVENT,
|
||||
TMP_ENTITY,
|
||||
)
|
||||
from .utils import brightness_to_rflink, identify_event_type
|
||||
|
||||
_LOGGER = logging.getLogger(__name__)
|
||||
|
||||
EVENT_BUTTON_PRESSED = "button_pressed"
|
||||
|
||||
|
||||
class RflinkDevice(Entity):
|
||||
"""Representation of a Rflink device.
|
||||
|
||||
Contains the common logic for Rflink entities.
|
||||
"""
|
||||
|
||||
_state: bool | None = None
|
||||
_available = True
|
||||
_attr_should_poll = False
|
||||
|
||||
def __init__(
|
||||
self,
|
||||
device_id,
|
||||
initial_event=None,
|
||||
name=None,
|
||||
aliases=None,
|
||||
group=True,
|
||||
group_aliases=None,
|
||||
nogroup_aliases=None,
|
||||
fire_event=False,
|
||||
signal_repetitions=DEFAULT_SIGNAL_REPETITIONS,
|
||||
):
|
||||
"""Initialize the device."""
|
||||
# Rflink specific attributes for every component type
|
||||
self._initial_event = initial_event
|
||||
self._device_id = device_id
|
||||
self._attr_unique_id = device_id
|
||||
if name:
|
||||
self._name = name
|
||||
else:
|
||||
self._name = device_id
|
||||
|
||||
self._aliases = aliases
|
||||
self._group = group
|
||||
self._group_aliases = group_aliases
|
||||
self._nogroup_aliases = nogroup_aliases
|
||||
self._should_fire_event = fire_event
|
||||
self._signal_repetitions = signal_repetitions
|
||||
|
||||
@callback
|
||||
def handle_event_callback(self, event):
|
||||
"""Handle incoming event for device type."""
|
||||
# Call platform specific event handler
|
||||
self._handle_event(event)
|
||||
|
||||
# Propagate changes through ha
|
||||
self.async_write_ha_state()
|
||||
|
||||
# Put command onto bus for user to subscribe to
|
||||
if self._should_fire_event and identify_event_type(event) == EVENT_KEY_COMMAND:
|
||||
self.hass.bus.async_fire(
|
||||
EVENT_BUTTON_PRESSED,
|
||||
{ATTR_ENTITY_ID: self.entity_id, ATTR_STATE: event[EVENT_KEY_COMMAND]},
|
||||
)
|
||||
_LOGGER.debug(
|
||||
"Fired bus event for %s: %s", self.entity_id, event[EVENT_KEY_COMMAND]
|
||||
)
|
||||
|
||||
def _handle_event(self, event):
|
||||
"""Platform specific event handler."""
|
||||
raise NotImplementedError
|
||||
|
||||
@property
|
||||
def name(self):
|
||||
"""Return a name for the device."""
|
||||
return self._name
|
||||
|
||||
@property
|
||||
def is_on(self):
|
||||
"""Return true if device is on."""
|
||||
if self.assumed_state:
|
||||
return False
|
||||
return self._state
|
||||
|
||||
@property
|
||||
def assumed_state(self):
|
||||
"""Assume device state until first device event sets state."""
|
||||
return self._state is None
|
||||
|
||||
@property
|
||||
def available(self):
|
||||
"""Return True if entity is available."""
|
||||
return self._available
|
||||
|
||||
@callback
|
||||
def _availability_callback(self, availability):
|
||||
"""Update availability state."""
|
||||
self._available = availability
|
||||
self.async_write_ha_state()
|
||||
|
||||
async def async_added_to_hass(self):
|
||||
"""Register update callback."""
|
||||
await super().async_added_to_hass()
|
||||
# Remove temporary bogus entity_id if added
|
||||
tmp_entity = TMP_ENTITY.format(self._device_id)
|
||||
if (
|
||||
tmp_entity
|
||||
in self.hass.data[DATA_ENTITY_LOOKUP][EVENT_KEY_COMMAND][self._device_id]
|
||||
):
|
||||
self.hass.data[DATA_ENTITY_LOOKUP][EVENT_KEY_COMMAND][
|
||||
self._device_id
|
||||
].remove(tmp_entity)
|
||||
|
||||
# Register id and aliases
|
||||
self.hass.data[DATA_ENTITY_LOOKUP][EVENT_KEY_COMMAND][self._device_id].append(
|
||||
self.entity_id
|
||||
)
|
||||
if self._group:
|
||||
self.hass.data[DATA_ENTITY_GROUP_LOOKUP][EVENT_KEY_COMMAND][
|
||||
self._device_id
|
||||
].append(self.entity_id)
|
||||
# aliases respond to both normal and group commands (allon/alloff)
|
||||
if self._aliases:
|
||||
for _id in self._aliases:
|
||||
self.hass.data[DATA_ENTITY_LOOKUP][EVENT_KEY_COMMAND][_id].append(
|
||||
self.entity_id
|
||||
)
|
||||
self.hass.data[DATA_ENTITY_GROUP_LOOKUP][EVENT_KEY_COMMAND][_id].append(
|
||||
self.entity_id
|
||||
)
|
||||
# group_aliases only respond to group commands (allon/alloff)
|
||||
if self._group_aliases:
|
||||
for _id in self._group_aliases:
|
||||
self.hass.data[DATA_ENTITY_GROUP_LOOKUP][EVENT_KEY_COMMAND][_id].append(
|
||||
self.entity_id
|
||||
)
|
||||
# nogroup_aliases only respond to normal commands
|
||||
if self._nogroup_aliases:
|
||||
for _id in self._nogroup_aliases:
|
||||
self.hass.data[DATA_ENTITY_LOOKUP][EVENT_KEY_COMMAND][_id].append(
|
||||
self.entity_id
|
||||
)
|
||||
self.async_on_remove(
|
||||
async_dispatcher_connect(
|
||||
self.hass, SIGNAL_AVAILABILITY, self._availability_callback
|
||||
)
|
||||
)
|
||||
self.async_on_remove(
|
||||
async_dispatcher_connect(
|
||||
self.hass,
|
||||
SIGNAL_HANDLE_EVENT.format(self.entity_id),
|
||||
self.handle_event_callback,
|
||||
)
|
||||
)
|
||||
|
||||
# Process the initial event now that the entity is created
|
||||
if self._initial_event:
|
||||
self.handle_event_callback(self._initial_event)
|
||||
|
||||
|
||||
class RflinkCommand(RflinkDevice):
|
||||
"""Singleton class to make Rflink command interface available to entities.
|
||||
|
||||
This class is to be inherited by every Entity class that is actionable
|
||||
(switches/lights). It exposes the Rflink command interface for these
|
||||
entities.
|
||||
|
||||
The Rflink interface is managed as a class level and set during setup (and
|
||||
reset on reconnect).
|
||||
"""
|
||||
|
||||
# Keep repetition tasks to cancel if state is changed before repetitions
|
||||
# are sent
|
||||
_repetition_task: asyncio.Task[None] | None = None
|
||||
|
||||
_protocol: ProtocolBase | None = None
|
||||
|
||||
_wait_ack: bool | None = None
|
||||
|
||||
@classmethod
|
||||
def set_rflink_protocol(
|
||||
cls, protocol: ProtocolBase | None, wait_ack: bool | None = None
|
||||
) -> None:
|
||||
"""Set the Rflink asyncio protocol as a class variable."""
|
||||
cls._protocol = protocol
|
||||
if wait_ack is not None:
|
||||
cls._wait_ack = wait_ack
|
||||
|
||||
@classmethod
|
||||
def is_connected(cls):
|
||||
"""Return connection status."""
|
||||
return bool(cls._protocol)
|
||||
|
||||
@classmethod
|
||||
async def send_command(cls, device_id, action):
|
||||
"""Send device command to Rflink and wait for acknowledgement."""
|
||||
return await cls._protocol.send_command_ack(device_id, action)
|
||||
|
||||
async def _async_handle_command(self, command, *args):
|
||||
"""Do bookkeeping for command, send it to rflink and update state."""
|
||||
self.cancel_queued_send_commands()
|
||||
|
||||
if command == "turn_on":
|
||||
cmd = "on"
|
||||
self._state = True
|
||||
|
||||
elif command == "turn_off":
|
||||
cmd = "off"
|
||||
self._state = False
|
||||
|
||||
elif command == "dim":
|
||||
# convert brightness to rflink dim level
|
||||
cmd = str(brightness_to_rflink(args[0]))
|
||||
self._state = True
|
||||
|
||||
elif command == "toggle":
|
||||
cmd = "on"
|
||||
# if the state is unknown or false, it gets set as true
|
||||
# if the state is true, it gets set as false
|
||||
self._state = self._state in [None, False]
|
||||
|
||||
# Cover options for RFlink
|
||||
elif command == "close_cover":
|
||||
cmd = "DOWN"
|
||||
self._state = False
|
||||
|
||||
elif command == "open_cover":
|
||||
cmd = "UP"
|
||||
self._state = True
|
||||
|
||||
elif command == "stop_cover":
|
||||
cmd = "STOP"
|
||||
self._state = True
|
||||
|
||||
# Send initial command and queue repetitions.
|
||||
# This allows the entity state to be updated quickly and not having to
|
||||
# wait for all repetitions to be sent
|
||||
await self._async_send_command(cmd, self._signal_repetitions)
|
||||
|
||||
# Update state of entity
|
||||
self.async_write_ha_state()
|
||||
|
||||
def cancel_queued_send_commands(self):
|
||||
"""Cancel queued signal repetition commands.
|
||||
|
||||
For example when user changed state while repetitions are still
|
||||
queued for broadcast. Or when an incoming Rflink command (remote
|
||||
switch) changes the state.
|
||||
"""
|
||||
# cancel any outstanding tasks from the previous state change
|
||||
if self._repetition_task:
|
||||
self._repetition_task.cancel()
|
||||
|
||||
async def _async_send_command(self, cmd, repetitions):
|
||||
"""Send a command for device to Rflink gateway."""
|
||||
_LOGGER.debug("Sending command: %s to Rflink device: %s", cmd, self._device_id)
|
||||
|
||||
if not self.is_connected():
|
||||
raise HomeAssistantError("Cannot send command, not connected!")
|
||||
|
||||
if self._wait_ack:
|
||||
# Puts command on outgoing buffer then waits for Rflink to confirm
|
||||
# the command has been sent out.
|
||||
await self._protocol.send_command_ack(self._device_id, cmd)
|
||||
else:
|
||||
# Puts command on outgoing buffer and returns straight away.
|
||||
# Rflink protocol/transport handles asynchronous writing of buffer
|
||||
# to serial/tcp device. Does not wait for command send
|
||||
# confirmation.
|
||||
self._protocol.send_command(self._device_id, cmd)
|
||||
|
||||
if repetitions > 1:
|
||||
self._repetition_task = self.hass.async_create_task(
|
||||
self._async_send_command(cmd, repetitions - 1), eager_start=False
|
||||
)
|
||||
|
||||
|
||||
class SwitchableRflinkDevice(RflinkCommand, RestoreEntity):
|
||||
"""Rflink entity which can switch on/off (eg: light, switch)."""
|
||||
|
||||
async def async_added_to_hass(self):
|
||||
"""Restore RFLink device state (ON/OFF)."""
|
||||
await super().async_added_to_hass()
|
||||
if (old_state := await self.async_get_last_state()) is not None:
|
||||
self._state = old_state.state == STATE_ON
|
||||
|
||||
def _handle_event(self, event):
|
||||
"""Adjust state if Rflink picks up a remote command for this device."""
|
||||
self.cancel_queued_send_commands()
|
||||
|
||||
command = event["command"]
|
||||
if command in ["on", "allon"]:
|
||||
self._state = True
|
||||
elif command in ["off", "alloff"]:
|
||||
self._state = False
|
||||
|
||||
async def async_turn_on(self, **kwargs):
|
||||
"""Turn the device on."""
|
||||
await self._async_handle_command("turn_on")
|
||||
|
||||
async def async_turn_off(self, **kwargs):
|
||||
"""Turn the device off."""
|
||||
await self._async_handle_command("turn_off")
|
@ -20,7 +20,6 @@ import homeassistant.helpers.config_validation as cv
|
||||
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
||||
from homeassistant.helpers.typing import ConfigType, DiscoveryInfoType
|
||||
|
||||
from . import SwitchableRflinkDevice
|
||||
from .const import (
|
||||
CONF_ALIASES,
|
||||
CONF_AUTOMATIC_ADD,
|
||||
@ -35,6 +34,7 @@ from .const import (
|
||||
EVENT_KEY_COMMAND,
|
||||
EVENT_KEY_ID,
|
||||
)
|
||||
from .entity import SwitchableRflinkDevice
|
||||
from .utils import brightness_to_rflink, rflink_to_brightness
|
||||
|
||||
_LOGGER = logging.getLogger(__name__)
|
||||
|
@ -40,7 +40,6 @@ from homeassistant.helpers.dispatcher import async_dispatcher_connect
|
||||
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
||||
from homeassistant.helpers.typing import ConfigType, DiscoveryInfoType
|
||||
|
||||
from . import RflinkDevice
|
||||
from .const import (
|
||||
CONF_ALIASES,
|
||||
CONF_AUTOMATIC_ADD,
|
||||
@ -53,6 +52,7 @@ from .const import (
|
||||
SIGNAL_HANDLE_EVENT,
|
||||
TMP_ENTITY,
|
||||
)
|
||||
from .entity import RflinkDevice
|
||||
|
||||
SENSOR_TYPES = (
|
||||
# check new descriptors against PACKET_FIELDS & UNITS from rflink.parser
|
||||
|
@ -14,7 +14,6 @@ import homeassistant.helpers.config_validation as cv
|
||||
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
||||
from homeassistant.helpers.typing import ConfigType, DiscoveryInfoType
|
||||
|
||||
from . import SwitchableRflinkDevice
|
||||
from .const import (
|
||||
CONF_ALIASES,
|
||||
CONF_DEVICE_DEFAULTS,
|
||||
@ -25,6 +24,7 @@ from .const import (
|
||||
CONF_SIGNAL_REPETITIONS,
|
||||
DEVICE_DEFAULTS_SCHEMA,
|
||||
)
|
||||
from .entity import SwitchableRflinkDevice
|
||||
|
||||
PARALLEL_UPDATES = 0
|
||||
|
||||
|
@ -7,7 +7,7 @@ control of RFLink cover devices.
|
||||
|
||||
import pytest
|
||||
|
||||
from homeassistant.components.rflink import EVENT_BUTTON_PRESSED
|
||||
from homeassistant.components.rflink.entity import EVENT_BUTTON_PRESSED
|
||||
from homeassistant.const import (
|
||||
ATTR_ENTITY_ID,
|
||||
SERVICE_CLOSE_COVER,
|
||||
|
@ -8,7 +8,7 @@ control of RFLink switch devices.
|
||||
import pytest
|
||||
|
||||
from homeassistant.components.light import ATTR_BRIGHTNESS
|
||||
from homeassistant.components.rflink import EVENT_BUTTON_PRESSED
|
||||
from homeassistant.components.rflink.entity import EVENT_BUTTON_PRESSED
|
||||
from homeassistant.const import (
|
||||
ATTR_ENTITY_ID,
|
||||
SERVICE_TURN_OFF,
|
||||
|
@ -7,7 +7,7 @@ control of Rflink switch devices.
|
||||
|
||||
import pytest
|
||||
|
||||
from homeassistant.components.rflink import EVENT_BUTTON_PRESSED
|
||||
from homeassistant.components.rflink.entity import EVENT_BUTTON_PRESSED
|
||||
from homeassistant.const import (
|
||||
ATTR_ENTITY_ID,
|
||||
SERVICE_TURN_OFF,
|
||||
|
Loading…
x
Reference in New Issue
Block a user