RinCat/RTL88x2BU-Linux-Driver
1
0
Fork 0
mirror of https://github.com/RinCat/RTL88x2BU-Linux-Driver.git synced 2025-07-01 15:44:16 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge 4e8d492b1e8c333d9001fe5e3bbff628e62fed6c into 9624bd8943dc9998fc09355ea725ef7d59f80cb2

Browse Source
This commit is contained in:
Slavic Dragovtev 2025-05-26 14:00:00 +03:00 committed by GitHub
commit dd1828adc6
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 12 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
README.md
View File

@ -2,27 +2,27 @@
**Current Driver Version**: 5.13.1-30 **Current Driver Version**: 5.13.1-30
**Support Kernel**: 2.6.24 ~ 6.14 (with unofficial patches) **Support Kernel**: 2.6.24 ~ 6.14 (with unofficial patches)
Linux in-tree rtw8822bu driver is working in process, check [this](https://lore.kernel.org/lkml/20220518082318.3898514-1-s.hauer@pengutronix.de/) patchset. Linux in-tree rtw8822bu driver is a work in progress. Check [this](https://lore.kernel.org/lkml/20220518082318.3898514-1-s.hauer@pengutronix.de/) patchset.
Official release note please check ReleaseNotes.pdf For official release notes 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. **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.
## Linux 5.18+ and RTW88 Driver ## Linux 5.18+ and RTW88 Driver
Starting from Linux 5.18, some distributions have added experimental RTW88 USB support (include RTW88x2BU support). 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. 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. If it doesn't, then 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. Check the currently loaded modules 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. If you see `88x2bu` then you are using this RTW88x2BU driver.
To blacklist RTW88 8822bu USB driver, run the following command: To blacklist RTW88 8822bu USB driver run:
``` ```
echo "blacklist rtw88_8822bu" > /etc/modprobe.d/rtw8822bu.conf echo "blacklist rtw88_8822bu" > /etc/modprobe.d/rtw8822bu.conf
``` ```
And reboot your system. ...and reboot your system.
## Supported Devices ## Supported Devices
<details> <details>
@ -115,7 +115,7 @@ And more.
## Manual installation ## Manual installation
### Clean ### Clean
* Make sure you cleaned old build files before builds new one * Make sure you clean old build files before building new ones
``` ```
make clean make clean
``` ```
@ -142,7 +142,7 @@ sudo make uninstall
## Using DKMS (Dynamic Kernel Module Support) ## Using DKMS (Dynamic Kernel Module Support)
Allows smooth integration with kernel updates Allows smooth integration with kernel updates.
### Initial DKMS installation ### Initial DKMS installation
``` ```
@ -161,16 +161,16 @@ dkms install rtl88x2bu/git --force
``` ```
# USB 3.0 Support # 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. 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 moduel, use `modprobe -r 88x2bu` to unload it first. 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: 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` `options 88x2bu rtw_switch_usb_mode=1`
# Debug # Debug
Set debug log use `echo 5 > /proc/net/rtl88x2bu/log_level` or `modprobe 88x2bu rtw_drv_log_level=5` To set debug log use `echo 5 > /proc/net/rtl88x2bu/log_level` or `modprobe 88x2bu rtw_drv_log_level=5`
# Distribution # Distribution
* Archlinux AUR https://aur.archlinux.org/packages/rtl88x2bu-dkms-git/ * Archlinux AUR https://aur.archlinux.org/packages/rtl88x2bu-dkms-git/