Skip to content

Commit 3ad8029

Browse files
gschintgenReenigneArcher
authored andcommitted
docs(troubleshooting): update note on AMD lowlatencyenc (Linux) (LizardByte#3117)
Co-authored-by: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com>
1 parent fbee982 commit 3ad8029

1 file changed

Lines changed: 15 additions & 16 deletions

File tree

docs/troubleshooting.md

Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -143,25 +143,24 @@ often grub is used to load the kernel and set its command line.)
143143

144144
### AMD encoding latency issues
145145
If you notice unexpectedly high encoding latencies (e.g. in Moonlight's
146-
performance overlay) or strong fluctuations thereof, this is due to
147-
[missing support](https://gitlab.freedesktop.org/drm/amd/-/issues/3336)
148-
in Mesa/libva for AMD's low latency encoder mode. This is particularly
149-
problematic at higher resolutions (4K).
150-
151-
Only the most recent development versions of mesa include support for this
152-
low-latency mode. It will be included in Mesa-24.2.
153-
154-
In order to enable it, Sunshine has to be started with a special environment
155-
variable:
156-
146+
performance overlay) or strong fluctuations thereof, your system's Mesa
147+
libraries are outdated (<24.2). This is particularly problematic at higher
148+
resolutions (4K).
149+
150+
Starting with Mesa-24.2 applications can request a
151+
[low-latency mode](https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/30039)
152+
by running them with a special
153+
[environment variable](https://docs.mesa3d.org/envvars.html#envvar-AMD_DEBUG):
157154
```bash
158-
AMD_DEBUG=lowlatencyenc sunshine
155+
export AMD_DEBUG=lowlatencyenc
159156
```
157+
Sunshine sets this variable automatically, no manual
158+
configuration is needed.
160159

161-
To check whether low-latency mode is being used, one can watch the `VCLK` and
162-
`DCLK` frequencies in `amdgpu_top`. Without this encoder tuning both clock
163-
frequencies will fluctuate strongly, whereas with active low-latency encoding
164-
they will stay high as long as the encoder is used.
160+
To check whether low-latency mode is being used, one can watch the VCLK and DCLK
161+
frequencies in amdgpu_top. Without this encoder tuning both clock frequencies
162+
will fluctuate strongly, whereas with active low-latency encoding they will stay
163+
high as long as the encoder is used.
165164

166165
### Gamescope compatibility
167166
Some users have reported stuttering issues when streaming games running within Gamescope.

0 commit comments

Comments
 (0)