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