====== Enable Panfrost ======

<WRAP important >
For Ubuntu 24.04 only.
</WRAP>

The default release images for ''VIM4/3/3L/1S'' with ''5.15'' kernel and ''Edge2'' with ''6.1'' kernel are shipped with 
close source code of Mali GPU userspace drivers, this documentation will guide you to enable the open source GPU driver of ''Panfrost''.

===== Enable Panfrost =====

You need to enable the Panfrost via [[device-tree-overlay | device tree overlay]].

<tabbox VIM4/3/3L/1S>

Add ''panfrost'' to node ''fdt_overlays='':

```shell
fdt_overlays=panfrost
```
<tabbox Edge2>

Add ''panthor-gpu'' to node ''fdt_overlays='':

```shell
fdt_overlays=panthor-gpu
```


For Edge2, you need extra steps to upgrade mesa packages to support Panfrost:

```shell
$ cat <<-EOF | sudo tee /etc/apt/sources.list.d/kisaku-panfork-mesa-noble.list
deb https://ppa.launchpadcontent.net/kisak/kisak-mesa/ubuntu noble main
# deb-src deb https://ppa.launchpadcontent.net/kisak/kisak-mesa/ubuntu noble main
EOF
$ wget https://raw.githubusercontent.com/khadas/fenix/refs/heads/master/config/panfork-kisak.key
$ cat panfork-kisak.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/panfork-kisak.gpg
$ sudo apt update
$ sudo apt -y upgrade
$ sudo apt -y install libegl-mesa0 libgbm1 libglapi-mesa libglx-mesa0
```
</tabbox>

===== Remove the close source GPU libraries =====

If you want to use the open source GPU driver you need to remove the close source GPU libraries.


```shell
sudo apt -y remove linux-gpu-mali-wayland
sudo apt -y reinstall  libegl1  libgles2   libegl1-mesa-dev  libgles2-mesa-dev  libglvnd-dev  libgles1  libwayland-dev  mesa-common-dev  libgl-dev  libegl-dev libgles-dev libgbm-dev  libgbm1  libwayland-egl1
sync
sudo reboot
```

===== Check Panfrost =====

After reboot and login you can goto ''Settings->System->System Details'' to check the ''Panfrost'' status.

{{:products:sbc:common:configurations:panfrost.webp?600|}}