Skip to contentSkip to conversation

doc/power: add info on scale mode reaction time

PATCH Applied David Hunt 2 participants 2 messages Nov 24, 2021 – Nov 26, 2021

lore
Share & tools
lore

David Hunt

author
#0 lore raw

PATCH 1/1 doc/power: add info on scale mode reaction time

When using PMD Power Management, scale mode reacts slower than monitor mode and pause mode. Add note in user guide to this effect.

---
 doc/guides/prog_guide/power_man.rst               | 4 +++-
 doc/guides/sample_app_ug/l3_forward_power_man.rst | 5 +++--
 2 files changed, 6 insertions(+), 3 deletions(-)
doc/guides/prog_guide/power_man.rst +3 -1
index e387d7811e..66592cf22f 100644
@@ -216,7 +216,9 @@ power saving whenever empty poll count reaches a certain number.
 
 * Frequency scaling
    This power saving scheme will use ``librte_power`` library functionality to
-   scale the core frequency up/down depending on traffic volume.
+   scale the core frequency up/down depending on traffic volume. The reaction
+   time of the frequency scaling mode is longer than the pause and monitor
+   mode.
 
 The "monitor" mode is only supported in the following configurations and scenarios:
 
doc/guides/sample_app_ug/l3_forward_power_man.rst +3 -2
index 8817eaadbf..84b014fab5 100644
@@ -345,8 +345,9 @@ and has three available power management schemes:
   to avoid busy looping when there is no traffic.
 
 ``scale``
-  This will use frequency scaling routines
-  available in the ``librte_power`` library.
+  This will use frequency scaling routines available in
+  the ``librte_power`` library. The reaction time of the
+  scale mode is longer than the pause and monitor mode.
 
 See :doc:`Power Management<../prog_guide/power_man>` chapter
 in the DPDK Programmer's Guide for more details on PMD power management.
Signature · 1 line
2.17.1
#1 lore raw

24/11/2021 17:53, David Hunt:

Quoted 11 lines

When using PMD Power Management, scale mode reacts slower than monitor mode and pause mode. Add note in user guide to this effect.

---
This power saving scheme will use ``librte_power`` library functionality to

doc/guides/prog_guide/power_man.rst +3 -1
-   scale the core frequency up/down depending on traffic volume.
+   scale the core frequency up/down depending on traffic volume. The reaction
+   time of the frequency scaling mode is longer than the pause and monitor
+   mode.

[...]

doc/guides/sample_app_ug/l3_forward_power_man.rst and has three available power management schemes: · line 350

Quoted 5 lines
doc/guides/sample_app_ug/l3_forward_power_man.rst +3 -2
-  This will use frequency scaling routines
-  available in the ``librte_power`` library.
+  This will use frequency scaling routines available in
+  the ``librte_power`` library. The reaction time of the
+  scale mode is longer than the pause and monitor mode.

You don't have to change existing lines to add a new sentence. That's why I recommend always starting a new sentence on a new line. I fixed it to make the patch cleaner.

Applied