diff options
author | Rob Clark <robdclark@chromium.org> | 2021-05-05 14:58:32 -0700 |
---|---|---|
committer | Marge Bot <eric+marge@anholt.net> | 2021-05-10 15:34:07 +0000 |
commit | 8ad7a7c7b3bfc3846b162c776bcf870442945b7c (patch) | |
tree | b56b9432227ed9bd1cbd706c0344d30b6e9764af | |
parent | 1fadcfedb72df0b152358399ae4c1173faf91de1 (diff) |
docs/perfetto: Updates for freedreno and render-stages
Signed-off-by: Rob Clark <robdclark@chromium.org>
Reviewed-by: Antonio Caggiano <antonio.caggiano@collabora.com>
Acked-by: Emma Anholt <emma@anholt.net>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9901>
-rw-r--r-- | docs/perfetto.rst | 31 |
1 files changed, 31 insertions, 0 deletions
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 --------------- |