feat: Allow to set down & up reactivity - Breaking change

Author: XavierBerger

docs/en/solar_router.md

@@ -10,8 +10,11 @@
 
     * ***Activate Solar Routing***  
       Control if Solar routing should be activated or not
-    * ***Reactivity***  
-      How fast will be the solar routing
+    * ***Down Reactivity***  
+      How fast will be the solar routing when real_power is more than target_grid_exchange.
+      From 1 to 100. 1 is the slowest, 100 is the fastest.
+    * ***Up Reactivity***  
+      How fast will be the solar routing when real_power is less than target_grid_exchange.
       From 1 to 100. 1 is the slowest, 100 is the fastest.
     * ***Router Level***  
       What is the current percentage of energy sent to the load by the overall router

docs/fr/solar_router.md

@@ -10,8 +10,11 @@
 
     * ***Activer le routage solaire***  
       Contrôle si le routage solaire doit être activé ou non
-    * ***Réactivité***  
-      Vitesse du routage solaire.  
+    * ***Down Reactivity (Réactivité descendante)***  
+      Vitesse du routage solaire utilisée lorsque la puissance réelle est supérieure à l'échange réseau cible.
+      De 1 à 100. 1 est le plus lent, 100 est le plus rapide.
+    * ***Up Reactivity (Réactivité ascendante)***  
+      Vitesse du routage solaire utilisée lorsque la puissance réelle est inférieure à l'échange réseau cible.
       De 1 à 100. 1 est le plus lent, 100 est le plus rapide.
     * ***Ouverture du régulateur***  
       Pourcentage actuel d'ouverture de la porte pour envoyer de l'énergie à la charge 

docs/images/SolarRouterInHomeAssistant.png

@@ -77,8 +77,19 @@ number:
 
   # Define the reactivity of router level
   - platform: template
-    name: "Reactivity"
-    id: reactivity
+    name: "Up Reactivity" 
+    id: up_reactivity
+    optimistic: True
+    restore_value: True
+    mode: box
+    min_value: 1
+    max_value: 100
+    initial_value: 10
+    unit_of_measurement: ""
+    step: 1
+  - platform: template
+    name: "Down Reactivity"
+    id: down_reactivity
     optimistic: True
     restore_value: True
     mode: box
@@ -124,7 +135,19 @@ script:
             id(router_level).publish_state(0);
             return;
           }
-          double delta = -1*(id(real_power).state-id(target_grid_exchange).state)*id(reactivity).state/1000;
+
+          // Calculate the power difference and adjust the regulator opening percentage
+          double real_power_state = id(real_power).state;
+          double target_grid_exchange_state = id(target_grid_exchange).state;
+          double reactivity_state = NAN;
+          if (real_power_state >= target_grid_exchange_state) {
+              reactivity_state = id(down_reactivity).state;
+          } else {
+              reactivity_state = id(up_reactivity).state;
+          }
+
+          double delta = -1*(real_power_state-target_grid_exchange_state)*reactivity_state/1000;
+          // Determine the new regulator status
           double new_router_level = id(router_level).state + delta;
           new_router_level = std::max(0.0, std::min(100.0, new_router_level));
           id(router_level).publish_state(new_router_level);

solar_router/engine_1dimmer.yaml

@@ -114,10 +114,21 @@ number:
     initial_value: 30
     restore_value: True
 
-  # Define the reactivity of router level
+    # Define the reactivity of router level
   - platform: template
-    name: "Reactivity"
-    id: reactivity
+    name: "Up Reactivity" 
+    id: up_reactivity
+    optimistic: True
+    restore_value: True
+    mode: box
+    min_value: 1
+    max_value: 100
+    initial_value: 10
+    unit_of_measurement: ""
+    step: 1
+  - platform: template
+    name: "Down Reactivity"
+    id: down_reactivity
     optimistic: True
     restore_value: True
     mode: box
@@ -169,8 +180,17 @@ script:
           // If router is activated, calculate the power difference and adjust the regulator opening percentage
           if ((id(power_meter_activated) == 1)) 
           {
-            double delta = 0;
-            delta = -1*(id(real_power).state-id(target_grid_exchange).state)*id(reactivity).state/1000;
+            // Calculate the power difference and adjust the regulator opening percentage
+            double real_power_state = id(real_power).state;
+            double target_grid_exchange_state = id(target_grid_exchange).state;
+            double reactivity_state = NAN;
+            if (real_power_state >= target_grid_exchange_state) {
+                reactivity_state = id(down_reactivity).state;
+            } else {
+                reactivity_state = id(up_reactivity).state;
+            }
+
+            double delta = -1*(real_power_state-target_grid_exchange_state)*reactivity_state/1000;
           
             // Determine the new regulator status
             double new_router_level = id(router_level).state + delta;