proto: Move fan configuration into relevant cooling modes

Author: Wenceslaw

CHANGELOG.md

@@ -5,10 +5,16 @@
 * Introduced new field `mode` in the `braiins.bos.v1.DPSConfiguration`, `braiins.bos.v1.SetDPSRequest`, `braiins.bos.v1.SetDPSResponse` message to get or set DPS mode.
 * Introduced new field `mode` in the `braiins.bos.v1.DPSConstraints` message to get the default value for DPS mode.
 * Introduced new method `SetCoolingMode` in the `braiins.bos.v1.CoolingService`. User can now set cooling mode to `automatic`, `manual`, `hydro` or `immersion`. It gives user possibility to set specific temperature and fan settings for each mode.
+* Introduced new field `min_fan_speed` in the `braiins.bos.v1.CoolingAutoMode` to set minimum fan speed for automatic cooling mode.
+* Introduced new field `max_fan_speed` in the `braiins.bos.v1.CoolingAutoMode` to set maximum fan speed for automatic cooling mode.
+* Introduced new field `min_fan_speed` in the `braiins.bos.v1.CoolingConstraints` to get default value for minimum fan speed for automatic cooling mode.
+* Introduced new field `max_fan_speed` in the `braiins.bos.v1.CoolingConstraints` to get default value for maximum fan speed for automatic cooling mode.
 
 ### Changed
 * Extend `CoolingConfiguration` mode with new value `immersion` that represents immersion cooling mode.
 * Extend `CoolingConfiguration` mode with new value `hydro` that represents hydro cooling mode.
+* Extend `CoolingAutoMode` with new field `minimum_required_fans`.
+* Extend `CoolingManualMode` with new field `minimum_required_fans`.
 
 ## [1.3.0] - 2024-10-22
 Version **1.3.0** introduces few small improvements.

proto/bos/v1/cooling.proto

@@ -40,6 +40,12 @@ message CoolingAutoMode {
   braiins.bos.v1.Temperature hot_temperature = 2;
   // Temperature threshold at which BOSMiner shuts down in order to prevent overheating and damaging the miner.
   braiins.bos.v1.Temperature dangerous_temperature = 3;
+  // Minimum fan speed expressed as a value between 0 and 100. min_fan_speed must be less than max_fan_speed.
+  optional uint32 min_fan_speed = 4;
+  // Maximum fan speed expressed as a value between 0 and 100. max_fan_speed must be greater than min_fan_speed.
+  optional uint32 max_fan_speed = 5;
+  // Minimum number of fans required to have BOSminer operational.
+  optional uint32 minimum_required_fans = 6;
 }
 
 // Fans are kept at a fixed, user-defined speed, no matter the temperature.
@@ -52,6 +58,8 @@ message CoolingManualMode {
   braiins.bos.v1.Temperature hot_temperature = 2;
   // Temperature threshold at which BOSMiner shuts down in order to prevent overheating and damaging the miner.
   braiins.bos.v1.Temperature dangerous_temperature = 3;
+  // Minimum number of fans required to have BOSminer operational.
+  optional uint32 minimum_required_fans = 5;
 }
 
 // Disable temperature control. May be dangerous.
@@ -75,6 +83,7 @@ message CoolingHydroMode {
 }
 
 message CoolingConfiguration {
+  // Minimum number of fans required to have BOSminer operational.
   optional uint32 minimum_required_fans = 1;
   oneof mode {
     CoolingAutoMode auto = 2;
@@ -101,6 +110,8 @@ message CoolingConstraints {
   braiins.bos.v1.TemperatureConstraints dangerous_temperature = 4;
   braiins.bos.v1.DoubleConstraints fan_speed_ratio = 5;
   braiins.bos.v1.UInt32Constraints minimum_required_fans = 6;
+  braiins.bos.v1.UInt32Constraints min_fan_speed = 7;
+  braiins.bos.v1.UInt32Constraints max_fan_speed = 8;
 }
 
 // Structure which contain info about one specific miner fan.