mirror of
https://github.com/torvalds/linux.git
synced 2026-07-27 17:47:41 +02:00
7455a0583a
Add configurable frequency limits to allow users to constrain the NPU operating frequency range for power and thermal management. This support requires firmware API version 3.34.0 or newer. New sysfs interface: The freq/ subdirectory contains the following attributes: - hw_min_freq: Minimum frequency supported by hardware (read-only) - hw_max_freq: Maximum frequency supported by hardware (read-only) - hw_efficient_freq: Hardware's optimal operating frequency (read-only) - current_freq: Current NPU frequency in MHz (read-only) - set_min_freq: Configure minimum operating frequency (50XX+ devices) - set_max_freq: Configure maximum operating frequency (50XX+ devices) Legacy attributes npu_max_frequency_mhz and npu_current_frequency_mhz are maintained for backward compatibility. Implementation details: - Frequency configuration is communicated to firmware via JSM messages - User-specified frequency values are clamped to hardware limits - Power-efficient frequency (pn_ratio) is adjusted dynamically to stay within the configured range - Frequency configuration is initialized during device boot - The JSM API header is updated to version 3.34.0 to support the new VPU_JSM_MSG_FREQ_CONFIG firmware message Added description for the sysfs attributes in the Documentation/ABI. Signed-off-by: Andrzej Kacprowski <andrzej.kacprowski@linux.intel.com> Reviewed-by: Karol Wachowski <karol.wachowski@linux.intel.com> Signed-off-by: Karol Wachowski <karol.wachowski@linux.intel.com> Link: https://patch.msgid.link/20260408150152.2093638-1-andrzej.kacprowski@linux.intel.com
66 lines
2.8 KiB
Plaintext
66 lines
2.8 KiB
Plaintext
What: /sys/bus/pci/drivers/intel_vpu/.../npu_busy_time_us
|
|
Date: May 2024
|
|
KernelVersion: 6.11
|
|
Contact: dri-devel@lists.freedesktop.org
|
|
Description: Time in microseconds that the device spent executing jobs. The time is
|
|
counted when and only when there are jobs submitted to firmware. This time
|
|
can be used to measure the utilization of NPU, either by calculating the
|
|
difference between two timepoints or monitoring utilization percentage by
|
|
reading periodically. Recommended read period is 1 second to avoid impact
|
|
on job submission performance. Read-only.
|
|
|
|
What: /sys/bus/pci/drivers/intel_vpu/.../npu_memory_utilization
|
|
Date: Jan 2025
|
|
KernelVersion: 6.15
|
|
Contact: dri-devel@lists.freedesktop.org
|
|
Description: Current NPU memory utilization in bytes. Reports the total size of all
|
|
resident buffer objects allocated for NPU use. Read-only.
|
|
|
|
What: /sys/bus/pci/drivers/intel_vpu/.../freq/hw_min_freq
|
|
Date: April 2026
|
|
KernelVersion: 7.2
|
|
Contact: dri-devel@lists.freedesktop.org
|
|
Description: Minimum frequency in MHz supported by the NPU hardware. This is a
|
|
hardware capability and cannot be changed. Read-only.
|
|
|
|
What: /sys/bus/pci/drivers/intel_vpu/.../freq/hw_efficient_freq
|
|
Date: April 2026
|
|
KernelVersion: 7.2
|
|
Contact: dri-devel@lists.freedesktop.org
|
|
Description: Most efficient operating frequency in MHz for the NPU. This represents
|
|
the frequency at which the NPU operates most efficiently in terms of power
|
|
and performance. Read-only.
|
|
|
|
What: /sys/bus/pci/drivers/intel_vpu/.../freq/hw_max_freq
|
|
Date: April 2026
|
|
KernelVersion: 7.2
|
|
Contact: dri-devel@lists.freedesktop.org
|
|
Description: Maximum frequency in MHz supported by the NPU hardware. This is a
|
|
hardware capability and cannot be changed. Read-only.
|
|
|
|
What: /sys/bus/pci/drivers/intel_vpu/.../freq/current_freq
|
|
Date: April 2026
|
|
KernelVersion: 7.2
|
|
Contact: dri-devel@lists.freedesktop.org
|
|
Description: Current operating frequency in MHz of the NPU. The value is valid only
|
|
when the device is active; returns 0 when idle. The actual frequency may
|
|
be lower than the requested range due to power or thermal constraints.
|
|
Read-only.
|
|
|
|
What: /sys/bus/pci/drivers/intel_vpu/.../freq/set_min_freq
|
|
Date: April 2026
|
|
KernelVersion: 7.2
|
|
Contact: dri-devel@lists.freedesktop.org
|
|
Description: Configured minimum operating frequency in MHz (50XX devices and newer).
|
|
Values written are clamped to hardware limits (hw_min_freq to hw_max_freq).
|
|
If set_min_freq exceeds set_max_freq, the driver clamps set_min_freq to
|
|
set_max_freq when selecting the operating frequency. Read-write.
|
|
|
|
What: /sys/bus/pci/drivers/intel_vpu/.../freq/set_max_freq
|
|
Date: April 2026
|
|
KernelVersion: 7.2
|
|
Contact: dri-devel@lists.freedesktop.org
|
|
Description: Configured maximum operating frequency in MHz (50XX devices and newer).
|
|
Values written are clamped to hardware limits (hw_min_freq to hw_max_freq).
|
|
Read-write.
|