Skip to content

Releases

RTL8821AU by BenkiNew — Release 2 · Linux 7.3 support

Choose a tag to compare

@BenkiNew BenkiNew released this 12 Nov 16:54

Which driver do I need? / Який драйвер вам потрібен?

Your kernel Use Action
Already has rtw88_8821au (ELRepo kernel-ml 7.3.1 and 7.3.4 do) The in-kernel driver Nothing to install. Check: modinfo rtw88_8821au
No rtw88_8821au (e.g. kernel-ml 7.2.x and older) This fork (out-of-tree, DKMS) Follow Installation below

Check: if modinfo rtw88_8821au prints a module path, your kernel already supports the adapter — prefer it.
If it says the module was not found, install this fork. Do not use both at once.

Ваше ядро Що обрати Дія
Уже має rtw88_8821au (ELRepo kernel-ml 7.3.1 і 7.3.4 мають) Вбудований драйвер ядра Нічого встановлювати. Перевірка: modinfo rtw88_8821au
Немає rtw88_8821au (наприклад kernel-ml 7.2.x і старіші) Цей форк (поза ядром, DKMS) Див. Installation нижче

Перевірка: якщо modinfo rtw88_8821au показує шлях до модуля, ядро вже підтримує адаптер, краще скористайтеся ним.
Якщо пише, що модуль не знайдено, ставте цей форк. Обидва одночасно не використовуйте.


English

Adds support for Linux 7.3 while keeping builds on 7.2.x and older unchanged.
The repository was also renamed from 8821au-20210708 to 8821au-maintained
(old links redirect).

Changes in this release

  • Fixed: build on Linux 7.3.x. The kernel changed two cfg80211_ops callbacks:
    remain_on_channel and mgmt_tx now receive the u64 cookie by value, and
    cfg80211 allocates the cookie itself. For >= 7.3.0 the driver no longer generates
    its own cookie; older kernels keep the previous behavior.
  • Changed: repository renamed to 8821au-maintained; the install guide now clones
    this fork instead of upstream, which does not build on 7.x.
  • Verified: clean compile (0 errors, the 2 known warnings) against ELRepo
    kernel-ml 7.2.8 and 7.3.4 (el10, x86_64).

Limits of verification

This release was compile-tested only on 7.3.x; it was not boot-tested there.
Kernels 7.3 already ship an in-kernel rtw88_8821au driver, so prefer it where it
works for you. This fork remains useful for 7.2.x and older kernels and as a fallback.
Hardware-validated results: see docs/VALIDATION.md.

Installation

git clone https://github.com/BenkiNew/8821au-maintained.git
cd 8821au-maintained
sudo ./install-driver.sh

Versioning

The base driver version (5.12.5.2, matching dkms.conf and upstream) is unchanged,
preserving compatibility with existing DKMS installations. -fork.2 identifies the
second release of this fork.

License

GNU GPLv2, with the inherited Realtek Corporation copyright and license preserved.


Українською

Додає підтримку Linux 7.3, не змінюючи збірку на 7.2.x і старіших ядрах.
Репозиторій також перейменовано з 8821au-20210708 на 8821au-maintained
(старі посилання перенаправляються).

Що в цьому релізі

  • Виправлено: збірка на Linux 7.3.x. Ядро змінило два callback-и cfg80211_ops:
    remain_on_channel і mgmt_tx тепер отримують u64 cookie за значенням, а cookie
    видає сам cfg80211. Для >= 7.3.0 драйвер більше не генерує власний cookie; для старіших
    ядер поведінка без змін.
  • Змінено: репозиторій перейменовано на 8821au-maintained; інструкція встановлення
    тепер клонує цей форк, а не upstream, який не збирається на 7.x.
  • Перевірено: чиста компіляція (0 помилок, 2 відомі попередження) проти ELRepo
    kernel-ml 7.2.8 і 7.3.4 (el10, x86_64).

Межі перевірки

На 7.3.x реліз лише скомпільовано, на реальному залізі там не завантажувався.
Ядра 7.3 уже мають вбудований драйвер rtw88_8821au, тож де він вам підходить —
користуйтеся ним. Цей форк залишається корисним для 7.2.x і старіших ядер та як
запасний варіант. Результати перевірок на залізі — docs/VALIDATION.md.

Повна хронологія — CHANGELOG.md.

RTL8821AU by BenkiNew — Release 1 · Linux 7.x support

Choose a tag to compare

@BenkiNew BenkiNew released this 30 Sep 11:26

Superseded by v5.12.5.2-fork.2 (adds Linux 7.3 support; also builds on 7.2.x). Use the latest release.
Note: the repository was renamed from 8821au-20210708 to 8821au-maintained; the clone URL in the text below is the old name and redirects.

Замінено релізом v5.12.5.2-fork.2 (додає підтримку Linux 7.3, збирається і на 7.2.x). Користуйтеся останнім релізом.


English

First official release of this fork, independently maintained by BenkiNew.
Upstream (morrownr/8821au-20210708) stopped regular kernel API updates beyond
Linux 6.14 (see the README).

Changes in this release

  • Fixed: the kernel version boundary for remain_on_channel (cfg80211):
    KERNEL_VERSION(7, 0, 0) → KERNEL_VERSION(7, 2, 0). Kernels 7.0.x–7.1.x
    incorrectly selected the newer API signature and failed to compile.
  • Added: cfg80211_ops.set_cqm_rssi_config for connection-quality monitoring
    using an RSSI threshold.
  • Fixed: builds on Linux 7.1/7.2 with new cfg80211 parameters, and the
    subsequent build regression on kernels older than 7.1.
  • Fixed: CI configuration (retired ubuntu-20.04 job and gcc-10), and
    spelling errors in README/FAQ.

For the full history and upstream PR links, see
CHANGELOG.md.

Installation

git clone https://github.com/BenkiNew/8821au-20210708.git
cd 8821au-20210708
sudo ./install-driver.sh

Versioning

The base driver version (5.12.5.2, matching dkms.conf and upstream) is
unchanged, preserving compatibility with existing DKMS installations.
-fork.1 identifies the first release of this fork.

License

GNU GPLv2, with the inherited Realtek Corporation copyright and license preserved.


Українською

Перший офіційний реліз цього форку. Форк самостійно підтримується під
BenkiNew — upstream (morrownr/8821au-20210708) відійшов від активного
супроводу (див. README).

Що в цьому релізі

  • Виправлено: межа версії ядра для remain_on_channel (cfg80211) —
    KERNEL_VERSION(7, 0, 0) → KERNEL_VERSION(7, 2, 0). Ядра 7.0.x–7.1.x
    помилково вважались сумісними й не компілювались.
  • Додано: cfg80211_ops.set_cqm_rssi_config — моніторинг якості
    з'єднання (RSSI-поріг).
  • Виправлено: збірка на ядрі Linux 7.1/7.2 (нові cfg80211-параметри) і
    наступна регресія для ядер < 7.1.
  • Виправлено: CI (мертва job ubuntu-20.04, gcc-10), друкарські
    помилки в README/FAQ.

Повна хронологія з посиланнями на upstream PR — CHANGELOG.md.

Встановлення

git clone https://github.com/BenkiNew/8821au-20210708.git
cd 8821au-20210708
sudo ./install-driver.sh

Версіювання

Базова версія драйвера (5.12.5.2, той самий рядок, що й у dkms.conf та
upstream) не змінена — існуючі DKMS-встановлення лишаються сумісними.
-fork.1 — номер релізу саме цього форку.

Ліцензія

GNU GPLv2, авторське право Realtek Corporation, успадкована без змін.