Add VoltageTransformer component

Signed-off-by: Leandro Lucarella <[email protected]>

Author: llucax

src/frequenz/client/microgrid/component/__init__.py

@@ -16,6 +16,7 @@
 from ._precharger import Precharger
 from ._relay import Relay
 from ._status import ComponentStatus
+from ._voltage_transformer import VoltageTransformer
 
 __all__ = [
     "Chp",
@@ -31,4 +32,5 @@
     "Meter",
     "Precharger",
     "Relay",
+    "VoltageTransformer",
 ]

src/frequenz/client/microgrid/component/_voltage_transformer.py

@@ -0,0 +1,43 @@
+# License: MIT
+# Copyright © 2024 Frequenz Energy-as-a-Service GmbH
+
+"""Voltage transformer component."""
+
+import dataclasses
+from typing import Literal
+
+from ._category import ComponentCategory
+from ._component import Component
+
+
+@dataclasses.dataclass(frozen=True, kw_only=True)
+class VoltageTransformer(Component):
+    """A voltage transformer component.
+
+    Voltage transformers are used to step up or step down the voltage, keeping
+    the power somewhat constant by increasing or decreasing the current.
+
+    If voltage is stepped up, current is stepped down, and vice versa.
+
+    Note:
+        Voltage transformers have efficiency losses, so the output power is always less
+        than the input power.
+    """
+
+    category: Literal[ComponentCategory.VOLTAGE_TRANSFORMER] = (
+        ComponentCategory.VOLTAGE_TRANSFORMER
+    )
+    """The category of this component."""
+
+    primary_voltage: float
+    """The primary voltage of the transformer, in volts.
+
+    This is the input voltage that is stepped up or down.
+    """
+
+    secondary_voltage: float
+    """The secondary voltage of the transformer, in volts.
+
+    This is the output voltage that is the result of stepping the primary
+    voltage up or down.
+    """

tests/component/test_voltage_transformer.py

@@ -0,0 +1,58 @@
+# License: MIT
+# Copyright © 2025 Frequenz Energy-as-a-Service GmbH
+
+"""Tests for VoltageTransformer component."""
+
+import pytest
+from frequenz.client.common.microgrid import MicrogridId
+from frequenz.client.common.microgrid.components import ComponentId
+
+from frequenz.client.microgrid.component import (
+    ComponentCategory,
+    ComponentStatus,
+    VoltageTransformer,
+)
+
+
+@pytest.fixture
+def component_id() -> ComponentId:
+    """Provide a test component ID."""
+    return ComponentId(42)
+
+
+@pytest.fixture
+def microgrid_id() -> MicrogridId:
+    """Provide a test microgrid ID."""
+    return MicrogridId(1)
+
+
+@pytest.mark.parametrize(
+    "primary, secondary", [(400.0, 230.0), (0.0, 0.0), (230.0, 400.0), (-230.0, -400.0)]
+)
+def test_creation_ok(
+    component_id: ComponentId,
+    microgrid_id: MicrogridId,
+    primary: float,
+    secondary: float,
+) -> None:
+    """Test VoltageTransformer component initialization with different voltages."""
+    voltage_transformer = VoltageTransformer(
+        id=component_id,
+        microgrid_id=microgrid_id,
+        name="test_voltage_transformer",
+        manufacturer="test_manufacturer",
+        model_name="test_model",
+        status=ComponentStatus.ACTIVE,
+        primary_voltage=primary,
+        secondary_voltage=secondary,
+    )
+
+    assert voltage_transformer.id == component_id
+    assert voltage_transformer.microgrid_id == microgrid_id
+    assert voltage_transformer.name == "test_voltage_transformer"
+    assert voltage_transformer.manufacturer == "test_manufacturer"
+    assert voltage_transformer.model_name == "test_model"
+    assert voltage_transformer.status == ComponentStatus.ACTIVE
+    assert voltage_transformer.category == ComponentCategory.VOLTAGE_TRANSFORMER
+    assert voltage_transformer.primary_voltage == pytest.approx(primary)
+    assert voltage_transformer.secondary_voltage == pytest.approx(secondary)