intel_epb.rst 1.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041
  1. .. SPDX-License-Identifier: GPL-2.0
  2. .. include:: <isonum.txt>
  3. ======================================
  4. Intel Performance and Energy Bias Hint
  5. ======================================
  6. :Copyright: |copy| 2019 Intel Corporation
  7. :Author: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
  8. .. kernel-doc:: arch/x86/kernel/cpu/intel_epb.c
  9. :doc: overview
  10. Intel Performance and Energy Bias Attribute in ``sysfs``
  11. ========================================================
  12. The Intel Performance and Energy Bias Hint (EPB) value for a given (logical) CPU
  13. can be checked or updated through a ``sysfs`` attribute (file) under
  14. :file:`/sys/devices/system/cpu/cpu<N>/power/`, where the CPU number ``<N>``
  15. is allocated at the system initialization time:
  16. ``energy_perf_bias``
  17. Shows the current EPB value for the CPU in a sliding scale 0 - 15, where
  18. a value of 0 corresponds to a hint preference for highest performance
  19. and a value of 15 corresponds to the maximum energy savings.
  20. In order to update the EPB value for the CPU, this attribute can be
  21. written to, either with a number in the 0 - 15 sliding scale above, or
  22. with one of the strings: "performance", "balance-performance", "normal",
  23. "balance-power", "power" that represent values reflected by their
  24. meaning.
  25. This attribute is present for all online CPUs supporting the EPB
  26. feature.
  27. Note that while the EPB interface to the processor is defined at the logical CPU
  28. level, the physical register backing it may be shared by multiple CPUs (for
  29. example, SMT siblings or cores in one package). For this reason, updating the
  30. EPB value for one CPU may cause the EPB values for other CPUs to change.