thermal: intel: int340x: Add throttling control interface to PTC
authorSrinivas Pandruvada <srinivas.pandruvada@linux.intel.com>
Fri, 13 Jun 2025 21:49:22 +0000 (14:49 -0700)
committerRafael J. Wysocki <rafael.j.wysocki@intel.com>
Mon, 16 Jun 2025 12:03:09 +0000 (14:03 +0200)
commit7954001a769a174f70d770c360fbff0d99dc51d4
tree837177354f9957815f89d3c96a2500aa2604261c
parente04c78d86a9699d136910cfc0bdcf01087e3267e
thermal: intel: int340x: Add throttling control interface to PTC

Firmware-based thermal temperature control loops may aggressively
throttle performance to prevent temperature overshoots relative to the
defined target temperature. This can negatively impact performance. User
space may prefer to prioritize performance, even if it results in
temperature overshoots with in acceptable range.

For example, user space might tolerate temperature overshoots when the
device is placed on a desk, as opposed to when it's on a lap. To
accommodate such scenarios, an optional attribute is provided to specify
a tolerance level for temperature overshoots while maintaining acceptable
performance.

Attribute:

thermal_tolerance: This attribute ranges from 0 to 7, where 0 represents
the most aggressive control to avoid any temperature overshoots, and 7
represents a more graceful approach, favoring performance even at the
expense of temperature overshoots.
Note: This level may not scale linearly. For example, a value of 3 does not
necessarily imply a 50% improvement in performance compared to a value of 0.

Signed-off-by: Srinivas Pandruvada <srinivas.pandruvada@linux.intel.com>
Reviewed-by: Zhang Rui <rui.zhang@intel.com>
Link: https://patch.msgid.link/20250613214923.2910397-1-srinivas.pandruvada@linux.intel.com
Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
Documentation/driver-api/thermal/intel_dptf.rst
drivers/thermal/intel/int340x_thermal/platform_temperature_control.c