Module: Mesa Branch: main Commit: 8ad7a7c7b3bfc3846b162c776bcf870442945b7c URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=8ad7a7c7b3bfc3846b162c776bcf870442945b7c
Author: Rob Clark <robdcl...@chromium.org> Date: Wed May 5 14:58:32 2021 -0700 docs/perfetto: Updates for freedreno and render-stages Signed-off-by: Rob Clark <robdcl...@chromium.org> Reviewed-by: Antonio Caggiano <antonio.caggi...@collabora.com> Acked-by: Emma Anholt <e...@anholt.net> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9901> --- docs/perfetto.rst | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/docs/perfetto.rst b/docs/perfetto.rst index 16af6802d26..18d89435ac5 100644 --- a/docs/perfetto.rst +++ b/docs/perfetto.rst @@ -23,6 +23,21 @@ same timeline, to better understand and tune/debug system level performance: - mesa: Per-process producer within mesa to capture render-stage traces on the GPU timeline, track events, etc. +The exact supported features vary per driver: + +.. list-table:: Supported data-sources + :header-rows: 1 + + * - Driver + - PPS Counters + - Render Stages + * - Freedreno + - ``gpu.counters.msm`` + - ``gpu.renderstages.msm`` + * - Turnip + - ``gpu.counters.msm`` + - + Run --- @@ -59,6 +74,22 @@ To capture a trace with perfetto you need to take the following steps: 8. Alternatively you can open the trace in `AGI <https://gpuinspector.dev/>`__ (which despite the name can be used to view non-android traces). +Driver Specifics +~~~~~~~~~~~~~~~~ + +Below is driver specific information/instructions for the PPS +provider. + +Freedreno / Turnip +^^^^^^^^^^^^^^^^^^ + +The Freedreno PPS driver needs root access to read system-wide +performance counters, so you can simply run it with sudo: + +.. code-block:: console + + sudo ./build/pps-producer + Troubleshooting --------------- _______________________________________________ mesa-commit mailing list mesa-commit@lists.freedesktop.org https://lists.freedesktop.org/mailman/listinfo/mesa-commit