1 .. SPDX-License-Identifier: GPL-2.0+ 1 .. SPDX-License-Identifier: GPL-2.0+
2 2
3 ========================= 3 =========================
4 drm/Panfrost Mali Driver 4 drm/Panfrost Mali Driver
5 ========================= 5 =========================
6 6
7 .. _panfrost-usage-stats: 7 .. _panfrost-usage-stats:
8 8
9 Panfrost DRM client usage stats implementation 9 Panfrost DRM client usage stats implementation
10 ============================================== 10 ==============================================
11 11
12 The drm/Panfrost driver implements the DRM cli 12 The drm/Panfrost driver implements the DRM client usage stats specification as
13 documented in :ref:`drm-client-usage-stats`. 13 documented in :ref:`drm-client-usage-stats`.
14 14
15 Example of the output showing the implemented 15 Example of the output showing the implemented key value pairs and entirety of
16 the currently possible format options: 16 the currently possible format options:
17 17
18 :: 18 ::
19 pos: 0 19 pos: 0
20 flags: 02400002 20 flags: 02400002
21 mnt_id: 27 21 mnt_id: 27
22 ino: 531 22 ino: 531
23 drm-driver: panfrost 23 drm-driver: panfrost
24 drm-client-id: 14 24 drm-client-id: 14
25 drm-engine-fragment: 1846584880 ns 25 drm-engine-fragment: 1846584880 ns
26 drm-cycles-fragment: 1424359409 26 drm-cycles-fragment: 1424359409
27 drm-maxfreq-fragment: 799999987 Hz 27 drm-maxfreq-fragment: 799999987 Hz
28 drm-curfreq-fragment: 799999987 Hz 28 drm-curfreq-fragment: 799999987 Hz
29 drm-engine-vertex-tiler: 71932239 29 drm-engine-vertex-tiler: 71932239 ns
30 drm-cycles-vertex-tiler: 52617357 30 drm-cycles-vertex-tiler: 52617357
31 drm-maxfreq-vertex-tiler: 79999998 31 drm-maxfreq-vertex-tiler: 799999987 Hz
32 drm-curfreq-vertex-tiler: 79999998 32 drm-curfreq-vertex-tiler: 799999987 Hz
33 drm-total-memory: 290 MiB 33 drm-total-memory: 290 MiB
34 drm-shared-memory: 0 MiB 34 drm-shared-memory: 0 MiB
35 drm-active-memory: 226 MiB 35 drm-active-memory: 226 MiB
36 drm-resident-memory: 36496 KiB 36 drm-resident-memory: 36496 KiB
37 drm-purgeable-memory: 128 KiB 37 drm-purgeable-memory: 128 KiB
38 38
39 Possible `drm-engine-` key names are: `fragmen 39 Possible `drm-engine-` key names are: `fragment`, and `vertex-tiler`.
40 `drm-curfreq-` values convey the current opera 40 `drm-curfreq-` values convey the current operating frequency for that engine.
41 41
42 Users must bear in mind that engine and cycle 42 Users must bear in mind that engine and cycle sampling are disabled by default,
43 because of power saving concerns. `fdinfo` use 43 because of power saving concerns. `fdinfo` users and benchmark applications which
44 query the fdinfo file must make sure to toggle 44 query the fdinfo file must make sure to toggle the job profiling status of the
45 driver by writing into the appropriate sysfs n 45 driver by writing into the appropriate sysfs node::
46 46
47 echo <N> > /sys/bus/platform/drivers/panfr 47 echo <N> > /sys/bus/platform/drivers/panfrost/[a-f0-9]*.gpu/profiling
48 48
49 Where `N` is either `0` or `1`, depending on t 49 Where `N` is either `0` or `1`, depending on the desired enablement status.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.