Mali binary driver

The sun4i and sun5i use a Mali400MP1 and sun7i uses Mali400MP2 (dual-core GPU). We have support available for several versions of the mali binary driver stack, even though our kernel tends to come with the R3P0 version. We support framebuffer and X11 as windowing systems.

= Mali and UMP kernel drivers =

First get a working display driver.

Modules
The default config for the kernel should have the Mali kernel drivers as modules. You should be able to load it by simply running

 modprobe mali

A cleaner solution is to have the module autoloaded at boot, by adding the following to /etc/modules:  mali

If you use a properly set up Xserver, then the necessary modules will be automatically loaded when X starts.

Device permission
The default permissions of /dev/ump and /dev/mali make these unusable for normal users. Add a file to /etc/udev/rules.d/, perhaps called 50-mali.rules, with the following content:  KERNEL=="mali", MODE="0660", GROUP="video" KERNEL=="ump", MODE="0660", GROUP="video" This should give a user belonging to the group video the right permissions to use the mali successfully.

= Installing the UMP (Unified Memory Provider) userspace library =

From a package
There are some packages available which fully install libUMP for you.

Prequisites
libUMP only depends on libc and the ump kernel module.

 apt-get install git build-essential autoconf

Clone the repo
 git clone https://github.com/linux-sunxi/libump.git

Build
 autoreconf -i ./configure make make install

If you are on debian or ubuntu, you can alternative build the libump packages:

 dpkg-buildpackage -b

= Installing the Mali userspace driver =

Prerequisites
You will need to have at least the basics installed:

 apt-get install git build-essential autoconf

Also, make sure that you have loaded the mali module, so that the kernel driver version can be autodetected.

Clone the repo
 git clone https://github.com/linux-sunxi/sunxi-mali.git cd sunxi-mali git submodule init git submodule update

Configure
Now you can descend into sunxi-mali, and you can let it detect your environment:

 make config

It will state the detected environment, like so:

 rm -f config.mk make config.mk make[1]: Entering directory `/home/libv/sunxi/sunxi-mali' make -f Makefile.config ABI="armhf" (Detected) VERSION="r3p0" (Detected) EGL_TYPE="x11" (Detected) make[2]: Entering directory `/home/libv/sunxi/sunxi-mali' echo "MALI_VERSION ?= r3p0" > config.mk echo "MALI_LIBS_ABI ?= armhf" >> config.mk echo "MALI_EGL_TYPE ?= x11" >> config.mk make[2]: Leaving directory `/home/libv/sunxi/sunxi-mali' make[1]: Leaving directory `/home/libv/sunxi/sunxi-mali'

Dependencies
The sunxi-mali build system checks whether the selected library has all of its dependencies resolved. You might need to resolve these dependencies through your package manager.

libdri2 (r3p0 X11 only)
Some distributions have libdri2 compiled into the X11 binary, instead of having it as a separate library and package. If that is the case, you need to compile libdri2 manually. You will need to have libdrm-dev installed for this though.

git clone https://github.com/robclark/libdri2 cd libdri2 ./autogen.sh ./configure make make install

Install
By following will install the GLES/EGL binaries into /usr/lib/, and EGL/GLES headers to /usr/include/:

make install

= Setting up the windowing system =

Framebuffer
If you are using the framebuffer version of the binaries, then your setup work is done.

You might want to change the fbdev device used by setting the FRAMEBUFFER environment variable.

Xserver
If you want a GLES capable Xserver, then you will need to install the fbturbo driver according to our Xorg page.

= Verifying the EGL/GLES driver stack =

From the mali-sunxi repository, you can run:

 make test test/test

And you should be able to see a smoothed triangle, either written out to the top left corner of the framebuffer, or in an X window. The console will tell you which renderer is being used:

... GL Vendor: "ARM" GL Renderer: "Mali-400 MP" GL Version: "OpenGL ES 2.0" ...

Success!

= Common pitfalls =

Mesa libraries are still in the way
If your are seeing this:

libEGL warning: failed to create a pipe screen for Mali DRI2 libEGL warning: DRI2: failed to open Mali DRI2 (search paths /usr/lib/arm-linux-gnueabihf/dri)

Then the current best advice is to move the mesa-egl aside:

 mv /usr/lib/arm-linux-gnueabihf/mesa-egl/ /usr/lib/arm-linux-gnueabihf/.mesa-egl/

Awkward, but at least gets you something workable.

= See also =


 * Setting up a working display driver
 * Setting up an accelerated driver for the Xserver
 * CedarX media acceleration (video decoding).