@@ -262,6 +262,25 @@ lowest non-linear performance in `AMD CPPC Performance Capability
262262<perf_cap_> `_.)
263263This attribute is read-only.
264264
265+ ``energy_performance_available_preferences ``
266+
267+ A list of all the supported EPP preferences that could be used for
268+ ``energy_performance_preference `` on this system.
269+ These profiles represent different hints that are provided
270+ to the low-level firmware about the user's desired energy vs efficiency
271+ tradeoff. ``default `` represents the epp value is set by platform
272+ firmware. This attribute is read-only.
273+
274+ ``energy_performance_preference ``
275+
276+ The current energy performance preference can be read from this attribute.
277+ and user can change current preference according to energy or performance needs
278+ Please get all support profiles list from
279+ ``energy_performance_available_preferences `` attribute, all the profiles are
280+ integer values defined between 0 to 255 when EPP feature is enabled by platform
281+ firmware, if EPP feature is disabled, driver will ignore the written value
282+ This attribute is read-write.
283+
265284Other performance and frequency values can be read back from
266285``/sys/devices/system/cpu/cpuX/acpi_cppc/ ``, see :ref: `cppc_sysfs `.
267286
@@ -280,8 +299,30 @@ module which supports the new AMD P-States mechanism on most of the future AMD
280299platforms. The AMD P-States mechanism is the more performance and energy
281300efficiency frequency management method on AMD processors.
282301
283- Kernel Module Options for ``amd-pstate ``
284- =========================================
302+
303+ AMD Pstate Driver Operation Modes
304+ =================================
305+
306+ ``amd_pstate `` CPPC has two operation modes: CPPC Autonomous(active) mode and
307+ CPPC non-autonomous(passive) mode.
308+ active mode and passive mode can be chosen by different kernel parameters.
309+ When in Autonomous mode, CPPC ignores requests done in the Desired Performance
310+ Target register and takes into account only the values set to the Minimum requested
311+ performance, Maximum requested performance, and Energy Performance Preference
312+ registers. When Autonomous is disabled, it only considers the Desired Performance Target.
313+
314+ Active Mode
315+ ------------
316+
317+ ``amd_pstate=active ``
318+
319+ This is the low-level firmware control mode which is implemented by ``amd_pstate_epp ``
320+ driver with ``amd_pstate=active `` passed to the kernel in the command line.
321+ In this mode, ``amd_pstate_epp `` driver provides a hint to the hardware if software
322+ wants to bias toward performance (0x0) or energy efficiency (0xff) to the CPPC firmware.
323+ then CPPC power algorithm will calculate the runtime workload and adjust the realtime
324+ cores frequency according to the power supply and thermal, core voltage and some other
325+ hardware conditions.
285326
286327Passive Mode
287328------------
@@ -298,6 +339,35 @@ processor must provide at least nominal performance requested and go higher if c
298339operating conditions allow.
299340
300341
342+ User Space Interface in ``sysfs ``
343+ =================================
344+
345+ Global Attributes
346+ -----------------
347+
348+ ``amd-pstate `` exposes several global attributes (files) in ``sysfs `` to
349+ control its functionality at the system level. They are located in the
350+ ``/sys/devices/system/cpu/amd-pstate/ `` directory and affect all CPUs.
351+
352+ ``status ``
353+ Operation mode of the driver: "active", "passive" or "disable".
354+
355+ "active"
356+ The driver is functional and in the ``active mode ``
357+
358+ "passive"
359+ The driver is functional and in the ``passive mode ``
360+
361+ "disable"
362+ The driver is unregistered and not functional now.
363+
364+ This attribute can be written to in order to change the driver's
365+ operation mode or to unregister it. The string written to it must be
366+ one of the possible values of it and, if successful, writing one of
367+ these values to the sysfs file will cause the driver to switch over
368+ to the operation mode represented by that string - or to be
369+ unregistered in the "disable" case.
370+
301371``cpupower `` tool support for ``amd-pstate ``
302372===============================================
303373
0 commit comments