Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

docs: driver-api/thermal/intel_dptf: Add new workload type hint

Add documentation for longer term classification of workload type for
power or performance.

Signed-off-by: Srinivas Pandruvada <srinivas.pandruvada@linux.intel.com>
Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>
Link: https://patch.msgid.link/20251118223620.554798-1-srinivas.pandruvada@linux.intel.com
Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>

authored by

Srinivas Pandruvada and committed by
Rafael J. Wysocki
8538e7ee 3402bc01

+23
+23
Documentation/driver-api/thermal/intel_dptf.rst
··· 409 409 Limit 1 from being exhausted. 410 410 411 411 4 – Unknown: Can't classify. 412 + 413 + On processors starting from Panther Lake additional hints are provided. 414 + The hardware analyzes workload residencies over an extended period to 415 + determine whether the workload classification tends toward idle/battery 416 + life states or sustained/performance states. Based on this long-term 417 + analysis, it classifies: 418 + 419 + Power Classification: If the workload exhibits more idle or battery life 420 + residencies, it is classified as "power". 421 + 422 + Performance Classification: If the workload exhibits more sustained or 423 + performance residencies, it is classified as "performance". 424 + 425 + This approach enables applications to ignore short-term workload 426 + fluctuations and instead respond to longer-term power vs. performance 427 + trends. 428 + 429 + Residency thresholds for this classification are CPU generation-specific. 430 + Classification is reported via bit 4 of the workload_type_index: 431 + 432 + Bit 4 = 1: Power classification 433 + 434 + Bit 4 = 0: Performance classification