= Adreno =

The Adreno is a series of GPUs developed by Qualcomm. Is used in the Galaxy Nexus 4 and 7 (2013).


=== Profiler Installation Instructions ===

Get the Adreno SDK by visiting [[https://developer.qualcomm.com/software/adreno-gpu-profiler]] and choosing the Linux option. They require you to register an account before accessing the tool. Download it and extract it to somewhere in your home directory.

The profiling applications require Mono to function. Install its dependencies with
{{{
    sudo apt install mono-complete
}}}
once that has completed, you can run the profiling tool with:
{{{
    cd bin
    mono AdrenoProfiler.exe
}}}
It will pop up a Connect dialog. Now time to configure the Ubuntu Touch device.



=== Device configuration ===
Your Touch device must have developer mode enabled, and be connected to your PC with a USB cable. Use ''adb shell'' for the following commands.

First need to set an android-side variable to enable the profiler. Do this by editing ''/var/lib/lxc/android/pre-start.d/10-no-adbd'' and add the line:
{{{
    echo "debug.egl.profiler=1" >> $LXC_ROOTFS_PATH/default.prop
}}}
The path to the profiler library is incorrect in the driver binaries, so need to patch them (unsure if this necessary). First need to get write access to them:
{{{
    mkdir temp
    mount /var/lib/lxc/android/system.img temp
    cd temp/lib/egl
}}}
You should be in the directory with the driver binaries. Correct the paths with:
{{{
    sed -i 's|/vendor/lib/egl/libq3dtools_adreno.so|/system/lib/egl/libq3dtools_adreno.so|g' libEGL_adreno.so
    sed -i 's|/vendor/lib/egl/libq3dtools_adreno.so|/system/lib/egl/libq3dtools_adreno.so|g' libGLES_android.so
    sed -i 's|/vendor/lib/egl/libq3dtools_adreno.so|/system/lib/egl/libq3dtools_adreno.so|g' libGLESv1_CM_adreno.so
    sed -i 's|/vendor/lib/egl/libq3dtools_adreno.so|/system/lib/egl/libq3dtools_adreno.so|g' libGLESv2_adreno.so
    sed -i 's|/vendor/lib/egl/libq3dtools_adreno.so|/system/lib/egl/libq3dtools_adreno.so|g' libplayback_adreno.so
}}}

Reboot for good measure, and ensure the usual Touch UI appears ok. 


Now run the AdrenoProfiler on your machine, and try the Connect dialog. An entry for each graphical application on the device should appear.

Note I found that it doesn't always notice a profilable application is running, and sometimes starting a new application helps it detect it (e.g. ''ubuntu-app-launch webbrowser-app'').