macOS Wi-Fi driver for Realtek RTW89 PCIe cards with a bundled Kext Installer and legacy Wi-Fi stack support
This kext is in preview. Keep a USB stick that boots your current OpenCore EFI in case macOS does not start. It requires Lilu and the legacy Wi-Fi stack: IOSkywalkFamily, IO80211FamilyLegacy, and AMFIPass from OpenCore Legacy Patcher.
AirPort_RTW89 is a native macOS Wi-Fi driver for Realtek RTW89 PCIe cards, ported from the Linux rtw89 driver. The card appears in the Wi-Fi menu and System Settings like a Macโs own.
It is an independent implementation from AirportRTW. See Alternative Implementation below for the trade-offs.
Supported Hardware
| Card | PCI ID (10EC:) |
Wi-Fi | Status |
|---|---|---|---|
| RTL8922DE | 892D, 882D, 895D |
7 | works (tester); 6 GHz and Wi-Fi 7 untested |
| RTL8922AE | 8922, 892B |
7 | untested |
| RTL8852CE | C852 |
6E | works (tester) |
| RTL8852BE | B852, B85B |
6 | works |
| RTL8852AE | 8852, A85A |
6 | works (testers) |
| RTL8852BTE | B520 |
6 | untested |
| RTL8851BE | B851 |
6 | untested |
USB versions of these cards are not supported.
What Works
- Networks: WPA3, WPA2 (Personal and Enterprise), open networks, phone hotspots.
- Speed: Wi-Fi 6, up to 80 MHz (about 500 Mb/s measured). The driver prefers a networkโs 5 GHz side when its signal is good.
- 6 GHz and Wi-Fi 7 on the cards that have them (new, untested on hardware).
- Wi-Fi menu, saved networks, scanning, restart and shutdown.
- Wi-Fi 7 160/320 MHz channels.
Not Yet
- AirDrop/AWDL/Continuity
- Wi-Fi 7 multi-link
- Sleep and wake are untested
Requirements
-
A Hackintosh booting with OpenCore, with Lilu.
-
Misc -> Security -> SecureBootModelset toDisabled(the installer can do this). -
The old Wi-Fi stack, which macOS needs for this driver. Download all three (each link is a zip with the kext inside):
They come from OpenCore Legacy Patcher; they are Appleโs and Dhinak Gโs, so this project does not include them.
Installation
Bundled Kext Installer (recommended)
-
Back up: copy your OpenCore EFI to a USB stick and check it boots.
-
Download the three kexts above and unzip them into your Downloads folder.
-
Download
AirPort_RTW89-<version>.zipfrom Releases and unzip it. -
Run the Kext Installer that comes with it:
- macOS: double-click
Kext Installer.command(first time: right-click -> Open). - Windows: double-click
Kext Installer.cmd. - Linux:
sh "Kext Installer.sh".
It finds your
config.plist, shows what it will change, and asks before doing anything. Your old config is saved asconfig.plist.pre-airport-rtw89. If Python is missing, it offers to install it. - macOS: double-click
-
Restart. Wi-Fi shows up in the menu bar within about 30 seconds.
To update, run the Kext Installer from the new release.
Manual Installation
- Copy
AirPort_RTW89.kextand the three kexts intoEFI/OC/Kexts. - Delete
IO80211FamilyLegacy.kext/Contents/PlugIns/AirPortBrcmNIC.kext(it is for Broadcom cards). - In ProperTree, run OC Snapshot, then check the order in
Kernel -> Add. It must be: Lilu, IOSkywalkFamily, IO80211FamilyLegacy, AMFIPass, AirPort_RTW89, then its pluginAirPort_RTW89.kext/Contents/PlugIns/AirPortRTW89Front.kext. Move entries if Snapshot put them elsewhere. - Add to
Kernel -> Block:Identifiercom.apple.iokit.IOSkywalkFamily,StrategyExclude,Archx86_64,MinKernel23.0.0,Enabledtrue. - Set
Misc -> Security -> SecureBootModeltoDisabled. - On macOS Tahoe, add
-amfipassbetatoboot-args. - If the same EFI also boots Ventura or older, give the four kexts
MinKernel23.0.0.
Troubleshooting
- macOS does not start: boot from your backup USB stick, then remove the kexts or restore
config.plist.pre-airport-rtw89. - WPA3 causes trouble: add the boot-arg
-rtw89nowpa3. - Collect logs for a report: download the tools zip (
AirPort_RTW89-<version>-tools.zip) and runsudo tools/collect_logs.sh. It makes one zip with the driverโs and macOSโs Wi-Fi logs. Passwords are never included and MAC addresses are shortened, but network names can appear, so check before posting publicly. tools/rtw89ctl status(from the tools zip) shows the connection, channel and speed.
Alternative Implementation
AirportRTW is an independent RTW89 driver from another maintainer. Pick it if you want native support on older macOS versions (10.13โ14) or RTW88 card support. Pick AirPort_RTW89 if you want a bundled installer, log tools, and active testing on Sequoia 15 and Tahoe 26 โ but it requires the legacy Wi-Fi stack on every macOS version.
FAQ
Which cards are supported?
AirPort_RTW89 targets Realtek RTW89 PCIe cards: RTL8851BE, RTL8852AE, RTL8852BE, RTL8852BTE, RTL8852CE, RTL8922AE, and RTL8922DE. USB versions are not supported.
Does it work with Broadcom or Intel cards?
No. This is a Realtek driver. For Broadcom use AirportBrcmFixup, and for Intel use itlwm.
Is macOS Tahoe supported?
Yes, but it is new. The project is tested on macOS Sequoia 15 and Tahoe 26. Sleep and wake are untested.
Related Kexts
- Lilu - Required dependency
- AirportRTW - Alternative RTW89 implementation
- AirportBrcmFixup - Broadcom Wi-Fi patches
- itlwm - Intel Wi-Fi driver
- BlueToolFixup - Bluetooth patches for macOS Monterey and later