xref: /linux/Documentation/gpu/panthor.rst (revision 904bc5479896d8da7dcd3e162ce224c32c3dc6c3)
16a797bdfSAdrián Larumbe.. SPDX-License-Identifier: GPL-2.0+
26a797bdfSAdrián Larumbe
36a797bdfSAdrián Larumbe=========================
46a797bdfSAdrián Larumbe drm/Panthor CSF driver
56a797bdfSAdrián Larumbe=========================
66a797bdfSAdrián Larumbe
7*904bc547SAdrián Larumbe.. _panthor-usage-stats:
86a797bdfSAdrián Larumbe
96a797bdfSAdrián LarumbePanthor DRM client usage stats implementation
106a797bdfSAdrián Larumbe==============================================
116a797bdfSAdrián Larumbe
126a797bdfSAdrián LarumbeThe drm/Panthor driver implements the DRM client usage stats specification as
136a797bdfSAdrián Larumbedocumented in :ref:`drm-client-usage-stats`.
146a797bdfSAdrián Larumbe
156a797bdfSAdrián LarumbeExample of the output showing the implemented key value pairs and entirety of
166a797bdfSAdrián Larumbethe currently possible format options:
176a797bdfSAdrián Larumbe
186a797bdfSAdrián Larumbe::
196a797bdfSAdrián Larumbe     pos:    0
206a797bdfSAdrián Larumbe     flags:  02400002
216a797bdfSAdrián Larumbe     mnt_id: 29
226a797bdfSAdrián Larumbe     ino:    491
236a797bdfSAdrián Larumbe     drm-driver:     panthor
246a797bdfSAdrián Larumbe     drm-client-id:  10
256a797bdfSAdrián Larumbe     drm-engine-panthor:     111110952750 ns
266a797bdfSAdrián Larumbe     drm-cycles-panthor:     94439687187
276a797bdfSAdrián Larumbe     drm-maxfreq-panthor:    1000000000 Hz
286a797bdfSAdrián Larumbe     drm-curfreq-panthor:    1000000000 Hz
296a797bdfSAdrián Larumbe     drm-total-memory:       16480 KiB
306a797bdfSAdrián Larumbe     drm-shared-memory:      0
316a797bdfSAdrián Larumbe     drm-active-memory:      16200 KiB
326a797bdfSAdrián Larumbe     drm-resident-memory:    16480 KiB
336a797bdfSAdrián Larumbe     drm-purgeable-memory:   0
346a797bdfSAdrián Larumbe
356a797bdfSAdrián LarumbePossible `drm-engine-` key names are: `panthor`.
366a797bdfSAdrián Larumbe`drm-curfreq-` values convey the current operating frequency for that engine.
376a797bdfSAdrián Larumbe
386a797bdfSAdrián LarumbeUsers must bear in mind that engine and cycle sampling are disabled by default,
396a797bdfSAdrián Larumbebecause of power saving concerns. `fdinfo` users and benchmark applications which
406a797bdfSAdrián Larumbequery the fdinfo file must make sure to toggle the job profiling status of the
416a797bdfSAdrián Larumbedriver by writing into the appropriate sysfs node::
426a797bdfSAdrián Larumbe
436a797bdfSAdrián Larumbe    echo <N> > /sys/bus/platform/drivers/panthor/[a-f0-9]*.gpu/profiling
446a797bdfSAdrián Larumbe
456a797bdfSAdrián LarumbeWhere `N` is a bit mask where cycle and timestamp sampling are respectively
466a797bdfSAdrián Larumbeenabled by the first and second bits.
47