Просмотр кода страницы Backlight

{{stub}}
Иногда, при использовании Linux, могут возникнуть сложности с контролем яркости экрана. На некоторых компьютерах может отсутствовать физический переключатель, а программные решения могут работать некорректно. Тем не менее, возможно найти рабочий способ для вашего оборудования. Цель данной статьи — собрать все возможные способы регулировки подсветки.

Данные способы можно разделить на следующие категории:

* яркость управляется горячей клавишей, определённой производителем, и нет интерфейса для того, чтобы ОС могла настраивать яркость;
* яркость можно контролировать через [[#ACPI|ACPI]], через графический драйвер или драйвер платформы. В этом случае управление подсветкой доступно пользователю через {{path|<nowiki>/sys/class/backlight</nowiki>}}, который может использоваться [[#Утилиты настройки|утилитами настройки]];
* яркость можно контролировать посредством аппаратного регистра с помощью [[#setpci|setpci]].

{{Note|Поскольку OLED-экраны не имеют подсветки, менять яркость на ноутбуках с OLED-экранами путём изменения яркости подсветки не получится. В этом случае воспринимаемую яркость экрана можно регулировать с помощью ШИМ-управления (не реализовано в ядре Linux) или с помощью [[#Цветовая коррекция|программной цветокоррекции]].}}

== Аппаратные интерфейсы ==

=== ACPI ===

Яркость подсветки экрана регулируется установкой уровня питания светодиодов или катодов. Зачастую уровень питания можно контролировать с помощью ACPI модуля ядра для видео. Интерфейс к этому модулю доступен через {{cmd|man 5 sysfs}} в {{path|/sys/class/backlight/}}.

Имя каталога зависит от модели видеокарты.

<syntaxhighlight lang="bash">
$ ls /sys/class/backlight/
acpi_video0
</syntaxhighlight>

В данном случае подсветкой управляет видеокарта ATI. В случае с картой Intel каталог будет называться {{cmd|intel_backlight}}. В следующих примерах используется {{cmd|acpi_video0}}. Если вы используете карту Intel, просто замените в примерах {{cmd|acpi_video0}} на {{cmd|intel_backlight}}.

Каталог содержит следующие файлы и подкаталоги:

<syntaxhighlight lang="bash">
$ ls /sys/class/backlight/acpi_video0/
actual_brightness  brightness         max_brightness     subsystem/    uevent
bl_power           device/            power/             type
</syntaxhighlight>

Максимальную яркость можно прочитать из файла {{path|max_brightness}}, и она обычно равна 15.

<syntaxhighlight lang="bash">
$ cat /sys/class/backlight/acpi_video0/max_brightness|
15
</syntaxhighlight>

Яркость можно изменить путём записи числа в файл {{path|brightness}}. Установить яркость выше максимальной не получится.

<syntaxhighlight lang="bash">
 # echo 5 > /sys/class/backlight/acpi_video0/brightness
</syntaxhighlight>

По умолчанию только {{cmd|root}} может менять яркость таким способом. Чтобы управлять яркостью могли пользователи из группы {{cmd|video}}, можно использовать правило udev (для применения может понадобиться перезагрузка):

<syntaxhighlight lang="bash">
 $ mcedit /etc/udev/rules.d/backlight.rules
</syntaxhighlight>
<syntaxhighlight lang="bash">
ACTION=="add", SUBSYSTEM=="backlight", RUN+="/bin/chgrp video $sys$devpath/brightness", RUN+="/bin/chmod g+w $sys$devpath/brightness"</syntaxhighlight>

==== Параметры ядра ====

Иногда ACPI не работает должным образом из-за различных реализаций материнских плат и особенностей ACPI, что может приводить, например, к некорректным уведомлениям о яркости. Этому могут быть подвержены некоторые ноутбуки с двойной графикой (например, дискретная видеокарта NVIDIA/AMD вместе с интегрированной Intel/AMD). Кроме того, иногда для ACPI может быть необходимо зарегистрировать свою собственную подсветку {{cmd|acpi_video0}}, даже если уже существует другая (например, {{cmd|intel_backlight}}), что может быть достигнуто добавлением следующих параметров ядра:

 acpi_backlight=video
 acpi_backlight=vendor
 acpi_backlight=native

{{Совет|
* На ноутбуках NVIDIA Optimus параметр ядра {{cmd|nomodeset}} может препятствовать регулировке подсветки.
* На ноутбуках Asus вам может также понадобиться загрузить модуль ядра {{cmd|asus-nb-wmi}}.
* Отключение legacy-загрузки на Dell XPS13 приводит к невозможности изменить подсветку.
* В Linux 6.1 подсистема подсветки была [https://hansdegoede.livejournal.com/26427.html переработана]. Если после обновления подсветка не работает, сперва попробуйте удалить существующий параметр ядра {{cmd|acpi_backlight}}. На некоторых ноутбуках Optimus можно попробовать загрузиться с параметром {{cmd|1=acpi_backlight=nvidia_wmi_ec}}.
}}

==== Правило udev ====
Если доступен интерфейс ACPI, уровень подсветки может быть установлен во время загрузки с помощью правила udev:
<syntaxhighlight lang="bash">
/etc/udev/rules.d/81-backlight.rules
</syntaxhighlight>
<syntaxhighlight lang="bash">
# Установить уровень подсветки равным 8
SUBSYSTEM=="backlight", ACTION=="add", KERNEL=="acpi_video0", ATTR{brightness}="8"
</syntaxhighlight>
{{Примечание|Служба systemd-backlight восстанавливает предыдущий уровень яркости подсветки во время загрузки. Для предотвращения конфликта с этим правилом смотрите раздел [[#Сохранение и восстановление|Сохранение и восстановление]].}}

=== setpci ===

В некоторых случаях (например, Intel Mobile 945GME [https://bugs.launchpad.net/ubuntu/+source/xserver-xorg-video-intel/+bug/397617]) можно задать регистр видеокарты для регулировки подсветки. Это означает регулировку подсветки путём непосредственного манипулирования оборудованием, что может быть рискованно и, как правило, не является хорошей идеей. Не все видеокарты поддерживают этот метод.

При использовании этого метода сперва используйте {{cmd|lspci}}, чтобы узнать, где находится ваша видеокарта.

 # setpci -s 00:02.0 F4.B=0

=== Внешние мониторы ===

[https://ru.wikipedia.org/wiki/Display_Data_Channel#Стандарт VESA DDC/CI DDC/CI] (Display Data Channel Command Interface — командный интерфейс обмена данными между компьютером и монитором) может использоваться для связи с внешними мониторами, реализующими стандарт MCCS (Monitor Control Command Set) по шине I2C.

DDC может контролировать яркость, контрастность, входы и т.д. на поддерживаемых мониторах. Настройки, доступные с панели OSD (экранное меню), также могут управляться через DDC.

Может понадобиться загрузить модуль ядра {{cmd|i2c-dev}}, если устройства {{cmd|/dev/i2c-*}} отсутствуют.

Для получения или изменения яркости можно использовать {{path|ddcutil}}:

<syntaxhighlight lang="bash">
 # apt-get install ddcutil
</syntaxhighlight>

<syntaxhighlight lang="bash">
# ddcutil capabilities | grep "Feature: 10"
  Feature: 10 (Brightness)
</syntaxhighlight>

<syntaxhighlight lang="bash">
# ddcutil getvcp 10
VCP code 0x10 (Brightness                    ): current value =    60, max value =   100
</syntaxhighlight>

<syntaxhighlight lang="bash">
 # ddcutil setvcp 10 70
</syntaxhighlight>

{{Note|
* {{cmd|ddcutil}} может не работать с некоторыми возможностями VCP, если на мониторе включена функция, которая уже автоматически их настраивает (например, [https://en.wikipedia.org/wiki/Contrast_ratio#Dynamic_contrast_.28DC.29 Dynamic Contrast Ratio] или BenQ ''Eye Care'').
* Чтобы упростить настройку горячих клавиш для управления яркостью, может быть удобно предоставить доступ обычному пользователю к соответствующим устройствам I2C. Для этого создайте группу {{cmd|i2c}} и настройте udev на назначение этой группы устройствам I2C. [https://raspberrypi.stackexchange.com/a/4472]
* Пакет {{pkg|ddcutil}} предоставляет файл {{path|/usr/share/ddcutil/data/90-nvidia-i2c.conf}}, который можно скопировать в {{path|/etc/X11/xorg.conf.d/}} вместо ручной настройки Xorg. Также он предоставляет правила udev {{path|/usr/share/ddcutil/data/45-ddcutil-i2c.rules}} и {{path|/usr/share/ddcutil/data/45-ddcutil-usb.rules}}.
}}
== Выключение подсветки ==

Выключение подсветки (например, при закрытии крышки ноутбука) может быть полезно для сохранения заряда батареи. Выполните следующую команду:

 $ xset dpms force off

Подсветка должна включиться снова при движении мыши или вводе с клавиатуры.

== Сохранение и восстановление ==

Пакет [[systemd]] предоставляет «static» службу {{cmd|systemd-backlight@.service}}, которая включена по умолчанию. Она сохраняет яркость подсветки во время выключения ПК и восстанавливает при включении. Эта служба использует метод ACPI, описанный в разделе [[#ACPI]], создавая службы для каждого каталога, найденного в {{path|/sys/class/backlight/}}. Например, если есть каталог {{path|acpi_video0}}, она создаст службу {{cmd|systemd-backlight@backlight:acpi_video0.service}}. Если вы используете другие методы установки яркости во время загрузки, рекомендуется отключить systemd-backlight путём добавления параметра ядра {{cmd|<nowiki>systemd.restore_state=0</nowiki>}}. Смотрите {{cmd|man systemd-backlight@.service}} для более подробной информации.

{{Note|Некоторые ноутбуки имеют несколько видеокарт (например, Optimus) и восстановление подсветки может не сработать. Попробуйте [[http://wiki.archlinux.org/title/Systemd_(Русский)#Использование_юнитов замаскировать]] отдельный экземпляр этой службы, например {{cmd|systemd-backlight@backlight:acpi_video1}} в случае {{cmd|acpi_video1}}.}}
Кроме того, утилита {{pkg|light}} поддерживает функцию сохранения и восстановления. Эта утилита может быть более полезна, если вы хотите сохранять яркость для отдельных пользователей, однако для этого не предусмотрено никаких юнитов systemd.

== Утилиты настройки ==

{{Note|Приведённые в таблице утилиты можно использовать для управления яркостью экрана. Все они совместимы с Wayland и не требуют X. Некоторые (например, {{pkg|light}}) добавляют правила udev, разрешающие пользователям из группы {{cmd|video}} (или {{cmd|input}}) изменять яркость.}}

{| class="wikitable sortable"
! Пакет
! Управление подсветкой клавиатуры
! Реагирование на освещённость
! Язык
! Лицензия
! Примечания
|-
| {{Pkg|acpilight}}
| {{Есть}}
| {{Нет}}
| Python3
| GPL 3.0 или новее
| Предоставляет исполняемый файл «xbacklight»
|-
| {{pkg|xbacklight}}
| {{Нет}}
| {{Нет}}
| C
| MIT
| Простой демон уведомлений для X11 (считывает RandR-свойство backlight)
|}

{{Note|Команды для запуска этих утилит можно привязать к клавишам {{cmd|XF86MonBrightnessUp}} и {{cmd|XF86MonBrightnessDown}}}}

=== xbacklight ===
Яркость может быть установлена с помощью пакета {{Pkg|xbacklight}}.

{{Note|
* xbacklight работает только с Intel. Другие драйверы не поддерживают RandR-свойство backlight.
* xbacklight в настоящий момент не работает с драйвером modesetting [https://gitlab.freedesktop.org/xorg/xserver/issues/47].
}}

Чтобы установить яркость в 50% от максимальной:

 $ xbacklight -set 50

Приращения могут использоваться вместо абсолютных значений, например, для увеличения или уменьшения яркости на 10%:

 $ xbacklight -inc 10
 $ xbacklight -dec 10

Если вы получаете ошибку «No outputs have backlight property», это потому, что xrandr/xbacklight не выбирает правильный каталог в {{path|/sys/class/backlight}}. Вы можете указать каталог, задав опцию {{cmd|Backlight}} в разделе {{cmd|Device}} в файле {{path|/etc/X11/xorg.conf.d/20-''video''.conf}}. Например, если имя каталога {{path|intel_backlight}} и используется драйвер Intel, раздел {{cmd|Device}} может выглядеть так:

<syntaxhighlight lang="bash">
/etc/X11/xorg.conf.d/20-intel.conf
</syntaxhighlight>

<syntaxhighlight lang="bash">
Section "Device"
    Identifier  "Intel Graphics"
    Driver      "intel"
    Option      "Backlight"  "intel_backlight"
EndSection}}
</syntaxhighlight>

{{Note|Использование этого в связке со встроенной и дискретной видеокартами может привести к непредсказуемым задержкам обновления экрана и/или мерцанию интерфейса в приложениях, которые работают на дискретной видеокарте. Используйте это только в том случае, если всё остальное не помогает.}}

Если у вас включена функция Intel Fastboot, может возникнуть ошибка {{cmd|No outputs have backlight property}}. В этом случае попытка применить описанный выше метод может привести к сбою Xorg при запуске. Чтобы решить проблему, Fastboot следует отключить. [https://bugs.freedesktop.org/show_bug.cgi?id=108225 Известно], что он вызывает проблемы с управлением яркостью.

=== Использование DBus с GNOME ===

Яркость также можно регулировать с помощью настроек gnome. При использовании этого метода изменения отражаются в интерфейсе gnome.

 $ gdbus call --session --dest org.gnome.SettingsDaemon.Power --object-path /org/gnome/SettingsDaemon/Power --method org.freedesktop.DBus.Properties.Set org.gnome.SettingsDaemon.Power.Screen Brightness "<int32 50>"

Пошаговое изменение яркости (для контроля с клавиатуры) также может быть реализовано этим методом.

 $ gdbus call --session --dest org.gnome.SettingsDaemon.Power --object-path /org/gnome/SettingsDaemon/Power --method org.gnome.SettingsDaemon.Power.Screen.StepUp
 $ gdbus call --session --dest org.gnome.SettingsDaemon.Power --object-path /org/gnome/SettingsDaemon/Power --method org.gnome.SettingsDaemon.Power.Screen.StepDown

=== Использование DBus с KDE ===

Смотрите https://userbase.kde.org/KDE_Connect/Tutorials/Useful_commands#Brightness_settings.

== Цветовая коррекция ==

Цветокоррекция не меняет яркость подсветки, а просто меняет [https://en.wikipedia.org/wiki/Lookup_table#Lookup_tables_in_image_processing LUT], то есть не влияет на время работы от батареи. Тем не менее, она может быть полезна, когда управление подсветкой недоступно (на настольных ПК или ноутбуках с OLED-экранами).

* '''Monica''' - инструмент для калибровки монитора. Работает как фронтенд к xgamma для изменения гамма-коррекции. - [https://web.archive.org/web/20090815224839/http://www.pcbypaul.com/software/monica.html Оф.сайт] - пакет: {{pkg|monica}}
* '''Redshift''' - инструмент для настройки цветовой температуры. Регулирует цветовую температуру изображения в зависимости от окружения. Это может снизить нагрузку на глаза, если вы работаете по ночам. Вдохновлён программой [https://ru.wikipedia.org/wiki/F.lux f.lux] - [http://jonls.dk/redshift/ Оф. сайт] - пакет: {{pkg|redshift}}
* '''xcalib''' - лёгкий загрузчик параметров калибровки монитора. Может загружать ICC-профиль монитора для совместного использования в настольных приложениях. - [https://github.com/OpenICC/xcalib Оф. сайт] - пакет: {{pkg|xcalib}}
* '''xgamma''' - Настройка гамма-коррекции монитора. - [https://xorg.freedesktop.org/ Оф. сайт] - пакет: {{pkg|xgamma}}
===Приложения===
====Monica====
Установка:
 # apt-get install monica

Для запуска введите в консоли:
 $ monica

====Redshift====
Установка:
 # apt-get install redshift
Запуск службы (служба запускается от обычного пользователя):
 $ systemctl --user enable --now redshift

Автонастройка местоположения не работает из-за Geoclue2. Но настройку можно сделать вручную.

Создаем файл 
 $ mcedit $HOME/.config/redshift.conf
Копируем в него следующее содержимое:
<syntaxhighlight lang="bash">
[redshift]
; Set the day and night screen temperatures
temp-day=6500
temp-night=5500

; enabling smooth transition
transition=1

adjustment-method=randr

; Now specify the location manually
location-provider=manual

[manual]
; use the Internet to get your latitudes and longitudes
lat=52.4064
lon=16.9252
</syntaxhighlight>

lat/lon - Latitudes и longitudes - Широта и долгота. Открываем карты (Google, Яндекс), находим свое местоположение, находим координаты и вставляем их в конфигурационный файл. 

Перезапускаем службу:

 $ systemctl --user restart redshift

=== Wayland ===

Redshift не поддерживает Wayland (но есть форк {{pkg|redshift-wayland-git}}). В Альте пока нет! Можно применить нужную температуру в tty перед запуском композитора.

Например:

 $ redshift -m drm -PO 3000

Некоторые композиторы позволяют применять цветокоррекцию во время работы:

* Для [[GNOME]] можно использовать встроенный '''Night Light''' - Ночной свет.
* Для [[KDE]] можно использовать встроенную Ночную цветовую схему.

{{Note|Ни в GNOME, ни в KDE не работает ночной режим в Wayland на видеокартах [[NVIDIA]] из-за того, что драйвер не поддерживает некоторые функции LUT. Смотрите [https://github.com/NVIDIA/open-gpu-kernel-modules/issues/162 issue 162] на GitHub и [https://pointieststick.com/2023/05/26/this-week-in-kde-night-color-on-wayland-with-nvidia/ эту новость] о попытках разработчиков KDE заставить это работать.}}
=== Xorg: настройка воспринимаемой яркости с помощью xrandr ===

Можно использовать [[Xrandr]] для изменения воспринимаемой яркости.

Для установки воспринимаемой яркости выше максимального уровня (действуют вышеупомянутые предостережения для NVIDIA):

 $ xrandr --output ''название_вывода'' --brightness 2

Это должно примерно вдвое увеличить яркость изображения. Это приведёт к снижению качества цвета в пользу яркости, тем не менее оно особенно подходит для ситуаций, когда окружающий свет очень яркий (например, солнечный свет).

Это также можно использовать для уменьшения воспринимаемой яркости в тёмной комнате, указав значение меньше 1 (например, 0.5). Это полезно, когда нет возможности регулировать подсветку (например, на настольном компьютере).

Определить ''название вывода'' подключенного устройства можно такой командой:

 $ xrandr | grep -w connected | cut -f '1' -d ' '

Для удобства можно сделать псевдоним:

 $ alias b='echo -e "Введите яркость:\n"; read val; xrandr --output ''название_вывода'' --brightness "${val}"'

=== NVIDIA settings ===

Пользователи проприетарных драйверов [[Nvidia|NVIDIA]] могут менять яркость дисплея с помощью утилиты '''nvidia-settings''' в разделе «X Server Color Correction». Однако имейте в виду, что это не имеет ничего общего с подсветкой (Интенсивность), она всего лишь регулирует цветность. (Уменьшение яркости таким образом не является энергоэффективным. Используйте его в последнюю очередь, если все другие варианты не срабатывают; увеличение яркости портит цвета на экране полностью, по аналогии с засвеченностью фотографий.)

== Решение проблем ==

=== Частота ШИМ-модуляции подсветки (только для Intel i915) ===

Известно, что на ноутбуках со светодиодной подсветкой иногда мерцает экран. Это объясняется тем, что наиболее эффективным способом управления яркостью подсветки светодиодов является быстрое включение и выключение светодиодов, изменяя время их свечения.

Однако частота переключения, так называемая частота ШИМ (широтно-импульсная модуляция) может быть недостаточно высокой, чтобы глаз воспринимал её как непрерывное свечение, и вместо этого видно мерцание. Это вызывает у некоторых людей такие симптомы, как головные боли и усталость глаз.

Если у вас графический адаптер Intel i915, то возможно настроить частоту ШИМ, чтобы устранить мерцание.

Период ШИМ (обратно пропорциональный частоте) записывается в 2 старших байта регистра {{cmd|0xC8254}} (если вы используете чипсет Intel GM45, вместо этого используйте адрес {{cmd|0x61254}}). Чтобы манипулировать значениями регистров, [[Команды_APT#Установка_пакетов|установите]] пакет {{pkg|igt-gpu-tools}}. 

Чтобы увеличить частоту, период должен быть уменьшен. Например:

<syntaxhighlight lang="bash">
# intel_reg read 0xC8254
0xC8254 : 0x12281228
</syntaxhighlight>

Затем, чтобы удвоить частоту ШИМ, разделите 2 старших байта (4 шестнадцатеричные цифры) на 2 и запишите полученное значение, сохраняя нижние байты неизменными:

 # intel_reg write 0xC8254 0x09141228

Вы можете использовать онлайн-калькулятор для расчета желаемого значения: https://devbraindom.blogspot.com/2013/03/eliminate-led-screen-flicker-with-intel.html

Чтобы установить новую частоту автоматически, попробуйте написать правило udev.

=== Не работает управление яркостью панели eDP (только для Intel i915) ===

Embedded Display Port (eDP) v1.2 добавил новый протокол управления панелью дисплея для подсветки и других элементов управления, который работает через канал AUX [https://www.vesa.org/wp-content/uploads/2010/12/DisplayPort-DevCon-Presentation-eDP-Dec-2010-v3.pdf]

По умолчанию драйвер i915 пытается использовать ШИМ для управления яркостью подсветки, что может не сработать.

Чтобы менять подсветку путём записи в регистры DPCD по каналу AUX, пропишите параметр ядра {{cmd|1=i915.enable_dpcd_backlight=1}}.

=== sysfs редактируется, но яркость не меняется ===
{{Note|Такое поведение и способы его обхода были подтверждены на Dell M6700 с Nvidia K5000m (версия BIOS до A10) и Clevo P750ZM (Eurocom P5 Pro Extreme) с Nvidia 980m.}}
На некоторых системах клавиши изменения яркости корректно меняют значения интерфейса acpi в {{path|/sys/class/backlight/acpi_video0/actual_brightness}}, но яркость экрана не изменяется. Апплеты яркости в средах рабочего стола тоже могут показывать изменения без реального влияния на яркость.

Если вы протестировали рекомендуемые параметры ядра и только {{cmd|xbacklight}} работает, то, возможно, вы столкнулись с несовместимостью между вашим BIOS и драйвером ядра.

В этом случае единственное решение — дождаться исправления от производителя BIOS или драйвера видеокарты.

Обходной путь — использовать inotify для запуска {{cmd|xbacklight}} после каждого изменения значения {{path|/sys/class/backlight/acpi_video0/actual_brightness}}.

Сперва установите пакет {{pkg|inotify-tools}}. Затем создайте скрипт, который будет запускаться при каждом включении с помощью автозагрузки.

{{path|/usr/local/bin/xbacklightmon}}:

<syntaxhighlight lang="bash">
#!/bin/sh

path=/sys/class/backlight/acpi_video0

luminance() {
    read -r level < "$path"/actual_brightness
    factor=$(printf "$max" | awk '{print 100/$1}')
    printf "$level $factor" | awk '{print int($1*$2)}'
}

read -r max < "$path"/max_brightness

xbacklight -set "$(luminance)"

inotifywait -me modify --format '' "$path"/actual_brightness | while read; do
    xbacklight -set "$(luminance)"
done
</syntaxhighlight>

=== Не работает управление подсветкой в MATE ===

Убедитесь, что установлен пакет {{pkg|mate-power-manager}}.

=== Не работают клавиши управления подсветкой в Xfce ===

В Xfce4 за обработку клавиш управления подсветкой отвечает [https://docs.xfce.org/xfce/xfce4-power-manager/start Менеджер питания].

Иногда параметр «Обрабатывать кнопки яркости экрана» может оказаться отключен по умолчанию.

Чтобы включить их обработку, откройте [https://docs.xfce.org/xfce/xfce4-power-manager/preferences настройки менеджера питания] и включите соответствующий параметр:

 $ xfce4-power-manager -c

=== xbacklight выдаёт: No outputs have backlight property ===

Иногда, в зависимости от установленной видеокарты, xbacklight из пакета {{pkg|xbacklight}} может выдать сообщение «No outputs have backlight property». Пакет {{pkg|acpilight}} предоставляет альтернативную реализацию xbacklight, которая может оказаться рабочей.

=== На драйвере amdgpu после перезагрузки подсветка всегда имеет максимальную яркость ===

Из-за [https://bugzilla.kernel.org/show_bug.cgi?id=203905 бага] в драйвере amdgpu значение {{cmd|actual_brightness}} подсветки сообщается как 16-битное целое число, которое находится за пределами 8-битного диапазона, указанного в {{cmd|max_brightness}}. Это приводит к тому, что служба {{cmd|systemd-backlight}} при загрузке пытается установить слишком большое значение, которое в итоге уменьшается до максимальной яркости (255).

Пока баг не исправлен, одним из возможных обходных путей является преобразование сохранённой яркости в пределы правильного диапазона перед её установкой. Это можно сделать с помощью скрипта и юнита службы:

{{path|fix-brightness.sh}}:

<syntaxhighlight lang="bash">
#!/bin/bash

# Адаптируйте эту строку под ваше оборудование
BRIGHTNESS_FILE="/var/lib/systemd/backlight/pci-0000:04:00.0:backlight:amdgpu_bl0"
BRIGHTNESS=$(cat "$BRIGHTNESS_FILE")
BRIGHTNESS=$(($BRIGHTNESS*255/65535))
BRIGHTNESS=${BRIGHTNESS/.*} # преобразование в целое число на всякий случай
echo $BRIGHTNESS > "$BRIGHTNESS_FILE"
</syntaxhighlight>

{{path|fix-brightness.service}}:
<syntaxhighlight lang="bash">
[Unit]
Description=Convert 16-bit brightness values to 8-bit before systemd-backlight applies it
Before=systemd-backlight@backlight:amdgpu_bl0.service

[Service]
Type=oneshot
ExecStart=''путь/к/fix-brightness.sh''

[Install]
WantedBy=multi-user.target
</syntaxhighlight>

На некоторых системах уровень подсветки, о котором сообщает драйвер, находится в правильном диапазоне [0, 255], но systemd всё равно не может восстановить правильное значение. Вероятно, это связано с [https://gitlab.freedesktop.org/drm/amd/-/issues/1337 гонкой в ядре]. В этом случае преобразование уровня яркости не поможет, так как он уже находится в правильном диапазоне. Вместо этого в качестве обходного пути можно сохранить уровень яркости в systemd перед выключением. Этого можно добиться с помощью следующего скрипта и юнита службы:

{{path|fix-brightness.sh}}:
<syntaxhighlight lang="bash">
#!/bin/sh

# Уровень подсветки с точки зрения systemd (измените при необходимости)
readonly SYSTEMD_BACKLIGHT_FILE='/var/lib/systemd/backlight/pci-0000:04:00.0:backlight:amdgpu_bl0'

# Уровень подсветки из драйвера AMDGPU
readonly AMDGPU_BACKLIGHT_FILE='/sys/class/backlight/amdgpu_bl0/brightness'

# Читаем текущее значение из драйвера и применяем его в systemd
readonly AMDGPU_BACKLIGHT_VALUE=$(cat "$AMDGPU_BACKLIGHT_FILE")
echo "$AMDGPU_BACKLIGHT_VALUE" > "$SYSTEMD_BACKLIGHT_FILE"
</syntaxhighlight>

{{path|fix-brightness.service}}:
<syntaxhighlight lang="bash">
[Unit]
Description=Save brightness value from AMDGPU
DefaultDependencies=no
After=final.target

[Service]
Type=oneshot
ExecStart=''путь/к/fix-brightness.sh''

[Install]
WantedBy=final.target
</syntaxhighlight>

=== Сохранение яркости <5% при перезагрузке ===

Согласно {{cmd|man 8 systemd-backlight@.service}}, если свойство udev {{cmd|ID_BACKLIGHT_CLAMP}} не установлено в false, минимальное допустимое значение сохраняемой яркости — 1 или 5% от максимальной яркости, в зависимости от того, что больше. Это ограничение будет снято, когда ядро позволит надёжно устанавливать в пользовательском пространстве значение яркости, не приводящее к выключению дисплея.

Чтобы яркость <5% сохранялась при перезагрузке, создайте правило udev:

{{path|/etc/udev/rules.d/99-backlight_clamp.rules}}:
<syntaxhighlight lang="bash">
# Разрешить сохранять яркость <5% при перезагрузке
SUBSYSTEM=="backlight", ENV{ID_BACKLIGHT_CLAMP}="0"
</syntaxhighlight>

==Источники==
*[https://wiki.archlinux.org/title/Backlight_(Русский) Wiki Archlinux]