"""Support for AVM FRITZ!SmartHome temperature sensor only devices.""" from __future__ import annotations from collections.abc import Callable from dataclasses import dataclass from datetime import datetime from typing import Final from pyfritzhome.fritzhomedevice import FritzhomeDevice from homeassistant.components.climate import PRESET_COMFORT, PRESET_ECO from homeassistant.components.sensor import ( SensorDeviceClass, SensorEntity, SensorEntityDescription, SensorStateClass, ) from homeassistant.config_entries import ConfigEntry from homeassistant.const import ( ELECTRIC_CURRENT_AMPERE, ELECTRIC_POTENTIAL_VOLT, ENERGY_KILO_WATT_HOUR, PERCENTAGE, POWER_WATT, TEMP_CELSIUS, ) from homeassistant.core import HomeAssistant from homeassistant.helpers.entity import EntityCategory from homeassistant.helpers.entity_platform import AddEntitiesCallback from homeassistant.helpers.typing import StateType from homeassistant.util.dt import utc_from_timestamp from . import FritzBoxDeviceEntity from .const import CONF_COORDINATOR, DOMAIN as FRITZBOX_DOMAIN from .model import FritzEntityDescriptionMixinBase @dataclass class FritzEntityDescriptionMixinSensor(FritzEntityDescriptionMixinBase): """Sensor description mixin for Fritz!Smarthome entities.""" native_value: Callable[[FritzhomeDevice], StateType | datetime] @dataclass class FritzSensorEntityDescription( SensorEntityDescription, FritzEntityDescriptionMixinSensor ): """Description for Fritz!Smarthome sensor entities.""" def suitable_eco_temperature(device: FritzhomeDevice) -> bool: """Check suitablity for eco temperature sensor.""" return device.has_thermostat and device.eco_temperature is not None def suitable_comfort_temperature(device: FritzhomeDevice) -> bool: """Check suitablity for comfort temperature sensor.""" return device.has_thermostat and device.comfort_temperature is not None def suitable_nextchange_temperature(device: FritzhomeDevice) -> bool: """Check suitablity for next scheduled temperature sensor.""" return device.has_thermostat and device.nextchange_temperature is not None def suitable_nextchange_time(device: FritzhomeDevice) -> bool: """Check suitablity for next scheduled changed time sensor.""" return device.has_thermostat and device.nextchange_endperiod is not None def suitable_temperature(device: FritzhomeDevice) -> bool: """Check suitablity for temperature sensor.""" return device.has_temperature_sensor and not device.has_thermostat def value_electric_current(device: FritzhomeDevice) -> float: """Return native value for electric current sensor.""" if ( isinstance(device.power, int) and isinstance(device.voltage, int) and device.voltage > 0 ): return round(device.power / device.voltage, 3) return 0.0 def value_nextchange_preset(device: FritzhomeDevice) -> str: """Return native value for next scheduled preset sensor.""" if device.nextchange_temperature == device.eco_temperature: return PRESET_ECO return PRESET_COMFORT def value_scheduled_preset(device: FritzhomeDevice) -> str: """Return native value for current scheduled preset sensor.""" if device.nextchange_temperature == device.eco_temperature: return PRESET_COMFORT return PRESET_ECO SENSOR_TYPES: Final[tuple[FritzSensorEntityDescription, ...]] = ( FritzSensorEntityDescription( key="temperature", name="Temperature", native_unit_of_measurement=TEMP_CELSIUS, device_class=SensorDeviceClass.TEMPERATURE, state_class=SensorStateClass.MEASUREMENT, entity_category=EntityCategory.DIAGNOSTIC, suitable=suitable_temperature, native_value=lambda device: device.temperature, # type: ignore[no-any-return] ), FritzSensorEntityDescription( key="humidity", name="Humidity", native_unit_of_measurement=PERCENTAGE, device_class=SensorDeviceClass.HUMIDITY, state_class=SensorStateClass.MEASUREMENT, suitable=lambda device: device.rel_humidity is not None, native_value=lambda device: device.rel_humidity, # type: ignore[no-any-return] ), FritzSensorEntityDescription( key="battery", name="Battery", native_unit_of_measurement=PERCENTAGE, device_class=SensorDeviceClass.BATTERY, entity_category=EntityCategory.DIAGNOSTIC, suitable=lambda device: device.battery_level is not None, native_value=lambda device: device.battery_level, # type: ignore[no-any-return] ), FritzSensorEntityDescription( key="power_consumption", name="Power Consumption", native_unit_of_measurement=POWER_WATT, device_class=SensorDeviceClass.POWER, state_class=SensorStateClass.MEASUREMENT, suitable=lambda device: device.has_powermeter, # type: ignore[no-any-return] native_value=lambda device: round((device.power or 0.0) / 1000, 3), ), FritzSensorEntityDescription( key="voltage", name="Voltage", native_unit_of_measurement=ELECTRIC_POTENTIAL_VOLT, device_class=SensorDeviceClass.VOLTAGE, state_class=SensorStateClass.MEASUREMENT, suitable=lambda device: device.has_powermeter, # type: ignore[no-any-return] native_value=lambda device: round((device.voltage or 0.0) / 1000, 2), ), FritzSensorEntityDescription( key="electric_current", name="Electric Current", native_unit_of_measurement=ELECTRIC_CURRENT_AMPERE, device_class=SensorDeviceClass.CURRENT, state_class=SensorStateClass.MEASUREMENT, suitable=lambda device: device.has_powermeter, # type: ignore[no-any-return] native_value=value_electric_current, ), FritzSensorEntityDescription( key="total_energy", name="Total Energy", native_unit_of_measurement=ENERGY_KILO_WATT_HOUR, device_class=SensorDeviceClass.ENERGY, state_class=SensorStateClass.TOTAL_INCREASING, suitable=lambda device: device.has_powermeter, # type: ignore[no-any-return] native_value=lambda device: (device.energy or 0.0) / 1000, ), # Thermostat Sensors FritzSensorEntityDescription( key="comfort_temperature", name="Comfort Temperature", native_unit_of_measurement=TEMP_CELSIUS, device_class=SensorDeviceClass.TEMPERATURE, suitable=suitable_comfort_temperature, native_value=lambda device: device.comfort_temperature, # type: ignore[no-any-return] ), FritzSensorEntityDescription( key="eco_temperature", name="Eco Temperature", native_unit_of_measurement=TEMP_CELSIUS, device_class=SensorDeviceClass.TEMPERATURE, suitable=suitable_eco_temperature, native_value=lambda device: device.eco_temperature, # type: ignore[no-any-return] ), FritzSensorEntityDescription( key="nextchange_temperature", name="Next Scheduled Temperature", native_unit_of_measurement=TEMP_CELSIUS, device_class=SensorDeviceClass.TEMPERATURE, suitable=suitable_nextchange_temperature, native_value=lambda device: device.nextchange_temperature, # type: ignore[no-any-return] ), FritzSensorEntityDescription( key="nextchange_time", name="Next Scheduled Change Time", device_class=SensorDeviceClass.TIMESTAMP, suitable=suitable_nextchange_time, native_value=lambda device: utc_from_timestamp(device.nextchange_endperiod), ), FritzSensorEntityDescription( key="nextchange_preset", name="Next Scheduled Preset", suitable=suitable_nextchange_temperature, native_value=value_nextchange_preset, ), FritzSensorEntityDescription( key="scheduled_preset", name="Current Scheduled Preset", suitable=suitable_nextchange_temperature, native_value=value_scheduled_preset, ), ) async def async_setup_entry( hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback ) -> None: """Set up the FRITZ!SmartHome sensor from ConfigEntry.""" coordinator = hass.data[FRITZBOX_DOMAIN][entry.entry_id][CONF_COORDINATOR] async_add_entities( [ FritzBoxSensor(coordinator, ain, description) for ain, device in coordinator.data.devices.items() for description in SENSOR_TYPES if description.suitable(device) ] ) class FritzBoxSensor(FritzBoxDeviceEntity, SensorEntity): """The entity class for FRITZ!SmartHome sensors.""" entity_description: FritzSensorEntityDescription @property def native_value(self) -> StateType | datetime: """Return the state of the sensor.""" return self.entity_description.native_value(self.data)