OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
gpu-drivers high occasional DISPUTE

Stop AMD laptop panel flicker or a frozen internal screen caused by Panel Replay

omarchyarchendeavouroscachyosmanjaroamdlaptopwaylandhyprland
CORRECTED An auditor found the fix wrong or incomplete and rewrote it. · checked against Omarchy omarchy 4.0.4-1 on 2026-10-05
AUDIT NOTE

The core holds. amd_shared.h (master) has DC_DISABLE_PSR=0x10 (PSR v1 and PSR-SU), DC_DISABLE_PSR_SU=0x200, DC_DISABLE_REPLAY=0x400. amdgpu_drv.c registers dcdebugmask as uint 0444. amdgpu_dm_debugfs.c creates replay_capability and psr_capability per eDP connector, printing 'Sink support' and 'Driver support'. modinfo -p amdgpu on 7.2.5-3-omarchy lists dcdebugmask, dcfeaturemask and abmlevel and no psr. drm/amd #5519 (Zenbook S16, Ryzen AI 9 465, ATNA60HR07-0, 7.0.x/7.1.x freeze at the greeter, 6.19.14 works, 0x10 no help, 0x400 fixes), #5772 (780M IdeaPad, psr=0 and 0x10 no help, 0x410 fixes), #5561 (TUXEDO sets 0x610) and #3912 (Framework 16, 0x400 fixes) all match. Defects: the symptom adds specifics no cited source contains (pink frames, Framework 13, Krackan). #3344 had two bisections, the first landing on the freesync commit, so 'bisected to Panel Replay' needs that qualifier. The danger says a drop-in that sorts before omarchy-defaults.conf discards Omarchy's defaults, which is wrong: omarchy-defaults.conf itself uses +=, so only a bare = in a file sorting after it wipes them. The plain-Arch Limine branch assumes limine-mkinitcpio-hook is installed. Nothing was exercised (no AMD GPU here).

The cause above was rewritten on 2026-10-05 to match this note; the fix was corrected by the audit itself.
RISK

Disabling Panel Replay and PSR costs idle battery on the internal panel, because the GPU has to scan out every frame. The parameter itself cannot break boot.

The drop-in is the real risk. A bare = instead of += in a file that sorts after omarchy-defaults.conf discards Omarchy's defaults including initramfs_async=0, which can leave an encrypted machine at an unthemed text LUKS prompt. limine-mkinitcpio rewrites the UKI on the ESP, so check df -h /boot first. A full ESP produces a truncated image. Do not enable Omarchy Direct Boot (omarchy-setup-direct-boot) while you are still testing parameters, because it bypasses the Limine menu you would recover from.

Symptom

On a recent AMD laptop (Ryzen AI "Strix Point" with DCN 3.5, Ryzen 8040 "Hawk Point" with Radeon 780M, Framework 16, ASUS Zenbook S16), the internal screen flickers, refreshes late in full-screen apps, or freezes on the last frame shortly after the desktop or greeter appears. The machine keeps running: VT switching works, SSH works, and an external monitor plugged in during the freeze shows a picture while the laptop panel stays stuck. The usual PSR fix, amdgpu.dcdebugmask=0x10, changes nothing, and amdgpu.psr=0 changes nothing either. The kernel log is usually clean at the moment it happens.

Cause

Panel Replay is a newer eDP self-refresh mode, separate from Panel Self Refresh v1 and PSR Selectively Updated. amdgpu enables it when the panel advertises support. The panel keeps showing its own stored frame, and a broken entry or exit path on some panel and firmware combinations produces flicker, or a panel that never takes a new frame.

amdgpu.dcdebugmask is a bitmask over enum DC_DEBUG_MASK in drivers/gpu/drm/amd/include/amd_shared.h. Three bits matter here:

  • DC_DISABLE_PSR = 0x10 disables PSR v1 and PSR-SU
  • DC_DISABLE_PSR_SU = 0x200 disables PSR-SU only
  • DC_DISABLE_REPLAY = 0x400 disables Panel Replay

So 0x10, the value most guides give, leaves Panel Replay switched on. Upstream reports match this:

  • drm/amd #5519: ASUS Zenbook S16 with a Ryzen AI 9 465 (DCN 3.5) and a Samsung ATNA60HR07-0 OLED. Every 7.0.x and 7.1.x kernel tested froze the panel at the Wayland greeter and 6.19.14 worked. 0x10 did not help and 0x400 alone fixed it.
  • drm/amd #5772: Radeon 780M IdeaPad flicker. amdgpu.psr=0 and 0x10 did not help and 0x410 fixed it.
  • drm/amd #3912: Framework 16, full-screen apps refreshing late or only on input. 0x400 fixed it.
  • drm/amd #3344: a Framework 16 flicker regression in 6.9. A second bisection, run with the first bad commit (enabling freesync) already applied, landed on "drm/amd/display: Enable Panel Replay for static screen use case".

In #5561, a TUXEDO vendor kernel sets amdgpu.dcdebugmask=0x610 by default, which is PSR, PSR-SU and Replay all off.

amdgpu.psr is not a parameter at all. modinfo -p amdgpu on kernel 7.2.5 lists dcdebugmask, dcfeaturemask and abmlevel, but no psr, so that advice is a silent no-op.

Fix

**1. Confirm the panel uses Panel Replay** (root, debugfs):


sudo sh -c 'for d in /sys/kernel/debug/dri/*/eDP-*; do echo "$d"; cat "$d/replay_capability" "$d/psr_capability" 2>/dev/null; done'

If replay_capability prints Sink support: yes and Driver support: yes, this record applies.

**2. Pick the value.** dcdebugmask is one bitmask and a 0444 parameter, so it is read only at boot. If the parameter appears twice on the command line, the last one wins. Combine bits into a single value:

| value | disables | |---|---| | 0x400 | Panel Replay only. Start here | | 0x410 | Panel Replay plus PSR v1 and PSR-SU | | 0x610 | Panel Replay, PSR and PSR-SU explicitly |

If you already carry amdgpu.dcdebugmask=0x10 from the flip_done record, replace it with 0x410. Do not add a second entry.

**3. Omarchy 4 (Limine + UKI).** The command line is baked into /boot/EFI/Linux/omarchy_linux.efi, and /boot/limine.conf is regenerated, so use your own drop-in with +=:


sudo tee -a /etc/limine-entry-tool.d/zz-local.conf >/dev/null <<'EOF'
# `+=` appends. A bare `=` would wipe Omarchy's own defaults.
KERNEL_CMDLINE[default]+=" amdgpu.dcdebugmask=0x400"
EOF
sudo limine-mkinitcpio && sudo limine-update && sudo reboot

To test once without writing anything, see the record limine-kernel-parameters-not-applying-omarchy. A Limine menu edit must keep the whole existing command line, because it replaces it.

**4. Plain Arch and derivatives:**

  • Limine with limine-mkinitcpio-hook installed: the same drop-in, then sudo limine-update
  • Limine without that hook: append the parameter to the cmdline: line of your entry in /boot/limine.conf (or wherever your limine.conf lives on the ESP)
  • systemd-boot: append to options in /boot/loader/entries/*.conf
  • GRUB:

sudo sed -i 's/^GRUB_CMDLINE_LINUX_DEFAULT="/&amdgpu.dcdebugmask=0x400 /' /etc/default/grub
sudo grub-mkconfig -o /boot/grub/grub.cfg

Reboot.

If 0x400 stops the freeze but some flicker remains, move to 0x410, then 0x610, one reboot each.

Verify


cat /sys/module/amdgpu/parameters/dcdebugmask   # 1024 for 0x400, 1040 for 0x410, 1552 for 0x610
cat /proc/cmdline

On Omarchy 4, /proc/cmdline must still contain Omarchy's defaults (quiet splash loglevel=0 ... initramfs_async=0). Then use the desktop normally on a bright page, or log out and back in to the greeter: the panel must keep updating and not flicker.

Sources

amdgpu-panel-replay-flicker-or-frozen-edp