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. 47