doc: update README hardware support table (#277)

This commit is contained in:
Ilya Zlobintsev 2024-03-02 10:52:13 +02:00 committed by GitHub
parent d1acdde89c
commit c058c62c77
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -41,6 +41,35 @@ sudo systemctl enable --now lactd
```
You can now use the GUI to change settings and view information.
# Hardware support
LACT for the most part does not implement features on a per-generation basis, rather it exposes the functionality that is available in the driver for the current system.
However the following table shows what functionality can be expected for a given generation.
- **Supported** - the functionality is known to work
- **Limited** - the functionality is known to work, but has certain limitations
- **Untested** - the functionality has not been confirmed to work, but it should
- **Unknown** - the functionality has not been confirmed to work, and it is unknown if it does
- **Unsupported** - the functionality is known to not work
| Generation | Clocks configuration | Power limit | Power states | Fan control | Notes |
|-------------------------------------|----------------------|-------------|--------------|-------------|---------------------------------------------------|
| Southern Islands (HD 7000) | Unsupported | Unknown | Unknown | Untested | Requires the `amdgpu.si_support=1` kernel option |
| Sea Islands (R7/R9 200) | Unsupported | Unknown | Untested | Untested | Requires the `amdgpu.cik_support=1` kernel option |
| Volcanic Islands (R7/R9 300) | Unsupported | Unknown | Untested | Untested | |
| Arctic Islands/Polaris (RX 400-500) | Supported | Supported | Supported | Supported | |
| Vega | Supported | Supported | Supported | Supported | |
| RDNA1 (RX 5000) | Supported | Supported | Supported | Supported | |
| RDNA2 (RX 6000) | Supported | Supported | Supported | Supported | |
| RDNA3 (RX 7000) | Supported | Limited | Supported | Limited | There is an unconfigurable temperature threshold below which the fan does not get turned on, even with a custom curve. The power cap is also sometimes lower than it should be. Requires kernel 6.7+. See [#255](https://github.com/ilya-zlobintsev/LACT/issues/255) for more info. |
GPUs not listed here will still work, but might not have full functionality available.
Monitoring/system info will be available everywhere. Integrated GPUs might also only have basic configuration available.
# Configuration
There is a configuration file available in `/etc/lact/config.yaml`. Most of the settings are accessible through the GUI, but some of them may be useful to be edited manually (like `admin_groups` to specify who has access to the daemon)
**Socket permissions setup:**
By default, LACT uses either ether the `wheel` or `sudo` group (whichever is available) for the ownership of the unix socket that the GUI needs to connect to.
@ -51,10 +80,6 @@ However, some systems may have different user configuration. In particular, this
To fix socket permissions in such configurations, edit `/etc/lact/config.yaml` and add your username or group as the first entry in `admin_groups` under `daemon`, and restart the service (`sudo systemctl restart lactd`).
# Configuration
There is a configuration file available in `/etc/lact/config.yaml`. Most of the settings are accessible through the GUI, but some of them may be useful to be edited manually (like `admin_groups` to specify who has access to the daemon)
# Overclocking
The overclocking functionality is disabled by default in the driver. There are two ways to enable it:
@ -64,17 +89,6 @@ The overclocking functionality is disabled by default in the driver. There are t
you might need to check your distro's configuration to make sure the initramfs was updated. Updating the kernel version is a guaranteed way to trigger an initramfs update.
- Specifying a boot parameter. You can manually specify the `amdgpu.ppfeaturemask=0xffffffff` kernel parameter in your bootloader to enable overclocking. See the [ArchWiki](https://wiki.archlinux.org/title/AMDGPU#Boot_parameter) for more details.
# Hardware support
Tested GPU generations:
- [X] Polaris (RX 500 series)
- [X] Vega
- [X] RDNA1 (RX 5000 series)
- [X] RDNA2 (RX 6000 series)
- [X] RDNA3 (RX 7000 series) - Requires Kernel 6.7+
GPUs not listed here will still work, but might not have full functionality available.
Monitoring/system info will be available everywhere. Integrated GPUs might also only have basic configuration available.
# Suspend/Resume
As some of the GPU settings may get reset when suspending the system, LACT will reload them on system resume. This may not work on distributions which don't use systemd, as it relies on the `org.freedesktop.login2` DBus interface.