linux/Documentation/driver-api/thermal
Srinivas Pandruvada b473d6a9d6 thermal: int340x: processor_thermal: Support power floor notifications
When the hardware reduces the power to the minimum possible, the power
floor is notified via an interrupt.

This can happen when user space requests a power limit via powercap RAPL
interface, which forces the system to enter to the lowest power. This
power floor indication can be used as a hint to resort to other methods
of reducing power than via RAPL power limit.

Before power floor status can be read or the firmware can trigger
notifications regarding it, it needs to be configured via a mailbox
command. The actual power floor status is read via bit 39 of MMIO
offset 0x5B18 of the processor thermal PCI device.

To show the current power floor status and get notification
on a sysfs attribute, add 2 new attributes to
/sys/bus/pci/devices/0000\:00\:04.0/power_limits/

power_floor_enable : This attribute is present when power floor
 notifications are supported. This attribute allows to enable/disable
 power floor notifications.

power_floor_status : This attribute is present when power floor
 notifications are supported. When enabled via power_floor_enable, this
 attribute shows the current power floor status.

The power floor implementation provides interfaces which are called
from the sysfs callbacks to enable/disable and read power floor
status. It also provides two additional interfaces to check if the
current processor thermal device interrupt is for power floor status
and to send notifications to user space.

Signed-off-by: Srinivas Pandruvada <srinivas.pandruvada@linux.intel.com>
[ rjw: Changelog and documentation changes edits ]
Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
2023-10-12 21:09:48 +02:00
..
cpu-cooling-api.rst
cpu-idle-cooling.rst docs: thermal: convert cpu-idle-cooling.rst to ReST 2020-06-19 14:03:00 -06:00
exynos_thermal_emulation.rst
exynos_thermal.rst thermal: exynos: Rename Samsung and Exynos to lowercase 2020-01-27 10:24:32 +01:00
index.rst Documentation: admin-guide: Move intel_powerclamp documentation 2023-02-09 20:53:39 +01:00
intel_dptf.rst thermal: int340x: processor_thermal: Support power floor notifications 2023-10-12 21:09:48 +02:00
nouveau_thermal.rst documentation: Update #nouveau IRC channel network 2021-07-25 22:20:55 +02:00
power_allocator.rst PM: EM: Clarify abstract scale usage for power values in Energy Model 2020-11-10 20:29:28 +01:00
sysfs-api.rst thermal/core: Remove thermal_bind_params structure 2023-04-07 11:18:22 +02:00
x86_pkg_temperature_thermal.rst