Radeon Video
The following instructions are for modern AMD GPU chipsets covered by the radeon driver.
Setup Xorg/udev
- Run the
setup-xorg-base
script. - Install the Xorg AMD video drivers:
# apk add xf86-video-ati
- For newer devices, use:
# apk add xf86-video-amdgpu
- Install the AMD firmware files:
# apk add linux-firmware-amdgpu
- Enable #Kernel Modesetting (KMS). Specifically, the
fbcon
module is necessary, or leaving Xorg (viaCtrl+Alt+F1
or quitting) will result in a black screen until the machine is power cycled. If you have already launch Xorg and don't want to experience this effect, you canmodprobe fbcon
while Xorg is running.
Kernel Modesetting (KMS)
To enable KMS at boot:
- Add the
radeon
oramdgpu
andfbcon
modules to /etc/modules:$ echo radeon >> /etc/modules
or
$ echo fbcon >> /etc/modules$ echo amdgpu >> /etc/modules
$ echo fbcon >> /etc/modules - Install
mkinitfs
:apk add mkinitfs
- Enable the
kms
feature in themkinitfs
configuration by adding it to the features variable, e.g.,Contents of /etc/mkinitfs/mkinitfs.conf
features="keymap cryptsetup kms ata base ide scsi usb virtio ext4" - Run
mkinitfs
. - Reboot to test the configuration.
Troubleshooting
Fixing MESA-LOADER errors
This material is obsolete ... Alpine no longer ships with the linux-hardened kernel (Discuss) |
The linux-hardened kernel package places restrictions on sysfs and will prevent the MESA-LOADER from working as a normal user even if added to the video group.
See https://bugs.alpinelinux.org/issues/7265
Either switch to the linux-vanilla package or apply the grsec_sysfs_restrict=0 kernel parameter to allow normal users to access hardware acceleration on the desktop.
Fixing a frozen X11 when invoking startx
You may need to set the AccelMethod to exa not glamor which is the default for the driver.
Contents of /etc/X11/xorg.conf