Skip to content

Releases

AirPort-RTW 1.2.1

Choose a tag to compare

@github-actions github-actions released this 11 Nov 21:49

AirPort-RTW 1.2.1

This update fixes a driver bug that could stop internet traffic during a large
download while macOS still showed Wi-Fi as connected.

Normal traffic and background scans could try to use the same slot in the Wi-Fi
card's transmit queue. The driver now protects the slot from selection until
the packet is queued.

Replace the existing AirPortRTW.kext in your OpenCore setup and restart.
The ZIP contains the kext and BOOT-ARGS.txt. The fix works with the default
settings and requires no additional boot arguments.

AirPort-RTW 1.2.0

Choose a tag to compare

@github-actions github-actions released this 04 Nov 07:36

AirPort-RTW 1.2.0

This release adds WPA3-Personal to the normal macOS Wi-Fi menu. You can
connect without installing a separate connection app. It also improves
network switching and fixes a problem that could stop roaming scans.

What's new

  • WPA3-Personal connections. SAE authentication and Protected Management
    Frames (PMF) are supported, including on WPA2/WPA3 transition networks.
  • Faster WPA3 traffic. Pairwise CCMP encryption uses the card's hardware
    by default. This improved speed and CPU use compared with the earlier
    software-only WPA3 builds.
  • WPA3 roaming. The driver can switch between compatible access points
    on the same network while keeping WPA3. Both automatic and manually
    requested switches were observed in device testing.
  • More reliable network changes. Disconnects, Wi-Fi toggling and the
    connection state shown to macOS have been improved. macOS is also told
    when an access point has rejected a connection attempt.
  • Scan stability fixes. WPA3 key updates no longer overwrite a running
    scan's state and timer, which could leave further scans and roaming blocked.
  • Safer diagnostic requests. The release includes fixes for the error
    query and kernel-stack problems reported while using Wi-Fi diagnostics.

Automatic roaming and the supported 802.11k/v functions remain available.
802.11r Fast Transition is not implemented, so an AP switch still needs
a new authentication exchange and can briefly interrupt traffic.

Known issues

  • Some starts may connect using WPA2 first. This was reported on a
    WPA2/WPA3 transition network; manually disconnecting and reconnecting selected
    WPA3. Other starts connected directly with WPA3. The cause is still being
    investigated, so WPA3 is not guaranteed on every automatic connection.
  • Some WPA3 attempts may be rejected before a later attempt succeeds.
    The access point returned SAE status 15 in the recorded cases. This does
    not by itself establish a wrong password or the cause of the rejection.
  • One WPA3 guest network did not provide an IP address. Authentication
    succeeded, but the capture showed unanswered DHCP requests. The cause may
    involve the network or the driver and has not been established.
  • Heavy downloads and speed tests can still cause packet drops. This release
    does not claim to resolve all traffic-related losses.
  • Reconnecting after sleep may be slow. Deep sleep and hibernation remain
    dependent on the system and are not fully validated.
  • WPA2-Enterprise and RTL8814AE support remain experimental. WPA3-Enterprise,
    pure pairwise TKIP, AirDrop and full Continuity support are not included.

Device testing covered WPA3 startup, hardware CCMP, network changes and roaming.
The 29 driver regression checks, crypto tests, native macOS build and compiled
IOCTL stack checks are run for the release. This does not establish
compatibility with every card, router or macOS configuration.

Download and update

Download AirPortRTW-1.2.0.zip and extract it once. It contains only:

  • AirPortRTW.kext
  • BOOT-ARGS.txt, listing the four supported driver boot arguments

License notices are kept inside the kext bundle. Connection tools, test
captures and beta documents are not included in the ZIP. A separate SHA-256
file is available for checking the download.

Back up your EFI, replace AirPortRTW.kext, and restart. Keep the compatible
Apple Wi-Fi dependencies used by your working installation. New installations
should follow the installation guide.
Sonoma and newer still require the compatible legacy Wi-Fi stack.

Check the loaded version in Terminal:

ioreg -r -c AirPortRTW -l | grep DriverBuild

It should show 1.2.0.

Automatic roaming is enabled by default. Add -rtwnoautoroam to your
existing OpenCore boot-args and restart to turn it off. Remove the argument
and restart to turn it on again. The other diagnostic options are explained
in BOOT-ARGS.txt.

Thanks to the original authors and everyone testing the driver. Credits and
licenses are listed in NOTICE.md.

AirPort-RTW 1.1.0

Choose a tag to compare

@github-actions github-actions released this 27 Oct 11:24

AirPort-RTW 1.1.0

This release focuses on roaming: switching between access points on the
same Wi-Fi network as you move around. It includes the changes tested through
1.1.0 Beta 14.

What's new since 1.0.2

  • Automatic AP switching. The driver checks nearby access points and can
    move to a better compatible connection without a manual command.
  • 5 GHz preference with 2.4 GHz fallback. A strong 5 GHz connection is
    preferred. Signal checks and a cooldown help avoid unnecessary switches.
  • DFS channel support for roaming. Suitable access points on these 5 GHz
    channels can be used after discovery and the required channel checks.
  • 802.11k assistance. The driver can request a list of nearby access
    points and respond to supported Beacon Measurement requests. Measurement
    support remains experimental.
  • 802.11v assistance. The driver can consider a router's suggested AP
    change and accept or decline it after checking the target and connection.
  • More diagnostics. Additional connection, roaming and wake information
    helps with investigating problems.
  • Experimental WPA2-Enterprise support. An initial connection path for
    work/school networks is included, but has not been verified on hardware.

Automatic AP switches and working Internet after 2.4/5 GHz changes have been
observed in testing. A switch may briefly interrupt traffic: 802.11r Fast
Transition is not implemented
. Router-initiated accepted 802.11v switches
and 802.11k measurement replies still need more real-world testing. This is
not a claim of complete support for every optional 802.11k/v feature.

Known issues

  • Heavy downloads and speed tests can cause packet drops, even without an
    AP switch or AWDL channel hopping. This is not fixed in 1.1.0; investigation
    is planned for 1.1.1.
  • Reconnecting after sleep can take longer than expected. One test took
    about a minute before connection startup. Deep sleep and hibernation remain
    dependent on the system and are not fully validated.
  • WPA3, PMF and 802.11r are not supported. WPA2-Enterprise is experimental;
    advanced Enterprise security modes and fast-roaming key caching are not
    advertised as supported.
  • AirDrop and full Continuity support are not included.
  • RTL8814AE remains experimental and needs physical hardware testing.
    RTL8812AE, USB and SDIO adapters are not supported.

Download and update

Download AirPortRTW-1.1.0.zip from this release and extract it once.
It contains AirPortRTW.kext and guides. The developer CTL tool is not included.
Do not use GitHub's “Source code” downloads to install the driver.

Back up your EFI, replace AirPortRTW.kext, and restart. Keep the compatible
Wi-Fi dependencies already used by your working setup. New installations
should follow the installation guide.

Check the loaded version in Terminal:

ioreg -r -c AirPortRTW -l | grep DriverBuild

It should show 1.1.0.

Turn off automatic roaming

Automatic roaming is enabled by default. To disable it, add -rtwnoautoroam
to the existing boot-args in your OpenCore config.plist, then restart.
Remove the argument and restart to enable automatic roaming again.
More commands are in the roaming guide.

Thanks to the original driver authors and everyone testing and reporting
problems. See NOTICE.md for credits.

AirPort-RTW 1.0.2

Choose a tag to compare

@github-actions github-actions released this 09 Oct 19:04

AirPortRTW 1.0.2

Published from the 1.0.2 Beta 4 code on 1.0.0-beta to main.
The final build identifies itself as 1.0.2-release; the bundle and kmod
versions are 1.0.2. No 2.0.0 beta feature changes are included.

Changes since 1.0.1

  • Bounded deferred RX processing and shutdown ordering to address the
    observed flush_work / napi_stop sleep-transition deadlock.
  • AWDL power fencing: cancel timers, flush owned queues, reject late work
    while suspended, and resume only when the radio is actually powered.
  • Wake scan/association cleanup and corrected native notifications for
    automatic reconnect, preserving a user-disabled Wi-Fi radio.
  • Native LINK_CHANGED wire layout and link-status query corrections.
  • Experimental RTL8814AE (10ec:8813) chip, table, PCI match and firmware
    integration, with a pinned core revision and verified firmware download.
  • RX ownership, AWDL power and link/wake regression tests and native
    macOS x86_64 bundle checks.

Remaining limitations

Uninterrupted long/deep sleep, standby and hibernation remain unverified.
The reported DarkWake pattern persisted without AirPortRTW loaded, so no
speculative driver workaround is included. The CoreWiFi BSSID_CHANGED
length warning is not claimed fixed. RTL8814AE requires physical hardware
testing; RTL8812AE, USB and SDIO are not enabled. AirDrop feature work
remains on the separate 2.0.0 beta branch.

Installation and verification

Replace the existing AirPortRTW.kext in EFI/OC/Kexts, retain the applicable
legacy Wi-Fi dependencies described in the README, and reboot. Do not load
multiple AirPortRTW/rtw88 builds simultaneously.

AirPort-RTW 1.0.1

Choose a tag to compare

@github-actions github-actions released this 03 Oct 14:41

AirPort-RTW 1.0.1

Maintenance release fixing a sleep-transition deadlock found after 1.0.0.

Fixed

  • Prevented NAPI work from requeueing indefinitely while the driver is being stopped for system sleep.
  • Fixes a sleep timeout that could end in a kernel panic after 180 seconds.
  • Avoids the machine remaining powered on and heating up while macOS waits for the network power-state callback to finish.

Included from 1.0.0

  • Native macOS Wi-Fi integration through IO80211FamilyLegacy
  • RTL8821CE verified
  • RTL8822BE / RTL8822CE supported and awaiting broader hardware reports
  • WPA2-Personal
  • WPA2/WPA3 transition networks using WPA2
  • Open networks
  • 2.4 GHz and 5 GHz
  • Native scanning and association
  • CoreWiFi auto-join
  • Sleep/wake reconnect path

AirPort-RTW 1.0.0

Choose a tag to compare

@github-actions github-actions released this 03 Oct 12:42

AirPort-RTW 1.0.0

First stable release of AirPort-RTW.

Working

  • Native macOS Wi-Fi integration through IO80211FamilyLegacy
  • RTL8821CE verified
  • RTL8822BE / RTL8822CE supported and awaiting broader hardware reports
  • WPA2-Personal
  • WPA2/WPA3 transition networks using WPA2
  • Open networks
  • 2.4 GHz and 5 GHz
  • Native scanning and association
  • CoreWiFi auto-join
  • Network traffic with normal throughput
  • Sleep / wake with macOS-managed reconnect

Not yet supported

  • WPA3-only
  • Enterprise Wi-Fi
  • Hidden networks
  • AirDrop / Continuity / functional AWDL

Keep a bootable OpenCore EFI backup when testing kernel extensions.