Realtek RTL88x2BU WiFi USB Driver for Linux
Go to file
Rin Cat (鈴猫) c266a02885
Merge pull request #99 from vinifmor/master
README: teaching how to force a given USB mode permanently
2021-08-09 16:25:43 -04:00
core Updated to 5.8.7.4 2021-07-15 02:42:01 -04:00
hal Remove always false expression 2021-07-15 02:42:45 -04:00
include Updated to 5.8.7.4 2021-07-15 02:42:01 -04:00
os_dep Add support EW-7822UAD 2021-07-20 11:38:57 -04:00
platform Update to 5.8.7.1 2020-08-02 05:12:24 -04:00
clean Update to 5.8.7.1 2020-08-02 05:12:24 -04:00
dkms.conf Update DKMS docs 2020-10-12 22:06:30 -04:00
halmac.mk Update to 5.8.7.1 2020-08-02 05:12:24 -04:00
ifcfg-wlan0 RTL88x2B Driver from Realtek. Version: 5.3.1 2018-11-23 15:22:37 -05:00
Kconfig RTL88x2B Driver from Realtek. Version: 5.3.1 2018-11-23 15:22:37 -05:00
LICENSE Create LICENSE 2020-01-27 08:23:16 -05:00
Makefile Updated to 5.8.7.4 2021-07-15 02:42:01 -04:00
README.md README: teaching how to force a given USB mode permanently 2021-08-09 10:56:32 -03:00
ReleaseNotes.pdf Update to 5.8.7.1 2020-08-02 05:12:24 -04:00
rtl8822b.mk Update to 5.6.1 2019-09-21 05:30:30 -04:00
runwpa RTL88x2B Driver from Realtek. Version: 5.3.1 2018-11-23 15:22:37 -05:00
wlan0dhcp RTL88x2B Driver from Realtek. Version: 5.3.1 2018-11-23 15:22:37 -05:00

REALTEK RTL88x2B USB Linux Driver

Current Driver Version: 5.8.7.4
Support Kernel: 2.6.24 ~ 5.13 (with unofficial patches)

Official release note please check ReleaseNotes.pdf

Note: if you believe your device is RTL8812BU or RTL8822BU but after loaded the module no NIC shows up, the device ID maybe not in the driver whitelist. In this case please submit a new issue with lsusb result, and your device name, brand, website, etc.

Supported Devices

  • ASUS AC1300 USB-AC55 B1
  • ASUS U2
  • Dlink - DWA-181
  • Dlink - DWA-182
  • Edimax EW-7822ULC
  • Edimax EW-7822UTC
  • Edimax EW-7822UAD
  • NetGear A6150
  • TP-Link Archer T3U
  • TP-Link Archer T3U Plus
  • TP-Link Archer T4U V3
  • TP-Link Archer T4U PLus
  • TRENDnet TEW-808UBM

And more.

How to use this kernel module

  • Ensure you have C compiler & toolchains, e.g. build-essential for Debian/Ubuntu, base-devel for Arch, etc.
  • Make sure you have installed the corresponding kernel headers
  • All commands need to be run in the driver directory
  • You need rebuild the kernel module everytime you update/change the kernel if you are not using DKMS

Manual installation

Clean

  • Make sure you cleaned old build files before builds new one
make clean

Building module for current running kernel

make

Building module for other kernels

make KSRC=/lib/modules/YOUR_KERNEL_VERSION/build

Installing

sudo make install

Uninstalling

sudo make uninstall

Manual DKMS installation

git clone "https://github.com/RinCat/RTL88x2BU-Linux-Driver.git" /usr/src/rtl88x2bu-git
sed -i 's/PACKAGE_VERSION="@PKGVER@"/PACKAGE_VERSION="git"/g' /usr/src/rtl88x2bu-git/dkms.conf
dkms add -m rtl88x2bu -v git
dkms autoinstall

USB 3.0 Support

You can try use modprobe 88x2bu rtw_switch_usb_mode=1 to force the adapter run under USB 3.0. But if your adapter/port/motherboard not support it, the driver will be in restart loop. Remove the parameter and reload the driver to restore. Alternatively, modprobe 88x2bu rtw_switch_usb_mode=2 let's it run as USB 2 device.

Notice: If you had already loaded the moduel, use modprobe -r 88x2bu to unload it first.

If you want to force a given mode permanently (even when switching the adapter across devices), create the file /etc/modprobe.d/99-RTL88x2BU.conf with the following content: options 88x2bu rtw_switch_usb_mode=1

Debug

Set debug log use echo 5 > /proc/net/rtl88x2bu/log_level or modprobe 88x2bu rtw_drv_log_level=5

Distribution