Repository navigation
MtkWlan 0.12.1
Restart-safe, self-healing, and the first core that tells the native front end the real link rate. Use it with MtkWlanNative 0.4.13.
- Warm restarts keep the card (#1). Restart and power off now quiesce the chip, and attach recovers a wedged one (WFSYS reset, then a PCIe function level reset). On the author's Legion 5 the first warm restart under 0.12 came back with Wi-Fi up and a clean firmware load.
- Link supervisor. A link that stays associated but stops passing traffic is noticed within about 8 s and rejoined, or the firmware is reloaded without dropping the interface (
MtkStallSec,mtkstall=). - Bigger scan cache (128 networks) and the join ROC is held through the WPA2 handshake.
- Core API v5: rate details (PHY, MCS, streams, width, guard interval) and the country code. Outside the US and its territories the radio only gets more passive, never louder.
MtkAutoNetworksandtools/recovery/for the installer and Recovery.
Tested on macOS 26.7.1 (25G241), Legion 5 15IAX10, MT7925 14c3:7925: joined at boot, and macOS reported 11ac, 80 MHz, MCS 9, 2 streams, 866 Mbit/s. That figure is the negotiated maximum; the firmware sent no TX status records on this link. Full notes in CHANGELOG.md.
MtkWlan.kext sha256 a15f492e7ca9004360fefe58d5286489b5848849ac6fd2e390aac3563ebea73d.
2026-10-28: runs unchanged on macOS 26.7.2 (25G332). The native Wi-Fi menu there needs MtkWlanNative 0.4.14; the bundle mt7925-wifi-bundle-0.12.1+0.4.14.zip has both.