RTL8812AU: Устанавливаем драйвер для USB WIFI.

Сообщение **root** » 19 дек 2020 13:03

Темы
RTL8812AU: установка драйвера для USB Wi-Fi адаптера на Fedora
RTL8812AU — устранение ошибок DKMS и сборки

RTL8812AU: установка драйвера для USB Wi-Fi адаптера на Fedora

Введение

Некоторые USB Wi-Fi адаптеры на чипах Realtek (в частности RTL8812AU, RTL8814AU и RTL8821AU) не поддерживаются стандартными драйверами ядра Linux.
Для Fedora потребуется установка внешнего модуля, собранного из исходников с GitHub. Ниже приведён пример установки через DKMS для Fedora 40+.

1. Подготовка системы
Перед началом убедитесь, что установлены инструменты сборки и DKMS.

Установим зависимости:
Код: Выделить всё
```
sudo dnf install git dkms kernel-devel kernel-headers make gcc
```
Проверим текущую версию ядра:
Код: Выделить всё
```
uname -r
```
(важно, чтобы пакеты `kernel-devel` и `kernel-headers` соответствовали установленному ядру)
Убедимся, что DKMS активен:
Код: Выделить всё
```
systemctl status dkms
```

2. Загрузка исходников драйвера
Актуальные исходники поддерживаются в репозитории `aircrack-ng` и `gordboy`.

Клонируем репозиторий:
Код: Выделить всё
```
git clone https://github.com/aircrack-ng/rtl8812au.git
```
Переходим в каталог:
Код: Выделить всё
```
cd rtl8812au
```
Проверим версию модуля в файле `dkms.conf`:
Код: Выделить всё
```
grep PACKAGE_VERSION dkms.conf
```
(например, `PACKAGE_VERSION="5.13.6"`)
Копируем исходники в каталог DKMS:
Код: Выделить всё
```
sudo cp -r . /usr/src/rtl8812au-5.13.6
```

3. Сборка и установка через DKMS
Выполним регистрацию, сборку и установку модуля.

Код: Выделить всё

sudo dkms add -m rtl8812au -v 5.13.6
sudo dkms build -m rtl8812au -v 5.13.6
sudo dkms install -m rtl8812au -v 5.13.6

Проверяем наличие модуля:

Код: Выделить всё

dkms status

Загружаем драйвер вручную (если не загрузился автоматически):

Код: Выделить всё

sudo modprobe 8812au

Проверяем подключение адаптера:

Код: Выделить всё

ip link show

4. Проверка и диагностика
Проверим, что модуль корректно загружен:

Код: Выделить всё

lsmod | grep 8812au

Если адаптер не определяется:

Переподключите устройство к другому порту USB.
Убедитесь, что питание на портах не ограничено (особенно на ноутбуках).
Посмотрите логи:
Код: Выделить всё
```
sudo dmesg | grep 8812au
```

При необходимости можно перезапустить службу сети:

Код: Выделить всё

sudo systemctl restart NetworkManager

5. Удаление драйвера
Для полного удаления модуля из DKMS:

Код: Выделить всё

sudo dkms remove -m rtl8812au -v 5.13.6 --all

После удаления можно удалить исходники:

Код: Выделить всё

sudo rm -rf /usr/src/rtl8812au-5.13.6

6. Полезные команды

Команда	Описание
nmcli dev wifi list	Список доступных сетей Wi-Fi
nmcli r wifi on	Включить Wi-Fi через NetworkManager
iwconfig	Проверить параметры адаптера (SSID, мощность и т.п.)
sudo modinfo 8812au	Показать информацию о модуле

Заключение
Установка драйвера RTL8812AU через DKMS в Fedora позволяет без ручной пересборки ядра обеспечить поддержку большинства адаптеров Realtek.
После обновления ядра модуль автоматически пересобирается.
Если адаптер не определяется — проверяйте соответствие версии `kernel-devel` и используемого ядра, а также вывод `dmesg`.
Для новых устройств предпочтительно использовать репозиторий `aircrack-ng`.

Сообщение **root** » 09 апр 2022 12:27

Продолжение темы: типичные ошибки при сборке драйвера RTL8812AU под Fedora

RTL8812AU — устранение ошибок DKMS и сборки

Типовые проблемы и решения

При установке драйвера через DKMS на Fedora иногда возникают ошибки сборки.
Ниже приведены наиболее распространённые случаи и способы их устранения.

1. Ошибка DKMS: "dkms.conf not found"
Сообщение:

Код: Выделить всё

Error! DKMS tree already contains: rtl8812au-5.13.6
File: /usr/src/rtl8812au-5.13.6/dkms.conf does not exist.

Причина: исходники были скопированы не полностью или в неверную директорию.
Решение:

Убедитесь, что в каталоге `/usr/src/rtl8812au-5.13.6/` есть файл `dkms.conf`.
Если нет — скопируйте исходники заново:
Код: Выделить всё
```
sudo rm -rf /usr/src/rtl8812au-5.13.6
sudo cp -r ~/rtl8812au /usr/src/rtl8812au-5.13.6
```

Повторите установку:

Код: Выделить всё

sudo dkms add -m rtl8812au -v 5.13.6
sudo dkms build -m rtl8812au -v 5.13.6
sudo dkms install -m rtl8812au -v 5.13.6

2. Ошибка GCC: "gcc version mismatch"
Сообщение:

Код: Выделить всё

Your GCC version does not match the compiler used to build the kernel.

Причина: версия `gcc` не совпадает с той, что использовалась при сборке текущего ядра.
Решение:

Узнайте версию компилятора, с которым собрано ядро:
Код: Выделить всё
```
cat /proc/version
```
Установите подходящую версию GCC (если доступна) или обновите ядро и заголовки:
Код: Выделить всё
```
sudo dnf upgrade kernel kernel-devel kernel-headers gcc
```
Перезагрузите систему и повторите сборку.

3. Ошибка DKMS: "Kernel preparation error"
Сообщение:

Код: Выделить всё

Error! Your kernel headers for kernel 6.x.x not found at /lib/modules/6.x.x/build

Причина: отсутствуют пакеты `kernel-devel` и `kernel-headers` для текущего ядра.
Решение:

Установите недостающие пакеты:
Код: Выделить всё
```
sudo dnf install kernel-devel kernel-headers
```
Убедитесь, что версия совпадает с `uname -r`:
Код: Выделить всё
```
rpm -q kernel-devel | grep $(uname -r)
```
Если версии не совпадают — перезагрузитесь в актуальное ядро.

4. Ошибка DKMS: "MOK signing failed"
Сообщение:

Код: Выделить всё

modprobe: ERROR: could not insert '8812au': Key was rejected by service

Причина: включён Secure Boot, а модуль не подписан.
Решение 1 (временное): отключить Secure Boot в UEFI.
Решение 2 (рекомендуемое): подписать модуль вручную.

Создайте ключ:

Код: Выделить всё

openssl req -new -x509 -newkey rsa:2048 -keyout MOK.key -out MOK.crt -nodes -days 36500 -subj "/CN=Fedora DKMS/"

Добавьте его в хранилище:
Код: Выделить всё
```
sudo mokutil --import MOK.crt
```
После перезагрузки подтвердите импорт ключа.

Подпишите модуль:

Код: Выделить всё

sudo /usr/src/kernels/$(uname -r)/scripts/sign-file sha256 MOK.key MOK.crt /lib/modules/$(uname -r)/extra/8812au.ko.xz

5. Ошибка NetworkManager: адаптер не появляется
Симптомы:
— модуль загружен (`lsmod | grep 8812au`), но интерфейса Wi-Fi нет.
Решение:

Перезапустите NetworkManager:
Код: Выделить всё
```
sudo systemctl restart NetworkManager
```
Проверьте интерфейсы:
Код: Выделить всё
```
ip link show
```
Если устройство всё ещё не отображается, выгрузите и снова загрузите модуль:
Код: Выделить всё
```
sudo modprobe -r 8812au
sudo modprobe 8812au
```

Заключение
Большинство ошибок при установке драйвера RTL8812AU под Fedora связаны с несоответствием версий ядра, GCC или активным Secure Boot.
Рекомендуется выполнять установку сразу после обновления системы и держать пакеты `kernel-devel`, `kernel-headers` и `gcc` синхронизированными.
При правильной настройке DKMS драйвер автоматически пересобирается при каждом обновлении ядра.