To code, test and upstream great quality Linux Standards compliant (mac80211) USB WiFi drivers for the Realtek RTW89 driver series.
Compatible with Linux kernel versions 6.6 and newer as long as your distro hasn't modified any kernel APIs. RHEL and all distros based on RHEL will have modified kernel APIs and are unlikely to be compatible with this driver.
- USB : (NEW) RTL8851BU, RTL8831BU, RTL8852BU, RTL8832BU, RTL8852CU, RTL8832CU
- PCIe: RTL8851BE, RTL8852AE, RTL8852BE, RTL8852CE, RTL8922AE
Note: If you own a USB WiFi adapter with any of the above supported chips and your adapter is single-state (no Windows driver on board) and single-function (no bluetooth support), please start an issue and post the brand, name and chip of your adapter as well as a link to the product. This will allow us to make a list of preferred adapters.
git, make, gcc, kernel-headers, dkms and mokutil (dkms and mokutil are optional.)
-
Create a clone of this repo in your local machine
git clone https://github.com/morrownr/rtw89 -
Change the working directory to rtw89
cd rtw89 -
Search and remove previously installed out-of-kernel rtw89 drivers. If your system has Larry's rtw89 driver installed, you must run this command to remove it, or this driver won't work as expected.
sudo make cleanup_target_system -
Build and install the driver
-
via dkms (Recommended especially if Secure Boot is enabled in your system)
sudo dkms install $PWD -
via make (The testers of the new drivers for the USB devices MUST install the driver in this way please.)
make clean modules && sudo make install
-
-
Install the firmware necessary for the driver
sudo make install_fw -
Copy the configuration file
rtw89.confto /etc/modprobe.d/sudo cp -v rtw89.conf /etc/modprobe.d/Note: The above step will blacklist in-kernel drivers that can conflict with drivers in this repo.
-
Enroll the MOK (Machine Owner Key). This is needed ONLY IF Secure Boot is enabled in your system. Please see this guide for details.
sudo mokutil --import /var/lib/dkms/mok.pubFor Ubuntu-based distro users, run this command instead.
sudo mokutil --import /var/lib/shim-signed/mok/MOK.der
For users who installed the driver via DKMS, run:
- Check the version of the rtw89 driver installed on your system.
sudo dkms status
- Remove the rtw89 driver and its source code (Change the driver version accordingly)
sudo dkms remove rtw89/6.15 --all
sudo rm -rf /usr/src/rtw89-6.15
- Remove the configuration file
sudo rm -f /etc/modprobe.d/rtw89.conf
For users who installed the driver via make, run these commands in the rtw89 source directory
sudo make uninstall
sudo rm -f /etc/modprobe.d/rtw89.conf
The rtw89 driver is the Wi-Fi driver for Realtek Wi-Fi 6/7 adapters and has nothing to do with Bluetooth.
-
Check the version of the rtw89 driver installed on your system.
sudo dkms status -
Remove the rtw89 driver. (Change the driver version accordingly)
sudo dkms remove rtw89/6.15 --allsudo rm -rf /usr/src/rtw89-6.15/ -
Run this command in the rtw89 source directory to pull the latest code
git pull -
Build, sign and install the rtw89 driver from the latest code.
sudo dkms install $PWD
-
Run this command in the rtw89 source directory to pull the latest code
git pull -
Rebuild and reinstall the driver from the latest code
make clean modules && sudo make install
-
Run this command in the rtw89 source directory to pull the latest code and firmware
git pull -
Update the firmware files in your system
sudo make install_fw
