Skip to content

WTLWireless 0.14.0

Choose a tag to compare

@watchthelight watchthelight released this 11 Nov 01:48
· 4 commits to main since this release

One kext in place of three. WTLWireless.kext holds the Wi-Fi driver, and inside it (Contents/PlugIns) the Wi-Fi menu part and the Bluetooth firmware loader. It replaces MtkWlan.kext 0.13.0, MtkWlanNative.kext 0.4.17 and MtkBt.kext 0.2.4. The code of the three is unchanged; the names, the packaging and the version (one for all three now) are new. This repository was renamed from WTLMtkWireless to WTLWireless with this release, and WTLWifiMenu and WTLMtkBluetooth are archived. Old links redirect.

Download WTLWireless-0.14.0-RELEASE.zip. It has the kext, INSTALL.md, a config-snippet.plist, the licences and a Recovery folder with the mtkwifi tool.

Coming from the old kexts

  1. Copy WTLWireless.kext to EFI/OC/Kexts.
  2. In config.plist, Kernel > Add: remove the entries for MtkWlan.kext, MtkWlanNative.kext and MtkBt.kext, and add three for the bundle, the driver first:
    • WTLWireless.kext (Contents/MacOS/WTLWireless)
    • WTLWireless.kext/Contents/PlugIns/WTLWirelessNative.kext (Contents/MacOS/WTLWirelessNative, MinKernel 25.0.0, MaxKernel 25.99.99)
    • WTLWireless.kext/Contents/PlugIns/WTLWirelessBt.kext (Contents/MacOS/WTLWirelessBt)
  3. Delete the three old kext folders.

boot-args (mtkfe=native mtknativeif=1), the Bluetooth NVRAM keys, BlueToolFixup and LegionBtFix stay as they are, and macOS keeps its saved networks and paired devices. Do not run old and new together: if MtkWlan.kext is still loaded, the new driver leaves the card to it and says so in the MtkConflict property of the card's PCI device.

What else is different

  • The classes are now WTLWireless, WTLWirelessNative and WTLWirelessBt (for ioreg -rc). The properties (MtkState, MtkNative..., MtkBt...) keep their names.
  • mtkwifi, tools/wifi.sh and tools/mtk-report.sh find the driver under either class name.
  • Sources are in src/core, src/native and src/bt, and ./build.sh builds the whole bundle.
  • macOS builds for the Wi-Fi menu are the same as before: 26.7.1 (25G241), 26.7.2 (25G332), 26.7.3 (25G342) and the 26.7.3 developer beta 25G416. On any other build the driver shows its Ethernet port by itself.

How it was checked

The host harness records 3589 events; against 0.13.0 the 3573 hardware lines are identical and one status line differs, the one that names the Wi-Fi menu part. Then two boots on a Legion 5 15IAX10 (macOS 26.7.3 developer beta, 25G416, MT7925 14c3:7925): first Wi-Fi from the bundle with MtkBt 0.2.4 still loaded, then all three parts from the bundle. Wi-Fi joined the saved WPA2 network at boot both times: same channel list as 0.13.0, 5 GHz, 80 MHz, MCS 9, 2 streams, 866 Mbit/s. Bluetooth: MtkBtState ready after 1251 ms, controller on, the known devices still listed.

Not checked on hardware for this release: pairing a new Bluetooth device, a connection and audio (the loader's code did not change), the MtkConflict path and the Ethernet fallback under the new names (host test only).

sha256

129744934a921eb64ba5fe58a8e16bfd581e85fbaa69e8baf2639a0046e91a4e  WTLWireless.kext/Contents/MacOS/WTLWireless
fc91675d01ee12359caa5da196195911bf2e61aa08117f16dc4e75e0cce1fb5f  WTLWireless.kext/Contents/PlugIns/WTLWirelessNative.kext/Contents/MacOS/WTLWirelessNative
e755a8c20aed5955aaef568747a29e40d924baea78c1f06a708cc1c057cbac67  WTLWireless.kext/Contents/PlugIns/WTLWirelessBt.kext/Contents/MacOS/WTLWirelessBt

These are the binaries from the two test boots. ./build.sh at this tag with Apple clang 21.0.0 (clang-2100.1.1.101) gives the same three files.