125 lines
4.1 KiB
Python
125 lines
4.1 KiB
Python
"""Support for the ZHA platform."""
|
|
from __future__ import annotations
|
|
|
|
import functools
|
|
import time
|
|
|
|
from homeassistant.components.device_tracker import SOURCE_TYPE_ROUTER
|
|
from homeassistant.components.device_tracker.config_entry import ScannerEntity
|
|
from homeassistant.config_entries import ConfigEntry
|
|
from homeassistant.const import Platform
|
|
from homeassistant.core import HomeAssistant, callback
|
|
from homeassistant.helpers.dispatcher import async_dispatcher_connect
|
|
from homeassistant.helpers.entity import DeviceInfo
|
|
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
|
|
|
from .core import discovery
|
|
from .core.const import (
|
|
CHANNEL_POWER_CONFIGURATION,
|
|
DATA_ZHA,
|
|
SIGNAL_ADD_ENTITIES,
|
|
SIGNAL_ATTR_UPDATED,
|
|
)
|
|
from .core.registries import ZHA_ENTITIES
|
|
from .entity import ZhaEntity
|
|
from .sensor import Battery
|
|
|
|
STRICT_MATCH = functools.partial(ZHA_ENTITIES.strict_match, Platform.DEVICE_TRACKER)
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
config_entry: ConfigEntry,
|
|
async_add_entities: AddEntitiesCallback,
|
|
):
|
|
"""Set up the Zigbee Home Automation device tracker from config entry."""
|
|
entities_to_create = hass.data[DATA_ZHA][Platform.DEVICE_TRACKER]
|
|
|
|
unsub = async_dispatcher_connect(
|
|
hass,
|
|
SIGNAL_ADD_ENTITIES,
|
|
functools.partial(
|
|
discovery.async_add_entities, async_add_entities, entities_to_create
|
|
),
|
|
)
|
|
config_entry.async_on_unload(unsub)
|
|
|
|
|
|
@STRICT_MATCH(channel_names=CHANNEL_POWER_CONFIGURATION)
|
|
class ZHADeviceScannerEntity(ScannerEntity, ZhaEntity):
|
|
"""Represent a tracked device."""
|
|
|
|
def __init__(self, unique_id, zha_device, channels, **kwargs):
|
|
"""Initialize the ZHA device tracker."""
|
|
super().__init__(unique_id, zha_device, channels, **kwargs)
|
|
self._battery_channel = self.cluster_channels.get(CHANNEL_POWER_CONFIGURATION)
|
|
self._connected = False
|
|
self._keepalive_interval = 60
|
|
self._should_poll = True
|
|
self._battery_level = None
|
|
|
|
async def async_added_to_hass(self):
|
|
"""Run when about to be added to hass."""
|
|
await super().async_added_to_hass()
|
|
if self._battery_channel:
|
|
self.async_accept_signal(
|
|
self._battery_channel,
|
|
SIGNAL_ATTR_UPDATED,
|
|
self.async_battery_percentage_remaining_updated,
|
|
)
|
|
|
|
async def async_update(self):
|
|
"""Handle polling."""
|
|
if self.zha_device.last_seen is None:
|
|
self._connected = False
|
|
else:
|
|
difference = time.time() - self.zha_device.last_seen
|
|
if difference > self._keepalive_interval:
|
|
self._connected = False
|
|
else:
|
|
self._connected = True
|
|
|
|
@property
|
|
def is_connected(self):
|
|
"""Return true if the device is connected to the network."""
|
|
return self._connected
|
|
|
|
@property
|
|
def source_type(self):
|
|
"""Return the source type, eg gps or router, of the device."""
|
|
return SOURCE_TYPE_ROUTER
|
|
|
|
@callback
|
|
def async_battery_percentage_remaining_updated(self, attr_id, attr_name, value):
|
|
"""Handle tracking."""
|
|
if attr_name != "battery_percentage_remaining":
|
|
return
|
|
self.debug("battery_percentage_remaining updated: %s", value)
|
|
self._connected = True
|
|
self._battery_level = Battery.formatter(value)
|
|
self.async_write_ha_state()
|
|
|
|
@property
|
|
def battery_level(self):
|
|
"""Return the battery level of the device.
|
|
|
|
Percentage from 0-100.
|
|
"""
|
|
return self._battery_level
|
|
|
|
@property
|
|
def device_info( # pylint: disable=overridden-final-method
|
|
self,
|
|
) -> DeviceInfo | None:
|
|
"""Return device info."""
|
|
# We opt ZHA device tracker back into overriding this method because
|
|
# it doesn't track IP-based devices.
|
|
# Call Super because ScannerEntity overrode it.
|
|
return super(ZhaEntity, self).device_info
|
|
|
|
@property
|
|
def unique_id(self) -> str | None:
|
|
"""Return unique ID."""
|
|
# Call Super because ScannerEntity overrode it.
|
|
return super(ZhaEntity, self).unique_id
|