watchthelight labs

Does this support macOS 12.7? Or anything pre-15? #5

open
team-orangeBlue 2026-11-08

I'm trying to make this wifi card work on my desktop.
Just installed it instead of the ac9260.

I've put this kext in, did a cmd+r with propertree, made sure mtkwlan loads before wlannative and bt.
Boot args in the config snippet plist are present:

				<string>-radcodec e1000=0 keepsyms=1 debug=0x100 mtkfe=native mtknativeif=1 alcid=1 agdpmod=pikera unfairgva=1</string>

However no new ethernet device appears, neither does a bluetooth device; wifi in top bar is force-off, settings crash trying to view the wifi device; bluetooth cannot be turned on, etc.

Any place to get logs from for troubleshooting or is macos 12 not in scope? Maybe set a minimum kernel version..?

Ryzen 2700X
B450 motherboard
Device appears on PCIe:

PCIDBG  VEN:DEV   Built-In APCI+Device Path
-------------------------------------------
---
04:00.0 8086:1539 YES      /PCI0@0/GPP2@1,3/PT02@0,2/PT20@0/I211@0 = PciRoot(0x0)/Pci(0x1,0x3)/Pci(0x0,0x2)/Pci(0x0,0x0)/Pci(0x0,0x0)
05:00.0 14c3:7925 YES      /PCI0@0/GPP2@1,3/PT02@0,2/PT21@1/WIBT@0 = PciRoot(0x0)/Pci(0x1,0x3)/Pci(0x0,0x2)/Pci(0x1,0x0)/Pci(0x0,0x0)
06:00.0 1987:5012 YES      /PCI0@0/GPP2@1,3/PT02@0,2/PT24@4/PX16@0 = PciRoot(0x0)/Pci(0x1,0x3)/Pci(0x0,0x2)/Pci(0x4,0x0)/Pci(0x0,0x0)
---
watchthelight 2026-11-10

macOS 12 hasn't been tried by anyone. The driver has only run on Darwin 24 and 25 (macOS 15 and 26). It depends on IONetworkingFamily and IOPCIFamily only, so it may load on 12, but I can't tell you it works.

Two things in your setup can't work on 12 either way. MtkWlanNative, the Wi-Fi menu part, is built for two Tahoe builds (25G241 and 25G332) and refuses to load anywhere else, so take it out and remove mtkfe=native mtknativeif=1 from boot-args. With the driver alone there's no Wi-Fi menu: the card shows up as an Ethernet port and you join with the mtkwifi tool. So the dead Wi-Fi icon and the Settings crash come from something else that says it's a Wi-Fi device. Is an itlwm or AirportItlwm left over from the AC 9260?

To see what the driver did:

kmutil showloaded | grep -i -E 'mtk|itlwm|bluetool'
ioreg -r -c MtkWlan -l -w0 | head -60
log show --last boot --predicate 'eventMessage CONTAINS "MtkWlan"' | tail -80

For Bluetooth, MtkBt needs BlueToolFixup, and the card's USB port has to be in your USB map. ioreg -rc MtkBt -l | grep MtkBt shows how far it got.

A minimum version is a fair idea. The README names 15 and 26 as tested, and I'd rather see your output before I set a hard limit.

Reply on GitHub