AirPort_RTW89

AirPort_RTW89

by FranciumOS-org
Network Realtek
Requires Lilu

macOS Wi-Fi driver for Realtek RTW89 PCIe cards with a bundled Kext Installer and legacy Wi-Fi stack support

Advertisement
Advertisement
Preview โ€” back up your EFI

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 -> SecureBootModel set to Disabled (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

  1. Back up: copy your OpenCore EFI to a USB stick and check it boots.

  2. Download the three kexts above and unzip them into your Downloads folder.

  3. Download AirPort_RTW89-<version>.zip from Releases and unzip it.

  4. 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 as config.plist.pre-airport-rtw89. If Python is missing, it offers to install it.

  5. 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

  1. Copy AirPort_RTW89.kext and the three kexts into EFI/OC/Kexts.
  2. Delete IO80211FamilyLegacy.kext/Contents/PlugIns/AirPortBrcmNIC.kext (it is for Broadcom cards).
  3. In ProperTree, run OC Snapshot, then check the order in Kernel -> Add. It must be: Lilu, IOSkywalkFamily, IO80211FamilyLegacy, AMFIPass, AirPort_RTW89, then its plugin AirPort_RTW89.kext/Contents/PlugIns/AirPortRTW89Front.kext. Move entries if Snapshot put them elsewhere.
  4. Add to Kernel -> Block: Identifier com.apple.iokit.IOSkywalkFamily, Strategy Exclude, Arch x86_64, MinKernel 23.0.0, Enabled true.
  5. Set Misc -> Security -> SecureBootModel to Disabled.
  6. On macOS Tahoe, add -amfipassbeta to boot-args.
  7. If the same EFI also boots Ventura or older, give the four kexts MinKernel 23.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 run sudo 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.

Resources