====== Ubuntu - GPU - AMD GPU - Setup an AMD video card ======

===== Install the official amdgpu driver from a third-party PPA repository =====

To install the PPA third-party repository drivers execute the following commands:

<code bash>
sudo add-apt-repository ppa:oibaf/graphics-drivers
</code>

<WRAP info>
**NOTE:**  Another alternative for drivers is https://launchpad.net/~paulo-miguel-dias/+archive/ubuntu/mesa
</WRAP>


The above will add the PPA AMD Radeon driver repository to your system. The following command will upgrade your current AMD Radeon driver to the latest version:

<code bash>
sudo apt update && sudo apt -y upgrade
</code>

In case you need to revert back to your original Ubuntu AMD Radeon drivers you can remove the PPA driver installation using the below commands:

<code bash>
sudo apt install ppa-purge
sudo ppa-purge ppa:oibaf/graphics-drivers
</code>

----

===== Reboot =====

Reboot the computer.

<code bash>
sudo reboot
</code>

----

===== Check if the driver is active =====

<code bash>
lshw -c video
</code>

returns:

<code bash>
  *-display                 
       description: VGA compatible controller
       product: Navi 10 [Radeon RX 5600 OEM/5600 XT / 5700/5700 XT]
       vendor: Advanced Micro Devices, Inc. [AMD/ATI]
       physical id: 0
       bus info: pci@0000:0b:00.0
       version: c1
       width: 64 bits
       clock: 33MHz
       capabilities: pm pciexpress msi vga_controller bus_master cap_list rom
       configuration: driver=amdgpu latency=0
       resources: irq:115 memory:d0000000-dfffffff memory:e0000000-e01fffff ioport:e000(size=256) memory:fcb00000-fcb7ffff memory:fcb80000-fcb9ffff
</code>

<WRAP info>
**NOTE:**  Look for the keyword **driver=** in the **configuration** line.

  * If this shows **amdgpu** then this is good; and the official GPU driver is being used.
  * If this shows **radeon** then not good; as this indicates that the open source driver is being used.  

</WRAP>

----

===== Blacklist the open source radeon module driver =====

<code bash>
lspci -k | grep -EA3 'VGA|3D|Display'
</code>

displays:

<code bash>
</code>

<WRAP info>
**NOTE:**  This shows two kernel modules available: radeon and amdgpu.
</WRAP>

----

===== Disable the radeon driver =====

Edit /etc/modprobe.d/blacklist.conf:

<code bash>
sudo vi /etc/default/grub
</code>

…and add the following line at the end:

<file bash /etc/modprobe.d/blacklist.conf>
blacklist radeon
</file>

----

===== Update grub =====

<code bash>
sudo update-initramfs -u
</code>

<WRAP important>
**WARNING:**  If you reboot now, you might end up in a very low desktop resolution.
</WRAP>


===== Enable the amdgpu driver =====

Edit the /etc/default/grub file:

<code bash>
sudo vi /etc/default/grub
</code>

...and add these lines:

<file bash /etc/default/grub>
GRUB_GFXMODE=1920x1080x32
GRUB_CMDLINE_LINUX_DEFAULT="radeon.si_support=0 radeon.cik_support=0 amdgpu.si_support=1 amdgpu.cik_support=1 amdgpu.dc=1 amdgpu.dpm=1 amdgpu.modeset=1"
</file>

----

===== Update Grub =====

<code bash>
sudo update-grub2 && sudo update-initramfs -u -k all<br>
</code>

----

===== Reboot =====

Reboot the computer.

<code bash>
sudo reboot
</code>

----

===== References =====

https://linuxconfig.org/amd-radeon-ubuntu-20-04-driver-installation

https://randomblog.hu/setting-up-your-amd-video-card-in-ubuntu-20-04/