panfrost.rst 1.7 KB

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