homeassistant 2025.9.3__py3-none-any.whl → 2025.10.0__py3-none-any.whl

homeassistant/components/letpot/translations/en.json

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

homeassistant/components/letpot/translations/es.json

@@ -49,6 +49,14 @@
                 "name": "Error de recarga"
             }
         },
+        "number": {
+            "light_brightness": {
+                "name": "Brillo de la luz"
+            },
+            "plant_days": {
+                "name": "Edad de las plantas"
+            }
+        },
         "select": {
             "display_temperature_unit": {
                 "name": "Unidad de temperatura en pantalla",

homeassistant/components/letpot/translations/et.json

@@ -49,6 +49,14 @@
                 "name": "T\u00e4itmise viga"
             }
         },
+        "number": {
+            "light_brightness": {
+                "name": "Valguse heledus"
+            },
+            "plant_days": {
+                "name": "Taimede vanus"
+            }
+        },
         "select": {
             "display_temperature_unit": {
                 "name": "Kuvatav temperatuuri\u00fchik",

homeassistant/components/letpot/translations/fr.json

@@ -22,6 +22,14 @@
         }
     },
     "entity": {
+        "number": {
+            "light_brightness": {
+                "name": "Luminosit\u00e9 de la lumi\u00e8re"
+            },
+            "plant_days": {
+                "name": "\u00c2ge des plantes"
+            }
+        },
         "select": {
             "display_temperature_unit": {
                 "name": "Unit\u00e9 de temp\u00e9rature affich\u00e9e",

homeassistant/components/letpot/translations/ga.json

@@ -49,6 +49,14 @@
                 "name": "Earr\u00e1id athl\u00edonta"
             }
         },
+        "number": {
+            "light_brightness": {
+                "name": "Gile solais"
+            },
+            "plant_days": {
+                "name": "Aois na bplanda\u00ed"
+            }
+        },
         "select": {
             "display_temperature_unit": {
                 "name": "Aonad teochta ar taispe\u00e1int",
@@ -58,7 +66,6 @@
                 }
             },
             "light_brightness": {
-                "name": "Gile solais",
                 "state": {
                     "high": "Ard",
                     "low": "\u00cdseal"

homeassistant/components/letpot/translations/id.json

@@ -22,5 +22,15 @@
                 }
             }
         }
+    },
+    "entity": {
+        "select": {
+            "light_brightness": {
+                "state": {
+                    "high": "Tinggi",
+                    "low": "Rendah"
+                }
+            }
+        }
     }
 }

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

@@ -49,6 +49,14 @@
                 "name": "Papildymo klaida"
             }
         },
+        "number": {
+            "light_brightness": {
+                "name": "\u0160viesos ry\u0161kumas"
+            },
+            "plant_days": {
+                "name": "Augal\u0173 am\u017eius"
+            }
+        },
         "select": {
             "display_temperature_unit": {
                 "name": "Temperat\u016bros vienetas ekrane",

homeassistant/components/letpot/translations/pt.json

@@ -21,7 +21,7 @@
             },
             "user": {
                 "data": {
-                    "email": "E-mail",
+                    "email": "Email",
                     "password": "Palavra-passe"
                 },
                 "data_description": {
@@ -49,6 +49,14 @@
                 "name": "Erro de recarga"
             }
         },
+        "number": {
+            "light_brightness": {
+                "name": "Intensidade da luz"
+            },
+            "plant_days": {
+                "name": "Idade das plantas"
+            }
+        },
         "select": {
             "display_temperature_unit": {
                 "name": "Unidade de temperatura no ecr\u00e3",

homeassistant/components/letpot/translations/sk.json

@@ -49,6 +49,14 @@
                 "name": "Chyba pri dop\u013a\u0148an\u00ed"
             }
         },
+        "number": {
+            "light_brightness": {
+                "name": "Jas svetla"
+            },
+            "plant_days": {
+                "name": "Vek rastl\u00edn"
+            }
+        },
         "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,14 @@
                 "name": "\u91cd\u65b0\u586b\u5145\u51fa\u9519"
             }
         },
+        "number": {
+            "light_brightness": {
+                "name": "\u706f\u5149\u4eae\u5ea6"
+            },
+            "plant_days": {
+                "name": "\u690d\u7269\u5e74\u9f84"
+            }
+        },
         "select": {
             "display_temperature_unit": {
                 "name": "\u6e29\u5ea6\u663e\u793a\u5355\u4f4d",

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

@@ -49,6 +49,14 @@
                 "name": "\u5145\u586b\u932f\u8aa4"
             }
         },
+        "number": {
+            "light_brightness": {
+                "name": "\u5149\u7dda\u4eae\u5ea6"
+            },
+            "plant_days": {
+                "name": "\u690d\u7269\u5e74\u9f61"
+            }
+        },
         "select": {
             "display_temperature_unit": {
                 "name": "\u986f\u793a\u6eab\u5ea6\u55ae\u4f4d",
@@ -58,7 +66,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/ar.json

@@ -0,0 +1,33 @@
+{
+    "entity": {
+        "climate": {
+            "climate_air_conditioner": {
+                "state_attributes": {
+                    "fan_mode": {
+                        "state": {
+                            "auto": "\u062a\u0644\u0642\u0627\u0626\u064a",
+                            "high": "\u0645\u0631\u062a\u0641\u0639",
+                            "low": "\u0645\u0646\u062e\u0641\u0636",
+                            "medium": "\u0645\u062a\u0648\u0633\u0637"
+                        }
+                    }
+                }
+            }
+        },
+        "select": {
+            "air_clean_operation_mode": {
+                "name": "\u0645\u0646\u0642\u064a \u0627\u0644\u0647\u0648\u0627\u0621"
+            },
+            "wind_strength": {
+                "state": {
+                    "slow": "\u0628\u0637\u064a\u0621"
+                }
+            }
+        },
+        "switch": {
+            "air_clean_operation_mode": {
+                "name": "\u0645\u0646\u0642\u064a \u0627\u0644\u0647\u0648\u0627\u0621"
+            }
+        }
+    }
+}

homeassistant/components/lg_thinq/translations/bg.json

@@ -268,6 +268,15 @@
             "cycle_count": {
                 "name": "\u0426\u0438\u043a\u043b\u0438"
             },
+            "energy_usage_last_month": {
+                "name": "\u0415\u043d\u0435\u0440\u0433\u0438\u044f \u043c\u0438\u043d\u0430\u043b\u0438\u044f \u043c\u0435\u0441\u0435\u0446"
+            },
+            "energy_usage_this_month": {
+                "name": "\u0415\u043d\u0435\u0440\u0433\u0438\u044f \u0442\u043e\u0437\u0438 \u043c\u0435\u0441\u0435\u0446"
+            },
+            "energy_usage_yesterday": {
+                "name": "\u0415\u043d\u0435\u0440\u0433\u0438\u044f \u0432\u0447\u0435\u0440\u0430"
+            },
             "fresh_air_filter": {
                 "state": {
                     "off": "\u0418\u0437\u043a\u043b\u044e\u0447\u0435\u043d",

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/ga.json

@@ -722,6 +722,15 @@
             "elapsed_day_total": {
                 "name": "Fad gr\u00fadaireachta"
             },
+            "energy_usage_last_month": {
+                "name": "Fuinneamh an mh\u00ed seo caite"
+            },
+            "energy_usage_this_month": {
+                "name": "Fuinneamh an mh\u00ed seo"
+            },
+            "energy_usage_yesterday": {
+                "name": "Fuinneamh inn\u00e9"
+            },
             "filter_lifetime": {
                 "name": "Scagaire at\u00e1 f\u00e1gtha"
             },