core/homeassistant/components/fully_kiosk/entity.py

47 lines
1.8 KiB
Python

"""Base entity for the Fully Kiosk Browser integration."""
from __future__ import annotations
from homeassistant.helpers.device_registry import CONNECTION_NETWORK_MAC
from homeassistant.helpers.entity import DeviceInfo, Entity
from homeassistant.helpers.update_coordinator import CoordinatorEntity
from .const import DOMAIN
from .coordinator import FullyKioskDataUpdateCoordinator
def valid_global_mac_address(mac: str | None) -> bool:
"""Check if a MAC address is valid, non-locally administered address."""
if not isinstance(mac, str):
return False
try:
first_octet = int(mac.split(":")[0], 16)
# If the second least-significant bit is set, it's a locally administered address, should not be used as an ID
return not bool(first_octet & 0x2)
except ValueError:
return False
class FullyKioskEntity(CoordinatorEntity[FullyKioskDataUpdateCoordinator], Entity):
"""Defines a Fully Kiosk Browser entity."""
_attr_has_entity_name = True
def __init__(self, coordinator: FullyKioskDataUpdateCoordinator) -> None:
"""Initialize the Fully Kiosk Browser entity."""
super().__init__(coordinator=coordinator)
device_info = DeviceInfo(
identifiers={(DOMAIN, coordinator.data["deviceID"])},
name=coordinator.data["deviceName"],
manufacturer=coordinator.data["deviceManufacturer"],
model=coordinator.data["deviceModel"],
sw_version=coordinator.data["appVersionName"],
configuration_url=f"http://{coordinator.data['ip4']}:2323",
)
if "Mac" in coordinator.data and valid_global_mac_address(
coordinator.data["Mac"]
):
device_info["connections"] = {
(CONNECTION_NETWORK_MAC, coordinator.data["Mac"])
}
self._attr_device_info = device_info