Fixes for yuzu.github.io version, update note on nouveau, and corrected the LLVM version for AMD users

lat9nq 2021-01-05 17:06:03 -05:00
parent 222941a7ad
commit 15116e5724

@ -3,32 +3,38 @@ The default installed version of Mesa provided by the distro is recommended. Use
## NVIDIA ## NVIDIA
The latest available proprietary NVIDIA blob in the package manager is recommended. Drivers older than the 450 series may not be compatible with Linux 5.8 and above. CUDA is currently not working on Linux 5.9 [[source]](https://phoronix.com/scan.php?page=news_item&px=NVIDIA-Linux-5.9-Delayed) (which doesn't affect yuzu but is a consideration for someone who needs the compute capabilities of their GPU). Aside from these issues, users should expect a similar yuzu experience to that found on Windows, as the drivers are nearly identical. The latest available proprietary NVIDIA blob in the package manager is recommended. Drivers older than the 450 series may not be compatible with Linux 5.8 and above. CUDA is currently not working on Linux 5.9 [[source]](https://phoronix.com/scan.php?page=news_item&px=NVIDIA-Linux-5.9-Delayed) (which doesn't affect yuzu but is a consideration for someone who needs the compute capabilities of their GPU). Aside from these issues, users should expect a similar yuzu experience to that found on Windows, as the drivers are nearly identical.
- Ubuntu and Linux Mint: Install `nvidia-driver-450` <br>
- Debian: https://wiki.debian.org/NvidiaGraphicsDrivers <br> - Ubuntu and Linux Mint: Install `nvidia-driver-450`
- Fedora: Enable [RPM Fusion](https://rpmfusion.org/Configuration) (at least **nonfree**), update, then install `xorg-x11-drv-nvidia` <br> - Debian: https://wiki.debian.org/NvidiaGraphicsDrivers
- Note that RPM Fusion free is needed to install FFmpeg libraries for yuzu, so both will need to be enabled anyway. <br> - Fedora: Enable [RPM Fusion](https://rpmfusion.org/Configuration) (at least **nonfree**), update, then install `xorg-x11-drv-nvidia`
- Arch Linux: Use either `nvidia` or `nvidia-dkms` <br> - Note that RPM Fusion free is needed to install FFmpeg libraries for yuzu, so both will need to be enabled anyway.
- Manjaro: Use Manjaro Settings Manager -> Hardware Configuration -> Auto Install Proprietary Driver <br> - Arch Linux: Install either `nvidia` or `nvidia-dkms` in pacman
- Manjaro: Use Manjaro Settings Manager -> Hardware Configuration -> Auto Install Proprietary Driver
Setting the environment variable `__GL_THREADED_OPTIMIZATIONS=1` can net additional performance. Setting the environment variable `__GL_THREADED_OPTIMIZATIONS=1` can net additional performance.
## AMD ## AMD
Mesa compiled with LLVM 12 is recommended. yuzu's OpenGL shader decompiler generates shaders that are often incompatible with Mesa based on LLVM 10, resulting in frequent unrecoverable driver crashes. Using a version of Mesa built on LLVM 12 can circumvent most of this, but for games that already generate invalid shaders (e.g. FE:TH), unrecoverable crashes will still occur. Mesa compiled with at least LLVM 11 is recommended. yuzu's OpenGL shader decompiler generates shaders that are often incompatible with Mesa based on LLVM 10, resulting in frequent unrecoverable driver crashes. Using a version of Mesa built on LLVM 12 can circumvent most of this, but for games that already generate invalid shaders (e.g. FE:TH), unrecoverable crashes will still occur.
- Ubuntu (and Debian, Linux Mint, etc.): **No good solution**, but you can try [Oibaf's Mesa driver](https://launchpad.net/~oibaf/+archive/ubuntu/graphics-drivers) (daily builds of Mesa git using LLVM 10) - Ubuntu (and Debian, Linux Mint, etc.): **No good solution**, but you can try [Oibaf's Mesa driver](https://launchpad.net/~oibaf/+archive/ubuntu/graphics-drivers) (daily builds of Mesa git using LLVM 10)
``` ```
sudo add-apt-repository ppa:oibaf/graphics-drivers sudo add-apt-repository ppa:oibaf/graphics-drivers
sudo apt update sudo apt update
sudo apt upgrade sudo apt upgrade
``` ```
- Fedora: Enable and install [Che's Mesa COPR](https://copr.fedorainfracloud.org/coprs/che/mesa/) (daily builds of Mesa git using LLVM 12): - Fedora: Enable and install [Che's Mesa COPR](https://copr.fedorainfracloud.org/coprs/che/mesa/) (daily builds of Mesa git using LLVM 12):
``` ```
sudo dnf copr enable che/llvm sudo dnf copr enable che/llvm
sudo dnf copr enable che/mesa sudo dnf copr enable che/mesa
sudo dnf update sudo dnf update
``` ```
- Arch Linux and Manjaro: Enable [mesa-git](https://wiki.archlinux.org/index.php/Unofficial_user_repositories#mesa-git) unofficial repository your machine, then install `mesa-git` (daily builds of Mesa git using LLVM 12): <br>```sudo pacman -Syu mesa-git``` - Arch Linux and Manjaro: Enable [mesa-git](https://wiki.archlinux.org/index.php/Unofficial_user_repositories#mesa-git) unofficial repository your machine, then install `mesa-git` (daily builds of Mesa git using LLVM 12): <br>```sudo pacman -Syu mesa-git```
- Users who have not setup multilib can safely skip 32-bit packages. - Users who have not setup multilib can safely skip 32-bit packages.
- Don't forget to add `SigLevel = PackageOptional` when you enable the `mesa-git` repository. - Don't forget to add `SigLevel = PackageOptional` when you enable the `mesa-git` repository.
Setting `force_integer_tex_nearest=true` fixes black textures in Kirby Fighters 2 and Kirby Star Allies. Setting `force_integer_tex_nearest=true` fixes black textures in Kirby Fighters 2 and Kirby Star Allies.
@ -41,6 +47,6 @@ Setting `mesa_glthread=true` can net additional performance, only if the executa
- Users looking to build Mesa on Arch Linux themselves can follow the [old guide](https://github.com/yuzu-emu/yuzu/wiki/%5BDeprecated%5D-Building-Mesa-on-Arch-Linux). - Users looking to build Mesa on Arch Linux themselves can follow the [old guide](https://github.com/yuzu-emu/yuzu/wiki/%5BDeprecated%5D-Building-Mesa-on-Arch-Linux).
## Pitfalls ## Pitfalls
- Don't use nouveau (Mesa) with NVIDIA. Even on older cards, most games fail to boot on yuzu with this driver. Those games that do boot are doomed to crash after maybe a minute. - Don't use nouveau (Mesa) with NVIDIA. Since the [Texture Cache Rewrite](https://github.com/yuzu-emu/yuzu/pull/4967), games have been booting on nouveau. However, almost all games, especially those that require 3D rendering, have some sort of issues.
- Do not use AMDGPU-PRO. :) - Do not use AMDGPU-PRO. :)
- AMDGPU-PRO is fine to use for most of its features (OpenCL, AMF, Vulkan to some extent), but it is *strongly* recommended not to install its libGL component. - AMDGPU-PRO is fine to use for most of its features (OpenCL, AMF, Vulkan to some extent), but it is *strongly* recommended not to install its libGL component.