Skip to content

Commit ef75228

Browse files
Stensel8Stensel8
committed
Document hybrid brightness regression
Add English and Dutch documentation for the brightness regression caused by Integrated-mode kernel parameters in Hybrid/Ultimate GPU modes. Move the mode-specific workaround into a new active issue and keep the resolved issue focused on the Integrated-only fix.
1 parent 705ecfa commit ef75228

2 files changed

Lines changed: 72 additions & 50 deletions

File tree

‎src/content/docs/known-issues.md‎

Lines changed: 36 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,41 @@ See the **Things I Wished Had Worked** section at the bottom of this page for th
5252

5353
{{% /details %}}
5454

55+
{{% details title="Fixing brightness in Integrated mode breaks it in Hybrid/Ultimate mode" closed="true" %}}
56+
57+
**What's happening:**
58+
The Integrated-mode brightness fix documented in the resolved issue above (`acpi_backlight=native amdgpu.backlight=0`) only fixes brightness in Integrated mode. If those same two kernel parameters stay in `GRUB_CMDLINE_LINUX_DEFAULT` when booting into Hybrid or Ultimate, brightness breaks there instead, even though it worked fine before via `nvidia_wmi_ec_backlight`.
59+
60+
Confirmed on CachyOS: same two parameters active, GPU mode switched to Hybrid via ROG Control (reboot required, `nvidia-smi -L` confirms the RTX 4060 is back). `/sys/class/backlight/` shows `amdgpu_bl2` and `nvidia_0` (no `nvidia_wmi_ec_backlight`, since `acpi_backlight=native` suppresses it regardless of GPU mode). Writing to *either* device succeeds (value reads back) but has zero visible effect on the panel, and the GNOME slider does nothing.
61+
62+
Working theory: in Hybrid mode the eDP panel may not actually be routed to the AMD iGPU by the hardware MUX the way Integrated mode routes it. `amdgpu.backlight=0` forces PWM signalling on `amdgpu_bl2`, but if `amdgpu_bl2` isn't the GPU actually driving the connector in this mode, that's moot. `nvidia_0`'s lack of effect might instead be explained by `nvidia.NVreg_EnableBacklightHandler=0`, a parameter that's been in the cmdline since early testing on the issue above (when it had no effect on `nvidia_wmi_ec_backlight`) but was never tested against `nvidia_0`, a device that only exists once `acpi_backlight=native` is set. If that flag disables the nvidia driver's backend for its own native backlight device, `nvidia_0` writes would succeed at the sysfs level while being silently dropped before reaching hardware. Not yet tested.
63+
64+
**Workaround:**
65+
There's no single `GRUB_CMDLINE_LINUX_DEFAULT` that works for every mode. Use whichever of these two matches the GPU mode you're switching to, since a mode change already needs a reboot on this hardware anyway:
66+
67+
**Integrated mode** (adds `acpi_backlight=native amdgpu.backlight=0`):
68+
```bash
69+
GRUB_CMDLINE_LINUX_DEFAULT='nowatchdog nvme_load=YES splash loglevel=3 nvidia.NVreg_EnableBacklightHandler=0 nvidia.NVreg_RegistryDwords=EnableBrightnessControl=0 acpi_backlight=native amdgpu.backlight=0'
70+
```
71+
72+
**Hybrid or Ultimate mode** (leaves the backlight interface at its working default):
73+
```bash
74+
GRUB_CMDLINE_LINUX_DEFAULT='nowatchdog nvme_load=YES splash loglevel=3 nvidia.NVreg_EnableBacklightHandler=0 nvidia.NVreg_RegistryDwords=EnableBrightnessControl=0'
75+
```
76+
77+
Both include the base CachyOS boot flags from this install (`nowatchdog nvme_load=YES splash loglevel=3`) plus the two NVIDIA parameters ruled out in the issue above, kept in both since they've never shown a negative effect. If your own `GRUB_CMDLINE_LINUX_DEFAULT` has different base flags, or you're on Bazzite (`grub2-mkconfig`, different config path), keep your existing flags and just add or drop `acpi_backlight=native amdgpu.backlight=0` at the end when you switch modes.
78+
79+
After editing `/etc/default/grub`:
80+
```bash
81+
sudo grub-mkconfig -o /boot/grub/grub.cfg
82+
sudo reboot
83+
```
84+
85+
**Status:**
86+
Open. The two-config workaround works but has to be redone by hand on every mode switch. Next thing to try: dropping `nvidia.NVreg_EnableBacklightHandler=0` while keeping the other two Integrated-mode parameters, then testing `nvidia_0` in Hybrid.
87+
88+
{{% /details %}}
89+
5590
## Resolved Issues
5691

5792
The following issues are resolved. Some were fixed by kernel or driver updates, some through a configuration workaround, and some I honestly may have just been doing wrong myself. I kept them all here anyway since they might save someone else the same time.
@@ -98,31 +133,7 @@ sudo reboot
98133
**Confirmed working:**
99134
- CachyOS (kernel 7.2.5-1-cachyos), `acpi_backlight=native amdgpu.backlight=0` in `GRUB_CMDLINE_LINUX_DEFAULT`, rebooted into Integrated GPU mode. `ls /sys/class/backlight/` shows only `amdgpu_bl2`. Brightness responds correctly via both the Fn-key hotkeys and the GNOME quick-settings slider.
100135

101-
**⚠️ Not upstream, and Integrated-only: don't just drop this in `GRUB_CMDLINE_LINUX_DEFAULT` globally:** this is a local kernel boot parameter workaround, not a fix in `asusctl`, `amdgpu`, or ASUS firmware. Nothing changed upstream, and it only fixes brightness in Integrated mode. Applying it as a blanket default regresses Hybrid mode, which worked fine before via `nvidia_wmi_ec_backlight`:
102-
103-
- CachyOS, same two parameters active, GPU mode switched to Hybrid via ROG Control (reboot required, `nvidia-smi -L` confirms the RTX 4060 is back). `/sys/class/backlight/` now shows `amdgpu_bl2` and `nvidia_0` (no `nvidia_wmi_ec_backlight`, since `acpi_backlight=native` suppresses it regardless of GPU mode). Writing to *either* `amdgpu_bl2` or `nvidia_0` succeeds (value reads back) but has zero visible effect on the panel, and the GNOME slider does nothing. So the same two parameters that fix Integrated **break** Hybrid, which had working brightness before any of this.
104-
105-
Working theory for why: in Hybrid mode the eDP panel may not actually be routed to the AMD iGPU by the hardware MUX the way Integrated mode routes it. `amdgpu.backlight=0` forces PWM signalling on `amdgpu_bl2`, but if `amdgpu_bl2` isn't the GPU actually driving the connector in this mode, that's moot. `nvidia_0`'s lack of effect might instead be explained by `nvidia.NVreg_EnableBacklightHandler=0`, a parameter that's been in the cmdline since early testing above (when it had no effect on `nvidia_wmi_ec_backlight`) but was never tested against `nvidia_0`, a device that only exists once `acpi_backlight=native` is set. If that flag disables the nvidia driver's backend for its own native backlight device, `nvidia_0` writes would succeed at the sysfs level while being silently dropped before reaching hardware. Not yet tested, next thing to try.
106-
107-
Because of this regression, there's no single `GRUB_CMDLINE_LINUX_DEFAULT` that works for every mode. Use whichever of these two matches the GPU mode you're switching to, since a mode change already needs a reboot on this hardware anyway:
108-
109-
**Integrated mode** (adds `acpi_backlight=native amdgpu.backlight=0`):
110-
```bash
111-
GRUB_CMDLINE_LINUX_DEFAULT='nowatchdog nvme_load=YES splash loglevel=3 nvidia.NVreg_EnableBacklightHandler=0 nvidia.NVreg_RegistryDwords=EnableBrightnessControl=0 acpi_backlight=native amdgpu.backlight=0'
112-
```
113-
114-
**Hybrid or Ultimate mode** (leaves the backlight interface at its working default):
115-
```bash
116-
GRUB_CMDLINE_LINUX_DEFAULT='nowatchdog nvme_load=YES splash loglevel=3 nvidia.NVreg_EnableBacklightHandler=0 nvidia.NVreg_RegistryDwords=EnableBrightnessControl=0'
117-
```
118-
119-
Both include the base CachyOS boot flags from this install (`nowatchdog nvme_load=YES splash loglevel=3`) plus the two NVIDIA parameters ruled out earlier in this write-up, kept in both since they've never shown a negative effect. If your own `GRUB_CMDLINE_LINUX_DEFAULT` has different base flags, or you're on Bazzite (`grub2-mkconfig`, different config path), keep your existing flags and just add or drop `acpi_backlight=native amdgpu.backlight=0` at the end when you switch modes.
120-
121-
After editing `/etc/default/grub`:
122-
```bash
123-
sudo grub-mkconfig -o /boot/grub/grub.cfg
124-
sudo reboot
125-
```
136+
**⚠️ Not upstream, and Integrated-only:** this is a local kernel boot parameter workaround, not a fix in `asusctl`, `amdgpu`, or ASUS firmware. Nothing changed upstream, and it only fixes brightness in Integrated mode. Applying it as a blanket `GRUB_CMDLINE_LINUX_DEFAULT` default actually breaks brightness in Hybrid/Ultimate mode, which worked fine before via `nvidia_wmi_ec_backlight`. See the separate active issue below for that regression and the current workaround.
126137

127138
**Related, still separate:** getting the GPU *mode switch itself* to apply reliably is a different bug (#318 above) with its own workaround (write directly to the sysfs attribute that needs to change, bypassing asusd's batched write: see the firmware-attribute table in the "GPU mode switching" section of the [asusctl page]({{< relref "/docs/hardware/asusctl-rog-control" >}})), needed only on installs not yet on the fixed `asusctl` `6.5.0`.
128139

‎src/content/docs/known-issues.nl.md‎

Lines changed: 36 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,41 @@ Zie de sectie **Dingen die ik graag werkend had gezien** onderaan deze pagina vo
5252

5353
{{% /details %}}
5454

55+
{{% details title="Helderheid fixen in Integrated mode breekt het in Hybrid/Ultimate mode" closed="true" %}}
56+
57+
**Wat er gebeurt:**
58+
De Integrated-mode-helderheidsfix uit het opgeloste probleem hierboven (`acpi_backlight=native amdgpu.backlight=0`) lost de helderheid alleen op in Integrated mode. Blijven diezelfde twee kernelparameters in `GRUB_CMDLINE_LINUX_DEFAULT` staan bij het opstarten in Hybrid of Ultimate, dan breekt de helderheid daar juist, terwijl die daarvoor prima werkte via `nvidia_wmi_ec_backlight`.
59+
60+
Bevestigd op CachyOS: dezelfde twee parameters actief, GPU-mode via ROG Control naar Hybrid gewisseld (reboot vereist, `nvidia-smi -L` bevestigt dat de RTX 4060 terug is). `/sys/class/backlight/` toont `amdgpu_bl2` en `nvidia_0` (geen `nvidia_wmi_ec_backlight`, want `acpi_backlight=native` onderdrukt die ongeacht GPU-mode). Schrijven naar **beide** devices slaagt (waarde leest terug) maar heeft geen zichtbaar effect op het scherm, en de GNOME-slider doet niets.
61+
62+
Werktheorie: in Hybrid mode is het eDP-paneel via de hardware-MUX mogelijk niet daadwerkelijk naar de AMD-iGPU gerouteerd zoals in Integrated mode. `amdgpu.backlight=0` forceert PWM-signalering op `amdgpu_bl2`, maar als `amdgpu_bl2` niet de GPU is die de connector in deze mode daadwerkelijk aanstuurt, doet dat er niet toe. Het gebrek aan effect bij `nvidia_0` kan mogelijk verklaard worden door `nvidia.NVreg_EnableBacklightHandler=0`, een parameter die al sinds vroeg testen op het probleem hierboven in de cmdline staat (toen zonder effect op `nvidia_wmi_ec_backlight`) maar nooit getest is tegen `nvidia_0`, een device dat pas bestaat zodra `acpi_backlight=native` staat. Als die vlag de backend van de nvidia-driver voor zijn eigen native backlight-device uitschakelt, zouden writes naar `nvidia_0` op sysfs-niveau slagen terwijl ze stilletjes verdwijnen voor ze de hardware bereiken. Nog niet getest.
63+
64+
**Workaround:**
65+
Er bestaat geen enkele `GRUB_CMDLINE_LINUX_DEFAULT` die voor elke mode werkt. Gebruik welke van deze twee past bij de GPU-mode waar je naartoe wisselt, want een modewissel vereist op deze hardware toch al een reboot:
66+
67+
**Integrated mode** (voegt `acpi_backlight=native amdgpu.backlight=0` toe):
68+
```bash
69+
GRUB_CMDLINE_LINUX_DEFAULT='nowatchdog nvme_load=YES splash loglevel=3 nvidia.NVreg_EnableBacklightHandler=0 nvidia.NVreg_RegistryDwords=EnableBrightnessControl=0 acpi_backlight=native amdgpu.backlight=0'
70+
```
71+
72+
**Hybrid of Ultimate mode** (laat de backlight-interface op de werkende standaard staan):
73+
```bash
74+
GRUB_CMDLINE_LINUX_DEFAULT='nowatchdog nvme_load=YES splash loglevel=3 nvidia.NVreg_EnableBacklightHandler=0 nvidia.NVreg_RegistryDwords=EnableBrightnessControl=0'
75+
```
76+
77+
Beide bevatten de basis CachyOS-bootflags van deze installatie (`nowatchdog nvme_load=YES splash loglevel=3`) plus de twee NVIDIA-parameters die in het probleem hierboven zijn uitgesloten, in beide gehouden omdat ze nooit een negatief effect hebben laten zien. Heeft jouw eigen `GRUB_CMDLINE_LINUX_DEFAULT` andere basisflags, of zit je op Bazzite (`grub2-mkconfig`, ander configpad), houd dan je eigen flags aan en voeg alleen `acpi_backlight=native amdgpu.backlight=0` toe of haal die weg aan het eind wanneer je van mode wisselt.
78+
79+
Na het bewerken van `/etc/default/grub`:
80+
```bash
81+
sudo grub-mkconfig -o /boot/grub/grub.cfg
82+
sudo reboot
83+
```
84+
85+
**Status:**
86+
Open. De workaround met twee configs werkt, maar moet handmatig herhaald worden bij elke modewissel. Volgende stap: `nvidia.NVreg_EnableBacklightHandler=0` weghalen met de andere twee Integrated-mode-parameters erin, en dan `nvidia_0` testen in Hybrid.
87+
88+
{{% /details %}}
89+
5590
## Opgeloste Problemen
5691

5792
De volgende problemen zijn opgelost. Sommige zijn verholpen door kernel- of driver-updates, andere via een configuratiewijziging, en eerlijk gezegd heb ik een aantal dingen misschien gewoon zelf fout gedaan. Ik heb ze hier toch bewaard, want misschien bespaar ik iemand anders dezelfde zoektocht.
@@ -98,31 +133,7 @@ sudo reboot
98133
**Bevestigd werkend:**
99134
- CachyOS (kernel 7.2.5-1-cachyos), `acpi_backlight=native amdgpu.backlight=0` in `GRUB_CMDLINE_LINUX_DEFAULT`, herstart in Integrated GPU-mode. `ls /sys/class/backlight/` toont alleen `amdgpu_bl2`. De helderheid reageert correct via zowel de Fn-toetsen als de GNOME quick-settings slider.
100135

101-
**⚠️ Niet upstream, en alleen voor Integrated: zet dit niet zomaar globaal in `GRUB_CMDLINE_LINUX_DEFAULT`:** dit is een lokale kernel-bootparameter-workaround, geen fix in `asusctl`, `amdgpu`, of ASUS-firmware. Er is niets upstream veranderd, en het lost de helderheid alleen op in Integrated mode. Als blanket default toegepast, regresseert het Hybrid mode, dat daarvoor prima werkte via `nvidia_wmi_ec_backlight`:
102-
103-
- CachyOS, dezelfde twee parameters actief, GPU-mode via ROG Control naar Hybrid gewisseld (reboot vereist, `nvidia-smi -L` bevestigt dat de RTX 4060 terug is). `/sys/class/backlight/` toont nu `amdgpu_bl2` en `nvidia_0` (geen `nvidia_wmi_ec_backlight`, want `acpi_backlight=native` onderdrukt die ongeacht GPU-mode). Schrijven naar **beide** `amdgpu_bl2` en `nvidia_0` slaagt (waarde leest terug) maar heeft geen zichtbaar effect op het scherm, en de GNOME-slider doet niets. Dezelfde twee parameters die Integrated fixen, **breken** dus Hybrid, dat daarvoor werkende helderheid had.
104-
105-
Werktheorie waarom: in Hybrid mode is het eDP-paneel via de hardware-MUX mogelijk niet daadwerkelijk naar de AMD-iGPU gerouteerd zoals in Integrated mode. `amdgpu.backlight=0` forceert PWM-signalering op `amdgpu_bl2`, maar als `amdgpu_bl2` niet de GPU is die de connector in deze mode daadwerkelijk aanstuurt, doet dat er niet toe. Het gebrek aan effect bij `nvidia_0` kan mogelijk verklaard worden door `nvidia.NVreg_EnableBacklightHandler=0`, een parameter die al sinds vroeg testen hierboven in de cmdline staat (toen zonder effect op `nvidia_wmi_ec_backlight`) maar nooit getest is tegen `nvidia_0`, een device dat pas bestaat zodra `acpi_backlight=native` staat. Als die vlag de backend van de nvidia-driver voor zijn eigen native backlight-device uitschakelt, zouden writes naar `nvidia_0` op sysfs-niveau slagen terwijl ze stilletjes verdwijnen voor ze de hardware bereiken. Nog niet getest, volgende stap.
106-
107-
Door deze regressie bestaat er geen enkele `GRUB_CMDLINE_LINUX_DEFAULT` die voor elke mode werkt. Gebruik welke van deze twee past bij de GPU-mode waar je naartoe wisselt, want een modewissel vereist op deze hardware toch al een reboot:
108-
109-
**Integrated mode** (voegt `acpi_backlight=native amdgpu.backlight=0` toe):
110-
```bash
111-
GRUB_CMDLINE_LINUX_DEFAULT='nowatchdog nvme_load=YES splash loglevel=3 nvidia.NVreg_EnableBacklightHandler=0 nvidia.NVreg_RegistryDwords=EnableBrightnessControl=0 acpi_backlight=native amdgpu.backlight=0'
112-
```
113-
114-
**Hybrid of Ultimate mode** (laat de backlight-interface op de werkende standaard staan):
115-
```bash
116-
GRUB_CMDLINE_LINUX_DEFAULT='nowatchdog nvme_load=YES splash loglevel=3 nvidia.NVreg_EnableBacklightHandler=0 nvidia.NVreg_RegistryDwords=EnableBrightnessControl=0'
117-
```
118-
119-
Beide bevatten de basis CachyOS-bootflags van deze installatie (`nowatchdog nvme_load=YES splash loglevel=3`) plus de twee NVIDIA-parameters die eerder in dit stuk zijn uitgesloten, in beide gehouden omdat ze nooit een negatief effect hebben laten zien. Heeft jouw eigen `GRUB_CMDLINE_LINUX_DEFAULT` andere basisflags, of zit je op Bazzite (`grub2-mkconfig`, ander configpad), houd dan je eigen flags aan en voeg alleen `acpi_backlight=native amdgpu.backlight=0` toe of haal die weg aan het eind wanneer je van mode wisselt.
120-
121-
Na het bewerken van `/etc/default/grub`:
122-
```bash
123-
sudo grub-mkconfig -o /boot/grub/grub.cfg
124-
sudo reboot
125-
```
136+
**⚠️ Niet upstream, en alleen voor Integrated:** dit is een lokale kernel-bootparameter-workaround, geen fix in `asusctl`, `amdgpu`, of ASUS-firmware. Er is niets upstream veranderd, en het lost de helderheid alleen op in Integrated mode. Als blanket default in `GRUB_CMDLINE_LINUX_DEFAULT` toegepast, breekt het juist de helderheid in Hybrid/Ultimate mode, die daarvoor prima werkte via `nvidia_wmi_ec_backlight`. Zie het aparte actieve probleem hieronder voor die regressie en de huidige workaround.
126137

127138
**Gerelateerd, maar apart:** de GPU-*modewissel zelf* betrouwbaar laten toepassen is een andere bug (#318 hierboven) met een eigen workaround (rechtstreeks schrijven naar het sysfs-attribuut dat moet veranderen, buiten asusd's batch-write om: zie de firmware-attributentabel in de sectie "GPU mode switching" op de [asusctl-pagina]({{< relref "/docs/hardware/asusctl-rog-control" >}})), alleen nodig op installaties die nog niet op de gefixte `asusctl` `6.5.0` zitten.
128139

0 commit comments

Comments
 (0)