entity.py

Go to the documentation of this file.

"""WiZ integration entities."""
 
from __future__ import annotations
 
from abc import abstractmethod
from typing import Any
 
from pywizlight.bulblibrary import BulbType
 
from homeassistant.const import ATTR_HW_VERSION, ATTR_MODEL
from homeassistant.core import callback
from homeassistant.helpers.device_registry import CONNECTION_NETWORK_MAC, DeviceInfo
from homeassistant.helpers.entity import Entity, ToggleEntity
from homeassistant.helpers.update_coordinator import (
    CoordinatorEntity,
    DataUpdateCoordinator,
)
 
from .models import WizData
 
 
class WizEntity(CoordinatorEntity[DataUpdateCoordinator[float | None]], Entity):
    """Representation of WiZ entity."""
 
    _attr_has_entity_name = True
 
    def __init__(self, wiz_data: WizData, name: str) -> None:
        """Initialize a WiZ entity."""
        super().__init__(wiz_data.coordinator)
        self._device_device = wiz_data.bulb
        bulb_type: BulbType = self._device_device.bulbtype
        self._attr_unique_id_attr_unique_id = self._device_device.mac
        self._attr_device_info_attr_device_info = DeviceInfo(
            connections={(CONNECTION_NETWORK_MAC, self._device_device.mac)},
            name=name,
            manufacturer="WiZ",
            sw_version=bulb_type.fw_version,
        )
        if bulb_type.name is None:
            return
        hw_data = bulb_type.name.split("_")
        board = hw_data.pop(0)
        model = hw_data.pop(0)
        hw_version = f"{board} {hw_data[0]}" if hw_data else board
        self._attr_device_info_attr_device_info[ATTR_HW_VERSION] = hw_version
        self._attr_device_info_attr_device_info[ATTR_MODEL] = model
 
    @callback
    def _handle_coordinator_update(self) -> None:
        """Handle updated data from the coordinator."""
        self._async_update_attrs_async_update_attrs()
        super()._handle_coordinator_update()
 
    @callback
    @abstractmethod
    def _async_update_attrs(self) -> None:
        """Handle updating _attr values."""
 
 
class WizToggleEntity(WizEntity, ToggleEntity):
    """Representation of WiZ toggle entity."""
 
    @callback
    def _async_update_attrs(self) -> None:
        """Handle updating _attr values."""
        self._attr_is_on_attr_is_on = self._device_device.status
 
    async def async_turn_off(self, **kwargs: Any) -> None:
        """Instruct the device to turn off."""
        await self._device_device.turn_off()
        await self.coordinator.async_request_refresh()