mirror of
https://github.com/home-assistant/core.git
synced 2026-08-28 18:24:50 -05:00
1502 lines
56 KiB
Python
1502 lines
56 KiB
Python
"""Support for Sofar sensors."""
|
|
|
|
from collections.abc import Callable, Mapping
|
|
from dataclasses import dataclass
|
|
from datetime import date, datetime, timedelta
|
|
from enum import IntEnum
|
|
from typing import cast, override
|
|
|
|
from sofar_modbus.modern.device import SofarInverter
|
|
|
|
from homeassistant.components.sensor import (
|
|
RestoreSensor,
|
|
SensorDeviceClass,
|
|
SensorEntity,
|
|
SensorEntityDescription,
|
|
SensorStateClass,
|
|
)
|
|
from homeassistant.const import (
|
|
PERCENTAGE,
|
|
EntityCategory,
|
|
UnitOfApparentPower,
|
|
UnitOfElectricCurrent,
|
|
UnitOfElectricPotential,
|
|
UnitOfEnergy,
|
|
UnitOfFrequency,
|
|
UnitOfPower,
|
|
UnitOfReactivePower,
|
|
UnitOfTemperature,
|
|
UnitOfTime,
|
|
)
|
|
from homeassistant.core import HomeAssistant, callback
|
|
from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback
|
|
from homeassistant.util import dt as dt_util
|
|
from homeassistant.util.variance import ignore_variance
|
|
|
|
# Aliased: a module-level SCAN_INTERVAL would set the platform's poll.
|
|
from .const import SCAN_INTERVAL as _POLL_INTERVAL
|
|
from .coordinator import SofarConfigEntry, SofarRuntimeData
|
|
from .entity import SofarEntity, SofarEntityDescription
|
|
|
|
PARALLEL_UPDATES = 0
|
|
|
|
# Two polls of slack, so jitter does not republish a steady countdown.
|
|
_COUNTDOWN_VARIANCE = timedelta(seconds=_POLL_INTERVAL * 2)
|
|
|
|
|
|
def _deadline_filter() -> Callable[[int], datetime]:
|
|
"""Turn remaining seconds into a deadline, holding it steady."""
|
|
return ignore_variance(
|
|
lambda seconds: dt_util.utcnow() + timedelta(seconds=seconds),
|
|
_COUNTDOWN_VARIANCE,
|
|
)
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
entry: SofarConfigEntry,
|
|
async_add_entities: AddConfigEntryEntitiesCallback,
|
|
) -> None:
|
|
"""Set up the Sofar Inverter Modbus sensor platform."""
|
|
runtime_data = entry.runtime_data
|
|
served = runtime_data.served_components
|
|
device = runtime_data.readings.device
|
|
|
|
async_add_entities(
|
|
_sensor_class(description)(runtime_data, description)
|
|
for description in SENSOR_DESCRIPTIONS
|
|
if description.component in served and not _is_battery_pack(description)
|
|
)
|
|
|
|
wired: set[int] = set()
|
|
|
|
@callback
|
|
def _async_add_wired_packs() -> None:
|
|
"""Add a pack's sensors the first time it reports a voltage."""
|
|
new = {
|
|
number
|
|
for number in _BATTERY_COMPONENTS
|
|
if number not in wired and _pack_is_wired(device, served, number)
|
|
}
|
|
if not new:
|
|
return
|
|
wired.update(new)
|
|
async_add_entities(
|
|
_sensor_class(description)(runtime_data, description)
|
|
for description in SENSOR_DESCRIPTIONS
|
|
if (part := description.part) is not None
|
|
and part[0] == "battery"
|
|
and part[1] in new
|
|
)
|
|
|
|
_async_add_wired_packs()
|
|
entry.async_on_unload(
|
|
runtime_data.readings.async_add_listener(_async_add_wired_packs)
|
|
)
|
|
|
|
|
|
def _is_battery_pack(description: SofarSensorDescription) -> bool:
|
|
"""Whether a description belongs to one numbered battery pack."""
|
|
return description.part is not None and description.part[0] == "battery"
|
|
|
|
|
|
def _pack_is_wired(device: SofarInverter, served: frozenset[str], number: int) -> bool:
|
|
"""Whether a pack has answered, so it physically exists."""
|
|
component_name = _BATTERY_COMPONENTS[number]
|
|
if component_name not in served:
|
|
return False
|
|
component = getattr(device, component_name)
|
|
return bool(getattr(component, f"battery_voltage_{number}", None))
|
|
|
|
|
|
def _sensor_class(
|
|
description: SofarSensorDescription,
|
|
) -> type[SofarSensor | SofarTotalSensor]:
|
|
"""Pick the entity class a description's semantics ask for."""
|
|
if description.device_class is SensorDeviceClass.TIMESTAMP:
|
|
return SofarCountdownSensor
|
|
if description.state_class in (
|
|
SensorStateClass.TOTAL,
|
|
SensorStateClass.TOTAL_INCREASING,
|
|
):
|
|
return SofarTotalSensor
|
|
return SofarSensor
|
|
|
|
|
|
class SofarSensor(SofarEntity, SensorEntity):
|
|
"""Defines a Sofar sensor."""
|
|
|
|
entity_description: SofarSensorDescription
|
|
|
|
@property
|
|
@override
|
|
def native_value(self) -> str | int | float | date | None:
|
|
component = getattr(self.coordinator.device, self.entity_description.component)
|
|
value = getattr(component, self.entity_description.key)
|
|
# IntEnum stringifies as the raw int; use the option slug.
|
|
if isinstance(value, IntEnum):
|
|
return value.name.lower()
|
|
return cast(str | int | float | date | None, value)
|
|
|
|
|
|
class SofarCountdownSensor(SofarSensor):
|
|
"""Defines a Sofar countdown, published as the moment it runs out."""
|
|
|
|
def __init__(
|
|
self,
|
|
runtime_data: SofarRuntimeData,
|
|
entity_description: SofarSensorDescription,
|
|
) -> None:
|
|
"""Initialize the entity."""
|
|
super().__init__(runtime_data, entity_description)
|
|
self._deadline = _deadline_filter()
|
|
|
|
@property
|
|
@override
|
|
def native_value(self) -> datetime | None:
|
|
component = getattr(self.coordinator.device, self.entity_description.component)
|
|
seconds = getattr(component, self.entity_description.key)
|
|
if not isinstance(seconds, int) or seconds <= 0:
|
|
# A restart must not land inside the finished countdown's slack.
|
|
self._deadline = _deadline_filter()
|
|
return None
|
|
return self._deadline(seconds)
|
|
|
|
|
|
class SofarTotalSensor(SofarEntity, RestoreSensor):
|
|
"""Defines a Sofar cumulative total sensor."""
|
|
|
|
entity_description: SofarSensorDescription
|
|
|
|
@override
|
|
async def async_added_to_hass(self) -> None:
|
|
await super().async_added_to_hass()
|
|
if (last_data := await self.async_get_last_sensor_data()) is None:
|
|
return
|
|
if last_data.native_value is None:
|
|
return
|
|
try:
|
|
val = float(str(last_data.native_value))
|
|
except ValueError, TypeError:
|
|
return
|
|
self._attr_native_value = val
|
|
if self.entity_description.state_class is SensorStateClass.TOTAL_INCREASING:
|
|
component = getattr(
|
|
self.coordinator.device, self.entity_description.component
|
|
)
|
|
component.seed_high_water(self.entity_description.key, val)
|
|
|
|
@property
|
|
@override
|
|
def native_value(self) -> int | float | None:
|
|
component = getattr(self.coordinator.device, self.entity_description.component)
|
|
if self.entity_description.state_class is SensorStateClass.TOTAL_INCREASING:
|
|
value = component.corrected(self.entity_description.key)
|
|
else:
|
|
value = getattr(component, self.entity_description.key)
|
|
if isinstance(value, (int, float)):
|
|
self._attr_native_value = value
|
|
return cast(int | float | None, self._attr_native_value)
|
|
|
|
|
|
@dataclass(frozen=True, kw_only=True)
|
|
class SofarSensorDescription(SensorEntityDescription, SofarEntityDescription):
|
|
"""Describe a Sofar sensor."""
|
|
|
|
|
|
@dataclass(frozen=True, kw_only=True)
|
|
class _PartMeasurement:
|
|
"""One measurement every string or pack repeats, before it gets a number."""
|
|
|
|
key: str
|
|
translation_key: str
|
|
device_class: SensorDeviceClass | None = None
|
|
native_unit_of_measurement: str | None = None
|
|
state_class: SensorStateClass | None = None
|
|
suggested_display_precision: int | None = None
|
|
entity_category: EntityCategory | None = None
|
|
entity_registry_enabled_default: bool = True
|
|
|
|
|
|
# Which register block each string or pack is read from.
|
|
_PV_STRING_COMPONENTS = {
|
|
1: "pv_1_2",
|
|
2: "pv_1_2",
|
|
3: "pv_3",
|
|
4: "pv_4",
|
|
5: "pv_5_6",
|
|
6: "pv_5_6",
|
|
7: "pv_7_8",
|
|
8: "pv_7_8",
|
|
9: "pv_9_10",
|
|
10: "pv_9_10",
|
|
}
|
|
_BATTERY_COMPONENTS = {
|
|
n: "battery_1_2" if n <= 2 else "battery_3_8" for n in range(1, 9)
|
|
}
|
|
|
|
_PV_STRING_MEASUREMENTS = (
|
|
_PartMeasurement(
|
|
key="pv_voltage",
|
|
translation_key="voltage",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
_PartMeasurement(
|
|
key="pv_current",
|
|
translation_key="current",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
_PartMeasurement(
|
|
key="pv_power",
|
|
translation_key="power",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
),
|
|
)
|
|
|
|
_BATTERY_MEASUREMENTS = (
|
|
_PartMeasurement(
|
|
key="battery_voltage",
|
|
translation_key="voltage",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
),
|
|
_PartMeasurement(
|
|
key="battery_current",
|
|
translation_key="current",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
suggested_display_precision=2,
|
|
),
|
|
_PartMeasurement(
|
|
key="battery_power",
|
|
translation_key="power",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
),
|
|
_PartMeasurement(
|
|
key="battery_temperature",
|
|
translation_key="temperature",
|
|
device_class=SensorDeviceClass.TEMPERATURE,
|
|
native_unit_of_measurement=UnitOfTemperature.CELSIUS,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
),
|
|
_PartMeasurement(
|
|
key="battery_capacity",
|
|
translation_key="state_of_charge",
|
|
device_class=SensorDeviceClass.BATTERY,
|
|
native_unit_of_measurement=PERCENTAGE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
),
|
|
_PartMeasurement(
|
|
key="battery_state_of_health",
|
|
translation_key="state_of_health",
|
|
native_unit_of_measurement=PERCENTAGE,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
),
|
|
_PartMeasurement(
|
|
key="battery_charge_cycle",
|
|
translation_key="charge_cycle",
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
),
|
|
)
|
|
|
|
|
|
def _part_sensors(
|
|
kind: str,
|
|
components: Mapping[int, str],
|
|
measurements: tuple[_PartMeasurement, ...],
|
|
) -> tuple[SofarSensorDescription, ...]:
|
|
"""Repeat a part's measurements across every string or pack it has."""
|
|
return tuple(
|
|
SofarSensorDescription(
|
|
key=f"{measurement.key}_{number}",
|
|
component=component,
|
|
translation_key=measurement.translation_key,
|
|
part=(kind, number),
|
|
device_class=measurement.device_class,
|
|
native_unit_of_measurement=measurement.native_unit_of_measurement,
|
|
state_class=measurement.state_class,
|
|
suggested_display_precision=measurement.suggested_display_precision,
|
|
entity_category=measurement.entity_category,
|
|
entity_registry_enabled_default=(
|
|
measurement.entity_registry_enabled_default
|
|
),
|
|
)
|
|
for number, component in components.items()
|
|
for measurement in measurements
|
|
)
|
|
|
|
|
|
SENSOR_DESCRIPTIONS: tuple[SofarSensorDescription, ...] = (
|
|
SofarSensorDescription(
|
|
key="pv_power_total",
|
|
component="pv_1_2",
|
|
translation_key="pv_power_total",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
),
|
|
SofarSensorDescription(
|
|
key="solar_generation_total",
|
|
component="energy",
|
|
translation_key="solar_generation_total",
|
|
device_class=SensorDeviceClass.ENERGY,
|
|
native_unit_of_measurement=UnitOfEnergy.KILO_WATT_HOUR,
|
|
state_class=SensorStateClass.TOTAL_INCREASING,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="system_state",
|
|
component="state",
|
|
translation_key="system_state",
|
|
device_class=SensorDeviceClass.ENUM,
|
|
options=[
|
|
"waiting",
|
|
"checking",
|
|
"grid_connected",
|
|
"emergency_power_supply",
|
|
"recoverable_fault",
|
|
"permanent_fault",
|
|
"upgrading",
|
|
"self_charging",
|
|
],
|
|
),
|
|
SofarSensorDescription(
|
|
key="waiting_time",
|
|
component="state",
|
|
translation_key="waiting_ends",
|
|
device_class=SensorDeviceClass.TIMESTAMP,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
),
|
|
SofarSensorDescription(
|
|
key="inverter_temperature_1",
|
|
component="state",
|
|
translation_key="inverter_temperature_1",
|
|
device_class=SensorDeviceClass.TEMPERATURE,
|
|
native_unit_of_measurement=UnitOfTemperature.CELSIUS,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
),
|
|
SofarSensorDescription(
|
|
key="inverter_temperature_2",
|
|
component="state",
|
|
translation_key="inverter_temperature_2",
|
|
device_class=SensorDeviceClass.TEMPERATURE,
|
|
native_unit_of_measurement=UnitOfTemperature.CELSIUS,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
),
|
|
SofarSensorDescription(
|
|
key="heatsink_temperature_1",
|
|
component="state",
|
|
translation_key="heatsink_temperature_1",
|
|
device_class=SensorDeviceClass.TEMPERATURE,
|
|
native_unit_of_measurement=UnitOfTemperature.CELSIUS,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
),
|
|
SofarSensorDescription(
|
|
key="heatsink_temperature_2",
|
|
component="state",
|
|
translation_key="heatsink_temperature_2",
|
|
device_class=SensorDeviceClass.TEMPERATURE,
|
|
native_unit_of_measurement=UnitOfTemperature.CELSIUS,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
),
|
|
SofarSensorDescription(
|
|
key="module_temperature_1",
|
|
component="state",
|
|
translation_key="module_temperature_1",
|
|
device_class=SensorDeviceClass.TEMPERATURE,
|
|
native_unit_of_measurement=UnitOfTemperature.CELSIUS,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
),
|
|
SofarSensorDescription(
|
|
key="module_temperature_2",
|
|
component="state",
|
|
translation_key="module_temperature_2",
|
|
device_class=SensorDeviceClass.TEMPERATURE,
|
|
native_unit_of_measurement=UnitOfTemperature.CELSIUS,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
),
|
|
SofarSensorDescription(
|
|
key="serial_number",
|
|
component="identity",
|
|
translation_key="serial_number",
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
),
|
|
SofarSensorDescription(
|
|
key="grid_frequency",
|
|
component="grid",
|
|
translation_key="grid_frequency",
|
|
device_class=SensorDeviceClass.FREQUENCY,
|
|
native_unit_of_measurement=UnitOfFrequency.HERTZ,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_output_total",
|
|
component="grid",
|
|
translation_key="active_power_output_total",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="reactive_power_output_total",
|
|
component="grid",
|
|
translation_key="reactive_power_output_total",
|
|
device_class=SensorDeviceClass.REACTIVE_POWER,
|
|
native_unit_of_measurement=UnitOfReactivePower.KILO_VOLT_AMPERE_REACTIVE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="apparent_power_output_total",
|
|
component="grid",
|
|
translation_key="apparent_power_output_total",
|
|
device_class=SensorDeviceClass.APPARENT_POWER,
|
|
native_unit_of_measurement=UnitOfApparentPower.KILO_VOLT_AMPERE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_pcc_total",
|
|
component="grid",
|
|
translation_key="active_power_pcc_total",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="reactive_power_pcc_total",
|
|
component="grid",
|
|
translation_key="reactive_power_pcc_total",
|
|
device_class=SensorDeviceClass.REACTIVE_POWER,
|
|
native_unit_of_measurement=UnitOfReactivePower.KILO_VOLT_AMPERE_REACTIVE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="apparent_power_pcc_total",
|
|
component="grid",
|
|
translation_key="apparent_power_pcc_total",
|
|
device_class=SensorDeviceClass.APPARENT_POWER,
|
|
native_unit_of_measurement=UnitOfApparentPower.KILO_VOLT_AMPERE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="voltage_l1",
|
|
component="grid",
|
|
translation_key="voltage_l1",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="current_output_l1",
|
|
component="grid",
|
|
translation_key="current_output_l1",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_output_l1",
|
|
component="grid",
|
|
translation_key="active_power_output_l1",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="reactive_power_output_l1",
|
|
component="grid",
|
|
translation_key="reactive_power_output_l1",
|
|
device_class=SensorDeviceClass.REACTIVE_POWER,
|
|
native_unit_of_measurement=UnitOfReactivePower.KILO_VOLT_AMPERE_REACTIVE,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="power_factor_output_l1",
|
|
component="grid",
|
|
translation_key="power_factor_output_l1",
|
|
device_class=SensorDeviceClass.POWER_FACTOR,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="current_pcc_l1",
|
|
component="grid",
|
|
translation_key="current_pcc_l1",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_pcc_l1",
|
|
component="grid",
|
|
translation_key="active_power_pcc_l1",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="reactive_power_pcc_l1",
|
|
component="grid",
|
|
translation_key="reactive_power_pcc_l1",
|
|
device_class=SensorDeviceClass.REACTIVE_POWER,
|
|
native_unit_of_measurement=UnitOfReactivePower.KILO_VOLT_AMPERE_REACTIVE,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="power_factor_pcc_l1",
|
|
component="grid",
|
|
translation_key="power_factor_pcc_l1",
|
|
device_class=SensorDeviceClass.POWER_FACTOR,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="voltage_l2",
|
|
component="grid",
|
|
translation_key="voltage_l2",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="current_output_l2",
|
|
component="grid",
|
|
translation_key="current_output_l2",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_output_l2",
|
|
component="grid",
|
|
translation_key="active_power_output_l2",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="reactive_power_output_l2",
|
|
component="grid",
|
|
translation_key="reactive_power_output_l2",
|
|
device_class=SensorDeviceClass.REACTIVE_POWER,
|
|
native_unit_of_measurement=UnitOfReactivePower.KILO_VOLT_AMPERE_REACTIVE,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="power_factor_output_l2",
|
|
component="grid",
|
|
translation_key="power_factor_output_l2",
|
|
device_class=SensorDeviceClass.POWER_FACTOR,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="current_pcc_l2",
|
|
component="grid",
|
|
translation_key="current_pcc_l2",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_pcc_l2",
|
|
component="grid",
|
|
translation_key="active_power_pcc_l2",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="reactive_power_pcc_l2",
|
|
component="grid",
|
|
translation_key="reactive_power_pcc_l2",
|
|
device_class=SensorDeviceClass.REACTIVE_POWER,
|
|
native_unit_of_measurement=UnitOfReactivePower.KILO_VOLT_AMPERE_REACTIVE,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="power_factor_pcc_l2",
|
|
component="grid",
|
|
translation_key="power_factor_pcc_l2",
|
|
device_class=SensorDeviceClass.POWER_FACTOR,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="voltage_l3",
|
|
component="grid",
|
|
translation_key="voltage_l3",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="current_output_l3",
|
|
component="grid",
|
|
translation_key="current_output_l3",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_output_l3",
|
|
component="grid",
|
|
translation_key="active_power_output_l3",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="reactive_power_output_l3",
|
|
component="grid",
|
|
translation_key="reactive_power_output_l3",
|
|
device_class=SensorDeviceClass.REACTIVE_POWER,
|
|
native_unit_of_measurement=UnitOfReactivePower.KILO_VOLT_AMPERE_REACTIVE,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="power_factor_output_l3",
|
|
component="grid",
|
|
translation_key="power_factor_output_l3",
|
|
device_class=SensorDeviceClass.POWER_FACTOR,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="current_pcc_l3",
|
|
component="grid",
|
|
translation_key="current_pcc_l3",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_pcc_l3",
|
|
component="grid",
|
|
translation_key="active_power_pcc_l3",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="reactive_power_pcc_l3",
|
|
component="grid",
|
|
translation_key="reactive_power_pcc_l3",
|
|
device_class=SensorDeviceClass.REACTIVE_POWER,
|
|
native_unit_of_measurement=UnitOfReactivePower.KILO_VOLT_AMPERE_REACTIVE,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="power_factor_pcc_l3",
|
|
component="grid",
|
|
translation_key="power_factor_pcc_l3",
|
|
device_class=SensorDeviceClass.POWER_FACTOR,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_pv_ext",
|
|
component="grid",
|
|
translation_key="active_power_pv_ext",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_load_sys",
|
|
component="grid",
|
|
translation_key="active_power_load_sys",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="voltage_phase_l1n",
|
|
component="grid",
|
|
translation_key="voltage_phase_l1n",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="current_output_l1n",
|
|
component="grid",
|
|
translation_key="current_output_l1n",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_output_l1n",
|
|
component="grid",
|
|
translation_key="active_power_output_l1n",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="current_pcc_l1n",
|
|
component="grid",
|
|
translation_key="current_pcc_l1n",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_pcc_l1n",
|
|
component="grid",
|
|
translation_key="active_power_pcc_l1n",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="voltage_phase_l2n",
|
|
component="grid",
|
|
translation_key="voltage_phase_l2n",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="current_output_l2n",
|
|
component="grid",
|
|
translation_key="current_output_l2n",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_output_l2n",
|
|
component="grid",
|
|
translation_key="active_power_output_l2n",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="current_pcc_l2n",
|
|
component="grid",
|
|
translation_key="current_pcc_l2n",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_pcc_l2n",
|
|
component="grid",
|
|
translation_key="active_power_pcc_l2n",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="voltage_line_l1",
|
|
component="grid",
|
|
translation_key="voltage_line_l1",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="voltage_line_l2",
|
|
component="grid",
|
|
translation_key="voltage_line_l2",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="voltage_line_l3",
|
|
component="grid",
|
|
translation_key="voltage_line_l3",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="active_power_offgrid_total",
|
|
component="offgrid",
|
|
translation_key="active_power_offgrid_total",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="reactive_power_offgrid_total",
|
|
component="offgrid",
|
|
translation_key="reactive_power_offgrid_total",
|
|
device_class=SensorDeviceClass.REACTIVE_POWER,
|
|
native_unit_of_measurement=UnitOfReactivePower.KILO_VOLT_AMPERE_REACTIVE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="apparent_power_offgrid_total",
|
|
component="offgrid",
|
|
translation_key="apparent_power_offgrid_total",
|
|
device_class=SensorDeviceClass.APPARENT_POWER,
|
|
native_unit_of_measurement=UnitOfApparentPower.KILO_VOLT_AMPERE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_frequency",
|
|
component="offgrid",
|
|
translation_key="offgrid_frequency",
|
|
device_class=SensorDeviceClass.FREQUENCY,
|
|
native_unit_of_measurement=UnitOfFrequency.HERTZ,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_voltage",
|
|
component="offgrid_single_phase",
|
|
translation_key="offgrid_voltage",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_voltage_l1",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_voltage_l1",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_current_output",
|
|
component="offgrid_single_phase",
|
|
translation_key="offgrid_current_output",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_current_output_l1",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_current_output_l1",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_active_power_output",
|
|
component="offgrid_single_phase",
|
|
translation_key="offgrid_active_power_output",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_active_power_output_l1",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_active_power_output_l1",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_reactive_power_output",
|
|
component="offgrid_single_phase",
|
|
translation_key="offgrid_reactive_power_output",
|
|
device_class=SensorDeviceClass.REACTIVE_POWER,
|
|
native_unit_of_measurement=UnitOfReactivePower.KILO_VOLT_AMPERE_REACTIVE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_reactive_power_output_l1",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_reactive_power_output_l1",
|
|
device_class=SensorDeviceClass.REACTIVE_POWER,
|
|
native_unit_of_measurement=UnitOfReactivePower.KILO_VOLT_AMPERE_REACTIVE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_apparent_power_output",
|
|
component="offgrid_single_phase",
|
|
translation_key="offgrid_apparent_power_output",
|
|
device_class=SensorDeviceClass.APPARENT_POWER,
|
|
native_unit_of_measurement=UnitOfApparentPower.KILO_VOLT_AMPERE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_apparent_power_output_l1",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_apparent_power_output_l1",
|
|
device_class=SensorDeviceClass.APPARENT_POWER,
|
|
native_unit_of_measurement=UnitOfApparentPower.KILO_VOLT_AMPERE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_load_peak_ratio",
|
|
component="offgrid_single_phase",
|
|
translation_key="offgrid_load_peak_ratio",
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_load_peak_ratio_l1",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_load_peak_ratio_l1",
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_voltage_l2",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_voltage_l2",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_current_output_l2",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_current_output_l2",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_active_power_output_l2",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_active_power_output_l2",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_reactive_power_output_l2",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_reactive_power_output_l2",
|
|
device_class=SensorDeviceClass.REACTIVE_POWER,
|
|
native_unit_of_measurement=UnitOfReactivePower.KILO_VOLT_AMPERE_REACTIVE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_apparent_power_output_l2",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_apparent_power_output_l2",
|
|
device_class=SensorDeviceClass.APPARENT_POWER,
|
|
native_unit_of_measurement=UnitOfApparentPower.KILO_VOLT_AMPERE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_load_peak_ratio_l2",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_load_peak_ratio_l2",
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_voltage_l3",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_voltage_l3",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_current_output_l3",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_current_output_l3",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_active_power_output_l3",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_active_power_output_l3",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_reactive_power_output_l3",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_reactive_power_output_l3",
|
|
device_class=SensorDeviceClass.REACTIVE_POWER,
|
|
native_unit_of_measurement=UnitOfReactivePower.KILO_VOLT_AMPERE_REACTIVE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_apparent_power_output_l3",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_apparent_power_output_l3",
|
|
device_class=SensorDeviceClass.APPARENT_POWER,
|
|
native_unit_of_measurement=UnitOfApparentPower.KILO_VOLT_AMPERE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_load_peak_ratio_l3",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_load_peak_ratio_l3",
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_voltage_output_l1n",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_voltage_output_l1n",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_current_output_l1n",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_current_output_l1n",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_active_power_output_l1n",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_active_power_output_l1n",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_voltage_output_l2n",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_voltage_output_l2n",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_current_output_l2n",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_current_output_l2n",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="offgrid_active_power_output_l2n",
|
|
component="offgrid_three_phase",
|
|
translation_key="offgrid_active_power_output_l2n",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="battery_power_total",
|
|
component="battery_totals",
|
|
translation_key="battery_power_total",
|
|
device_class=SensorDeviceClass.POWER,
|
|
native_unit_of_measurement=UnitOfPower.KILO_WATT,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
),
|
|
SofarSensorDescription(
|
|
key="battery_capacity_total",
|
|
component="battery_totals",
|
|
translation_key="battery_state_of_charge_total",
|
|
device_class=SensorDeviceClass.BATTERY,
|
|
native_unit_of_measurement=PERCENTAGE,
|
|
state_class=SensorStateClass.MEASUREMENT,
|
|
),
|
|
SofarSensorDescription(
|
|
key="battery_state_of_health_total",
|
|
component="battery_totals",
|
|
translation_key="battery_state_of_health_total",
|
|
native_unit_of_measurement=PERCENTAGE,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
),
|
|
SofarSensorDescription(
|
|
key="solar_generation_today",
|
|
component="energy",
|
|
translation_key="solar_generation_today",
|
|
device_class=SensorDeviceClass.ENERGY,
|
|
native_unit_of_measurement=UnitOfEnergy.KILO_WATT_HOUR,
|
|
state_class=SensorStateClass.TOTAL_INCREASING,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="load_consumption_today",
|
|
component="energy",
|
|
translation_key="load_consumption_today",
|
|
device_class=SensorDeviceClass.ENERGY,
|
|
native_unit_of_measurement=UnitOfEnergy.KILO_WATT_HOUR,
|
|
state_class=SensorStateClass.TOTAL_INCREASING,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="load_consumption_total",
|
|
component="energy",
|
|
translation_key="load_consumption_total",
|
|
device_class=SensorDeviceClass.ENERGY,
|
|
native_unit_of_measurement=UnitOfEnergy.KILO_WATT_HOUR,
|
|
state_class=SensorStateClass.TOTAL_INCREASING,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="import_energy_today",
|
|
component="energy",
|
|
translation_key="import_energy_today",
|
|
device_class=SensorDeviceClass.ENERGY,
|
|
native_unit_of_measurement=UnitOfEnergy.KILO_WATT_HOUR,
|
|
state_class=SensorStateClass.TOTAL_INCREASING,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="import_energy_total",
|
|
component="energy",
|
|
translation_key="import_energy_total",
|
|
device_class=SensorDeviceClass.ENERGY,
|
|
native_unit_of_measurement=UnitOfEnergy.KILO_WATT_HOUR,
|
|
state_class=SensorStateClass.TOTAL_INCREASING,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="export_energy_today",
|
|
component="energy",
|
|
translation_key="export_energy_today",
|
|
device_class=SensorDeviceClass.ENERGY,
|
|
native_unit_of_measurement=UnitOfEnergy.KILO_WATT_HOUR,
|
|
state_class=SensorStateClass.TOTAL_INCREASING,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="export_energy_total",
|
|
component="energy",
|
|
translation_key="export_energy_total",
|
|
device_class=SensorDeviceClass.ENERGY,
|
|
native_unit_of_measurement=UnitOfEnergy.KILO_WATT_HOUR,
|
|
state_class=SensorStateClass.TOTAL_INCREASING,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="battery_input_energy_today",
|
|
component="battery_energy",
|
|
translation_key="battery_input_energy_today",
|
|
device_class=SensorDeviceClass.ENERGY,
|
|
native_unit_of_measurement=UnitOfEnergy.KILO_WATT_HOUR,
|
|
state_class=SensorStateClass.TOTAL_INCREASING,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="battery_input_energy_total",
|
|
component="battery_energy",
|
|
translation_key="battery_input_energy_total",
|
|
device_class=SensorDeviceClass.ENERGY,
|
|
native_unit_of_measurement=UnitOfEnergy.KILO_WATT_HOUR,
|
|
state_class=SensorStateClass.TOTAL_INCREASING,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="battery_output_energy_today",
|
|
component="battery_energy",
|
|
translation_key="battery_output_energy_today",
|
|
device_class=SensorDeviceClass.ENERGY,
|
|
native_unit_of_measurement=UnitOfEnergy.KILO_WATT_HOUR,
|
|
state_class=SensorStateClass.TOTAL_INCREASING,
|
|
suggested_display_precision=2,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="battery_output_energy_total",
|
|
component="battery_energy",
|
|
translation_key="battery_output_energy_total",
|
|
device_class=SensorDeviceClass.ENERGY,
|
|
native_unit_of_measurement=UnitOfEnergy.KILO_WATT_HOUR,
|
|
state_class=SensorStateClass.TOTAL_INCREASING,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="passive_eps_wait_time",
|
|
component="eps",
|
|
translation_key="passive_eps_wait_time",
|
|
device_class=SensorDeviceClass.DURATION,
|
|
native_unit_of_measurement=UnitOfTime.SECONDS,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_protocol",
|
|
component="battery_config_id",
|
|
translation_key="bat_config_protocol",
|
|
device_class=SensorDeviceClass.ENUM,
|
|
options=[
|
|
"first_flight_built_in_bms_default",
|
|
"pie_energy_protocol_pylon",
|
|
"first_flight_protocol_general",
|
|
"amass",
|
|
"lg",
|
|
"alphaess",
|
|
"catl",
|
|
"weco",
|
|
"fronus",
|
|
"ems",
|
|
"nilar",
|
|
"bts_5k",
|
|
"move_for",
|
|
],
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_overvoltage_protection",
|
|
component="battery_config_id",
|
|
translation_key="bat_config_overvoltage_protection",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_charging_voltage",
|
|
component="battery_config",
|
|
translation_key="bat_config_charging_voltage",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_undervoltage_protection",
|
|
component="battery_config",
|
|
translation_key="bat_config_undervoltage_protection",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_minimum_discharge_voltage",
|
|
component="battery_config",
|
|
translation_key="bat_config_minimum_discharge_voltage",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_maximum_charge_current_limit",
|
|
component="battery_config",
|
|
translation_key="bat_config_maximum_charge_current_limit",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_maximum_discharge_current_limit",
|
|
component="battery_config",
|
|
translation_key="bat_config_maximum_discharge_current_limit",
|
|
device_class=SensorDeviceClass.CURRENT,
|
|
native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
suggested_display_precision=2,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_depth_of_discharge",
|
|
component="battery_config",
|
|
translation_key="bat_config_depth_of_discharge",
|
|
native_unit_of_measurement=PERCENTAGE,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_end_of_discharge",
|
|
component="battery_config",
|
|
translation_key="bat_config_end_of_discharge",
|
|
native_unit_of_measurement=PERCENTAGE,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_capacity",
|
|
component="battery_config",
|
|
translation_key="bat_config_capacity",
|
|
native_unit_of_measurement="Ah",
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_rated_battery_voltage",
|
|
component="battery_config",
|
|
translation_key="bat_config_rated_battery_voltage",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_cell_type",
|
|
component="battery_config",
|
|
translation_key="bat_config_cell_type",
|
|
device_class=SensorDeviceClass.ENUM,
|
|
options=[
|
|
"lead_acid",
|
|
"lithium_iron_phosphate",
|
|
"ternary",
|
|
"lithium_titanate",
|
|
"agm",
|
|
"gel",
|
|
"flooded",
|
|
],
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_eps_buffer",
|
|
component="battery_config",
|
|
translation_key="bat_config_eps_buffer",
|
|
native_unit_of_measurement=PERCENTAGE,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_tempco",
|
|
component="battery_config",
|
|
translation_key="bat_config_tempco",
|
|
native_unit_of_measurement="mV/Cell",
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="bat_config_voltage_float",
|
|
component="battery_config",
|
|
translation_key="bat_config_voltage_float",
|
|
device_class=SensorDeviceClass.VOLTAGE,
|
|
native_unit_of_measurement=UnitOfElectricPotential.VOLT,
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
entity_registry_enabled_default=False,
|
|
),
|
|
SofarSensorDescription(
|
|
key="sync_rtc_result",
|
|
component="rtc_sync",
|
|
translation_key="sync_rtc_result",
|
|
device_class=SensorDeviceClass.ENUM,
|
|
options=[
|
|
"successful",
|
|
"operation_in_progress",
|
|
"enabled_discharging",
|
|
"disabled",
|
|
"operation_failed_controller_refused_to_respond",
|
|
"operation_failed_no_response_from_the_controller",
|
|
"operation_failed_current_function_disabled",
|
|
"operation_failed_parameter_access_failed",
|
|
"operation_failed_input_parameters_incorrect",
|
|
],
|
|
entity_category=EntityCategory.DIAGNOSTIC,
|
|
),
|
|
)
|
|
|
|
SENSOR_DESCRIPTIONS += _part_sensors(
|
|
"pv_string", _PV_STRING_COMPONENTS, _PV_STRING_MEASUREMENTS
|
|
) + _part_sensors("battery", _BATTERY_COMPONENTS, _BATTERY_MEASUREMENTS)
|