View source for Radeon Video

{{TOC right}}

The following instructions are for modern AMD GPU chipsets covered by the radeon driver.

== Setup Xorg/udev ==

# Run the <code>[[Alpine setup scripts#setup-xorg-base|setup-xorg-base]]</code> script.
# Install the Xorg AMD video drivers: {{Cmd|# apk add xf86-video-ati}}
# For newer devices, use: {{Cmd|# apk add xf86-video-amdgpu}}
# Enable [[#Kernel Modesetting (KMS)]]. Specifically, the <code>fbcon</code> module is necessary, or leaving Xorg (via <code>Ctrl+Alt+F1</code> 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 can <code>modprobe fbcon</code> while Xorg is running.

== Kernel Modesetting (KMS) ==

To enable [[KMS]] at boot:
# Add the <code>radeon</code> or <code>amdgpu</code> and <code>fbcon</code> modules to {{Path|/etc/modules}}: {{Cmd|$ echo radeon >> /etc/modules<br />$ echo fbcon >> /etc/modules}} or {{Cmd|$ echo amdgpu >> /etc/modules<br />$ echo fbcon >> /etc/modules}}
# Install <code>mkinitfs</code>: {{Cmd|apk add mkinitfs}}
# Enable the <code>kms</code> feature in the <code>mkinitfs</code> configuration by adding it to the <var>features</var> variable, e.g., {{cat|/etc/mkinitfs/mkinitfs.conf|features{{=}}"keymap cryptsetup kms ata base ide scsi usb virtio ext4"}}
# Run <code>mkinitfs</code>.
# Reboot to test the configuration.

== Troubleshooting ==
=== Fixing MESA-LOADER errors===
{{Obsolete|Alpine no longer ships with the ''linux-hardened'' kernel}}

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.

{{cat|/etc/X11/xorg.conf|
  Section "Device"
        Option      "AccelMethod"        	"exa"
	Identifier  "Card0"
	Driver      "radeon"
	BusID       "PCI:1:0:0"
  EndSection}}
 
= =
* [https://wiki.archlinux.org/index.php/ATI archlinux.org / ATI]
* [https://wiki.archlinux.org/index.php/Xorg archlinux.org / Xorg]

[[Category:Drivers]]