watchthelight labs

MT7925 (103c:8f06) on macOS 26.0 (25A354): Ethernet front end works (en1), no native Wi-Fi UI — is 26.0 supported? #6

open
xiaoyizpast 2026-11-09

@watchthelight thanks for the driver — reporting a working setup plus one limitation, with logs.

Environment
Laptop HP HyperX OMEN PRO 16 (board 103c:8f06)
CPU Ryzen 9 9955HX
Wi-Fi MediaTek MT7925, PCI 14c3:7925, subsystem 103c:8c38
macOS 26.0 (25A354), kernel 25.0.0
Bootloader OpenCore 1.0.9
MtkWlan 0.12.1 (org.watchthelight.MtkWlan)
MtkBt 0.2.4 (org.watchthelight.MtkBt)

Current status

The Ethernet front end works:

en1: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1500
    ether d8:5b:27:21:01:93
    inet 182.151.161.216 netmask 0xfffffc00
    status: active

default gateway 182.151.160.1, interface en1
ping 1.1.1.1 -> 2/2 received, avg 76 ms

Interface path from configd:

IOService:/AppleACPIPlatformExpert/PCI0@0/AppleACPIPCI/GPP6@1,7/IOPP/WLAN@0/MtkWlan/MtkWlanEth/IOEthernetInterface

Note it came up as en1 on this machine (the README mentions en2; both Realtek ports are en0 and en1 here, and MtkWlanEth took en1).

Limitation

No Wi-Fi pane in System Settings and no native Wi-Fi menu. That matches the README (native front end needs 26.7.1 / 26.7.2), but I would like to confirm the 26.0 status and whether support is planned.

Debug steps

kmutil showloaded | grep -i mtk
# org.watchthelight.MtkWlan (0.12.1)
# org.watchthelight.MtkBt (0.2.4)

ioreg -l -w0 | grep -A6 'pci14c3,7925'
# "compatible" = "pci103c,8c38","pci14c3,7925","pciclass,028000","WLAN"

ioreg -n MtkWlan -r -d 1
# "MtkFwVersion" = "____000000-20260813113118"
# "MtkCountry"   = "US, 36 channels (11 at 2.4 GHz), rc 0"
# "MtkPower" = Yes, "MtkRxBa" = Yes, "MtkTxBa" = Yes

ifconfig -l
# lo0 gif0 stf0 XHC128 XHC96 XHC0 en0 en1 utun0..3   (no en2)

Kernel log excerpt

2026-11-09 23:51:40.549 Df launchd[1:2a4] [system/com.local.mtkwifi-autojoin [297]:] Requesting first run LWCR update
2026-11-09 23:51:40.550 Df backgroundtaskmanagementd[288:6a5] [com.apple.backgroundtaskmanagement:main] effectiveItemDisposition: appURL=(null), type=legacy daemon, url=file:///Library/LaunchDaemons/com.local.mtkwifi-autojoin.plist, config={
        "/Users/macos/bin/mtkwifi",
    BTMConfigExecutablePath = "/Users/macos/bin/mtkwifi";
    BTMConfigLabel = "com.local.mtkwifi-autojoin";
2026-11-09 23:51:40.551 Df launchd[1:30c] [system/com.local.mtkwifi-autojoin [297]:] Updated BTM identifiers: 00000000-0000-0000-0000-000000000000 New LWCR needed: 1
2026-11-09 23:51:40.551 Df xpcproxy[297:6bf] Launch constraint set on 00000000-0000-0000-0000-000000000000 /Library/LaunchDaemons/com.local.mtkwifi-autojoin.plist
2026-11-09 23:51:40.551 Df launchd[1:2a4] [system/com.local.mtkwifi-autojoin [297]:] service state: running
2026-11-09 23:51:40.551 Df launchd[1:2a4] [system/com.local.mtkwifi-autojoin [297]:] internal event: INIT, code = 0
2026-11-09 23:51:40.551 Df launchd[1:2a4] [system/com.local.mtkwifi-autojoin [297]:] Successfully spawned mtkwifi[297] because speculative
2026-11-09 23:51:40.892 Df launchd[1:2a4] [pid/297 [mtkwifi]:] uncorking exec source upfront
2026-11-09 23:51:40.892 Df launchd[1:2a4] [pid/297 [mtkwifi]:] created
2026-11-09 23:51:41.486 Df kernel[0:896] (IOPCIFamily) [PCIe:0 6921943984 ns] [childPublished()] child MtkBt(0x100000506) published
2026-11-09 23:51:41.894 Df kernelmanagerd[126:87f] Received kext load notification: org.watchthelight.MtkWlan
2026-11-09 23:51:41.894 E  kernelmanager_helper[365:8f8] Could not process load notification in helper: Could not find: Did not find identifier (org.watchthelight.MtkWlan) in helper to process load notification
2026-11-09 23:51:47.741 Df launchd[1:30c] [system/com.local.mtkwifi-autojoin [297]:] exited due to exit(1), ran for 7194ms
2026-11-09 23:51:47.741 Df launchd[1:30c] [system/com.local.mtkwifi-autojoin [297]:] service state: exited
2026-11-09 23:51:47.741 Df launchd[1:30c] [system/com.local.mtkwifi-autojoin [297]:] internal event: EXITED, code = 0
2026-11-09 23:51:47.741 Df launchd[1:30c] [system:] service inactive: com.local.mtkwifi-autojoin
2026-11-09 23:51:47.741 Df launchd[1:30c] [system/com.local.mtkwifi-autojoin [297]:] service state: not running
2026-11-09 23:51:47.741 Df launchd[1:30c] [pid/297 [mtkwifi]:] shutting down
2026-11-09 23:51:47.741 Df launchd[1:30c] [pid/297 [mtkwifi]:] cleaning up
  path = IOService:/AppleACPIPlatformExpert/PCI0@0/AppleACPIPCI/GPP6@1,7/IOPP/WLAN@0/MtkWlan/MtkWlanEth/IOEthernetInterface
2026-11-09 23:52:18.835 A  mtkwifi[893:1b47] (libsystem_info.dylib) Retrieve User by ID
2026-11-10 00:57:15.263 Df sudo[22977:1ffe8]    macos : a password is required ; PWD=/Users/macos/Documents/deepseek-harness/default-workspace ; USER=root ; COMMAND=/Users/macos/bin/mtkwifi status

mtkwifi CLI observations (separate, minor)

  • mtkwifi scan requires root.
  • mtkwifi add fails with mkdir ... No such file or directory until /Library/Application Support/legion is created manually.
  • Saved networks do not auto-join without a LaunchDaemon running mtkwifi autojoin.

Questions

  1. Is macOS 26.0 (25A354) intentionally unsupported for the native front end, or is it a build-specific limitation that could be relaxed?
  2. Is there anything I can test/collect on 26.0 to help (e.g. specific ioreg keys, mtkwifi scan --wait output)?
  3. Any known issue with the card coming up as en1 instead of en2?

Full log and ioreg can be provided if useful. Happy to test builds.

My project

Machine-specific OpenCore config, SSDTs and post-install notes for this exact laptop:

Reply on GitHub