Files
HomeAssistantVS/custom_components/asusrouter/device_tracker.py
T
2026-06-11 11:50:50 -04:00

195 lines
4.9 KiB
Python

"""AsusRouter device tracker module."""
from __future__ import annotations
import logging
from typing import Any
from homeassistant.components.device_tracker import SourceType
from homeassistant.components.device_tracker.config_entry import ScannerEntity
from homeassistant.config_entries import ConfigEntry
from homeassistant.core import HomeAssistant, callback
from homeassistant.helpers import device_registry as dr
from homeassistant.helpers.dispatcher import async_dispatcher_connect
from homeassistant.helpers.entity import DeviceInfo
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from .client import ARClient
from .const import (
ASUSROUTER,
CONF_DEFAULT_TRACK_DEVICES,
CONF_TRACK_DEVICES,
DEFAULT_DEVICE_NAME,
DOMAIN,
)
from .router import ARDevice
_LOGGER = logging.getLogger(__name__)
async def async_setup_entry(
hass: HomeAssistant,
config_entry: ConfigEntry,
async_add_entities: AddEntitiesCallback,
) -> None:
"""Set up device tracker for AsusRouter component."""
# If device tracking is disabled
if (
config_entry.options.get(
CONF_TRACK_DEVICES, CONF_DEFAULT_TRACK_DEVICES
)
is False
):
return
router = hass.data[DOMAIN][config_entry.entry_id][ASUSROUTER]
tracked: set = set()
@callback
def update_router():
"""Update the values of the router."""
add_entities(router, async_add_entities, tracked)
router.async_on_close(
async_dispatcher_connect(hass, router.signal_device_new, update_router)
)
update_router()
@callback
def add_entities(
router: ARDevice,
async_add_entities: AddEntitiesCallback,
tracked: set[str],
) -> None:
"""Add new tracker entities from the router."""
new_tracked = []
for mac, device in router.devices.items():
if mac in tracked:
continue
new_tracked.append(ARDeviceEntity(router, device))
tracked.add(mac)
if new_tracked:
async_add_entities(new_tracked)
class ARDeviceEntity(ScannerEntity):
"""Connected device class."""
_attr_should_poll = False
def __init__(
self,
router: ARDevice,
client: ARClient,
) -> None:
"""Initialize connected device."""
self._router = router
self._client = client
self._attr_unique_id = f"{router.mac}_{client.mac_address}"
self._attr_name = client.name or DEFAULT_DEVICE_NAME
self._attr_capability_attributes = {
"mac": client.mac_address,
"name": self._attr_name,
}
# Assign device info if set up
if router.client_device is True and client.device is True:
self._attr_device_info = self._compile_device_info(
client.mac_address, client.name
)
def _compile_device_info(
self, mac_address: str, name: str | None
) -> DeviceInfo:
"""Compile device info."""
return DeviceInfo(
connections={(dr.CONNECTION_NETWORK_MAC, mac_address)},
default_name=name,
via_device=(DOMAIN, self._router.mac),
)
@property
def device_info(self) -> DeviceInfo:
"""Return device info."""
return self._attr_device_info
@property
def source_type(self) -> SourceType:
"""Source type."""
return SourceType.ROUTER
@property
def is_connected(self) -> bool | None:
"""Device status."""
return self._client.state
@property
def ip_address(self) -> str | None:
"""Device IP address."""
return self._client.ip_address
@property
def mac_address(self) -> str:
"""Device MAC address."""
return self._client.mac_address
@property
def hostname(self) -> str | None:
"""Device hostname."""
return self._client.name
@property
def icon(self) -> str:
"""Device icon."""
return (
"mdi:lan-connect" if self._client.state else "mdi:lan-disconnect"
)
@property
def unique_id(self) -> str | None:
"""Return unique ID of the entity."""
return self._attr_unique_id
@property
def extra_state_attributes(self) -> dict[str, Any]:
"""Return extra state attributes."""
return dict(sorted(self._client.extra_state_attributes.items())) or {}
@callback
def async_on_demand_update(self) -> None:
"""Update the state."""
if self._client.mac_address in self._router.devices:
self._client = self._router.devices[self._client.mac_address]
self.async_write_ha_state()
async def async_added_to_hass(self) -> None:
"""Register state update callback."""
self.async_on_remove(
async_dispatcher_connect(
self.hass,
self._router.signal_device_update,
self.async_on_demand_update,
)
)