切换 GPU 驱动

搭载 RK3588（不包含 RK3582）系列 SOC 的产品在使用 Debian 12 (Bookworm) 版本系统时默认使用 Panthor GPU 驱动，您可根据需求依据下方教程操作进行 GPU 驱动切换。

注意

本文档仅适用于搭载 RK3588（不包含 RK3582）系列 SOC 的产品。

Driver	OpenGL	OpenGL ES	OpenCL	8K HDMI
Mali	❌	✔	✔	✔
Panthor	✔	✔	❌	❌

Mali

使用 Rockchip 专有 xorg-xserver 版本

1. 添加 /etc/apt/preferences.d/mali 文件，内容为：

Package: *xserver*
Pin: release a=rk3588-bookworm
Pin-Priority: 1001

Package: *xserver*
Pin: release a=rk3588-bookworm-test
Pin-Priority: 1001

Package: *xserver*
Pin: release a=rk3588s2-bookworm
Pin-Priority: 1001

Package: *xserver*
Pin: release a=rk3588s2-bookworm-test
Pin-Priority: 1001

2. 然后参考使用 rsetup 进行系统升级来重新安装 Rockchip 专有软件包 (如果不执行此步骤会导致桌面闪退或者颜色翻转)

安装 Mali 用户层驱动

sudo apt-get update
sudo apt-get install libmali-valhall-g610-g13p0-x11-gbm

开启 Mali GPU Overlay

参考 Overlay 开启教程，开启 Enable Arm Mali GPU driver Overlay。

Panthor

恢复使用 Debian 官方打包的主线 xorg-xserver 版本

1. 删除 /etc/apt/preferences.d/mali 文件：

sudo rm /etc/apt/preferences.d/mali

2. 然后参考使用 rsetup 进行系统升级来重新安装 Debian 官方软件包 (如果不执行此步骤会导致桌面闪退或者颜色翻转)

卸载 Mali 用户层驱动，并安装上游 Mesa 驱动

sudo apt-get update
sudo apt-get remove libmali-valhall-g610-g13p0-x11-gbm
sudo apt-get install mesa-utils mesa-utils-extra libglx-mesa0 libgl1-mesa-dri

关闭 Mali GPU Overlay

参考 Overlay 开启教程，关闭 Enable Arm Mali GPU driver Overlay。

重启系统

sudo reboot

验证 GPU 驱动

验证内核驱动

查看是否有对应的 GPU 驱动加载信息：

# mali
rock@radxa-cm5-io:~$ lsmod | grep bifrost_kbase
bifrost_kbase        1015808  3

# Panthor
rock@radxa-cm5-io:~$ lsmod | grep panthor
panthor                98304  1
drm_gpuvm              24576  1 panthor
drm_exec               16384  2 drm_gpuvm,panthor
drm_shmem_helper       20480  1 panthor
gpu_sched              36864  1 panthor

验证 xorg-xserver 版本

运行以下命令，查看当前 [installed,automatic] 对应的 xorg-xserver 来源。使用 mali 驱动时，为 rk3588*-bookworm，使用 Panthor 驱动时，为 stable。

rock@radxa-cm5-io:~$ sudo apt list -a xserver-common xserver-xorg-core xserver-xorg-legacy
Listing... Done
xserver-common/stable-security,stable 2:21.1.7-3+deb12u7 all
xserver-common/rk3588s2-bookworm,rk3588s2-bookworm,now 2:21.1.7-3+deb12u2 all [installed,automatic]

xserver-xorg-core/stable-security,stable 2:21.1.7-3+deb12u7 arm64
xserver-xorg-core/rk3588s2-bookworm,now 2:21.1.7-3+deb12u2 arm64 [installed,automatic]

xserver-xorg-legacy/stable-security,stable 2:21.1.7-3+deb12u7 arm64
xserver-xorg-legacy/rk3588s2-bookworm,now 2:21.1.7-3+deb12u2 arm64 [installed,automatic]

验证用户层驱动

运行以下命令，使用 mali 驱动则为 [installed] 字样，使用 Panthor 则没有 [installed] 字样：

rock@radxa-cm5-io:~$ sudo apt list libmali-valhall-g610-g13p0-x11-gbm
Listing... Done
libmali-valhall-g610-g13p0-x11-gbm/rk3588s2-bookworm,now 1.9-1 arm64 [installed]
rock@radxa-cm5-io:~$