e36615e799
Step "3." appeared twice in the Installation Guide source
(cleanup_target_system and "Build and install the driver").
Rendered output on github.com is correct because CommonMark
auto-renumbers ordered lists, but the raw source reads
1, 2, 3, 3, 4, 5, 6, which is confusing for tools that consume
the markdown directly (terminal viewers, AI assistants
summarising install steps, RAG indexes over raw docs).
Renumber so source and render agree:
3. Search and remove ... (unchanged)
3 -> 4. Build and install the driver
4 -> 5. Install the firmware
5 -> 6. Copy rtw89.conf to /etc/modprobe.d/
6 -> 7. Enroll the MOK
No content or wording changes.
|
||
|---|---|---|
| fedora | ||
| firmware | ||
| hostapd | ||
| .gitignore | ||
| acpi.c | ||
| acpi.h | ||
| cam.c | ||
| cam.h | ||
| chan.c | ||
| chan.h | ||
| coex.c | ||
| coex.h | ||
| core.c | ||
| core.h | ||
| debug.c | ||
| debug.h | ||
| dkms.conf | ||
| efuse.c | ||
| efuse.h | ||
| efuse_be.c | ||
| fw.c | ||
| fw.h | ||
| mac.c | ||
| mac.h | ||
| mac80211.c | ||
| mac_be.c | ||
| Makefile | ||
| pci.c | ||
| pci.h | ||
| pci_be.c | ||
| phy.c | ||
| phy.h | ||
| phy_be.c | ||
| ps.c | ||
| ps.h | ||
| README.md | ||
| reg.h | ||
| regd.c | ||
| rtw89.conf | ||
| rtw8851b.c | ||
| rtw8851b.h | ||
| rtw8851b_rfk.c | ||
| rtw8851b_rfk.h | ||
| rtw8851b_rfk_table.c | ||
| rtw8851b_rfk_table.h | ||
| rtw8851b_table.c | ||
| rtw8851b_table.h | ||
| rtw8851be.c | ||
| rtw8851bu.c | ||
| rtw8852a.c | ||
| rtw8852a.h | ||
| rtw8852a_rfk.c | ||
| rtw8852a_rfk.h | ||
| rtw8852a_rfk_table.c | ||
| rtw8852a_rfk_table.h | ||
| rtw8852a_table.c | ||
| rtw8852a_table.h | ||
| rtw8852ae.c | ||
| rtw8852au.c | ||
| rtw8852b.c | ||
| rtw8852b.h | ||
| rtw8852b_common.c | ||
| rtw8852b_common.h | ||
| rtw8852b_rfk.c | ||
| rtw8852b_rfk.h | ||
| rtw8852b_rfk_table.c | ||
| rtw8852b_rfk_table.h | ||
| rtw8852b_table.c | ||
| rtw8852b_table.h | ||
| rtw8852be.c | ||
| rtw8852bt.c | ||
| rtw8852bt.h | ||
| rtw8852bt_rfk.c | ||
| rtw8852bt_rfk.h | ||
| rtw8852bt_rfk_table.c | ||
| rtw8852bt_rfk_table.h | ||
| rtw8852bte.c | ||
| rtw8852bu.c | ||
| rtw8852c.c | ||
| rtw8852c.h | ||
| rtw8852c_rfk.c | ||
| rtw8852c_rfk.h | ||
| rtw8852c_rfk_table.c | ||
| rtw8852c_rfk_table.h | ||
| rtw8852c_table.c | ||
| rtw8852c_table.h | ||
| rtw8852ce.c | ||
| rtw8852cu.c | ||
| rtw8922a.c | ||
| rtw8922a.h | ||
| rtw8922a_rfk.c | ||
| rtw8922a_rfk.h | ||
| rtw8922ae.c | ||
| rtw8922au.c | ||
| rtw8922d.c | ||
| rtw8922d.h | ||
| rtw8922d_rfk.c | ||
| rtw8922d_rfk.h | ||
| rtw8922de.c | ||
| sar.c | ||
| sar.h | ||
| ser.c | ||
| ser.h | ||
| txrx.h | ||
| usb.c | ||
| usb.h | ||
| usb_storage.conf | ||
| util.c | ||
| util.h | ||
| wow.c | ||
| wow.h | ||
The Mission of this Repo:
To code, test and upstream great quality Linux Standards compliant (mac80211) USB WiFi drivers for the Realtek RTW89 driver series.
Compatibility
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.
Supported chips
- USB : RTL8831BU, RTL8851BU, RTL8832AU, RTL8852AU, RTL8832BU, RTL8852BU
- USB : RTL8832CU, RTL8852CU, RTL8912AU, RTL8922AU
- PCIe: RTL8851BE, RTL8852AE, RTL8852BE(-VS, -VT), RTL8852CE, RTL8922AE(-VS)
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.
Prerequisites
git, make, gcc, kernel-headers, dkms and mokutil (dkms and mokutil are optional.)
Installation Guide
-
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 (In this way you will have to manually reinstall the driver after each kernel update)
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
Uninstallation Guide
For users who installed the driver via DKMS,
- Check the version of the rtw89 driver installed in your system.
sudo dkms status rtw89
- 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
Q&A
Q1. Bluetooth is still not working after installing this driver, why?
The rtw89 driver is the Wi-Fi driver for Realtek Wi-Fi 6/7 adapters and has nothing to do with Bluetooth. Open a new issue and share the output of the command sudo cat /sys/kernel/debug/usb/devices with us if you run into a Bluetooth problem.
Q2. How to update the driver installed via DKMS?
-
Check the version of the rtw89 driver installed in your system.
sudo dkms status rtw89 -
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
Q3. How to update the driver installed via make?
-
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
Q4. How to update the firmware in my system?
-
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
Q5. I see my USB Wi-Fi adapter is in Driver CDROM Mode when running lsusb, what should I do?
Install usb-modeswitch (or usb_modeswitch), a tool that can switch your adapter to Wi-Fi mode.
Q6. My computer takes a very long time to boot when the Wi-Fi dongle is pre-inserted, how to fix it?
-
Copy usb_storage.conf to
/etc/modprobe.d/. This file will tell the culpritusb_storagenot to touch the Wi-Fi dongles.sudo cp usb_storage.conf /etc/modprobe.d/ -
Regenerate initramfs images. The following command is only applicable to Debian/Ubuntu and their variants. Please consult the manual if you are running other distros.
sudo update-initramfs -u -k all