xref: /linux/Documentation/ABI/testing/sysfs-driver-ivpu (revision 8c13415c8a4383447c21ec832b20b3b283f0e01a)
1What:		/sys/bus/pci/drivers/intel_vpu/.../npu_busy_time_us
2Date:		May 2024
3KernelVersion:	6.11
4Contact:	dri-devel@lists.freedesktop.org
5Description:	Time in microseconds that the device spent executing jobs. The time is
6		counted when and only when there are jobs submitted to firmware. This time
7		can be used to measure the utilization of NPU, either by calculating the
8		difference between two timepoints or monitoring utilization percentage by
9		reading periodically. Recommended read period is 1 second to avoid impact
10		on job submission performance. Read-only.
11
12What:		/sys/bus/pci/drivers/intel_vpu/.../npu_memory_utilization
13Date:		Jan 2025
14KernelVersion:	6.15
15Contact:	dri-devel@lists.freedesktop.org
16Description:	Current NPU memory utilization in bytes. Reports the total size of all
17		resident buffer objects allocated for NPU use. Read-only.
18
19What:		/sys/bus/pci/drivers/intel_vpu/.../freq/hw_min_freq
20Date:		April 2026
21KernelVersion:	7.2
22Contact:	dri-devel@lists.freedesktop.org
23Description:	Minimum frequency in MHz supported by the NPU hardware. This is a
24		hardware capability and cannot be changed. Read-only.
25
26What:		/sys/bus/pci/drivers/intel_vpu/.../freq/hw_efficient_freq
27Date:		April 2026
28KernelVersion:	7.2
29Contact:	dri-devel@lists.freedesktop.org
30Description:	Most efficient operating frequency in MHz for the NPU. This represents
31		the frequency at which the NPU operates most efficiently in terms of power
32		and performance. Read-only.
33
34What:		/sys/bus/pci/drivers/intel_vpu/.../freq/hw_max_freq
35Date:		April 2026
36KernelVersion:	7.2
37Contact:	dri-devel@lists.freedesktop.org
38Description:	Maximum frequency in MHz supported by the NPU hardware. This is a
39		hardware capability and cannot be changed. Read-only.
40
41What:		/sys/bus/pci/drivers/intel_vpu/.../freq/current_freq
42Date:		April 2026
43KernelVersion:	7.2
44Contact:	dri-devel@lists.freedesktop.org
45Description:	Current operating frequency in MHz of the NPU. The value is valid only
46		when the device is active; returns 0 when idle. The actual frequency may
47		be lower than the requested range due to power or thermal constraints.
48		Read-only.
49
50What:		/sys/bus/pci/drivers/intel_vpu/.../freq/set_min_freq
51Date:		April 2026
52KernelVersion:	7.2
53Contact:	dri-devel@lists.freedesktop.org
54Description:	Configured minimum operating frequency in MHz (50XX devices and newer).
55		Values written are clamped to hardware limits (hw_min_freq to hw_max_freq).
56		If set_min_freq exceeds set_max_freq, the driver clamps set_min_freq to
57		set_max_freq when selecting the operating frequency. Read-write.
58
59What:		/sys/bus/pci/drivers/intel_vpu/.../freq/set_max_freq
60Date:		April 2026
61KernelVersion:	7.2
62Contact:	dri-devel@lists.freedesktop.org
63Description:	Configured maximum operating frequency in MHz (50XX devices and newer).
64		Values written are clamped to hardware limits (hw_min_freq to hw_max_freq).
65		Read-write.
66