diff options
| author | Marc Bonnici <marc.bonnici@arm.com> | 2019-01-25 17:32:18 +0000 |
|---|---|---|
| committer | setrofim <setrofim@gmail.com> | 2019-01-28 12:45:10 +0000 |
| commit | 3f202205a5b056f3c17ff21eb1988672738d6827 (patch) | |
| tree | fca81a19ac968f0cfbbae1b784d983e03ec48c49 | |
| parent | ce7720b26d583475bd3da68ad121822ce3185bd1 (diff) | |
doc/faq: Add answer on how to fall back to surfaceflinger
| -rw-r--r-- | doc/source/faq.rst | 35 |
1 files changed, 34 insertions, 1 deletions
diff --git a/doc/source/faq.rst b/doc/source/faq.rst index 1b5b739a..86a8fccc 100644 --- a/doc/source/faq.rst +++ b/doc/source/faq.rst @@ -69,7 +69,40 @@ WA3 config file. **Q:** My Juno board keeps resetting upon starting WA even if it hasn't crashed. -------------------------------------------------------------------------------- -Please ensure that you do not have any other terminals (e.g. ``screen`` +**A** Please ensure that you do not have any other terminals (e.g. ``screen`` sessions) connected to the board's UART. When WA attempts to open the connection for its own use this can cause the board to reset if a connection is already present. + + +**Q:** I'm using the FPS instrument but I do not get any/correct results for my workload +----------------------------------------------------------------------------------------- + +**A:** If your device is running with Android 6.0 + then the default utility for +collecting fps metrics will be ``gfxinfo`` however this does not seem to be able +to extract any meaningful information for some workloads. In this case please +try setting the ``force_surfaceflinger`` parameter for the ``fps`` augmentation +to ``True``. This will attempt to guess the "View" for the workload +automatically however this is device specific and therefore may need +customizing. If this is required please open the application and execute +``dumpsys SurfaceFlinger --list`` on the device via adb. This will provide a +list of all views available for measuring. + +As an example, when trying to find the view for the AngryBirds Rio workload you +may get something like: + +.. code-block:: none + + ... + AppWindowToken{41dfe54 token=Token{77819a7 ActivityRecord{a151266 u0 com.rovio.angrybirdsrio/com.rovio.fusion.App t506}}}#0 + a3d001c com.rovio.angrybirdsrio/com.rovio.fusion.App#0 + Background for -SurfaceView - com.rovio.angrybirdsrio/com.rovio.fusion.App#0 + SurfaceView - com.rovio.angrybirdsrio/com.rovio.fusion.App#0 + com.rovio.angrybirdsrio/com.rovio.fusion.App#0 + boostedAnimationLayer#0 + mAboveAppWindowsContainers#0 + ... + +From these ``"SurfaceView - com.rovio.angrybirdsrio/com.rovio.fusion.App#0"`` is +the mostly likely the View that needs to be set as the ``view`` workload +parameter and will be picked up be the ``fps`` augmentation. |