feat: Coordinator, Geraet und Licht-Entitaet

custom_components/ninlight/entity.py

@@ -0,0 +1,43 @@
+"""Base entity and device info for ninlight lamps."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from homeassistant.helpers import device_registry as dr
+from homeassistant.helpers.device_registry import DeviceInfo, format_mac
+from homeassistant.helpers.update_coordinator import CoordinatorEntity
+
+from .const import DOMAIN
+from .coordinator import NinlightCoordinator
+
+
+def device_name(info: dict[str, Any]) -> str:
+    """The lamp's own name, else '<product> <last four MAC digits>'."""
+    name = str(info.get("name") or "").strip()
+    if name:
+        return name
+    mac4 = format_mac(info["mac"]).replace(":", "")[-4:]
+    product = info.get("product_name") or info["device_type"]
+    return f"{product} {mac4}"
+
+
+class NinlightEntity(CoordinatorEntity[NinlightCoordinator]):
+    """Common base: unique id from the MAC, one device per lamp."""
+
+    _attr_has_entity_name = True
+
+    def __init__(self, coordinator: NinlightCoordinator, key: str) -> None:
+        super().__init__(coordinator)
+        info = coordinator.data.info
+        mac = format_mac(info["mac"])
+        self._attr_unique_id = f"{mac}_{key}"
+        self._attr_device_info = DeviceInfo(
+            identifiers={(DOMAIN, mac)},
+            connections={(dr.CONNECTION_NETWORK_MAC, mac)},
+            manufacturer="ninlight",
+            model=info.get("product_name") or None,
+            model_id=info["device_type"],
+            name=device_name(info),
+            sw_version=info["fw_version"],
+        )