homeassistant 2025.8.2__py3-none-any.whl → 2025.9.0__py3-none-any.whl

homeassistant/components/enphase_envoy/binary_sensor.py

@@ -6,7 +6,7 @@ from collections.abc import Callable
 from dataclasses import dataclass
 from operator import attrgetter
 
-from pyenphase import EnvoyEncharge, EnvoyEnpower
+from pyenphase import EnvoyC6CC, EnvoyCollar, EnvoyEncharge, EnvoyEnpower
 
 from homeassistant.components.binary_sensor import (
     BinarySensorDeviceClass,
@@ -72,6 +72,42 @@ ENPOWER_SENSORS = (
 )
 
 
+@dataclass(frozen=True, kw_only=True)
+class EnvoyCollarBinarySensorEntityDescription(BinarySensorEntityDescription):
+    """Describes an Envoy IQ Meter Collar binary sensor entity."""
+
+    value_fn: Callable[[EnvoyCollar], bool]
+
+
+COLLAR_SENSORS = (
+    EnvoyCollarBinarySensorEntityDescription(
+        key="communicating",
+        translation_key="communicating",
+        device_class=BinarySensorDeviceClass.CONNECTIVITY,
+        entity_category=EntityCategory.DIAGNOSTIC,
+        value_fn=attrgetter("communicating"),
+    ),
+)
+
+
+@dataclass(frozen=True, kw_only=True)
+class EnvoyC6CCBinarySensorEntityDescription(BinarySensorEntityDescription):
+    """Describes an C6 Combiner controller binary sensor entity."""
+
+    value_fn: Callable[[EnvoyC6CC], bool]
+
+
+C6CC_SENSORS = (
+    EnvoyC6CCBinarySensorEntityDescription(
+        key="communicating",
+        translation_key="communicating",
+        device_class=BinarySensorDeviceClass.CONNECTIVITY,
+        entity_category=EntityCategory.DIAGNOSTIC,
+        value_fn=attrgetter("communicating"),
+    ),
+)
+
+
 async def async_setup_entry(
     hass: HomeAssistant,
     config_entry: EnphaseConfigEntry,
@@ -95,6 +131,18 @@ async def async_setup_entry(
             for description in ENPOWER_SENSORS
         )
 
+    if envoy_data.collar:
+        entities.extend(
+            EnvoyCollarBinarySensorEntity(coordinator, description)
+            for description in COLLAR_SENSORS
+        )
+
+    if envoy_data.c6cc:
+        entities.extend(
+            EnvoyC6CCBinarySensorEntity(coordinator, description)
+            for description in C6CC_SENSORS
+        )
+
     async_add_entities(entities)
 
 
@@ -168,3 +216,69 @@ class EnvoyEnpowerBinarySensorEntity(EnvoyBaseBinarySensorEntity):
         enpower = self.data.enpower
         assert enpower is not None
         return self.entity_description.value_fn(enpower)
+
+
+class EnvoyCollarBinarySensorEntity(EnvoyBaseBinarySensorEntity):
+    """Defines an IQ Meter Collar binary_sensor entity."""
+
+    entity_description: EnvoyCollarBinarySensorEntityDescription
+
+    def __init__(
+        self,
+        coordinator: EnphaseUpdateCoordinator,
+        description: EnvoyCollarBinarySensorEntityDescription,
+    ) -> None:
+        """Init the Collar base entity."""
+        super().__init__(coordinator, description)
+        collar_data = self.data.collar
+        assert collar_data is not None
+        self._attr_unique_id = f"{collar_data.serial_number}_{description.key}"
+        self._attr_device_info = DeviceInfo(
+            identifiers={(DOMAIN, collar_data.serial_number)},
+            manufacturer="Enphase",
+            model="IQ Meter Collar",
+            name=f"Collar {collar_data.serial_number}",
+            sw_version=str(collar_data.firmware_version),
+            via_device=(DOMAIN, self.envoy_serial_num),
+            serial_number=collar_data.serial_number,
+        )
+
+    @property
+    def is_on(self) -> bool:
+        """Return the state of the Collar binary_sensor."""
+        collar_data = self.data.collar
+        assert collar_data is not None
+        return self.entity_description.value_fn(collar_data)
+
+
+class EnvoyC6CCBinarySensorEntity(EnvoyBaseBinarySensorEntity):
+    """Defines an C6 Combiner binary_sensor entity."""
+
+    entity_description: EnvoyC6CCBinarySensorEntityDescription
+
+    def __init__(
+        self,
+        coordinator: EnphaseUpdateCoordinator,
+        description: EnvoyC6CCBinarySensorEntityDescription,
+    ) -> None:
+        """Init the C6 Combiner base entity."""
+        super().__init__(coordinator, description)
+        c6cc_data = self.data.c6cc
+        assert c6cc_data is not None
+        self._attr_unique_id = f"{c6cc_data.serial_number}_{description.key}"
+        self._attr_device_info = DeviceInfo(
+            identifiers={(DOMAIN, c6cc_data.serial_number)},
+            manufacturer="Enphase",
+            model="C6 COMBINER CONTROLLER",
+            name=f"C6 Combiner {c6cc_data.serial_number}",
+            sw_version=str(c6cc_data.firmware_version),
+            via_device=(DOMAIN, self.envoy_serial_num),
+            serial_number=c6cc_data.serial_number,
+        )
+
+    @property
+    def is_on(self) -> bool:
+        """Return the state of the C6 Combiner binary_sensor."""
+        c6cc_data = self.data.c6cc
+        assert c6cc_data is not None
+        return self.entity_description.value_fn(c6cc_data)

homeassistant/components/enphase_envoy/diagnostics.py

@@ -118,6 +118,7 @@ async def async_get_config_entry_diagnostics(
         device_dict.pop("_cache", None)
         # This can be removed when suggested_area is removed from DeviceEntry
         device_dict.pop("_suggested_area")
+        device_dict.pop("is_new", None)
         device_entities.append({"device": device_dict, "entities": entities})
 
     # remove envoy serial

homeassistant/components/enphase_envoy/manifest.json

@@ -1,13 +1,13 @@
 {
   "domain": "enphase_envoy",
   "name": "Enphase Envoy",
-  "codeowners": ["@bdraco", "@cgarwood", "@joostlek", "@catsmanac"],
+  "codeowners": ["@bdraco", "@cgarwood", "@catsmanac"],
   "config_flow": true,
   "documentation": "https://www.home-assistant.io/integrations/enphase_envoy",
   "iot_class": "local_polling",
   "loggers": ["pyenphase"],
   "quality_scale": "platinum",
-  "requirements": ["pyenphase==2.2.3"],
+  "requirements": ["pyenphase==2.3.0"],
   "zeroconf": [
     {
       "type": "_enphase-envoy._tcp.local."

homeassistant/components/enphase_envoy/sensor.py

@@ -12,6 +12,8 @@ from typing import TYPE_CHECKING
 from pyenphase import (
     EnvoyACBPower,
     EnvoyBatteryAggregate,
+    EnvoyC6CC,
+    EnvoyCollar,
     EnvoyEncharge,
     EnvoyEnchargeAggregate,
     EnvoyEnchargePower,
@@ -790,6 +792,58 @@ ENPOWER_SENSORS = (
 )
 
 
+@dataclass(frozen=True, kw_only=True)
+class EnvoyCollarSensorEntityDescription(SensorEntityDescription):
+    """Describes an Envoy Collar sensor entity."""
+
+    value_fn: Callable[[EnvoyCollar], datetime.datetime | int | float | str]
+
+
+COLLAR_SENSORS = (
+    EnvoyCollarSensorEntityDescription(
+        key="temperature",
+        native_unit_of_measurement=UnitOfTemperature.CELSIUS,
+        device_class=SensorDeviceClass.TEMPERATURE,
+        value_fn=attrgetter("temperature"),
+    ),
+    EnvoyCollarSensorEntityDescription(
+        key=LAST_REPORTED_KEY,
+        translation_key=LAST_REPORTED_KEY,
+        native_unit_of_measurement=None,
+        device_class=SensorDeviceClass.TIMESTAMP,
+        value_fn=lambda collar: dt_util.utc_from_timestamp(collar.last_report_date),
+    ),
+    EnvoyCollarSensorEntityDescription(
+        key="grid_state",
+        translation_key="grid_status",
+        value_fn=lambda collar: collar.grid_state,
+    ),
+    EnvoyCollarSensorEntityDescription(
+        key="mid_state",
+        translation_key="mid_state",
+        value_fn=lambda collar: collar.mid_state,
+    ),
+)
+
+
+@dataclass(frozen=True, kw_only=True)
+class EnvoyC6CCSensorEntityDescription(SensorEntityDescription):
+    """Describes an Envoy C6 Combiner controller sensor entity."""
+
+    value_fn: Callable[[EnvoyC6CC], datetime.datetime]
+
+
+C6CC_SENSORS = (
+    EnvoyC6CCSensorEntityDescription(
+        key=LAST_REPORTED_KEY,
+        translation_key=LAST_REPORTED_KEY,
+        native_unit_of_measurement=None,
+        device_class=SensorDeviceClass.TIMESTAMP,
+        value_fn=lambda c6cc: dt_util.utc_from_timestamp(c6cc.last_report_date),
+    ),
+)
+
+
 @dataclass(frozen=True)
 class EnvoyEnchargeAggregateRequiredKeysMixin:
     """Mixin for required keys."""
@@ -1050,6 +1104,15 @@ async def async_setup_entry(
             AggregateBatteryEntity(coordinator, description)
             for description in AGGREGATE_BATTERY_SENSORS
         )
+    if envoy_data.collar:
+        entities.extend(
+            EnvoyCollarEntity(coordinator, description)
+            for description in COLLAR_SENSORS
+        )
+    if envoy_data.c6cc:
+        entities.extend(
+            EnvoyC6CCEntity(coordinator, description) for description in C6CC_SENSORS
+        )
 
     async_add_entities(entities)
 
@@ -1488,3 +1551,70 @@ class AggregateBatteryEntity(EnvoySystemSensorEntity):
         battery_aggregate = self.data.battery_aggregate
         assert battery_aggregate is not None
         return self.entity_description.value_fn(battery_aggregate)
+
+
+class EnvoyCollarEntity(EnvoySensorBaseEntity):
+    """Envoy Collar sensor entity."""
+
+    entity_description: EnvoyCollarSensorEntityDescription
+
+    def __init__(
+        self,
+        coordinator: EnphaseUpdateCoordinator,
+        description: EnvoyCollarSensorEntityDescription,
+    ) -> None:
+        """Initialize Collar entity."""
+        super().__init__(coordinator, description)
+        collar_data = self.data.collar
+        assert collar_data is not None
+        self._serial_number = collar_data.serial_number
+        self._attr_unique_id = f"{collar_data.serial_number}_{description.key}"
+        self._attr_device_info = DeviceInfo(
+            identifiers={(DOMAIN, collar_data.serial_number)},
+            manufacturer="Enphase",
+            model="IQ Meter Collar",
+            name=f"Collar {collar_data.serial_number}",
+            sw_version=str(collar_data.firmware_version),
+            via_device=(DOMAIN, self.envoy_serial_num),
+            serial_number=collar_data.serial_number,
+        )
+
+    @property
+    def native_value(self) -> datetime.datetime | int | float | str:
+        """Return the state of the collar sensors."""
+        collar_data = self.data.collar
+        assert collar_data is not None
+        return self.entity_description.value_fn(collar_data)
+
+
+class EnvoyC6CCEntity(EnvoySensorBaseEntity):
+    """Envoy C6CC sensor entity."""
+
+    entity_description: EnvoyC6CCSensorEntityDescription
+
+    def __init__(
+        self,
+        coordinator: EnphaseUpdateCoordinator,
+        description: EnvoyC6CCSensorEntityDescription,
+    ) -> None:
+        """Initialize Encharge entity."""
+        super().__init__(coordinator, description)
+        c6cc_data = self.data.c6cc
+        assert c6cc_data is not None
+        self._attr_unique_id = f"{c6cc_data.serial_number}_{description.key}"
+        self._attr_device_info = DeviceInfo(
+            identifiers={(DOMAIN, c6cc_data.serial_number)},
+            manufacturer="Enphase",
+            model="C6 COMBINER CONTROLLER",
+            name=f"C6 Combiner {c6cc_data.serial_number}",
+            sw_version=str(c6cc_data.firmware_version),
+            via_device=(DOMAIN, self.envoy_serial_num),
+            serial_number=c6cc_data.serial_number,
+        )
+
+    @property
+    def native_value(self) -> datetime.datetime:
+        """Return the state of the c6cc inventory sensors."""
+        c6cc_data = self.data.c6cc
+        assert c6cc_data is not None
+        return self.entity_description.value_fn(c6cc_data)

homeassistant/components/enphase_envoy/strings.json

@@ -407,6 +407,12 @@
       },
       "last_report_duration": {
         "name": "Last report duration"
+      },
+      "grid_status": {
+        "name": "[%key:component::enphase_envoy::entity::binary_sensor::grid_status::name%]"
+      },
+      "mid_state": {
+        "name": "MID state"
       }
     },
     "switch": {

homeassistant/components/enphase_envoy/translations/bg.json

@@ -85,6 +85,9 @@
             "dc_voltage": {
                 "name": "DC \u043d\u0430\u043f\u0440\u0435\u0436\u0435\u043d\u0438\u0435"
             },
+            "grid_status": {
+                "name": "\u0421\u044a\u0441\u0442\u043e\u044f\u043d\u0438\u0435 \u043d\u0430 \u043c\u0440\u0435\u0436\u0430\u0442\u0430"
+            },
             "max_capacity": {
                 "name": "\u041a\u0430\u043f\u0430\u0446\u0438\u0442\u0435\u0442 \u043d\u0430 \u0431\u0430\u0442\u0435\u0440\u0438\u044f\u0442\u0430"
             },

homeassistant/components/enphase_envoy/translations/ca.json

@@ -138,6 +138,9 @@
             "energy_today": {
                 "name": "Producci\u00f3 d'energia avui"
             },
+            "grid_status": {
+                "name": "Estat de xarxa el\u00e8ctrica"
+            },
             "last_reported": {
                 "name": "\u00daltima dada"
             },

homeassistant/components/enphase_envoy/translations/cs.json

@@ -204,6 +204,9 @@
             "energy_today": {
                 "name": "Dne\u0161n\u00ed v\u00fdroba energie"
             },
+            "grid_status": {
+                "name": "Stav s\u00edt\u011b"
+            },
             "last_report_duration": {
                 "name": "D\u00e9lka posledn\u00ed zpr\u00e1vy"
             },
@@ -261,6 +264,9 @@
             "max_reported": {
                 "name": "Maxim\u00e1ln\u00ed v\u00fdkon po celou dobu \u017eivotnosti"
             },
+            "mid_state": {
+                "name": "Stav MID"
+            },
             "net_consumption": {
                 "name": "Aktu\u00e1ln\u00ed \u010dist\u00e1 spot\u0159eba energie"
             },

homeassistant/components/enphase_envoy/translations/de.json

@@ -204,6 +204,9 @@
             "energy_today": {
                 "name": "Energieerzeugung heute"
             },
+            "grid_status": {
+                "name": "Netzstatus"
+            },
             "last_report_duration": {
                 "name": "Letzter Berichtszeitraum"
             },
@@ -261,6 +264,9 @@
             "max_reported": {
                 "name": "Maximalleistung \u00fcber Lebensdauer"
             },
+            "mid_state": {
+                "name": "MID-Zustand"
+            },
             "net_consumption": {
                 "name": "Aktueller Nettostromverbrauch"
             },

homeassistant/components/enphase_envoy/translations/el.json

@@ -163,6 +163,9 @@
             "energy_produced": {
                 "name": "\u03a0\u03b1\u03c1\u03b1\u03b3\u03c9\u03b3\u03ae \u03b5\u03bd\u03ad\u03c1\u03b3\u03b5\u03b9\u03b1\u03c2 \u03b1\u03c0\u03cc \u03c4\u03b7\u03bd \u03c0\u03c1\u03bf\u03b7\u03b3\u03bf\u03cd\u03bc\u03b5\u03bd\u03b7 \u03ad\u03ba\u03b8\u03b5\u03c3\u03b7"
             },
+            "grid_status": {
+                "name": "\u039a\u03b1\u03c4\u03ac\u03c3\u03c4\u03b1\u03c3\u03b7 \u03b4\u03b9\u03ba\u03c4\u03cd\u03bf\u03c5"
+            },
             "last_report_duration": {
                 "name": "\u0394\u03b9\u03ac\u03c1\u03ba\u03b5\u03b9\u03b1 \u03c4\u03b7\u03c2 \u03c4\u03b5\u03bb\u03b5\u03c5\u03c4\u03b1\u03af\u03b1\u03c2 \u03b1\u03bd\u03b1\u03c6\u03bf\u03c1\u03ac\u03c2"
             },
@@ -217,6 +220,9 @@
             "max_reported": {
                 "name": "\u039c\u03ad\u03b3\u03b9\u03c3\u03c4\u03b7 \u03b9\u03c3\u03c7\u03cd\u03c2 \u03c3\u03b5 \u03cc\u03bb\u03b7 \u03c4\u03b7 \u03b4\u03b9\u03ac\u03c1\u03ba\u03b5\u03b9\u03b1 \u03b6\u03c9\u03ae\u03c2 \u03ba\u03b1\u03b8' \u03cc\u03bb\u03b7 \u03c4\u03b7 \u03b4\u03b9\u03ac\u03c1\u03ba\u03b5\u03b9\u03b1 \u03b6\u03c9\u03ae\u03c2"
             },
+            "mid_state": {
+                "name": "\u039a\u03b1\u03c4\u03ac\u03c3\u03c4\u03b1\u03c3\u03b7 MID"
+            },
             "net_ct_current": {
                 "name": "\u039a\u03b1\u03b8\u03b1\u03c1\u03ae \u03ba\u03b1\u03c4\u03b1\u03bd\u03ac\u03bb\u03c9\u03c3\u03b7 \u03c1\u03b5\u03cd\u03bc\u03b1\u03c4\u03bf\u03c2 CT"
             },

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

@@ -204,6 +204,9 @@
             "energy_today": {
                 "name": "Energy production today"
             },
+            "grid_status": {
+                "name": "Grid status"
+            },
             "last_report_duration": {
                 "name": "Last report duration"
             },
@@ -261,6 +264,9 @@
             "max_reported": {
                 "name": "Lifetime maximum power"
             },
+            "mid_state": {
+                "name": "MID state"
+            },
             "net_consumption": {
                 "name": "Current net power consumption"
             },

homeassistant/components/enphase_envoy/translations/en.json

@@ -204,6 +204,9 @@
             "energy_today": {
                 "name": "Energy production today"
             },
+            "grid_status": {
+                "name": "Grid status"
+            },
             "last_report_duration": {
                 "name": "Last report duration"
             },
@@ -261,6 +264,9 @@
             "max_reported": {
                 "name": "Lifetime maximum power"
             },
+            "mid_state": {
+                "name": "MID state"
+            },
             "net_consumption": {
                 "name": "Current net power consumption"
             },

homeassistant/components/enphase_envoy/translations/es.json

@@ -124,7 +124,7 @@
                 "name": "Corriente alterna"
             },
             "ac_voltage": {
-                "name": "Voltaje de CA"
+                "name": "Tensi\u00f3n de CA"
             },
             "acb_available_energy": {
                 "name": "Energ\u00eda de bater\u00eda ACB disponible"
@@ -196,7 +196,7 @@
                 "name": "Corriente continua"
             },
             "dc_voltage": {
-                "name": "Voltaje de CC"
+                "name": "Tensi\u00f3n de CC"
             },
             "energy_produced": {
                 "name": "Producci\u00f3n de energ\u00eda desde el informe anterior"
@@ -204,6 +204,9 @@
             "energy_today": {
                 "name": "Producci\u00f3n de energ\u00eda hoy"
             },
+            "grid_status": {
+                "name": "Estado de la red"
+            },
             "last_report_duration": {
                 "name": "Duraci\u00f3n del \u00faltimo informe"
             },
@@ -261,6 +264,9 @@
             "max_reported": {
                 "name": "M\u00e1xima potencia durante su vida \u00fatil"
             },
+            "mid_state": {
+                "name": "Estado MID"
+            },
             "net_consumption": {
                 "name": "Consumo de energ\u00eda neto actual"
             },

homeassistant/components/enphase_envoy/translations/et.json

@@ -204,6 +204,9 @@
             "energy_today": {
                 "name": "Energia tootmine t\u00e4na"
             },
+            "grid_status": {
+                "name": "V\u00f5rgu olek"
+            },
             "last_report_duration": {
                 "name": "Viimase aruande kestus"
             },
@@ -261,6 +264,9 @@
             "max_reported": {
                 "name": "Maksimaalne v\u00f5imsus kogu eluea jooksul"
             },
+            "mid_state": {
+                "name": "MID olek"
+            },
             "net_consumption": {
                 "name": "Praegune netoenergia tarbimine"
             },

homeassistant/components/enphase_envoy/translations/fr.json

@@ -128,6 +128,9 @@
             "daily_production_phase": {
                 "name": "Production d'\u00e9lectricit\u00e9 aujourd'hui {phase_name}"
             },
+            "grid_status": {
+                "name": "Statut du r\u00e9seau"
+            },
             "last_reported": {
                 "name": "Dernier rapport"
             },