watchthelight 2026-10-20
This driver runs the MediaTek MT7925 (14c3:7925) and matches the AMD RZ717 (14c3:0717), which is the same chip. The MT7921, MT7921K (RZ608), MT7922 (RZ616), MT7920 and MT7902 are not supported, and the chip check in src/MtkWlan.cpp refuses them on purpose: a kext that loads on a card it cannot bring up would take away the Wi-Fi that SimpleMtkWlan and its forks give those cards today.
What the MT7921/MT7922 port needs (from reading Linux mt76, mt7921 and mt7925 drivers side by side; nothing of this is written yet):
- Firmware:
WIFI_RAM_CODE_MT7961_1.bin and WIFI_MT7961_patch_mcu_1_2_hdr.bin instead of the MT7925 pair. tools/gen_firmware.py embeds the files by name and checks firmware/SHA256SUMS; the loader in src/MtkFw.cpp reads the same header layout, so this part is a file swap plus the chip id in the check.
- MCU commands: the MT7925 driver uses the UNI command set throughout. The MT7921 family answers most of them, but a few (station record, bss info, the channel switch) are the older non-UNI commands in mt76's
mt7921 driver. src/MtkScan.cpp and src/MtkJoin.cpp are where the calls live.
- Register map and DMA: WFDMA ring bases differ between the two families;
src/MtkRegs.cpp and src/MtkDma.cpp hold the MT7925 values, mt76's mt7921/regs.h has the others.
- TX power tables (
src/MtkPower.cpp) are per chip; the firmware's defaults are safe until then.
- The Bluetooth loader is a separate matter: the MT7921/MT7922 Bluetooth firmware files and WMT sequence differ, and SimpleMtkBtFw already covers them.
What I need: a card. I only have the MT7925 laptop. If you have an MT7921, RZ608, MT7922 or RZ616 in an OpenCore machine and are willing to run test builds and send tools/mtk-report.sh archives, reply here with the PCI ids (ioreg -p IOPCI -l | grep -E '"IOName"|vendor-id|device-id' -A2 or the System Information PCI pane) and your macOS build. A card on loan would be faster still.
Until this closes, the right driver for those cards is SimpleMtkWlan (pengubow and forks) or AirportMtkWlan for the native menu on macOS 15.2 to 15.x.