Current Driver Version: 5.13.1-30 Support Kernel: 2.6.24 ~ 7.2 (with unofficial patches)

Most users should use the in-kernel rtw88_8822bu driver on Linux 6.12 or newer instead of this driver. Support for RTL8812BU and RTL8822BU adapters was introduced in Linux 6.2, but later kernels include substantial improvements. Use an up-to-date distribution kernel and firmware.

For official release notes please check ReleaseNotes.pdf.

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

This driver does NOT support newer Realtek 802.11ax (Wi-Fi 6) chipsets such as RTL8852BU.

The in-kernel driver is recommended for normal use. This external driver is a fallback for older kernels, specific compatibility problems, or specialized features and vendor-specific tools.

Check the currently loaded modules using lsmod. rtw88_8822bu is the in-kernel module for these adapters; 88x2bu is the external module from this repository. Other rtw88_ modules may belong to another wireless device.

Only blacklist the in-kernel driver if you need to use this external driver. To prevent rtw88_8822bu from loading automatically, run:

echo "blacklist rtw88_8822bu" | sudo tee /etc/modprobe.d/rtw8822bu.conf

Install this external driver using the instructions below, then reboot your system.

To return to the in-kernel driver, uninstall this external driver using the method matching your installation (manual or DKMS), remove the blacklist entry created above, and reboot. Also remove any other blacklist entries you previously added for rtw88_8822bu.

And more.

• 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

• Make sure you clean old build files before building new ones

make clean

make

make KSRC=/lib/modules/YOUR_KERNEL_VERSION/build

sudo make install

sudo make uninstall

Allows smooth integration with kernel updates.

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

cd  /usr/src/rtl88x2bu-git
git fetch
git rebase origin/master --autostash
dkms build rtl88x2bu/git --force
dkms install rtl88x2bu/git --force

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

Notice: If you had already loaded the module, 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

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

• Archlinux AUR https://aur.archlinux.org/packages/rtl88x2bu-dkms-git/