Make category/type update backwards compatible. (#224)

Author: Marenz

RELEASE_NOTES.md

@@ -2,11 +2,15 @@
 
 ## Summary
 
-<!-- Here goes a general summary of what this release is about -->
+This update introduces the possibility to target specific types of batteries, inverters and EV chargers.
+
+## Deprecations
+
+* In the `TargetComponents` message, the field `components.component_categories` is now deprecated. See the upgrading section for details.
 
 ## Upgrading
 
-* The `TargetComponents` message now accepts an optional `type` too. `.components.component_categories` is no longer just a `ComponentCategory` but a new `CategoryAndType` message that has a required `category` (`ComponentCategory`) and an optional `type` (`oneof BatteryType, EVChargerType, InverterType`).
+* The `TargetComponents` message now accepts an optional `type` too. `.components.component_categories` is now deprecated. Instead `.components.component_categories_types`, a new `CategoryAndType` message that has a required `category` (`ComponentCategory`) and an optional `type` (`oneof BatteryType, EVChargerType, InverterType`) should be used.
 
 ## New Features
 

proto/frequenz/api/dispatch/v1/dispatch.proto

@@ -336,6 +336,13 @@ message TargetComponents {
     repeated uint64 ids = 1;
   }
 
+
+  // Deprecated: Use `CategoryTypeSet` instead
+  message CategorySet {
+    // Set of component categories
+    repeated frequenz.api.common.v1.microgrid.components.ComponentCategory categories = 1;
+  }
+
   // Wrapper for controlling dispatches with a set of component categories and optional types
   // Required as we can't use `repeated` directly in a `oneof`
   message CategoryTypeSet {
@@ -370,8 +377,13 @@ message TargetComponents {
     // Set of component IDs
     IdSet component_ids = 1;
 
-    // Component categories
-    CategoryTypeSet component_categories = 2;
+    // Deprecated: Component categories
+    // Use `CategoryTypeSet` instead
+    // In future versions, this field will be removed.
+    CategorySet component_categories = 2;
+
+    // Component categories with optional types
+    CategoryTypeSet component_categories_types = 3;
   }
 }