Introduction to the PVRTune Manual

PVRTune profiles and analyses applications running on PowerVR GPUs

Document Overview

This document is a complete user manual for PVRTune and PVRPerfServer. It includes installation instructions, functionality explanations, and useful tips on how to get the most out of the application.

What is PVRTune?

PVRTune is a performance analysis tool for PowerVR graphics cores. It uses driver-level counters and hardware registers to provide real-time data on the performance of an application running on a PowerVR GPU.

PVRTune has four primary elements:

  • PVRPerfServer - This is a command line application that reads counters and registers from the drivers. PVRPerfServer then either saves the data to a PVRTUNE file or transmits the data to PVRTune GUI over a network. PVRPerfServer can also read from any application which uses the PVRScope library.
    Note: This application only runs on PowerVR devices.
  • PVRTune GUI: This is a client-side desktop profiling application used to analyse the performance of PowerVR graphics cores. It provides a real-time graphical representation of the information sent by a device through PVRPerfServer.
  • PVRHub: This is an application which manages an instance of PVRPerfServer or PVRTrace/PVRCarbon running on the target device. PVRHub runs on Android and Linux. For the remainder of this document, all PVRPerfServer functionality can be accomplished using PVRHub, unless otherwise stated.
    Note: On Android, PVRHub is an application that has a user interface. On Linux, it is a set of folders and scripts.
  • PVRScope: A performance analysis library that retrieves graphics core counter data. It works alongside PVRTune to augment it with custom markers and counters.

The following sections will explain how to set up each of these elements to analyse application performance on PowerVR devices. There will be a particular focus on setting up PVRPerfServer and the PVRTune GUI.

The image below demonstrates how these different elements interact with each other and the device driver.