Documentation/gpu/panthor.rst

   1 .. SPDX-License-Identifier: GPL-2.0+
   2
   3 =========================
   4  drm/Panthor CSF driver
   5 =========================
   6
   7 .. _panthor-usage-stats:
   8
   9 Panthor DRM client usage stats implementation
  10 ==============================================
  11
  12 The drm/Panthor driver implements the DRM client usage stats specification as
  13 documented in :ref:`drm-client-usage-stats`.
  14
  15 Example of the output showing the implemented key value pairs and entirety of
  16 the 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
  35 Possible `drm-engine-` key names are: `panthor`.
  36 `drm-curfreq-` values convey the current operating frequency for that engine.
  37
  38 Users must bear in mind that engine and cycle sampling are disabled by default,
  39 because of power saving concerns. `fdinfo` users and benchmark applications which
  40 query the fdinfo file must make sure to toggle the job profiling status of the
  41 driver by writing into the appropriate sysfs node::
  42
  43     echo <N> > /sys/bus/platform/drivers/panthor/[a-f0-9]*.gpu/profiling
  44
  45 Where `N` is a bit mask where cycle and timestamp sampling are respectively
  46 enabled by the first and second bits.