From 8ad7a7c7b3bfc3846b162c776bcf870442945b7c Mon Sep 17 00:00:00 2001 From: Rob Clark Date: Wed, 5 May 2021 14:58:32 -0700 Subject: [PATCH] docs/perfetto: Updates for freedreno and render-stages Signed-off-by: Rob Clark Reviewed-by: Antonio Caggiano Acked-by: Emma Anholt Part-of: --- 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 `__ (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 ---------------