Add frequency metric to Inverter and EVCharger data

Signed-off-by: Mathias L. Baumann <[email protected]>

Author: Marenz

src/frequenz/sdk/microgrid/component/_component_data.py

@@ -278,6 +278,9 @@ class InverterData(ComponentData):
     """
     # pylint: enable=line-too-long
 
+    frequency: float
+    """AC frequency, in Hertz (Hz)."""
+
     _component_state: inverter_pb.ComponentState.ValueType
     """State of the inverter."""
 
@@ -303,6 +306,7 @@ def from_proto(cls, raw: microgrid_pb.ComponentData) -> InverterData:
             active_power_exclusion_lower_bound=raw_power.system_exclusion_bounds.lower,
             active_power_inclusion_upper_bound=raw_power.system_inclusion_bounds.upper,
             active_power_exclusion_upper_bound=raw_power.system_exclusion_bounds.upper,
+            frequency=raw.inverter.data.ac.frequency.value,
             _component_state=raw.inverter.state.component_state,
             _errors=list(raw.inverter.errors),
         )
@@ -332,6 +336,9 @@ class EVChargerData(ComponentData):
         wire for phase/line 1,2 and 3 respectively.
     """
 
+    frequency: float
+    """AC frequency, in Hertz (Hz)."""
+
     cable_state: EVChargerCableState
     """The state of the ev charger's cable."""
 
@@ -366,6 +373,7 @@ def from_proto(cls, raw: microgrid_pb.ComponentData) -> EVChargerData:
             component_state=EVChargerComponentState.from_pb(
                 raw.ev_charger.state.component_state
             ),
+            frequency=raw.ev_charger.data.ac.frequency.value,
         )
         ev_charger_data._set_raw(raw=raw)
         return ev_charger_data

tests/utils/component_data_wrapper.py

@@ -106,6 +106,7 @@ def __init__(  # pylint: disable=too-many-arguments
         active_power_exclusion_lower_bound: float = math.nan,
         active_power_inclusion_upper_bound: float = math.nan,
         active_power_exclusion_upper_bound: float = math.nan,
+        frequency: float = 50.0,
         _component_state: inverter_pb.ComponentState.ValueType = (
             inverter_pb.ComponentState.COMPONENT_STATE_UNSPECIFIED
         ),
@@ -125,6 +126,7 @@ def __init__(  # pylint: disable=too-many-arguments
             active_power_inclusion_upper_bound=active_power_inclusion_upper_bound,
             active_power_exclusion_upper_bound=active_power_exclusion_upper_bound,
             _component_state=_component_state,
+            frequency=frequency,
             _errors=_errors if _errors else [],
         )
 
@@ -154,6 +156,7 @@ def __init__(  # pylint: disable=too-many-arguments
         active_power: float = math.nan,
         current_per_phase: Tuple[float, float, float] | None = None,
         voltage_per_phase: Tuple[float, float, float] | None = None,
+        frequency: float = 50.0,
         cable_state: EVChargerCableState = EVChargerCableState.UNSPECIFIED,
         component_state: EVChargerComponentState = EVChargerComponentState.UNSPECIFIED,
     ) -> None:
@@ -176,6 +179,7 @@ def __init__(  # pylint: disable=too-many-arguments
                 if voltage_per_phase
                 else (math.nan, math.nan, math.nan)
             ),
+            frequency=frequency,
             cable_state=cable_state,
             component_state=component_state,
         )