homeassistant 2025.9.4__py3-none-any.whl → 2025.10.0b1__py3-none-any.whl

homeassistant/components/letpot/translations/en.json

@@ -49,6 +49,15 @@
                 "name": "Refill error"
             }
         },
+        "number": {
+            "light_brightness": {
+                "name": "Light brightness"
+            },
+            "plant_days": {
+                "name": "Plants age",
+                "unit_of_measurement": "days"
+            }
+        },
         "select": {
             "display_temperature_unit": {
                 "name": "Temperature unit on display",

homeassistant/components/letpot/translations/es.json

@@ -58,7 +58,6 @@
                 }
             },
             "light_brightness": {
-                "name": "Brillo de la luz",
                 "state": {
                     "high": "Alto",
                     "low": "Bajo"

homeassistant/components/letpot/translations/et.json

@@ -58,7 +58,6 @@
                 }
             },
             "light_brightness": {
-                "name": "Valguse heledus",
                 "state": {
                     "high": "K\u00f5rge",
                     "low": "Madal"

homeassistant/components/letpot/translations/fr.json

@@ -31,7 +31,6 @@
                 }
             },
             "light_brightness": {
-                "name": "Luminosit\u00e9 de la lumi\u00e8re",
                 "state": {
                     "high": "\u00c9lev\u00e9",
                     "low": "Faible"

homeassistant/components/letpot/translations/ga.json

@@ -58,7 +58,6 @@
                 }
             },
             "light_brightness": {
-                "name": "Gile solais",
                 "state": {
                     "high": "Ard",
                     "low": "\u00cdseal"

homeassistant/components/letpot/translations/it.json

@@ -33,7 +33,6 @@
                 }
             },
             "light_brightness": {
-                "name": "Luminosit\u00e0 della luce",
                 "state": {
                     "high": "Alto/a",
                     "low": "Basso/a"

homeassistant/components/letpot/translations/lt.json

@@ -58,7 +58,6 @@
                 }
             },
             "light_brightness": {
-                "name": "\u0160viesos ry\u0161kumas",
                 "state": {
                     "high": "Auk\u0161tas",
                     "low": "\u017demas"

homeassistant/components/letpot/translations/nl.json

@@ -43,6 +43,11 @@
                 "name": "Pompfout"
             }
         },
+        "number": {
+            "plant_days": {
+                "unit_of_measurement": "dagen"
+            }
+        },
         "select": {
             "display_temperature_unit": {
                 "name": "Temperatuureenheid op het display",

homeassistant/components/letpot/translations/pt.json

@@ -58,7 +58,6 @@
                 }
             },
             "light_brightness": {
-                "name": "Intensidade da luz",
                 "state": {
                     "high": "Alto",
                     "low": "Baixo"

homeassistant/components/letpot/translations/sk.json

@@ -49,6 +49,15 @@
                 "name": "Chyba pri dop\u013a\u0148an\u00ed"
             }
         },
+        "number": {
+            "light_brightness": {
+                "name": "Jas svetla"
+            },
+            "plant_days": {
+                "name": "Vek rastl\u00edn",
+                "unit_of_measurement": "dni"
+            }
+        },
         "select": {
             "display_temperature_unit": {
                 "name": "Jednotka teploty na displeji",

homeassistant/components/letpot/translations/sv.json

@@ -58,7 +58,6 @@
                 }
             },
             "light_brightness": {
-                "name": "Ljusstyrka",
                 "state": {
                     "high": "H\u00f6g",
                     "low": "L\u00e5g"

homeassistant/components/letpot/translations/zh-Hans.json

@@ -49,6 +49,15 @@
                 "name": "\u91cd\u65b0\u586b\u5145\u51fa\u9519"
             }
         },
+        "number": {
+            "light_brightness": {
+                "name": "\u706f\u5149\u4eae\u5ea6"
+            },
+            "plant_days": {
+                "name": "\u690d\u7269\u5e74\u9f84",
+                "unit_of_measurement": "\u5929"
+            }
+        },
         "select": {
             "display_temperature_unit": {
                 "name": "\u6e29\u5ea6\u663e\u793a\u5355\u4f4d",

homeassistant/components/letpot/translations/zh-Hant.json

@@ -49,6 +49,15 @@
                 "name": "\u5145\u586b\u932f\u8aa4"
             }
         },
+        "number": {
+            "light_brightness": {
+                "name": "\u5149\u7dda\u4eae\u5ea6"
+            },
+            "plant_days": {
+                "name": "\u690d\u7269\u5e74\u9f61",
+                "unit_of_measurement": "\u5929"
+            }
+        },
         "select": {
             "display_temperature_unit": {
                 "name": "\u986f\u793a\u6eab\u5ea6\u55ae\u4f4d",
@@ -58,7 +67,7 @@
                 }
             },
             "light_brightness": {
-                "name": "\u71c8\u5149\u4eae\u5ea6",
+                "name": "\u5149\u7dda\u4eae\u5ea6",
                 "state": {
                     "high": "\u9ad8",
                     "low": "\u4f4e"

homeassistant/components/lg_thinq/coordinator.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from collections.abc import Mapping
+from datetime import time
 import logging
 from typing import TYPE_CHECKING, Any
 
@@ -70,6 +71,9 @@ class DeviceDataUpdateCoordinator(DataUpdateCoordinator[dict[str, Any]]):
                 event_filter=self.async_config_update_filter,
             )
         )
+        # Time of day for fetching the device's energy usage
+        # (randomly assigned when device is first created in Home Assistant)
+        self.update_energy_at_time_of_day: time | None = None
 
     async def _handle_update_config(self, _: Event) -> None:
         """Handle update core config."""

homeassistant/components/lg_thinq/entity.py

@@ -34,6 +34,7 @@ class ThinQEntity(CoordinatorEntity[DeviceDataUpdateCoordinator]):
         coordinator: DeviceDataUpdateCoordinator,
         entity_description: EntityDescription,
         property_id: str,
+        postfix_id: str | None = None,
     ) -> None:
         """Initialize an entity."""
         super().__init__(coordinator)
@@ -48,7 +49,11 @@ class ThinQEntity(CoordinatorEntity[DeviceDataUpdateCoordinator]):
             model=f"{coordinator.api.device.model_name} ({self.coordinator.api.device.device_type})",
             name=coordinator.device_name,
         )
-        self._attr_unique_id = f"{coordinator.unique_id}_{self.property_id}"
+        self._attr_unique_id = (
+            f"{coordinator.unique_id}_{self.property_id}"
+            if postfix_id is None
+            else f"{coordinator.unique_id}_{self.property_id}_{postfix_id}"
+        )
         if self.location is not None and self.location not in (
             Location.MAIN,
             Location.OVEN,

homeassistant/components/lg_thinq/icons.json

@@ -440,6 +440,15 @@
       },
       "cycle_count_for_location": {
         "default": "mdi:counter"
+      },
+      "energy_usage_yesterday": {
+        "default": "mdi:chart-bar"
+      },
+      "energy_usage_this_month": {
+        "default": "mdi:chart-bar"
+      },
+      "energy_usage_last_month": {
+        "default": "mdi:chart-bar"
       }
     }
   }

homeassistant/components/lg_thinq/manifest.json

@@ -7,5 +7,5 @@
   "documentation": "https://www.home-assistant.io/integrations/lg_thinq",
   "iot_class": "cloud_push",
   "loggers": ["thinqconnect"],
-  "requirements": ["thinqconnect==1.0.7"]
+  "requirements": ["thinqconnect==1.0.8"]
 }

homeassistant/components/lg_thinq/sensor.py

@@ -2,10 +2,13 @@
 
 from __future__ import annotations
 
+from collections.abc import Callable
+from dataclasses import dataclass
 from datetime import datetime, time, timedelta
 import logging
+import random
 
-from thinqconnect import DeviceType
+from thinqconnect import USAGE_DAILY, USAGE_MONTHLY, DeviceType, ThinQAPIException
 from thinqconnect.devices.const import Property as ThinQProperty
 from thinqconnect.integration import ActiveMode, ThinQPropertyEx, TimerProperty
 
@@ -18,11 +21,13 @@ from homeassistant.components.sensor import (
 from homeassistant.const import (
     CONCENTRATION_MICROGRAMS_PER_CUBIC_METER,
     PERCENTAGE,
+    UnitOfEnergy,
     UnitOfTemperature,
     UnitOfTime,
 )
 from homeassistant.core import HomeAssistant
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback
+from homeassistant.helpers.event import async_track_point_in_time
 from homeassistant.util import dt as dt_util
 
 from . import ThinqConfigEntry
@@ -553,6 +558,44 @@ DEVICE_TYPE_SENSOR_MAP: dict[DeviceType, tuple[SensorEntityDescription, ...]] =
     ),
 }
 
+
+@dataclass(frozen=True, kw_only=True)
+class ThinQEnergySensorEntityDescription(SensorEntityDescription):
+    """Describes ThinQ energy sensor entity."""
+
+    device_class = SensorDeviceClass.ENERGY
+    state_class = SensorStateClass.TOTAL
+    native_unit_of_measurement = UnitOfEnergy.WATT_HOUR
+    suggested_display_precision = 0
+    usage_period: str
+    start_date_fn: Callable[[datetime], datetime]
+    end_date_fn: Callable[[datetime], datetime]
+    update_interval: timedelta = timedelta(days=1)
+
+
+ENERGY_USAGE_SENSORS: tuple[ThinQEnergySensorEntityDescription, ...] = (
+    ThinQEnergySensorEntityDescription(
+        key="yesterday",
+        translation_key="energy_usage_yesterday",
+        usage_period=USAGE_DAILY,
+        start_date_fn=lambda today: today - timedelta(days=1),
+        end_date_fn=lambda today: today - timedelta(days=1),
+    ),
+    ThinQEnergySensorEntityDescription(
+        key="this_month",
+        translation_key="energy_usage_this_month",
+        usage_period=USAGE_MONTHLY,
+        start_date_fn=lambda today: today,
+        end_date_fn=lambda today: today,
+    ),
+    ThinQEnergySensorEntityDescription(
+        key="last_month",
+        translation_key="energy_usage_last_month",
+        usage_period=USAGE_MONTHLY,
+        start_date_fn=lambda today: today.replace(day=1) - timedelta(days=1),
+        end_date_fn=lambda today: today.replace(day=1) - timedelta(days=1),
+    ),
+)
 _LOGGER = logging.getLogger(__name__)
 
 
@@ -562,7 +605,7 @@ async def async_setup_entry(
     async_add_entities: AddConfigEntryEntitiesCallback,
 ) -> None:
     """Set up an entry for sensor platform."""
-    entities: list[ThinQSensorEntity] = []
+    entities: list[ThinQSensorEntity | ThinQEnergySensorEntity] = []
     for coordinator in entry.runtime_data.coordinators.values():
         if (
             descriptions := DEVICE_TYPE_SENSOR_MAP.get(
@@ -584,7 +627,23 @@ async def async_setup_entry(
                         ),
                     )
                 )
-
+        for energy_description in ENERGY_USAGE_SENSORS:
+            entities.extend(
+                ThinQEnergySensorEntity(
+                    coordinator=coordinator,
+                    entity_description=energy_description,
+                    property_id=energy_property_id,
+                    postfix_id=energy_description.key,
+                )
+                for energy_property_id in coordinator.api.get_active_idx(
+                    (
+                        ThinQPropertyEx.ENERGY_USAGE
+                        if coordinator.sub_id is None
+                        else f"{ThinQPropertyEx.ENERGY_USAGE}_{coordinator.sub_id}"
+                    ),
+                    ActiveMode.READ_ONLY,
+                )
+            )
     if entities:
         async_add_entities(entities)
 
@@ -686,3 +745,84 @@ class ThinQSensorEntity(ThinQEntity, SensorEntity):
         if unit == UnitOfTime.SECONDS:
             return (data.hour * 3600) + (data.minute * 60) + data.second
         return 0
+
+
+class ThinQEnergySensorEntity(ThinQEntity, SensorEntity):
+    """Represent a ThinQ energy sensor platform."""
+
+    entity_description: ThinQEnergySensorEntityDescription
+    _stop_update: Callable[[], None] | None = None
+
+    async def async_added_to_hass(self) -> None:
+        """Handle added to Hass."""
+        await super().async_added_to_hass()
+        if self.coordinator.update_energy_at_time_of_day is None:
+            # random time 01:00:00 ~ 02:59:00
+            self.coordinator.update_energy_at_time_of_day = time(
+                hour=random.randint(1, 2), minute=random.randint(0, 59)
+            )
+            _LOGGER.debug(
+                "[%s] Set energy update time: %s",
+                self.coordinator.device_name,
+                self.coordinator.update_energy_at_time_of_day,
+            )
+
+        await self._async_update_and_schedule()
+
+    async def async_will_remove_from_hass(self) -> None:
+        """Run when entity will be removed from hass."""
+        if self._stop_update is not None:
+            self._stop_update()
+        return await super().async_will_remove_from_hass()
+
+    @property
+    def available(self) -> bool:
+        """Return True if entity is available."""
+        return super().available or self.native_value is not None
+
+    async def async_update(self, now: datetime | None = None) -> None:
+        """Update the state of the sensor."""
+        await self._async_update_and_schedule()
+        self.async_write_ha_state()
+
+    async def _async_update_and_schedule(self) -> None:
+        """Update the state of the sensor."""
+        local_now = datetime.now(
+            dt_util.get_time_zone(self.coordinator.hass.config.time_zone)
+        )
+        next_update = local_now + self.entity_description.update_interval
+        if self.coordinator.update_energy_at_time_of_day is not None:
+            # calculate next_update time by combining tomorrow and update_energy_at_time_of_day
+            next_update = datetime.combine(
+                (next_update).date(),
+                self.coordinator.update_energy_at_time_of_day,
+                next_update.tzinfo,
+            )
+        try:
+            self._attr_native_value = await self.coordinator.api.async_get_energy_usage(
+                energy_property=self.property_id,
+                period=self.entity_description.usage_period,
+                start_date=(self.entity_description.start_date_fn(local_now)).date(),
+                end_date=(self.entity_description.end_date_fn(local_now)).date(),
+                detail=False,
+            )
+        except ThinQAPIException as exc:
+            _LOGGER.warning(
+                "[%s:%s] Failed to fetch energy usage data. reason=%s",
+                self.coordinator.device_name,
+                self.entity_description.key,
+                exc,
+            )
+        finally:
+            _LOGGER.debug(
+                "[%s:%s] async_update_and_schedule next_update: %s, native_value: %s",
+                self.coordinator.device_name,
+                self.entity_description.key,
+                next_update,
+                self._attr_native_value,
+            )
+            self._stop_update = async_track_point_in_time(
+                self.coordinator.hass,
+                self.async_update,
+                next_update,
+            )

homeassistant/components/lg_thinq/strings.json

@@ -923,6 +923,15 @@
       },
       "cycle_count_for_location": {
         "name": "{location} cycles"
+      },
+      "energy_usage_yesterday": {
+        "name": "Energy yesterday"
+      },
+      "energy_usage_this_month": {
+        "name": "Energy this month"
+      },
+      "energy_usage_last_month": {
+        "name": "Energy last month"
       }
     },
     "select": {

homeassistant/components/lg_thinq/translations/cs.json

@@ -729,6 +729,15 @@
             "elapsed_day_total": {
                 "name": "Doba va\u0159en\u00ed"
             },
+            "energy_usage_last_month": {
+                "name": "Energie minul\u00fd m\u011bs\u00edc"
+            },
+            "energy_usage_this_month": {
+                "name": "Energie tento m\u011bs\u00edc"
+            },
+            "energy_usage_yesterday": {
+                "name": "Energie v\u010dera"
+            },
             "filter_lifetime": {
                 "name": "Zb\u00fdvaj\u00edc\u00ed filtr"
             },

homeassistant/components/lg_thinq/translations/de.json

@@ -729,6 +729,15 @@
             "elapsed_day_total": {
                 "name": "Brauzeit"
             },
+            "energy_usage_last_month": {
+                "name": "Energie im letzten Monat"
+            },
+            "energy_usage_this_month": {
+                "name": "Energie in diesem Monat"
+            },
+            "energy_usage_yesterday": {
+                "name": "Energie gestern"
+            },
             "filter_lifetime": {
                 "name": "Filter verbleibend"
             },

homeassistant/components/lg_thinq/translations/en-GB.json

@@ -729,6 +729,15 @@
             "elapsed_day_total": {
                 "name": "Brewing duration"
             },
+            "energy_usage_last_month": {
+                "name": "Energy last month"
+            },
+            "energy_usage_this_month": {
+                "name": "Energy this month"
+            },
+            "energy_usage_yesterday": {
+                "name": "Energy yesterday"
+            },
             "filter_lifetime": {
                 "name": "Filter remaining"
             },

homeassistant/components/lg_thinq/translations/en.json

@@ -729,6 +729,15 @@
             "elapsed_day_total": {
                 "name": "Brewing duration"
             },
+            "energy_usage_last_month": {
+                "name": "Energy last month"
+            },
+            "energy_usage_this_month": {
+                "name": "Energy this month"
+            },
+            "energy_usage_yesterday": {
+                "name": "Energy yesterday"
+            },
             "filter_lifetime": {
                 "name": "Filter remaining"
             },

homeassistant/components/lg_thinq/translations/es.json

@@ -729,6 +729,15 @@
             "elapsed_day_total": {
                 "name": "Duraci\u00f3n de la elaboraci\u00f3n"
             },
+            "energy_usage_last_month": {
+                "name": "Energ\u00eda el mes pasado"
+            },
+            "energy_usage_this_month": {
+                "name": "Energ\u00eda este mes"
+            },
+            "energy_usage_yesterday": {
+                "name": "Energ\u00eda ayer"
+            },
             "filter_lifetime": {
                 "name": "Filtro restante"
             },

homeassistant/components/lg_thinq/translations/et.json

@@ -729,6 +729,15 @@
             "elapsed_day_total": {
                 "name": "Pruulimise kestus"
             },
+            "energy_usage_last_month": {
+                "name": "Energia eelmisel kuul"
+            },
+            "energy_usage_this_month": {
+                "name": "Energia sel kuul"
+            },
+            "energy_usage_yesterday": {
+                "name": "Energia eile"
+            },
             "filter_lifetime": {
                 "name": "Filtri j\u00e4relej\u00e4\u00e4nud aeg"
             },

homeassistant/components/lg_thinq/translations/lt.json

@@ -729,6 +729,15 @@
             "elapsed_day_total": {
                 "name": "Alaus gaminimo trukm\u0117"
             },
+            "energy_usage_last_month": {
+                "name": "Energija pra\u0117jus\u012f m\u0117nes\u012f"
+            },
+            "energy_usage_this_month": {
+                "name": "Energija \u0161\u012f m\u0117nes\u012f"
+            },
+            "energy_usage_yesterday": {
+                "name": "Energija vakar"
+            },
             "filter_lifetime": {
                 "name": "Liko filtras"
             },

homeassistant/components/lg_thinq/translations/nl.json

@@ -522,6 +522,15 @@
             "elapsed_day_total": {
                 "name": "Brouwduur"
             },
+            "energy_usage_last_month": {
+                "name": "Energie vorige maand"
+            },
+            "energy_usage_this_month": {
+                "name": "Energie deze maand"
+            },
+            "energy_usage_yesterday": {
+                "name": "Energie gisteren"
+            },
             "filter_lifetime": {
                 "name": "Filter resterend"
             },

homeassistant/components/lg_thinq/translations/pt.json

@@ -729,6 +729,15 @@
             "elapsed_day_total": {
                 "name": "Dura\u00e7\u00e3o da fermenta\u00e7\u00e3o"
             },
+            "energy_usage_last_month": {
+                "name": "Energia no m\u00eas passado"
+            },
+            "energy_usage_this_month": {
+                "name": "Energia este m\u00eas"
+            },
+            "energy_usage_yesterday": {
+                "name": "Energia ontem"
+            },
             "filter_lifetime": {
                 "name": "Filtro restante"
             },

homeassistant/components/lg_thinq/translations/sk.json

@@ -729,6 +729,15 @@
             "elapsed_day_total": {
                 "name": "Trvanie varenia"
             },
+            "energy_usage_last_month": {
+                "name": "Energia minul\u00fd mesiac"
+            },
+            "energy_usage_this_month": {
+                "name": "Energia tento mesiac"
+            },
+            "energy_usage_yesterday": {
+                "name": "Energia v\u010dera"
+            },
             "filter_lifetime": {
                 "name": "Zost\u00e1vaj\u00faci filter"
             },

homeassistant/components/lg_thinq/translations/zh-Hans.json

@@ -729,6 +729,15 @@
             "elapsed_day_total": {
                 "name": "\u51b2\u6ce1\u65f6\u957f"
             },
+            "energy_usage_last_month": {
+                "name": "\u80fd\u6e90 - \u4e0a\u6708"
+            },
+            "energy_usage_this_month": {
+                "name": "\u80fd\u6e90 - \u672c\u6708"
+            },
+            "energy_usage_yesterday": {
+                "name": "\u80fd\u6e90 - \u6628\u5929"
+            },
             "filter_lifetime": {
                 "name": "\u6ee4\u82af\u5269\u4f59\u65f6\u957f"
             },

homeassistant/components/lg_thinq/translations/zh-Hant.json

@@ -729,6 +729,15 @@
             "elapsed_day_total": {
                 "name": "\u91c0\u9020\u6301\u7e8c\u6642\u9593"
             },
+            "energy_usage_last_month": {
+                "name": "\u4e0a\u6708\u80fd\u6e90"
+            },
+            "energy_usage_this_month": {
+                "name": "\u672c\u6708\u80fd\u6e90"
+            },
+            "energy_usage_yesterday": {
+                "name": "\u6628\u65e5\u80fd\u6e90"
+            },
             "filter_lifetime": {
                 "name": "\u904e\u6ffe\u5668\u5269\u9918\u91cf"
             },