Current Driver Version: 5.13.1-30 Support Kernel: 2.6.24 ~ 6.10 (with unofficial patches)
Linux in-tree rtw8822bu driver is working in process, check this patchset.
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.
Starting from Linux 5.18, some distributions have added experimental RTW88 USB support (include RTW88x2BU support). It is not yet stable but if it works well on your system, then you no longer need this driver. But if it doesn't work or is unstable, you need to manually blacklist it because it has a higher loading priority than this external drivers.
Check the currently loaded module using lsmod
. If you see rtw88_core
, rtw88_usb
, or any name beginning with rtw88_
then you are using the RTW88 driver.
If you see 88x2bu
then you are using this RTW88x2BU driver.
To blacklist RTW88 8822bu USB driver, run the following command:
echo "blacklist rtw88_8822bu" > /etc/modprobe.d/rtw8822bu.conf
And reboot your system.
And more.
build-essential
for Debian/Ubuntu, base-devel
for Arch, etc.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 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
Set debug log use echo 5 > /proc/net/rtl88x2bu/log_level
or modprobe 88x2bu rtw_drv_log_level=5