Repository navigation
v0.2.0 — macOS 26 Tahoe support, faster first join
Adds a build for macOS 26 Tahoe and fixes the first Wi-Fi join after boot. It is still experimental and has been tested on one machine only (Lenovo Legion Slim 5 16APH8, RZ616, macOS 15.8.1 and 26.7.1).
- AirportMtkWlan-Sequoia-v0.2.0.zip: native Wi-Fi menu, macOS 15 Sequoia.
- AirportMtkWlan-Tahoe-v0.2.0.zip: native Wi-Fi menu, macOS 26 Tahoe.
- SimpleMtkWlan-v0.2.0.zip: Ethernet-style; join with
mtkctl. - mtkctl-v0.2.0.zip: command-line client for both kexts.
Both AirportMtkWlan zips contain a kext named AirportMtkWlan.kext. Use the one for your macOS version: a Sequoia build loads on Tahoe but never attaches. Load one kext only.
Changes since v0.1.0
- New macOS 26 (Tahoe) build of AirportMtkWlan.
- The first join after boot or after turning Wi-Fi on no longer fails. A join that was waiting for a MAC-address change was cancelled by that change's own restart, so macOS always had to retry.
- RX path hardened for Skywalk: chained A-MSDU frames are linearised, queued frames are dropped instead of panicking when the interface goes away, and an mbuf leak on a bad A-MSDU subframe is fixed.
- Native
CHANNELS_INFOon Tahoe, and link quality (LQM) is now reported to macOS. - TX applies back-pressure instead of dropping frames when the queue is full.
- RX Block Ack reordering counters in
mtkctl debug; the BA gap timeout is tunable.
The RX/Skywalk, CHANNELS_INFO and LQM changes are ported from laobamac/itlwm (cad1841, 36d5e28, a01d1d5).
Known problems
- Download is capped at about 90-100 Mbit/s; upload is not.
- No sleep/wake, no WPA3-only (SAE), no 802.11ax, no 6 GHz.
For installation and troubleshooting, see the README.
Built from 21a7be2 (Debug, x86_64, unsigned). Checksums are in SHA256SUMS.txt.