Repository navigation
Releases
RTL8821AU by BenkiNew — Release 2 · Linux 7.3 support
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_opscallbacks:
remain_on_channelandmgmt_txnow receive theu64 cookieby value, and
cfg80211 allocates the cookie itself. For>= 7.3.0the 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.shVersioning
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
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 from8821au-20210708to8821au-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). Kernels7.0.x–7.1.x
incorrectly selected the newer API signature and failed to compile. - Added:
cfg80211_ops.set_cqm_rssi_configfor 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.04job andgcc-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.shVersioning
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, успадкована без змін.