1.. SPDX-License-Identifier: GPL-2.0+
 2
 3=========================
 4 drm/Panthor CSF driver
 5=========================
 6
 7.. _panthor-usage-stats:
 8
 9Panthor DRM client usage stats implementation
10==============================================
11
12The drm/Panthor driver implements the DRM client usage stats specification as
13documented in :ref:`drm-client-usage-stats`.
14
15Example of the output showing the implemented key value pairs and entirety of
16the currently possible format options:
17
18::
19     pos:    0
20     flags:  02400002
21     mnt_id: 29
22     ino:    491
23     drm-driver:     panthor
24     drm-client-id:  10
25     drm-engine-panthor:     111110952750 ns
26     drm-cycles-panthor:     94439687187
27     drm-maxfreq-panthor:    1000000000 Hz
28     drm-curfreq-panthor:    1000000000 Hz
29     drm-total-memory:       16480 KiB
30     drm-shared-memory:      0
31     drm-active-memory:      16200 KiB
32     drm-resident-memory:    16480 KiB
33     drm-purgeable-memory:   0
34
35Possible `drm-engine-` key names are: `panthor`.
36`drm-curfreq-` values convey the current operating frequency for that engine.
37
38Users must bear in mind that engine and cycle sampling are disabled by default,
39because of power saving concerns. `fdinfo` users and benchmark applications which
40query the fdinfo file must make sure to toggle the job profiling status of the
41driver by writing into the appropriate sysfs node::
42
43    echo <N> > /sys/bus/platform/drivers/panthor/[a-f0-9]*.gpu/profiling
44
45Where `N` is a bit mask where cycle and timestamp sampling are respectively
46enabled by the first and second bits.