Update the README

README.md

@@ -44,20 +44,44 @@ The heating curve coefficient is a configurable parameter in SAT that allows you
 SAT supports automatic PID gain tuning. When this feature is enabled, SAT will continuously adjust the PID gains to optimize the temperature control performance based on the current conditions instead of manually filling in the PID-values.
 
 ## Overshoot protection
-With overshoot protection enabled, SAT will automatically calculate the maximum allowed modulation value for the boiler based on the setpoint and the calculation overshoot protection value.
+
+With overshoot protection enabled, SAT will automatically calculate the maximum allowed modulation value for the boiler based on the setpoint and the calculation overshoot
+protection value.
 
 ## Tuning
-*Heating Curve Coefficient*: By adjusting the heating curve coefficient, you can balance the heating loss of your home with the energy generated from your boiler at a given setpoint based on the outside temperature. When this value is properly tuned then the room temperature should float around the setpoint.
+
+*Heating Curve Coefficient*: By adjusting the heating curve coefficient, you can balance the heating loss of your home with the energy generated from your boiler at a given
+setpoint based on the outside temperature. When this value is properly tuned then the room temperature should float around the setpoint.
 
 *Gains*: SAT offers two ways of tuning the PID gains - manual and automatic.
+
 - Manual tuning: You can fill the Proportional, Integral and Derivative fields in the General tab with your own values.
-- Automatic Gains ( Recommended ): You can enable this option in the Advanced Tab. Automatic gains dynamically change the kP, kI and kD values based on the heating curve value. So, based on the outside temperature the gains are changing from mild to aggressive without intervention.
+- Automatic Gains ( Recommended ): You can enable this option in the Advanced Tab. Automatic gains dynamically change the kP, kI and kD values based on the heating curve
+  value. So, based on the outside temperature the gains are changing from mild to aggressive without intervention.
+
+*Overshoot Protection* (Experimental): This feature should be enabled when the minimum boiler capacity is greater than the control setpoint calculated by SAT. If the boiler
+overshoots the control setpoint, it may cycle, which can shorten the life of the burner. The solution is to adjust the boiler's on/off times to maintain the temperature at the
+setpoint while minimizing cycling.
 
-*Overshoot Protection* ( Experimental ): When this option is enabled, SAT sends the MM=0 and CS=75 commands. Then SAT tries to find the highest boiler flow water temperature that can be produced given that the boiler runs at 0 % modulation. This mechanism needs at least 20 minutes. When overshoot protection value calculation is over, SAT falls back to it's normal operation. This value is stored as attribute in the SAT climate entity and then is used in order to calculate the boiler ON/OFF times of the low load control algorithm.
+Overshoot Protection Value (OPV) Calculation: The OPV is a crucial value that determines the boiler's on/off times when the Overshoot Protection feature is enabled. SAT
+provides two ways to calculate it.
 
-*Automatic Duty Cycle* ( Experimental ): When this option is enabled, SAT calculates the ON and OFF times of the boiler, in 15 minutes intervals, given that the kW needed to heat the home are less than the minimun boiler capacity. Moreover using this feature SAT is able to regulate efficiently the room temperature even in mild weather by automatically adjusting the duty cycle.
+*Manual Calculation*: If you know the maximum flow water temperature of the boiler at 0% modulation, you can use the service `Overshoot Protection Value` to set the value.
+
+*Automatic Calculation*: To calculate the OPV automatically, call the service `Overshoot Protection Calculation`. SAT will then send the MM=0 and CS=75 commands and attempt to
+find the highest flow water temperature the boiler can produce while running at 0% modulation. This process takes at least 20 minutes. Once the OPV calculation is complete,
+SAT will resume normal operation and send a completion notification. The calculated value will be stored as an attribute in the SAT climate entity and used to determine the
+boiler's on/off times in the low load control algorithm.
+
+Note: If you have any TRVs, open all of them (set them to a high setpoint) to ensure accurate calculation of the OPV. Once the calculation is complete, you can lower the
+setpoint back to your desired temperature.
+
+*Automatic Duty Cycle* ( Experimental ): When this option is enabled, SAT calculates the ON and OFF times of the boiler, in 15 minutes intervals, given that the kW needed to
+heat the home are less than the minimum boiler capacity. Moreover using this feature SAT is able to regulate efficiently the room temperature even in mild weather by
+automatically adjusting the duty cycle.
 
 ## Support
+
 If you want to support this project, you can [**buy me a coffee here**](https://www.buymeacoffee.com/alexwijn).
 
 <a href="https://www.buymeacoffee.com/alexwijn"><img src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=&slug=alexwijn&button_colour=0ac982&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff"></a>