Unlocking Mali G1 Pro Graphics: A Complete Guide to PanVK and Panfrost Open-Source Drivers

Overview

The Arm Mali G1 Pro is the latest addition to the Mali v14 GPU family, and with it comes exciting support in two open-source driver projects: PanVK (Vulkan) and Panfrost (OpenGL via Gallium3D). This guide walks you through everything you need to know about getting these drivers up and running on your Mali G1 Pro hardware. Whether you're a developer testing the latest features or an enthusiast seeking open-source graphics, this tutorial covers the prerequisites, step-by-step installation, common pitfalls, and a summary of the new capabilities.

Prerequisites

Before diving in, ensure your system meets these requirements:

• Hardware: A device equipped with an Arm Mali G1 Pro GPU (part of the Mali v14 series).
• Operating System: A Linux distribution (e.g., Ubuntu 22.04+, Fedora 38+) with a recent kernel (5.15+ recommended for Mali support).
• Software: Git, Meson, Ninja, and a C/C++ compiler (GCC or Clang) for building Mesa.
• Dependencies: Vulkan loader, libdrm, Python 3, and various X11/Wayland libraries for display output.

If you're unsure about your kernel version, run uname -r in a terminal. For Mali GPU detection, use lspci | grep Mali or check device tree entries on embedded systems.

Step-by-Step Guide

Step 1: Obtain the Latest Mesa Source

PanVK and Panfrost are part of the Mesa graphics stack. Fetch the most recent code from the official repository:

git clone https://gitlab.freedesktop.org/mesa/mesa.git
cd mesa

Check out a stable branch or a tag that includes v14 Mali support. As of early 2025, the main branch contains the necessary patches. For production use, consider a release tag like mesa-24.3 or later.

Step 2: Install Build Dependencies

Install required packages (example for Debian/Ubuntu):

sudo apt update
sudo apt install build-essential meson ninja-build python3-pip \
    libvulkan-dev libdrm-dev libx11-dev libxext-dev \
    libwayland-dev wayland-protocols libegl1-mesa-dev

For Fedora/RHEL:

sudo dnf install gcc gcc-c++ meson ninja-build python3-pip \
    vulkan-loader-devel libdrm-devel libX11-devel \
    libwayland-devel wayland-protocols-devel mesa-libEGL-devel

Step 3: Configure Mesa for Mali G1 Pro

Create a build directory and configure Mesa with the appropriate flags:

meson setup builddir/ \
    -Dgallium-drivers=panfrost \
    -Dvulkan-drivers=panvk \
    -Dplatforms=x11,wayland \
    -Dbuildtype=release

This enables the Panfrost Gallium driver (for OpenGL/GLES) and the PanVK Vulkan driver, targeting v14 hardware. If you also need software rendering for fallback, add -Dgallium-drivers=swrast.

Step 4: Build and Install

Compile Mesa with Ninja:

ninja -C builddir/ -j$(nproc)

Once compilation finishes, install the drivers (you may need sudo):

sudo ninja -C builddir/ install

This places the drivers in /usr/local/lib (default). Verify installation:

ls /usr/local/lib/dri/panfrost_dri.so
ls /usr/local/lib/libvulkan_panfrost.so

Step 5: Configure System Libraries

Ensure the system's Vulkan loader can find the PanVK driver. Create a JSON file in /usr/share/vulkan/icd.d/ (or /etc/vulkan/icd.d/):

sudo nano /usr/share/vulkan/icd.d/panfrost.json

Add the following:

{
  "file_format_version": "1.0.0",
  "ICD": {
    "library_path": "/usr/local/lib/libvulkan_panfrost.so",
    "api_version": "1.3"
  }
}

For the OpenGL driver, ensure the library path is in your LD_LIBRARY_PATH or symlink to /usr/lib.

Step 6: Test the Drivers

Run the Vulkaninfo tool to confirm Mali G1 Pro support:

vulkaninfo --summary | grep -i pan

Look for "PanVK" in the device list. Test OpenGL with:

glxinfo -B | grep -i panfrost

For a graphical demo, try glmark2-es2-panfrost or vkmark.

Common Mistakes

• Outdated Kernel: The Mali v14 support requires kernel-side changes. Use kernel 6.2+ for optimal compatibility.
• Missing Firmware: Some Mali GPUs need proprietary firmware blobs. Ensure they are present in /lib/firmware/ (e.g., mali_csffw.bin).
• Build Configuration: Forgetting -Dvulkan-drivers=panvk leads to missing Vulkan support; double-check your Meson options.
• ICD File Not Sourced: Without a proper Vulkan ICD JSON, the loader won't see PanVK. Verify the path and permissions.
• Mismatched Library Versions: If you have multiple Mesa installations, the wrong library might be loaded. Use ldd to check which driver is used by an application.

Summary

With the steps above, you can enable the open-source PanVK and Panfrost drivers on Arm Mali G1 Pro hardware, unlocking both Vulkan and OpenGL capabilities. This support marks a significant milestone for Mali v14 GPUs in the open-source community. Always keep your Mesa and kernel up to date to benefit from ongoing improvements. For further details, refer to the Mesa documentation and the prerequisites section above.