Add a new variant Meter to ElectricalComponentCategorySpecificInfo

This commit introduces a new message `Meter` to the `v1alpha8` package,
which encapsulates static information about meters in a microgrid.
Additionally, the `ElectricalComponentCategorySpecificInfo` enum has
been extended to include the `Meter` variant. This enhancement
enables the representation of meter-specific information within a
microgrid.

Signed-off-by: Tiyash Basu <[email protected]>

Author: tiyash-basu-frequenz

RELEASE_NOTES.md

@@ -10,7 +10,8 @@
 
 ## New Features
 
-<!-- Here goes the main new features and examples or instructions on how to use them -->
+- A new message has been added to the `v1alpha8` package: `microgrid.electrical_components.Meter`. This message holds static information about specific meters in a microgrid.
+- The `microgrid.electrical_components.ElectricalComponentCategorySpecificInfo` enum in the `v1alpha8` package has been extended with a new variant: `Meter`. This addition allows expressing information specific to meters within a microgrid.
 
 ## Bug Fixes
 

proto/frequenz/api/common/v1alpha8/microgrid/electrical_components/electrical_components.proto

@@ -559,6 +559,25 @@ message PowerTransformer {
   float secondary = 2;
 }
 
+// A representation of a meter.
+//
+// Meters typically cannot be controlled remotely, but they can provide
+// telemetry data.
+message Meter {
+  // Indicates if the polarity of the meter is reversed.
+  //
+  // While installation, meters may be wired in an opposite direction, causing
+  // consumption to be reported as negative values, and production as positive
+  // values. Since this is opposite to the convention followed in this API -
+  // consumption is positive, and production is negative - it is important to
+  // know if such a reversal is present.
+  //
+  // If true, the telemetry values reported by the meter should be inverted
+  // (multiplied by -1) to reflect the correct polarity - consumption as
+  // positive, and production as negative.
+  bool polarity_reversed = 1;
+}
+
 // MetricConfigBounds describes a set of limits for a specific metric consisting
 // of a lower and upper bound for said metric.
 //
@@ -585,6 +604,7 @@ message ElectricalComponentCategorySpecificInfo {
     GridConnectionPoint grid_connection_point = 3;
     Inverter inverter = 4;
     PowerTransformer power_transformer = 5;
+    Meter meter = 6;
   }
 }